Settings reference

This page is generated from the same list the bot, the dashboard and the /config command use, so it always matches. 82 settings.

Change any of them on the dashboard under Settings or in Discord with /config set. "Needs" is the staff level required to change it. Values you have not changed use the default.

Features

Features settings
Setting	Type	Default	Needs	Details
`features.audit.enabled` Audit log enabled	On or off	on	Admin	Turn the Audit log feature on or off for this server.
`features.bridge.enabled` Chat bridge enabled	On or off	off	Admin	Turn the Chat bridge feature on or off for this server.
`features.giveaways.enabled` Giveaways enabled	On or off	off	Admin	Turn the Giveaways feature on or off for this server.
`features.leaderboards.enabled` Leaderboards enabled	On or off	on	Admin	Turn the Leaderboards feature on or off for this server.
`features.linking.enabled` Account linking enabled	On or off	on	Admin	Turn the Account linking feature on or off for this server.
`features.logging.enabled` Chat and message logging enabled	On or off	off	Admin	Turn the Chat and message logging feature on or off for this server.
`features.moderation.enabled` Moderation enabled	On or off	off	Admin	Turn the Moderation feature on or off for this server.
`features.notes.enabled` Staff notes enabled	On or off	off	Admin	Turn the Staff notes feature on or off for this server.
`features.public_pages.enabled` Public pages enabled	On or off	off	Admin	Turn the Public pages feature on or off for this server.
`features.ranks.enabled` Minecraft ranks and XP enabled	On or off	on	Admin	Turn the Minecraft ranks and XP feature on or off for this server.
`features.reports.enabled` Reports enabled	On or off	off	Admin	Turn the Reports feature on or off for this server.
`features.status.enabled` Server status enabled	On or off	on	Admin	Turn the Server status feature on or off for this server.
`features.suggestions.enabled` Suggestions enabled	On or off	off	Admin	Turn the Suggestions feature on or off for this server.
`features.tiers.enabled` Discord XP roles enabled	On or off	on	Admin	Turn the Discord XP roles feature on or off for this server.
`features.welcome.enabled` Welcome posts enabled	On or off	off	Admin	Turn the Welcome posts feature on or off for this server.

Staff

Staff settings
Setting	Type	Default	Needs	Details
`staff.administrator_is_admin` Administrators count as Admin	On or off	on	Owner	Members with Discord's Administrator permission are treated as Admin level.

Channels

Channels settings
Setting	Type	Default	Needs	Details
`channels.alerts` Admin alerts channel	Channel	not set	Admin	Where the bot tells admins about problems it finds. Bot permissions: View Channels, Send Messages, Embed Links
`channels.audit` Audit log channel	Channel	not set	Admin	A copy of the audit log is posted here. Part of: Audit log Bot permissions: View Channels, Send Messages, Embed Links
`channels.reports` Reports channel	Channel	not set	Admin	Where member reports are posted. Part of: Reports Bot permissions: View Channels, Send Messages, Embed Links
`channels.status` Status channel	Channel	not set	Admin	A channel that shows the live Minecraft server status. Part of: Server status Bot permissions: View Channels, Send Messages, Embed Links
`channels.suggestions` Suggestions channel	Channel	not set	Admin	Where member suggestions are posted for voting. Part of: Suggestions Bot permissions: View Channels, Send Messages, Embed Links
`channels.welcome` Welcome channel	Channel	not set	Admin	Where welcome cards are posted for new members. Part of: Welcome posts Bot permissions: View Channels, Send Messages, Embed Links

Account linking

Account linking settings
Setting	Type	Default	Needs	Details
`linking.code_ttl` Link code lifetime	Duration	10m	Admin	How long the code a player gets from /vv link in game stays valid. Codes work once; a new code replaces the old one. At least 1m. At most 1h Part of: Account linking

Branding and time

Branding and time settings
Setting	Type	Default	Needs	Details
`branding.footer` Embed footer	Text	Powered by VV-Bot	Admin	Text shown in the footer of the bot's embeds. Up to 64 characters
`time.zone` Time zone	Time zone	UTC	Admin	Used for daily resets and timestamps shown to members.

Public pages

Public pages settings
Setting	Type	Default	Needs	Details
`public.leaderboard` Public leaderboard	On or off	off	Admin	Show this server's leaderboard on its public page. Part of: Public pages

Audit

