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.
| Setting | Purpose |
|---|---|
name | Bot name shown in audit reasons, help and notices. |
applicationId, guildId | The Discord application and server for this running copy. You may use separate copies for other servers you own or manage. |
ownerIds | User IDs allowed to run owner prefix commands. Keep at least one. |
prefix | Owner command prefix, comma by default. |
databaseFile | Relative SQLite path inside the package. This edition runs one bot against one database. |
appearance.embedColor, giveawayColor, successColor, warningColor, errorColor | Six-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.moderator | Role allowed to warn and timeout members and run giveaways. |
roles.administrator | Role allowed to kick, ban, unban, announce and change cases. |
roles.ticketHandler | Additional role allowed to claim and close tickets. |
roles.newMember | Optional 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, reviewChannelId | Turn on owner-reviewed /perm select and /perm remove requests and choose the private channel where approval buttons are posted. See Permission approvals. |
channels.moderationLog | Private log for cases and automod events. |
channels.ticketLog | Private transcript log; required to close tickets. |
channels.reports | Private report destination; required for /report. |
channels.welcome | Optional public welcome channel. |
categories.tickets | Parent category for private tickets; required to open them. |
tickets.panelTitle, tickets.panelDescription, tickets.channelPrefix | Ticket panel copy and ticket channel name prefix. |
welcome.message | Supports {member} and {server} placeholders. |
automod.mode | off, watch (log only), or on. Starts in watch. |
automod.logChannel | Private destination for rule verdicts; falls back to channels.moderationLog. |
automod.allowedHosts, blockedHosts, scamHosts, brandHosts | Lists and mappings for link decisions. Unknown links are not automatically scams. |
automod.allowedInviteCodes, blockedWords, blockedExtensions | Allowed 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, exemptUserIds | Explicit exemptions from automatic action. |
quarantine.roleId, channelId, removeOtherRoles | Optional quarantine role, private room and role-removal choice. Run /quarantine setup after setting IDs. |
staffApplications.enabled, reviewChannelId, questions | Private application form and review destination. |
staffRecords.memberRoleId, positions | Common staff role and position-to-role mapping. See Staff records. |
giveaways.enabled | Enables 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.