> ## 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.

# Nocturne Documentation

> Welcome to the official documentation for Nocturne. Learn how to configure hierarchies, automate role assignments, and manage your staff team.

<h2 id="about-nocture">
  What is Nocturne?
</h2>

Nocturne is a Discord bot built specifically for staff management. When someone joins your staff team, they typically need several roles at once: a base role, a permissions role, a staff lounge access role, and maybe a ping role. When they leave, all of those need to come off cleanly. Nocturne handles all of that with a single command.

Instead of manually juggling roles in Discord's UI or remembering which five roles a promotion requires, your management team runs `/staff hire`, `/staff promote`, or `/staff fire`, and Nocturne automatically takes care of the role assignments, cleanups, DM notices, and audit logging.

Nocturne is built for general Discord servers of any size or type. Whether you run a gaming community, a content server, or a large public server with multiple staff departments, it fits without needing workarounds.

### Details

<Columns cols={2}>
  <Column>
    * Bot: `Nocturne#2184`
    * Bot ID: `1473533466673938617`
  </Column>

  <Column>
    * Developer: `@frozen4917`
    * Developer ID: `728846598330646662`
  </Column>
</Columns>

***

<h2 id="paths">
  Choose Your Path
</h2>

What are you trying to do today? Choose the category that best fits your current goal.

<CardGroup cols={2}>
  <Card title="Before You Start" icon="book-bookmark" href="/guide/before-you-start">
    Have a quick dive into Discord's role hierarchy and how everything is formatted in this documentation.
  </Card>

  <Card title="Quick Setup Guide" icon="timer" href="/guide/quick-start">
    A 10-minute checklist to build your first tree and get the bot operational without any hassle.
  </Card>

  <Card title="Why Nocturne?" icon="circle-question" href="/resources/why-nocturne">
    Understand what problem Nocturne solves and how it compares to other approaches.
  </Card>

  <Card title="Role Hierarchies" icon="list-tree" href="/commands/tree/basics">
    Learn how to construct and manage your tree and configure roles.
  </Card>

  <Card title="Bot Configuration" icon="gear" href="/commands/config/overview">
    Toggle some behavioural flags, set up whitelisted roles and log channels.
  </Card>

  <Card title="Custom DM Notices" icon="envelope" href="/commands/config/dm-notices">
    Personalise the direct messages the bot sends when someone is promoted or fired.
  </Card>

  <Card title="Variables Cheat Sheet" icon="brackets-curly" href="/guide/variables-guide">
    A quick reference list of `{variable}` tags for writing custom DM notices.
  </Card>

  <Card title="Staff Actions Guide" icon="users" href="/commands/staff-actions">
    Learn how to execute Hire, Fire, Promote, and Demote commands safely.
  </Card>
</CardGroup>

***

<h2 id="links">
  Important Links
</h2>

Need help, or ready to add the bot to your server?

<CardGroup cols={2}>
  <Card title="Invite Nocturne" icon="discord" href="https://discord.com/oauth2/authorize?client_id=1473533466673938617&permissions=275683527680&integration_type=0&scope=bot+applications.commands">
    Add Nocturne to your Discord server and start automating your team today.
  </Card>

  <Card title="Join Support Server" icon="book-open" href="https://discord.gg/ZWdVcXhpn4">
    Found a bug? Need help with permissions? Open a ticket in our support server.
  </Card>
</CardGroup>