Audit settings
Setting	Type	Default	Needs	Details
`audit.mirror` Copy the audit log to a channel	On or off	off	Admin	Post every new audit entry (staff commands and dashboard changes) to the audit log channel. Set that channel with /config channel audit. Part of: Audit log Bot permissions: View Channels, Send Messages, Embed Links
`audit.retention_days` Keep the audit log for (days)	Whole number	180	Admin	Audit entries older than this are deleted automatically. Minimum 7. Maximum 730 Part of: Audit log

Bridge

Bridge settings
Setting	Type	Default	Needs	Details
`bridge.avatar_url` Head image address	Text per Minecraft server	https://mc-heads.net/avatar/{uuid}/128	Admin	Where a player's head image is fetched from. {uuid} is the player's id without dashes and {name} is the player's name. It must start with https://. Up to 200 characters Part of: Chat bridge
`bridge.avatars` Show player heads	On or off per Minecraft server	on	Admin	Use each player's head as the picture next to their chat lines. The image comes from a public skin service, which can see which players chat. Turn this off to keep player names and ids away from third parties. Part of: Chat bridge
`bridge.channel` Bridge channel	Channel per Minecraft server	not set	Admin	The Discord channel that shows this Minecraft server's chat and carries chat from Discord back to it. Leave it empty to turn the bridge off for this server. Part of: Chat bridge Bot permissions: View Channels, Manage Webhooks
`bridge.discord_to_mc` Discord chat to Minecraft	On or off per Minecraft server	on	Admin	Show what members write in the bridge channel to the players in game. This needs the Message Content permission, which only the operator of the bot can grant. Without it the other direction keeps working. Part of: Chat bridge
`bridge.format_to_mc` Discord to Minecraft format	Text per Minecraft server	{text}	Admin	How a Discord message looks in game. Use {author} for the member's Discord name and {text} for the message. The plugin already puts [Discord] and the member's name in front of it, so the default is just {text}. Up to 120 characters Part of: Chat bridge
`bridge.mc_to_discord` Minecraft chat to Discord	On or off per Minecraft server	on	Admin	Show what players say in game in the bridge channel. Part of: Chat bridge
`bridge.relay_advancements` Show advancements	On or off per Minecraft server	off	Admin	Post a line in the bridge channel when a player earns an advancement. This can be a lot of lines on a busy server, so it starts off. Part of: Chat bridge
`bridge.relay_deaths` Show deaths	On or off per Minecraft server	on	Admin	Post a line in the bridge channel when a player dies. Part of: Chat bridge
`bridge.relay_joins` Show joins and leaves	On or off per Minecraft server	on	Admin	Post a line in the bridge channel when a player joins or leaves the Minecraft server. Part of: Chat bridge
`bridge.webhook_name` Webhook name	Text per Minecraft server	VV Bridge	Admin	The name of the webhook the bot creates in the bridge channel. You can see it under Integrations in that channel's settings. Up to 32 characters Part of: Chat bridge

Giveaways

Giveaways settings
Setting	Type	Default	Needs	Details
`giveaways.max_active` Giveaways running at once	Whole number	5	Admin	The most giveaways that can be running in this server at the same time. Minimum 1. Maximum 50 Part of: Giveaways
`giveaways.max_duration` Longest giveaway	Duration	4w 2d	Admin	The longest a giveaway may run before it ends. At least 1m. At most 12w 6d Part of: Giveaways
`giveaways.max_winners` Most winners per giveaway	Whole number	20	Admin	The highest number of winners staff can choose when starting a giveaway. Minimum 1. Maximum 50 Part of: Giveaways

Ladder

Ladder settings
Setting	Type	Default	Needs	Details
`ladder.color_default` Default rank colour	Colour (hex)	not set	Admin	The colour a new rank gets when none is given. Leave empty for plain, uncoloured ranks. Part of: Minecraft ranks and XP
`ladder.default_weight_ceiling` Rank weight band: top	Whole number	200	Admin	The top of the weight band (see 'Rank weight band: bottom'). It must leave room for one whole number per rank between the two. Minimum 1. Maximum 9999 Part of: Minecraft ranks and XP
`ladder.default_weight_floor` Rank weight band: bottom	Whole number	100	Admin	LuckPerms group weights for the rank ladder are spread evenly BETWEEN the bottom and top of the band, so ranks sit above your lower groups and below your staff groups. A paired server that reports its own band uses that instead; this is the fallback. Minimum 0. Maximum 9998 Part of: Minecraft ranks and XP
`ladder.group_prefix` LuckPerms group name prefix	Text	vv_	Admin	Each rank becomes a LuckPerms group called <prefix><rank name>. The default 'vv_' matches the plugin's default allowlist and keeps rank groups from colliding with the server's own groups (a rank called 'admin' must never touch the 'admin' group). Lowercase letters, digits, '_' and '-' only, at most 12 characters. Up to 12 characters Part of: Minecraft ranks and XP
`ladder.prefix_brackets` Wrap rank prefixes in [brackets]	On or off	on	Admin	Show a rank in chat as [Lost Soul] instead of Lost Soul. Part of: Minecraft ranks and XP

