Configuration reference

Copy config.example.json to config.json with npm run setup. Restart the bot after changing this file. IDs must be Discord IDs from your application and server. Empty optional IDs disable those destinations or features.

SettingPurpose
nameBot name shown in audit reasons, help and notices.
applicationId, guildIdThe Discord application and server for this running copy. You may use separate copies for other servers you own or manage.
ownerIdsUser IDs allowed to run owner prefix commands. Keep at least one.
prefixOwner command prefix, comma by default.
databaseFileRelative SQLite path inside the package. This edition runs one bot against one database.
appearance.embedColor, giveawayColor, successColor, warningColor, errorColorSix-digit hex colours for Discord embeds (for example #FF3D8B). Giveaways have their own accent; ticket panels, announcements, welcome messages, logs and command replies use the same palette. The bot name appears in card footers.
roles.moderatorRole allowed to warn and timeout members and run giveaways.
roles.administratorRole allowed to kick, ban, unban, announce and change cases.
roles.ticketHandlerAdditional role allowed to claim and close tickets.
roles.newMemberOptional role assigned to new human members.
permissions.*Minimum bot access for moderation, cases, giveaways, announcements, staff management and quarantine. Each value is moderator, admin or owner.
permissionRequests.enabled, reviewChannelIdTurn on owner-reviewed /perm select and /perm remove requests and choose the private channel where approval buttons are posted. See Permission approvals.
channels.moderationLogPrivate log for cases and automod events.
channels.ticketLogPrivate transcript log; required to close tickets.
channels.reportsPrivate report destination; required for /report.
channels.welcomeOptional public welcome channel.
categories.ticketsParent category for private tickets; required to open them.
tickets.panelTitle, tickets.panelDescription, tickets.channelPrefixTicket panel copy and ticket channel name prefix.
welcome.messageSupports {member} and {server} placeholders.
automod.modeoff, watch (log only), or on. Starts in watch.
automod.logChannelPrivate destination for rule verdicts; falls back to channels.moderationLog.
automod.allowedHosts, blockedHosts, scamHosts, brandHostsLists and mappings for link decisions. Unknown links are not automatically scams.
automod.allowedInviteCodes, blockedWords, blockedExtensionsAllowed invite codes and configured content/file filters.
automod.actions.*, automod.limits.*, automod.strikes.*Per-rule actions, thresholds and escalation. See Advanced automod.
automod.exemptRoleIds, exemptChannelIds, exemptUserIdsExplicit exemptions from automatic action.
quarantine.roleId, channelId, removeOtherRolesOptional quarantine role, private room and role-removal choice. Run /quarantine setup after setting IDs.
staffApplications.enabled, reviewChannelId, questionsPrivate application form and review destination.
staffRecords.memberRoleId, positionsCommon staff role and position-to-role mapping. See Staff records.
giveaways.enabledEnables or disables /giveaway.

The token is the only value in .env. The licence is a separate signed license.json; do not edit it. Owner, role and approved per-user permissions are checked by the bot. A Discord Administrator bit alone does not put someone on the owner list.

The source licence is for servers you own or manage, without server registration. Each running copy still has one applicationId, one guildId, its own token and its own data folder.