Permissions
Every ExyliaPracticeBot permission, its default, and how to make a mode, a difficulty or a feature a rank perk.
Every node below is declared in plugin.yml with a default, so a permission plugin sees all of them
and their descriptions. The player nodes default to true: out of the box everybody can use every
feature, and a server makes one a rank perk by denying it to the default group.
| Permission | Who has it | What it allows |
|---|---|---|
exyliapracticebot.use | Everyone | Open /bot and its menus, and reset your settings. |
exyliapracticebot.spawn | Everyone | Spawn a practice bot (command, menu button). |
exyliapracticebot.teleport | Everyone | Teleport to the bot and bring the bot to you. |
exyliapracticebot.advanced | Everyone | Open and change the Fine tuning screen. |
exyliapracticebot.mode.* | Everyone | Pick every combat mode. |
exyliapracticebot.mode.sword | Everyone | Pick the sword mode. |
exyliapracticebot.mode.pot_pvp | Everyone | Pick the pot_pvp mode. |
exyliapracticebot.mode.uhc | Everyone | Pick the uhc mode. |
exyliapracticebot.mode.crystal_pvp | Everyone | Pick the crystal_pvp mode. |
exyliapracticebot.mode.mace_pvp | Everyone | Pick the mace_pvp mode. |
exyliapracticebot.mode.boxing | Everyone | Pick the boxing mode. |
exyliapracticebot.difficulty.* | Everyone | Pick every difficulty. |
exyliapracticebot.difficulty.easy | Everyone | Pick the easy difficulty. |
exyliapracticebot.difficulty.normal | Everyone | Pick the normal difficulty. |
exyliapracticebot.difficulty.hard | Everyone | Pick the hard difficulty. |
exyliapracticebot.difficulty.insane | Everyone | Pick the insane difficulty. |
exyliapracticebot.difficulty.extreme | Everyone | Pick the extreme difficulty. |
exyliapracticebot.bypass.limit | Admins (op) | Spawn a bot into the slots kept for matches (reserved-for-matches). max-bots still applies. |
exyliapracticebot.admin | Admins (op) | Reload the plugin, change its settings in game, and export or import its database. |
The Fine tuning screen (exyliapracticebot.advanced) covers opening it, every slider and its five toggles: invincible, instant totems, anti-knockback, slow falling and fire resistance. exyliapracticebot.spawn also covers the menu's Spawn button, and exyliapracticebot.teleport the menu's teleport button.
Two things never need a node: removing your bot (/bot remove and the menu's Remove button are
never behind a rank) and picking no mode (NONE), which is how a player steps out of one.
A command needs exyliapracticebot.use and the feature node: /bot spawn checks use and then
spawn, the two teleports check use and then teleport. exyliapracticebot.admin does not imply
any player node, but those default to true, so a staff member has them unless you deny them.
When a node is missing#
A player who clicks or types something they do not hold gets the bot.no-permission line from
messages.yml — You don't have permission to do that. — and nothing changes.
The Mode and Difficulty buttons do better than refuse: cycling skips every mode or difficulty
the player cannot pick, so they only ever land on one they hold. NONE is always on the mode wheel,
and a player who holds only one difficulty stays on it.
The nodes gate picking. A player whose settings already hold a mode or difficulty you now deny keeps
it until they change it or reset, and Reset settings goes back to the server's bot.mode and
bot.difficulty whatever they hold. Keep those two defaults to a mode and difficulty everybody may use.
Menus wired into other plugins#
The checks live in the plugin's own menu actions, not in the menu files, so they follow the action
wherever you wire it. A practicebot:spawn button in a hub menu still needs exyliapracticebot.spawn,
and a practicebot:set_mode crystal_pvp button still needs exyliapracticebot.mode.crystal_pvp.
remove, reset_settings and the gear buttons (cycle for armour, hands and potions, toggle for
attack, follow and shield up) check nothing. See Menus.
The API does not ask about permissions at all: another plugin that spawns a bot through
PracticeBotService decides for itself whether a player may be given one. See
API.
Examples#
Making the fine-tuning screen a VIP perk:
/lp group default permission set exyliapracticebot.advanced false
/lp group vip permission set exyliapracticebot.advanced trueKeeping crystal PvP and the top difficulty for a rank:
/lp group default permission set exyliapracticebot.mode.crystal_pvp false
/lp group default permission set exyliapracticebot.difficulty.extreme false
/lp group vip permission set exyliapracticebot.mode.crystal_pvp true
/lp group vip permission set exyliapracticebot.difficulty.extreme trueTaking the plugin away from one group while leaving it for the rest:
/lp group survival permission set exyliapracticebot.use falseRestricting where bots may be spawned is configuration rather than permissions: worlds in
config.yml is the list of worlds a spawn is accepted in, and it applies to everybody. See
Configuration.
Something missing on this page? Tell us on Discord