Skip to content

docs: rewrite Island Management as the Islands admin guide - #125

Merged
tastybento merged 2 commits into
masterfrom
docs/islands-guide
Nov 15, 2026
Merged

tastybento merged 2 commits into
masterfrom
docs/islands-guide

Conversation

@tastybento

Copy link
Copy Markdown
Member

Rewrites BentoBox/About/IslandManagement.md (same URL, nav title "Islands") as a task-based admin guide.

New layout: plan the world before opening (the settings that can't change later) → creating islands (default actions, auto-create on login, VIP starter islands) → island size (range permissions and commands) → homes → names → resets (limits, cooldown, giving resets back) → deleting (delete/undelete/register/unregister) → cleaning up old islands (housekeeping sweeps and purge) → multiple islands → info → troubleshooting.

Corrections, checked against BentoBox source (develop) and the BSkyBlock config:

  • The extra-homes permission is [gamemode].island.maxhomes.<n>, not island.home.maxhomes (IslandsManager.getMaxHomes).
  • There is no maxresets permission. Extra resets are managed with /bsbadmin resets set|add|remove|reset.
  • distance-between-islands is the island radius, so centres are twice that apart (IslandGrid, BSkyBlock config comment). The protection range can go up to that value, not to half of it.
  • BentoBox does clean up inactive islands: /bsbadmin purge <days> plus the opt-in age sweep. The old page said it didn't.
  • The purge command is /bsbadmin purge deleted (a game mode admin command), not /bbox admin purge deleted.
  • Range and max-homes permissions are read from the owner, at login (and at creation for range).
  • Only the owner can reset, and resetting removes team members (IslandResetCommand).
  • Added the bundle permission [gamemode].island.create.<bundle> for VIP starter islands, island name rules and island.name.format, and the housekeeping settings with their defaults.

Removed: the 3.16.1 "What's new" box (release notes) and the "what happens when a player leaves a team" section, which now lives on Teams & Ranks.

zensical build passes (2 existing Biomes anchor warnings).

🤖 Generated with Claude Code

tastybento and others added 2 commits November 14, 2026 18:55
Planning the world, creating islands, island size, homes, names, resets,
deleting, cleaning up old islands, multiple islands, info and
troubleshooting. Checked against BentoBox source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tastybento

Copy link
Copy Markdown
Member Author

Follow-up commit: five links in Admin Tools, FAQ, Glossary and Border pointed at section anchors on the old page. They now point at the new sections (#homes, #deleting-islands, #resetting-islands, #island-size-protection-range). Build is back to the 2 existing Biomes warnings.

@tastybento
tastybento merged commit 401084f into master Nov 15, 2026
2 checks passed
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