-
-
Notifications
You must be signed in to change notification settings - Fork 44
Commands and Permissions
All BungeePerms commands begin with /bungeeperms. You can also use the /bp alias in place of /bungeeperms for convenience.
Command: /bungeeperms help
Permission: bungeeperms.help
Description: Shows help on BungeePerms commands.
Command: /bungeeperms reload
Permission: bungeeperms.reload
Description: Reloads the permissions from the database or YAML file.
Command: /bungeeperms debug <true|false>
Permission: bungeeperms.debug
Description: Enables or disables the debug.
Command: /bungeeperms overview
Permission: bungeeperms.overview
Description: Shows a compact overview of all groups.
Command: /bungeeperms search <permission>
Permission: bungeeperms.search
Description: Lists all groups and users where the given permission is set.
Command: /bungeeperms users [-c]
Permission: bungeeperms.users.list
Description: Lists all users. Adding -c parameter counts the users instead.
Command: /bungeeperms user <user> info [server [world]]
Permission: bungeeperms.user.info
Description: Shows information about the given user.
Example:
bungeeperms user tuxillator info
[INFO] About tuxillator
[INFO] UUID: aa868438-e18e-4b14-b7a5-6490bc29273f
[INFO] Groups: mod (40)
[INFO] Effective permissions: 77
Command: /bungeeperms user <user> delete
Permission: bungeeperms.user.delete
Description: Deletes the user.
Command: /bungeeperms user <user> addperm <permission> [server [world]]
Permission: bungeeperms.user.perms.add
Description: Adds a permission to the given user. Server and world are optional; if included the permission is only provided for the given world/server.
Example:
To give tuxillator access to the BungeeCord /server command...
/bungeeperms user tuxillator addperm bungeecord.command.server
Command: /bungeeperms user <user> addtimedperm <perm> <duration> [server [world]]
Permission: bungeeperms.user.perms.add
Description: Adds a permission to the given user. The permission is revoked after duration has run out. Duration uses the format 1d1h1m1s. Server and world are optional; if included the permission is only provided for the given world/server.
Example:
To give tuxillator access to the BungeeCord /server command for 1 day ...
/bungeeperms user tuxillator addtimedperm bungeecord.command.server 1d
Command: /bungeeperms user <user> removeperm <permission> [server [world]]
Permission: bungeeperms.user.perms.remove
Description: Removes a permission from the given user. Server and world are optional; if included the permission is only removed for the given world/server.
Example:
To give remove access earlier given to the BungeeCord /server command...
/bungeeperms user tuxillator addperm bungeecord.command.server
Command: /bungeeperms user <user> removetimedperm <permission> [server [world]]
Permission: bungeeperms.user.perms.remove
Description: Removes a timed permission from the given user. Server and world are optional; if included the permission is only removed for the given world/server.
Example:
To give remove access earlier given to the BungeeCord /server command...
/bungeeperms user tuxillator removetimedperm bungeecord.command.server
Command: /bungeeperms user <user> has <permission> [server [world]]
Permission: bungeeperms.user.perms.has
Description: Checks if the given user has the given permission. Server and world are optional; if included the permission is only considered for the given world/server.
Command: /bungeeperms user <user> list [server [world]]
Permission: bungeeperms.user.perms.list
Description: Lists the permissions of the given user. Each permission will have a suffix in brackets identifying how the permissions resolver determined this entry, and for which servers/worlds if applicable.
Server and world are optional; if included the permissions for the given world/server are included in the list.
Example:
/bungeeperms user tuxillator list lobby
yields
teleportsigns.use (visitor)
minecraft.command.gamemode (own | lobby)
These rules show the user in question has permission to use TeleportSigns via membership of the visitor group. He can also set the gamemode on the lobby server via the permission being applied directly to this user.
Command: /bungeeperms user <user> listonly [server [world]]
Permission: bungeeperms.user.perms.list
Description: Lists the permissions of the given user. Each permission will have a suffix in brackets identifying how the permissions resolver determined this entry, and for which servers/worlds if applicable.
Server and world are optional; if included only the permissions for the given world/server are included in the list.
Example:
/bungeeperms user tuxillator listonly lobby
yields
minecraft.command.gamemode (own | lobby)
These rules show the user in question has permission to use TeleportSigns via membership of the visitor group. He can also set the gamemode on the lobby server via the permission being applied directly to this user.
Command: /bungeeperms user <user> addgroup <groupname> [server [world]]
Permission: bungeeperms.user.group.add
Description: Adds the user to the given group. Note the user will automatically have implicit membership to all inherited groups. Server and world are optional; if included the group is only considered for the given world/server.
Command: /bungeeperms user <user> addtimedgroup <groupname> <duration> [server [world]]
Permission: bungeeperms.user.group.add
Description: Adds the user to the given group. The group is revoked after duration has run out. Duration uses the format 1d1h1m1s. Note the user will automatically have implicit membership to all inherited groups. Server and world are optional; if included the group is only considered for the given world/server.
Command: /bungeeperms user <user> removegroup <groupname> [server [world]]
Permission: bungeeperms.user.group.remove
Description: Removes the user from the given group. Server and world are optional; if included the group is only considered for the given world/server.
Command: /bungeeperms user <user> removetimedgroup <groupname> [server [world]]
Permission: bungeeperms.user.group.remove
Description: Removes the user from the given timed group. Server and world are optional; if included the group is only considered for the given world/server.
Command: /bungeeperms user <user> setgroup <groupname>
Permission: bungeeperms.user.group.set
Description: Removes the user from all groups which are in the same ladder as the given group and add the user to given group.
Command: /bungeeperms user <user> groups
Permission: bungeeperms.user.groups
Description: Lists the groups the given user is in.
Command: /bungeeperms user <user> display <displayname> [server [world]]
Permission: bungeeperms.user.user
Description: Sets the display name for the given user
Command: /bungeeperms user <user> prefix <prefix> [server [world]]
Permission: bungeeperms.user.prefix
Description: Sets the prefix for the given user
Command: /bungeeperms user <user> suffix <suffix> [server [world]]
Permission: bungeeperms.user.suffix
Description: Sets the suffix for the given user
Command: /bungeeperms groups
Permission: bungeeperms.groups
Description: Lists all groups.
Command: /bungeeperms group <groupname> info [server [world]]
Permission: bungeeperms.group.info
Description: Shows information about the given group.
Example:
bp group mod info
[INFO] Info to group mod:
[INFO] Inheritances: citizen (11)
[INFO] Group permissions: 40
[INFO] Rank: 10
[INFO] Weight: 1000
[INFO] Ladder: default
[INFO] Default: FALSE
[INFO] Effective permissions: 71
[INFO] Dislay name: (none)
[INFO] Prefix: [mod]
[INFO] Suffix: (none)
Command: /bungeeperms group <groupname> users [-c]
Permission: bungeeperms.group.users
Description: Lists the usernames in the given group. Adding -c parameter counts the number of members instead.
Command: /bungeeperms group <groupname> create
Permission: bungeeperms.group.create
Description: Create the given group
Command: /bungeeperms group <groupname> delete
Permission: bungeeperms.group.delete
Description: Delete the given group
Command: /bungeeperms group <groupname> addinherit <group> [server [world]]
Permission: bungeeperms.group.inheritances.add
Description: Adds a inheritance to the given group
Command: /bungeeperms group <groupname> addtimedinherit <group> <duration> [server [world]]
Permission: bungeeperms.group.inheritances.add
Description: Adds a timed inheritance to the given group. The inheritance is removed after duration has run out. Duration uses the format 1d1h1m1s.
Command: /bungeeperms group <groupname> removeinherit <group> [server [world]]
Permission: bungeeperms.group.inheritances.remove
Description: Remove a inheritance from the given group
Command: /bungeeperms group <groupname> removetimedinherit <group> [server [world]]
Permission: bungeeperms.group.inheritances.remove
Description: Remove a timed inheritance from the given group
Command: /bungeeperms group <groupname> rank <new rank>
Permission: bungeeperms.group.rank
Description: Sets the rank for the given group
Command: /bungeeperms group <groupname> weight <new weight>
Permission: bungeeperms.group.weight
Description: Sets the weight for the given group
Command: /bungeeperms group <groupname> ladder <new ladder>
Permission: bungeeperms.group.ladder
Description: Sets the ladder for the given group
Command: /bungeeperms group <groupname> default <true|false>
Permission: bungeeperms.group.default
Description: Determines whether the given group is a default group or not
Command: /bungeeperms group <groupname> display <displayname> [server [world]]
Permission: bungeeperms.group.display
Description: Sets the display name for the given group
Command: /bungeeperms group <groupname> prefix <prefix> [server [world]]
Permission: bungeeperms.group.prefix
Description: Sets the prefix for the given group
Command: /bungeeperms group <groupname> suffix <suffix> [server [world]]
Permission: bungeeperms.group.suffix
Description: Sets the suffix for the given group
Command: /bungeeperms group <groupname> addperm <permission> [server [world]]
Permission: bungeeperms.group.perms.add
Description: Adds a permission to the given group
Command: /bungeeperms group <groupname> addtimedperm <permission> <duration> [server [world]]
Permission: bungeeperms.group.perms.add
Description: Adds a permission to the given group. The permission is revoked after duration has run out. Duration uses the format 1d1h1m1s.
Command: /bungeeperms group <groupname> removeperm <permission> [server [world]]
Permission: bungeeperms.group.perms.remove
Description: Remove a permission from the given group.
Command: /bungeeperms group <groupname> removetimedperm <permission> [server [world]]
Permission: bungeeperms.group.perms.remove
Description: Remove a timed permission from the given group.
Command: /bungeeperms group <groupname> has <permission> [server [world]]
Permission: bungeeperms.group.perms.has
Description: Checks if the given group has the given permission.
Command: /bungeeperms group <groupname> list [server [world]
Permission: bungeeperms.group.perms.list
Description: Lists the permissions of the given group. Server and world are optional; if included the permissions for the given world/server are included in the list.
Command: /bungeeperms group <groupname> listonly [server [world]
Permission: bungeeperms.group.perms.list
Description: Lists the permissions of the given group. Server and world are optional; if included only the permissions for the given world/server are included in the list.
Command: /bungeeperms promote <username> [ladder]
Permission: bungeeperms.promote and bungeeperms.promote.<newgroup>
Description: Promotes the given user to the next rank.
Command: /bungeeperms demote <username> [ladder]
Permission: bungeeperms.demote and bungeeperms.demote.<newgroup>
Description: Demotes the given user to the previous rank.
Command: /bungeeperms format
Permission: bungeeperms.format
Description: Reformats the permission.yml or MySQL table BE CAREFUL
Command: /bungeeperms cleanup
Permission: bungeeperms.cleanup
Description: Cleans up the permission.yml or mysql table !BE VERY CAREFUL! Removes a lot of players from the permissions.yml if configured.
Command: /bungeeperms backend [yaml|mysql]
Permission: bungeeperms.backend
Description: Shows the used permissions database (file or mysql table) [or migrates to the given database] !BE CAREFUL! (MAKE A BACKUP BEFORE EXECUTING)
Command: /bungeeperms migrate <backend [yaml|mysql]|useuuid [true|false]>
Permission: bungeeperms.migrate
Description: Does migrations of different data (permissions, uuid) or shows status !BE CAREFUL! (MAKE A BACKUP BEFORE EXECUTING)
Explanation:
/bungeeperms migrate backend: Shows which backend you are currently using.
/bungeeperms migrate backend <yaml|mysql>: Converts your current backend to the new backend.
/bungeeperms migrate useuuid: Shows how players are identified.
/bungeeperms migrate useuuid <true|false>: Convert your backend to use UUIDs or not.
Command: /bungeeperms uuid <player|uuid> [-rm]
Permission: bungeeperms.uuid
Description: Gets the UUID of a player from database (-r: reverse; -m: ask mojang)