Leaderboards

Leaderboards settings
Setting	Type	Default	Needs	Details
`leaderboards.refresh_interval` Live leaderboard refresh interval	Duration	12h	Admin	How often self-updating leaderboards are edited, for example 30m or 12h. At least 10m. At most 1w Part of: Leaderboards

Logging

Logging settings
Setting	Type	Default	Needs	Details
`logging.channels_allow` Only log these channels	List of channels	not set	Admin	If you list channels here, only those are logged. Leave it empty to log every public channel. Private and age-restricted channels are never logged either way. Part of: Chat and message logging
`logging.channels_deny` Never log these channels	List of channels	not set	Admin	Channels listed here are not logged, even if they are public. This wins over the list of channels to log. Part of: Chat and message logging
`logging.chat.enabled` Log Minecraft chat	On or off	off	Admin	Keep what players say in Minecraft chat, encrypted, so staff can search it when investigating a report. Needs the plugin and the Chat and message logging feature. Staff searches are recorded. Lines are deleted automatically after the retention time. Part of: Chat and message logging
`logging.messages.enabled` Log Discord messages	On or off	off	Admin	Keep what members write in this server's public channels, encrypted, so staff can search it when investigating a report. Needs the bot's Message Content permission from Discord. Direct messages, private channels and age-restricted channels are never logged. Staff searches are recorded. Part of: Chat and message logging
`logging.mode` What Discord messages are logged	One of a list	everything	Admin	everything: every message in a logged channel, removed from the log when the member deletes it. deleted_edited_only: nothing is stored unless a message is edited or deleted, then its text is kept so staff can see it. This only changes Discord messages; Minecraft chat has its own switch. Changing it does not delete what was stored earlier. Choices: everything, deleted_edited_only Part of: Chat and message logging
`logging.notice` Tell members that logging is on	On or off	on	Admin	Post a short notice in a logged channel the first time someone writes there (again after 30 days), and tell players in Minecraft when they join. Recommended: people should know. Part of: Chat and message logging
`logging.retention` How long logs are kept	Duration	4w 2d	Admin	Logged lines and messages are deleted after this long. Between 7d and 180d. Shortening it deletes older entries within the hour. At least 1w. At most 25w 5d Part of: Chat and message logging

Minecraft

Minecraft settings
Setting	Type	Default	Needs	Details
`minecraft.max_servers` Minecraft servers allowed	Whole number	3	Owner	How many Minecraft servers this community can connect at the same time. Removed servers do not count. Only the server owner can change this. Minimum 1. Maximum 10
`minecraft.status_show_players` Show player names in /status	On or off	on	Admin	When off, /status shows only how many players are online, not who they are. Part of: Server status

Moderation

Moderation settings
Setting	Type	Default	Needs	Details
`moderation.ban_delete_days` Message history deleted on ban (days)	Whole number	0	Admin	How many days of the banned member's messages are removed when no number is given in /mod ban. 0 keeps their messages. Discord allows up to 7. Minimum 0. Maximum 7 Part of: Moderation
`moderation.default_reason` Default reason	Text	No reason given	Admin	Used when staff leave the reason empty (only possible for actions where a reason is optional). Up to 100 characters Part of: Moderation
`moderation.dm_on_action` Tell members by DM	On or off	on	Admin	Send the member a direct message (server, action and reason) when they are warned, muted, kicked or banned. If their DMs are closed the action still goes through. Part of: Moderation
`moderation.helper_max_mute` Longest mute a Helper may give	Duration	1d	Admin	Helpers, the lowest staff level, can mute a member for at most this long. Longer mutes need a Mod. Discord itself never allows more than 28 days. At least 1m. At most 4w Part of: Moderation
`moderation.mod_max_mute` Longest mute a Mod may give	Duration	4w	Admin	Mods can mute a member for at most this long. Admins and owners can always use Discord's maximum of 28 days. At least 1m. At most 4w Part of: Moderation
`moderation.require_reason` Require a reason	On or off	on	Admin	Staff must write a reason for warnings, mutes, kicks and bans. Turn off to let them skip it (the default reason is used instead). Part of: Moderation

