Content generated with AI — it may contain mistakes.

ExyliaPracticeBot/ReferenceUpdated in v1.5.0

Permissions

Every ExyliaPracticeBot permission, its default, and how to make a mode, a difficulty or a feature a rank perk.

Page 12 of 213 min read

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.

PermissionWho has itWhat it allows
exyliapracticebot.useEveryoneOpen /bot and its menus, and reset your settings.
exyliapracticebot.spawnEveryoneSpawn a practice bot (command, menu button).
exyliapracticebot.teleportEveryoneTeleport to the bot and bring the bot to you.
exyliapracticebot.advancedEveryoneOpen and change the Fine tuning screen.
exyliapracticebot.mode.*EveryonePick every combat mode.
exyliapracticebot.mode.swordEveryonePick the sword mode.
exyliapracticebot.mode.pot_pvpEveryonePick the pot_pvp mode.
exyliapracticebot.mode.uhcEveryonePick the uhc mode.
exyliapracticebot.mode.crystal_pvpEveryonePick the crystal_pvp mode.
exyliapracticebot.mode.mace_pvpEveryonePick the mace_pvp mode.
exyliapracticebot.mode.boxingEveryonePick the boxing mode.
exyliapracticebot.difficulty.*EveryonePick every difficulty.
exyliapracticebot.difficulty.easyEveryonePick the easy difficulty.
exyliapracticebot.difficulty.normalEveryonePick the normal difficulty.
exyliapracticebot.difficulty.hardEveryonePick the hard difficulty.
exyliapracticebot.difficulty.insaneEveryonePick the insane difficulty.
exyliapracticebot.difficulty.extremeEveryonePick the extreme difficulty.
exyliapracticebot.bypass.limitAdmins (op)Spawn a bot into the slots kept for matches (reserved-for-matches). max-bots still applies.
exyliapracticebot.adminAdmins (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.

Denying a mode does not take it off a saved bot

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.

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 true

Keeping 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 true

Taking the plugin away from one group while leaving it for the rest:

/lp group survival permission set exyliapracticebot.use false

Restricting 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