Commands - LakenTV/Minecraft-Staff-Manager GitHub Wiki
This page documents all commands provided by StaffManager, including their subcommands, arguments, permissions, and available options.
| 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
0xA0to 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
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.promotegives access to the command's functionality.
Default Permissions:
None. Players cannot use any of the command's functionality by default.
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.suspendgives access to the command's functionality.
Default Permissions:
None. Players cannot use any of the command's functionality by default.
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.demotegives access to the command's functionality.
Default Permissions:
None. Players cannot use any of the command's functionality by default.
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.staffbangives access to the command's functionality.
Default Permissions:
None. Players cannot use any of the command's functionality by default.
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.punishgives access to punishing a player using only the permissions the sender has, the other configured actions wont apply. -
staffmanager.bypass.punish-per-command-permissionsgives 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.
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.activategives access to the command's functionality.
Default Permissions:
-
staffmanager.command.activateis by default accessible for everyone.
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.pardongives access to the command's functionality.
Default Permissions:
None. Players cannot use any of the command's functionality by default.
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.statusgives access to only able to see own's status. -
staffmanager.command.status.othersgives acess to seeing others' status
Default Permissions:
-
staffmanager.command.statusis by default accessible for everyone. -
staffmanager.command.status.othersis accessible to only operators by default.
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.applygives access to the command's functionality.
Default Permissions:
-
staffmanager.command.applyis by default accessible for everyone.