Tree Basics

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

Creating a Tree

To start building a hierarchy, you first need to create the tree itself.

User: Manage Server

Command

/tree create <name>

Text Example

Example

/tree create name:Moderation

Visual Output

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!

---

Viewing Trees

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

/tree view [tree]

Without [tree] parameter

If you leave [tree] parameter blank, the bot will display a high-level summary of all the trees currently configured in your server.

Text Example

Example

/tree view

Visual Output

With [tree] parameter

If you provide a [tree] parameter, the bot will display a detailed breakdown of that specific tree.

Text Example

Example

/tree view tree:Moderation

Visual Output

In the detailed tree breakdown, you might see two types of issues:

1. If you see a warning symbol next to a role, it means Nocturne cannot manage the role because it is physically above Nocturne’s highest role. To fix this, drag one of Nocturne’s roles above the role you want it to manage.
2. If you see a “(Deleted)” text next to a role, it means Nocturne has recognised that the role/linked role is deleted. Nocturne will throw errors or partial update confirmations until you fix it by running /fix. More details about /fix can be found in our System Fix Guide.

---

Renaming a Tree

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

/tree rename <tree> <name>

Text Example

Example

/tree rename tree:Event name:Event Team

Visual Output

Renaming a tree updates it everywhere in the database. You will immediately use the new name when running /staff commands.

---

Deleting a Tree

If a department is shut down or you want to start from scratch, you can permanently delete a tree.

User: Manage Server

Command

/tree delete <tree>

Text Example

Example

/tree delete tree:Partnership

Visual Output

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