> ## 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.
# Staff Actions
> The staff command group is the core engine of Nocturne, allowing you to seamlessly manage your team while the bot handles all role assignments, cleanups, DMing the target and logging automatically.
The `/staff` command group is the day-to-day side of Nocturne. To run (most of) these commands, executors either need the native Discord `Manage Roles` permission, or must be granted access via a [Whitelist Role](/commands/config/whitelist-roles).
Want to know more about Whitelist Roles? Check out our [Whitelist Role Guide](/commands/config/whitelist-roles).
***
Common Parameters
Across all staff actions, you will see a few recurring optional and required parameters. Here is what they do:
* **`[reason]`**
* A brief explanation for the action. This will be mentioned in the log activity.
* *Note: This is optional for Hires and Promotions, but strictly **required** for Fires and Demotions.*
* [Predefined reasons](/commands/config/reasons) are used here. You can configure reasons, and they will surface with this parameter when you start typing.
* **`[notes]`**
* An optional secondary text field, usually used to link evidence, add a private note, or expand on the reason.
* This is not mentioned in the log activity. It fills the `{notes}` variable in custom [DM Notices](/commands/config/dm-notices).
* **`[dm-user]`**
* It is a True/False toggle that overrides the server's global [DM Message](/commands/config/overview#dm-messages-global-toggle) setting on a case-by-case basis.
***
Hiring Staff
Hiring a user automatically assigns them the entry-level Base Role (Position 1) of the specified tree, alongside any Linked Roles attached to it.
User: Manage Roles (or Whitelisted Role)
```text Command theme={null}
/staff hire [reason] [dm-user] [notes]
```
```text Example theme={null}
/staff hire user:@ArcticFox tree:Moderation reason:Passed the selection round! notes:Make sure to check <#1240638425992794164> for more information! Say 'hi' is <#1240638425992794165>
```
* In the above example, `@ArcticFox` will be given the first role in the Moderation tree.
* If configured, they will also be sent a DM Notice, which will include the note as filled in the command.
***
Promoting a user moves them one step up the tree's hierarchy (e.g., from Position 1 to Position 2). Nocturne automatically removes their old Base Role and assigns the new one. It will also automatically update its linked roles.
User: Manage Roles (or Whitelisted Role)
```text Command theme={null}
/staff promote [reason] [dm-user] [notes]
```
```text Example theme={null}
/staff promote user:@ArcticFox tree:Moderation
```
* In the above example, `@ArcticFox` will gain the next role in the Moderation tree. They will also receive the linked roles associated with that new role.
* If configured, they will also be sent a DM Notice.
Check out [Persistence Flag](/commands/config/overview#persistence-linked-roles) to toggle the linked role behaviour during promotion!
***
Demoting Staff
Demoting a user moves them one step down the tree's hierarchy (e.g., from Position 2 to Position 1). Because this is a negative action, **a reason is always required.**
User: Manage Roles (or Whitelisted Role)
```text Command theme={null}
/staff demote [dm-user] [notes]
```
```text Example theme={null}
/staff demote user:@ArcticFox tree:Moderation reason:Failed activity quota dm-user:false
```
* In the above example, `@ArcticFox` will be demoted down a role in the Moderation tree. They will also lose the linked roles associated with the previous role.
* In this specific example, `[dm-user]` is set to false. Nocturne will **not** send a DM notice to `@ArcticFox`.
***
Firing Staff
Firing a user completely strips them of their current Base Role and all associated Linked Roles within that tree. Like demotions, **a reason is always required.**
User: Manage Roles (or Whitelisted Role)
```text Command theme={null}
/staff fire [dm-user] [notes]
```
```text Example theme={null}
/staff fire user:@ArcticFox tree:Moderation reason:Lacks Christmas Spirit
```
* In the above example, `@ArcticFox` will lose all roles from the associated tree.
* If configured, they will also be sent a DM Notice.
Check out [Instant-fire Flag](/commands/config/overview#instant-fire) to control when a user can be fired.
***
Staff Information
You can look up a user's staff roles across all trees in the server, along with the position in the tree, their linked roles, and any discrepancies on their profiles, such as having multiple base roles from the same tree, using a single `/staff info` command.
```text Command theme={null}
/staff info [user]
```
```text Example theme={null}
/staff info user:@ArcticFox
```
