A Tree in Nocturne is a container for a specific staff hierarchy. Each tree acts like a ladder/promotional pathway and is used to keep departments separate (e.g., Moderation, Events).
To start building a hierarchy, you first need to create the tree itself.User: Manage Server
Command
Visual Output
Command
/tree create <name>
Example
/tree create name:Moderation
Tree names can be a maximum of 32 characters long. We recommend keeping them short and recognisable, as you will be typing them out frequently when running staff commands!
You can check the configuration of your trees at any time. This will display all the Base Roles, their Hierarchy Positions, and any Linked Roles attached to them, along with the status of custom DM Notices for that tree.User: Manage Server
Command
Without [tree] parameter
With [tree] parameter
Command
/tree view <name>
If you leave [tree] parameter blank, the bot will display a high-level summary of all the trees currently configured in your server.
Example
/tree view
If you provide a[tree] parameter, the bot will display a detailed breakdown of that specific tree.
Example
/tree view tree:Moderation
In the detailed tree breakdown, you might see two types of issues:
Warning symbol next to a role: Nocturne cannot manage this role because it sits above Nocturne’s own role in the server hierarchy. Fix it by dragging Nocturne’s role above it in Server Settings > Roles.
(Deleted) next to a role: The role has been deleted from your server. Nocturne will throw errors until you run /fix to clean it up. See the System Fix Guide for details.
If you ever need to rebrand a department, you can easily rename an existing tree without having to recreate all the roles inside it.User: Manage Server
Command
Visual Output
Command
/tree rename <tree> <name>
Example
/tree rename tree:Event name:Event Team
Renaming a tree updates it everywhere in the database. You will immediately use the new name when running /staff commands.
If a department is shut down or you want to start from scratch, you can permanently delete a tree.User: Manage Server
Command
Visual Output
Command
/tree delete <tree>
Example
/tree delete name:Partnership
This action cannot be undone. Deleting a tree will permanently wipe its configuration from the database, including all assigned Base Roles, Linked Roles, and custom DM Notices configured for that tree. (Note: This does not delete the actual roles from your Discord server settings, it just unlinks them from the bot).