Reports

Reports settings
Setting	Type	Default	Needs	Details
`reports.cooldown` Report cooldown	Duration	1m	Admin	How long a member has to wait between two reports. Stops one person flooding staff. At least 5s. At most 1d Part of: Reports
`reports.max_open_per_user` Open reports per member	Whole number	5	Admin	A member can have at most this many unhandled reports at once. Minimum 1. Maximum 50 Part of: Reports

Suggestions

Suggestions settings
Setting	Type	Default	Needs	Details
`suggestions.allow_redecide` Allow changing a decision	On or off	on	Admin	Let staff approve or deny a suggestion that was already decided. When off, a decision is final. Part of: Suggestions
`suggestions.cooldown` Suggestion cooldown	Duration	2m	Admin	How long a member has to wait between two suggestions. At least 5s. At most 1d Part of: Suggestions
`suggestions.dm_author` DM the author on a decision	On or off	on	Admin	Tell the member by direct message when staff approve or deny their suggestion. Part of: Suggestions
`suggestions.vote_emojis` Voting reactions	Text	thumbs up sign thumbs down sign	Admin	The reactions added to each suggestion so members can vote. Separate them with spaces (up to 5; custom emojis from this server work too). Leave empty for no reactions. Up to 120 characters Part of: Suggestions

Welcome

Welcome settings
Setting	Type	Default	Needs	Details
`welcome.mention_role` Welcome committee role	Role	not set	Admin	A role mentioned under every welcome post, to nudge people to say hello. Leave empty to mention nobody. Part of: Welcome posts

Xp

Xp settings
Setting	Type	Default	Needs	Details
`tiers.keep_lower_roles` Keep lower XP roles	On or off	off	Admin	Off: a member holds only the highest XP role they have earned. On: they keep every XP role they have earned. Part of: Discord XP roles
`xp.discord.cooldown` Chat XP cooldown	Duration	1m	Admin	In cooldown mode: the shortest time between two XP awards for the same member, for example 60s or 2m. At least 5s. At most 1d Part of: Discord XP roles
`xp.discord.cooldown_amount` XP per award (cooldown mode)	Whole number	15	Admin	In cooldown mode: how much Discord XP each award is worth. Minimum 0. Maximum 1000 Part of: Discord XP roles
`xp.discord.daily_amount` Daily XP	Whole number	20	Admin	Discord XP a member earns from /daily, once per day. Minimum 0. Maximum 10000 Part of: Discord XP roles
`xp.discord.daily_streak_bonus` Daily streak bonus	Whole number	5	Admin	Extra XP per day of streak on top of the daily amount (day 1 has no bonus). Minimum 0. Maximum 1000 Part of: Discord XP roles
`xp.discord.daily_streak_cap` Daily streak bonus cap	Whole number	6	Admin	The streak bonus stops growing after this many bonus days. Minimum 0. Maximum 365 Part of: Discord XP roles
`xp.discord.every_n` Messages per XP award	Whole number	50	Admin	In every_n mode: a member earns XP on every Nth message they send. Minimum 1. Maximum 10000 Part of: Discord XP roles
`xp.discord.every_n_amount` XP per award (every_n mode)	Whole number	10	Admin	In every_n mode: how much Discord XP each award is worth. Minimum 0. Maximum 1000 Part of: Discord XP roles
`xp.discord.ignored_channels` Channels that earn no chat XP	List of channels	not set	Admin	Messages in these channels are not counted. Useful for bot-spam or counting channels. Part of: Discord XP roles
`xp.discord.message_mode` How chatting earns Discord XP	One of a list	cooldown	Admin	cooldown: a message earns XP at most once per cooldown (smooth, hard to farm). every_n: every Nth message earns XP, however fast they are sent. The bot only counts messages; it never reads what they say. Choices: every_n, cooldown Part of: Discord XP roles
`xp.discord.welcome_amount` XP for welcoming a new member	Whole number	100	Admin	Discord XP a member earns for pressing the Welcome button on a new member's post. Minimum 0. Maximum 10000 Part of: Welcome posts
`xp.discord.welcome_claim_limit` Welcomes that pay out per new member	Whole number	1	Admin	How many people can earn XP for welcoming the same new member. The first few to press the button win; the post then closes. Minimum 1. Maximum 25 Part of: Welcome posts
`xp.mc.quest_default` Default quest reward	Whole number	200	Admin	Minecraft XP a new quest is worth when no amount is given. Minimum 0. Maximum 100000 Part of: Minecraft ranks and XP