Server Configuration

Configure Nevi's roles, leveling, economy, and moderation settings using the /config command.

Viewing your configuration

To see all of your server's current settings at a glance, use the view subcommand.

Usage

/config view

This displays every configurable setting along with its current value. Settings you haven't changed will show their defaults. It's a good idea to review this after first setting up Nevi to make sure everything is configured the way you want.

Setting values

Each setting can be changed individually using the config command with the setting name and new value.

Usage

/config set <setting> <value>

Example

/config set currencyName Gold

Boolean settings accept true or false. Role settings accept a role mention or role name. Text settings accept any string value.

Role settings

Nevi uses three role settings to determine who has elevated permissions for bot commands. These are separate from Discord's built-in permissions.

moderatorRole

Members with this role can use moderation commands like warn, mute, and kick.

/config set moderatorRole @Moderator

adminRole

Members with this role can use all moderator commands plus administrative commands like config, log setup, and autoroles.

/config set adminRole @Admin

muteRole

The role applied to members when they are muted. This role should have "Send Messages" denied in all channels where you want the mute to take effect.

/config set muteRole @Muted

If you don't set these roles, Nevi falls back to checking Discord's built-in permissions (e.g., Kick Members, Ban Members). See Permissions for the full permission hierarchy.

XP & leveling settings

These settings control Nevi's leveling system. For a deeper dive into how XP works, see the Leveling docs.

experienceEnabled

Master toggle for the XP system. When false, no one earns XP.

/config set experienceEnabled true

levelUpMessages

Whether Nevi announces when a member levels up. When false, members still level up but no message is sent.

/config set levelUpMessages true

levelUpChannel

The channel where level-up messages are sent. If not set, the message is sent in the channel where the member leveled up.

/config set levelUpChannel #level-ups

levelUpMessage

Customize the level-up announcement. Supports template variables: {user}, {level}, {oldlevel}, {server}.

/config set levelUpMessage Congrats {user}, you reached level {level}!

Economy settings

Customize the name and symbol of your server's currency to match your community's theme. See the Economy docs for the full economy system.

currencyName

The name of your server's currency (e.g., "Gold", "Coins", "Gems"). This appears in all economy command responses.

/config set currencyName Doubloons

currencySymbol

The emoji or symbol shown next to currency amounts. Can be a custom server emoji or a Unicode emoji.

/config set currencySymbol 💰

Moderation settings

These settings fine-tune how Nevi handles moderation actions.

dmPunishments

When true, Nevi sends a DM to the punished member explaining what happened (e.g., "You were warned in Server Name for: reason"). Members with DMs disabled won't receive these.

/config set dmPunishments true

detailedLogging

When true, Nevi stores message content so that when a message is deleted or edited, the full original content appears in your log channel, even if Discord's cache has already cleared it. Without this, deleted messages may show as "unknown content."

/config set detailedLogging true

For more on logging, see the Logging System page.

All settings reference

Here is a complete reference of every configurable setting.

Setting	Type	Description
moderatorRole	Role	Role for moderator-level commands
adminRole	Role	Role for admin-level commands
muteRole	Role	Role applied when a member is muted
experienceEnabled	Boolean	Enable or disable the XP system
levelUpMessages	Boolean	Send messages when members level up
levelUpChannel	Channel	Channel for level-up announcements
levelUpMessage	String	Custom level-up message template
dmPunishments	Boolean	DM users when they are punished
scheduledCommands	Boolean	Enable scheduled commands feature
detailedLogging	Boolean	Store message content for full delete/edit logs
currencyName	String	Name of the server currency
currencySymbol	String	Emoji or symbol for the currency

Related Commands

/configmanagementRequires admin

Configure server settings