Skip to content

docs: add Permissions & VIP Perks guide; regenerate Commands and Permissions - #126

Merged
tastybento merged 1 commit into
masterfrom
docs/permissions-guide
Nov 15, 2026
Merged

tastybento merged 1 commit into
masterfrom
docs/permissions-guide

Conversation

@tastybento

Copy link
Copy Markdown
Member

New admin guide: BentoBox/Permissions-Guide.md (Admin Guides → Permissions & VIP Perks)

  • How permissions are named (bentobox., <gamemode>.island/admin/mod/settings., numeric limits) and who has them by default; /bentobox perms to check.
  • Perks with a number (team/coop/trust size, range, homes, islands, ban limit) and the rules from User.getPermissionValue:
    • The highest number wins.
    • The number replaces the config value even when it's lower, so a VIP can end up with less than default.
    • .* gives the config value, not unlimited.
    • Island perks follow the owner and update when the owner logs in.
  • Other perks: the VIP starter island bundle, colour names, cooldown/delay bypass, noban/noexpel.
  • Not permissions: extra resets, and island command ranks.
  • A LuckPerms VIP example and staff role sets, plus troubleshooting.
  • ⚠️ Found while checking: in BSkyBlock, AOneBlock and AcidIsland island.deletehome/renamehome default to OP, and in AOneBlock and AcidIsland so does island.homes (their addon.yml). The guide tells admins to grant them alongside extra homes. That might be worth changing in those game modes.

Commands reference (BentoBox/Commands.md), regenerated from the command classes and en-US.yml. It was a 10-row table marked "as of 2.2.0"; it now covers:

  • all 12 /bentobox subcommands, including perms, rank, placeholders, dump-placeholders and reload locales
  • all 33 player and 68 admin game mode commands, with parameters and permissions
  • a table of the game modes' command labels and prefixes

Permissions reference (BentoBox/Permissions.md), regenerated (was "as of 1.6.0"): BentoBox, game mode player/admin/mod command permissions, numeric perks, settings permissions and moderator bypasses. Defaults vary by game mode, so it points to /bentobox perms.

zensical build passes (2 existing Biomes anchor warnings).

🤖 Generated with Claude Code

…issions

New admin guide on how permissions are named, numeric perks and how their
values are chosen, a LuckPerms VIP example and staff roles. Commands and
Permissions reference pages are regenerated from BentoBox source (they
said 'as of 2.2.0' and 'as of 1.6.0').

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tastybento
tastybento merged commit 9e16d6d into master Nov 15, 2026
2 checks passed
@tastybento

Copy link
Copy Markdown
Member Author

Updated the home-permission warning: it isn't just BSkyBlock/AOneBlock/AcidIsland. Most game modes didn't declare island.homes/deletehome/renamehome, and SkyGrid was missing most team permissions too. Fixes are in BSkyBlock#560, AOneBlock#569, AcidIsland#188, CaveBlock#124, Boxed#139, SkyGrid#92, poseidon#20 and StrangerRealms#17 (all BentoBoxWorld). The warning now says it applies to releases from before November 2026.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant