Commands - LakenTV/Minecraft-Staff-Manager GitHub Wiki

This page documents all commands provided by StaffManager, including their subcommands, arguments, permissions, and available options.

Command overview

Command Description Permission
/promote Promotes a player to staff. staffmanager.command.promote
/suspend Suspends a staff member. staffmanager.command.suspend
/demote Removes a player's staff status. staffmanager.command.demote
/staffban Staff-bans a player. staffmanager.command.staffban
/punish Applies a configured punishment. staffmanager.command.punish
/activate staff Activates a player's staff status. staffmanager.command.activate
/pardon Pardons a moderation action. staffmanager.command.pardon
/status Displays a player's StaffManager status. staffmanager.command.status
/listplayers Lists players known to StaffManager. staffmanager.command.listplayers
/apply Displays staff application information. staffmanager.command.apply
/approve Approves a players staff egibility. staffmanager.command.approve
/warn Warns a player. staffmanager.command.warn
/staffmanager Manage basic functions of the plugin in a command form. staffmanager.command.staffmanager

Syntax Notes: Before you proceding with this wiki page it is worth nothing that:

  • All category inputs must be prefixed with a #
  • Some keywords need to match Capitalization
  • The player input can contain a whitespace 0xA0 to filter offline from online players in the tab completion, this will leave an extra "space" before the player name, if this space bothers you, you can configure it to not filter online players altogether
  • The tab completion is your best friend for these commands, so if you dont have acess to the wiki, you can rely on the tab completion

/promote

Description: Promotes a player to a StaffManager staff rank.

What does it do?
Sets the player's staff goal to the specified rank. The player does not immediately receive the target rank's permissions. Instead, their LuckPerms rank is set to the configured trainee rank while they progress toward their staff goal.

Usage(s):

  • /promote <player> <rank>

<player> refers to the player you want to promote.

<rank> refers to the staff rank you want the player to work toward.

Permission(s):

  • staffmanager.command.promote gives access to the command's functionality.

Default Permissions:
None. Players cannot use any of the command's functionality by default.

/suspend

Description: Suspends an already staff player, removing their lp permissions temporarily for a specified amount.

What does it do?
It removes the players staff rank the moment the command is run, it will not let the player use any staff permissions for the duration, after the suspension expires or when a admin runs /pardon <player> moderation Suspension, the player must manually do /activate staff to regain their staff permissions

Usage(s):

  • /suspend <player> <duration> [#category] [reason...]

<player> refers to the player you want to suspend.

<duration> refers to the duration their staff rank is suspended.

Can deny execution if:

  • player is not staff

Permission(s):

  • staffmanager.command.suspend gives access to the command's functionality.

Default Permissions:
None. Players cannot use any of the command's functionality by default.

/demote

Description: Demotes a player back to the default rank

What does it do?
It removes the players staff rank the moment the command is run, the player must be promoted again to regain their staff perms

Usage(s):

  • /demote <player> [#category] [reason...]

<player> refers to the player you want to demote.

Can deny execution if:

  • player is not staff

Permission(s):

  • staffmanager.command.demote gives access to the command's functionality.

Default Permissions:
None. Players cannot use any of the command's functionality by default.

/staffban

Description: Blacklists a player from being promoted and gets demoted automatically

What does it do?
It removes the players staff rank the moment the command is run, the player cannot be promoted until the staff ban expires or if an admin runs /pardon <player> moderation StaffBan.

Usage(s):

  • /staffban <player> <duration> [#category] [reason...]

<player> refers to the player you want to blacklist from staff.

<duration> refers to the duration they must be blacklisted

Permission(s):

  • staffmanager.command.staffban gives access to the command's functionality.

Default Permissions:
None. Players cannot use any of the command's functionality by default.

/punish

Description: Punishes a player accordingly the configuration of the categories

What does it do?
It punishes a player acording to the category definition, if no higher action is set, /punish will use the maximum action available

Usage(s):

  • /punish <player> <category> [<category>|+<proof>]... Note (if the syntax if too confusing): The syntax is valid as long as argument 1 is a player, argument 2 is a category, then you can append a proof by inserting text (can include spaces) prefixed with +, you can also add more categories by typing the name of the category prefixed with a #

<player> refers to the player you want to punish.

<category> refers to the category you want the player to be punished for. (REMEMBER: you must prefix it with # or else StaffManager wont recognise it)

<proof> refers to the proof for punishing the player, each new + appends a new proof, so you can have multiple

Permission(s):

  • staffmanager.command.punish gives access to punishing a player using only the permissions the sender has, the other configured actions wont apply.
  • staffmanager.bypass.punish-per-command-permissions gives access to punishing a player using ALL configured actions, even if they dont have perms for one or more of them.

Default Permissions:
None. Players cannot use any of the command's functionality by default.

/activate staff

Description: Allows the player to activate their staff permissions

What does it do?
It checks if the player has completed the requirements as soon as the command is run, if they did, it will give them the staff rank

Usage(s):

  • /activate staff

Can deny execution if:

  • Player didnt complete the required playtime
  • Player isnt approved and the server requires it
  • Player has no staff goal set
  • Player is staff banned or suspended

Permission(s):

  • staffmanager.command.activate gives access to the command's functionality.

Default Permissions:

  • staffmanager.command.activate is by default accessible for everyone.

/pardon

Description: Pardons a players moderation or offence

What does it do?
It removes a players moderation such as Warns, Staff bans, Suspensions, ServerBans and Mutes (if moderation provider is set to STAFFMANAGER, if not you may need another command to do it), and/or offenses

Usage(s):

  • /pardon <player> moderation <moderationType>

  • /pardon <player> offense [<category> | <action>]

<player> refers to the player you want to pardon.

<moderationType> refers to the action you want to pardon they include [Mute, ServerBan (not Ban), Suspend and StaffBan] they must be typed as they are, matching capitals.

<category> refers to The filter used to clear all offenses that its category is the input.

<action> refers to The filter used to clear all offenses that were created in that context action typed (KEEP IN MIND: this does not pardon any moderations /pardon Alex offence SERVERBAN will not unban Alex, for that you need to use /pardon Alex moderation ServerBan).

Syntax Note: You can and are encouraged to use both filters for /pardon <player> offense [<category> | <action>].

Permission(s):

  • staffmanager.command.pardon gives access to the command's functionality.

Default Permissions:
None. Players cannot use any of the command's functionality by default.

/status

Description: Allows the player to see their staff progress

What does it do?
It displays when no screen is mentioned according to the default status screen order

Usage(s):

  • /status
  • /status as <player>
  • /status <screenName>
  • /status <screenName> as <player>

Permission(s):

  • staffmanager.command.status gives access to only able to see own's status.

  • staffmanager.command.status.others gives acess to seeing others' status

Default Permissions:

  • staffmanager.command.status is by default accessible for everyone.
  • staffmanager.command.status.others is accessible to only operators by default.

/apply

Description: Allows the player to see the server's own rules/how-to to apply for staff configurable here (Note: StaffManager is not designed and will not manage your applications as this is a minecraft plugin, please use an external trusted application to manage applications)

What does it do?
It shows the player how to apply in that specific server

Usage(s):

  • /apply

Permission(s):

  • staffmanager.command.apply gives access to the command's functionality.

Default Permissions:

  • staffmanager.command.apply is by default accessible for everyone.
⚠️ **GitHub.com Fallback** ⚠️