> ## Documentation Index
> Fetch the complete documentation index at: https://nocturneidle.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Config Overview & Flags

> he central control panel for Nocturne. Configure behaviour flags, log channels, whitelisted roles, DM notices, and more.

The `/config` command group acts as the central control panel for Nocturne. Instead of forcing your server to adapt to the bot, these commands allow you to tailor the bot's underlying logic, limits, and behaviour to match how your community already operates.

***

<h2 id="config-view">
  Viewing Your Configuration
</h2>

Before and after making any changes, you can pull up a complete dashboard of your server's settings. This command displays your active behavioural flags, your log channel, configured whitelists, global DM notices, and overall system health.

<Badge color="red" size="sm">User: Manage Server</Badge>

<Tabs>
  <Tab title="Command" icon="code-simple">
    ```text Command theme={null}
    /config view
    ```
  </Tab>

  <Tab title="Visual Output" icon="image">
    <img src="https://mintcdn.com/nocturneidle/rKKUixGtrUsPbPeX/images/Config-View.png?fit=max&auto=format&n=rKKUixGtrUsPbPeX&q=85&s=0021f9e51db67725ca77ed1aa0b214bb" alt="Config View" title="Config View" className="mx-auto" style={{ width:"43%" }} width="428" height="707" data-path="images/Config-View.png" />
  </Tab>
</Tabs>

<Tip>
  If you are ever unsure whether a specific setting is turned on, or if you want to check how many trees you have active, `/config view` should always be your first stop!
</Tip>

***

<h2 id="flags">
  Server Behaviour Flags
</h2>

Nocturne has three core behavioural toggles that change how the bot handles staff actions. All three are managed from a single interactive panel.

<Badge color="red" size="sm">User: Manage Server</Badge>

<Tabs>
  <Tab title="Command" icon="code-simple">
    ```text Command theme={null}
    /config flags
    ```
  </Tab>

  <Tab title="Visual Output" icon="image">
    <img src="https://mintcdn.com/nocturneidle/rKKUixGtrUsPbPeX/images/Config-Flags.png?fit=max&auto=format&n=rKKUixGtrUsPbPeX&q=85&s=05b36ae29d1cb6c16a42288f23af7af3" alt="Config Flags" title="Config Flags" className="mx-auto" style={{ width:"55%" }} width="767" height="563" data-path="images/Config-Flags.png" />
  </Tab>
</Tabs>

Running `/config flags` opens an **ephemeral interactive panel** visible only to you. Each flag is displayed with a short description, its current status, and a button to toggle it on or off instantly.

* A **blue <kbd>Enable</kbd> button** and the `Disabled` status means the flag is currently disabled. Clicking the button will enable the flag.
* A **red <kbd>Disable</kbd> button** and the `Enabled` status means the flag is currently enabled. Clicking the button will disable the flag.

***

<h3 id="instant-fire">
  Instant Fire
</h3>

By default, a staff member must be demoted step-by-step down to the lowest role in a tree before they can be fired entirely.

Enabling **Instant Fire** lets executors fire a staff member directly from any position, stripping all associated roles in one action, regardless of where they currently sit in the hierarchy.

<Info>
  By default, **Instant Fire** is **disabled**.
</Info>

***

<h3 id="persistence">
  Linked Role Persistence
</h3>

By default, when a user is promoted from an old base role to a new base role, Nocturne cleans up their profile by removing the linked roles attached to their old base role.

Enabling **Persistence** stops this cleanup. Linked roles from lower roles will remain on the user permanently as they get promoted. They will only be removed if the user is explicitly demoted or fired.

<Info>
  By default, **Linked Role Persistence** is **enabled**.
</Info>

***

<h3 id="dm-notices-default">
  DM Notices Default
</h3>

Whenever a staff action is taken (Hire, Fire, Promote, Demote), Nocturne can send a direct message to the target user notifying them of the change.

**DM Notices Default** is the global on/off switch for this feature. When disabled, Nocturne performs all staff actions silently without attempting to contact the user. If enabled, Nocturne will DM the user, letting them know about the action taken.

<Info>
  By default, **DM Notices Default** is **disabled**.
</Info>

<Note>
  Regardless of the status of this flag, the executor running the `/staff` command can always use the optional `[dm-user]` field to decide whether to send a DM or not. If that option is not selected, then Nocturne will default to whatever the this flag is set to.
</Note>

<Tip>
  If you enable DM Notices Default, you will likely want to customise what those messages say. Check out the [DM Notices Guide](/commands/config/dm-notices) to learn how to personalise them per action and per tree.
</Tip>