From 590bfa076697bf82a2a4ad21d8439e4b2be20eb0 Mon Sep 17 00:00:00 2001 From: tastybento Date: Sat, 3 Oct 2026 08:47:37 -0700 Subject: [PATCH] docs: update documentation for releases up to 2026-10-03 BentoBox 3.23.0-3.23.3, AOneBlock 1.28.0, AcidIsland 2.1.2, Boxed 3.4.1, StrangerRealms 1.0.6 and TopBlock 2.1.2. Level 2.29.0 was already documented in #106. Co-Authored-By: Claude Opus 5.5 --- data/release-tracker.json | 82 +++++++++++------------ docs/BentoBox/About/AdminTools.md | 43 +++++++++++- docs/addons/TopBlock/index.md | 11 +++ docs/gamemodes/AOneBlock/index.md | 28 ++++++-- docs/gamemodes/AcidIsland/Commands.md | 4 +- docs/gamemodes/AcidIsland/index.md | 12 ++++ docs/gamemodes/BSkyBlock/Commands.md | 4 +- docs/gamemodes/Boxed/Commands.md | 9 ++- docs/gamemodes/Boxed/index.md | 13 ++++ docs/gamemodes/Poseidon/Commands.md | 4 +- docs/gamemodes/SkyGrid/Commands.md | 4 +- docs/gamemodes/StrangerRealms/Commands.md | 4 +- docs/gamemodes/StrangerRealms/index.md | 9 +++ docs/index.md | 2 +- 14 files changed, 169 insertions(+), 60 deletions(-) diff --git a/data/release-tracker.json b/data/release-tracker.json index 76a5bd2d..9d0b183c 100644 --- a/data/release-tracker.json +++ b/data/release-tracker.json @@ -1,200 +1,200 @@ { - "last_run": "2026-09-06T23:47:33Z", + "last_run": "2026-10-03T15:44:01Z", "repos": { "BentoBox": { - "last_checked": "2026-09-06T23:47:33Z", - "last_release": "3.22.4", + "last_checked": "2026-10-03T15:44:01Z", + "last_release": "3.23.3", "doc_path": "BentoBox/", "category": "core" }, "AcidIsland": { - "last_checked": "2026-09-06T23:47:33Z", - "last_release": "2.1.1", + "last_checked": "2026-10-03T15:44:01Z", + "last_release": "2.1.2", "doc_path": "gamemodes/AcidIsland/index.md", "category": "gamemode" }, "AOneBlock": { - "last_checked": "2026-09-06T23:47:33Z", - "last_release": "1.27.1", + "last_checked": "2026-10-03T15:44:01Z", + "last_release": "1.28.0", "doc_path": "gamemodes/AOneBlock/index.md", "category": "gamemode" }, "Boxed": { - "last_checked": "2026-09-06T23:47:33Z", - "last_release": "3.4.0", + "last_checked": "2026-10-03T15:44:01Z", + "last_release": "3.4.1", "doc_path": "gamemodes/Boxed/index.md", "category": "gamemode" }, "BSkyBlock": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.20.0", "doc_path": "gamemodes/BSkyBlock/index.md", "category": "gamemode" }, "CaveBlock": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.23.1", "doc_path": "gamemodes/CaveBlock/index.md", "category": "gamemode" }, "poseidon": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.1.1", "doc_path": "gamemodes/Poseidon/index.md", "category": "gamemode" }, "RaftMode": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "", "doc_path": "gamemodes/RaftMode/index.md", "category": "gamemode" }, "SkyGrid": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "", "doc_path": "gamemodes/SkyGrid/index.md", "category": "gamemode" }, "StrangerRealms": { - "last_checked": "2026-09-06T23:47:33Z", - "last_release": "1.0.5", + "last_checked": "2026-10-03T15:44:01Z", + "last_release": "1.0.6", "doc_path": "gamemodes/StrangerRealms/index.md", "category": "gamemode" }, "Bank": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.10.1", "doc_path": "addons/Bank/index.md", "category": "addon" }, "Biomes": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "2.3.2", "doc_path": "addons/Biomes/index.md", "category": "addon" }, "Border": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "4.8.5", "doc_path": "addons/Border/index.md", "category": "addon" }, "Challenges": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.8.1", "doc_path": "addons/Challenges/index.md", "category": "addon" }, "Chat": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.4.1", "doc_path": "addons/Chat/index.md", "category": "addon" }, "CheckMeOut": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "", "doc_path": "addons/CheckMeOut/index.md", "category": "addon" }, "ControlPanel": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.16.1", "doc_path": "addons/ControlPanel/index.md", "category": "addon" }, "DimensionalTrees": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.9.0", "doc_path": "addons/DimensionalTrees/index.md", "category": "addon" }, "ExtraMobs": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.15.0", "doc_path": "addons/ExtraMobs/index.md", "category": "addon" }, "FarmersDance": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "", "doc_path": "addons/FarmersDance/index.md", "category": "addon" }, "Greenhouses": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.10.2", "doc_path": "addons/Greenhouses/index.md", "category": "addon" }, "InvSwitcher": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.19.3", "doc_path": "addons/InvSwitcher/index.md", "category": "addon" }, "IslandFly": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "", "doc_path": "addons/IslandFly/index.md", "category": "addon" }, "Level": { - "last_checked": "2026-09-06T23:47:33Z", - "last_release": "2.28.1", + "last_checked": "2026-10-03T15:44:01Z", + "last_release": "2.29.0", "doc_path": "addons/Level/index.md", "category": "addon" }, "Likes": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "", "doc_path": "addons/Likes/index.md", "category": "addon" }, "Limits": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.30.2", "doc_path": "addons/Limits/index.md", "category": "addon" }, "MagicCobblestoneGenerator": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "2.10.0", "doc_path": "addons/MagicCobblestoneGenerator/index.md", "category": "addon" }, "TopBlock": { - "last_checked": "2026-09-06T23:47:33Z", - "last_release": "2.1.1", + "last_checked": "2026-10-03T15:44:01Z", + "last_release": "2.1.2", "doc_path": "addons/TopBlock/index.md", "category": "addon" }, "TwerkingForTrees": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.6.0", "doc_path": "addons/TwerkingForTrees/index.md", "category": "addon" }, "Upgrades": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.0.5", "doc_path": "addons/Upgrades/index.md", "category": "addon" }, "Visit": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "", "doc_path": "addons/Visit/index.md", "category": "addon" }, "Warps": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.19.1", "doc_path": "addons/Warps/index.md", "category": "addon" }, "VoidPortals": { - "last_checked": "2026-09-06T23:47:33Z", + "last_checked": "2026-10-03T15:44:01Z", "last_release": "1.6.1", "doc_path": "addons/VoidPortals/index.md", "category": "addon" diff --git a/docs/BentoBox/About/AdminTools.md b/docs/BentoBox/About/AdminTools.md index 39487737..ff6540e3 100644 --- a/docs/BentoBox/About/AdminTools.md +++ b/docs/BentoBox/About/AdminTools.md @@ -37,6 +37,7 @@ Each game mode has its own admin command. For BSkyBlock it's `/bsb`, for AcidIsl | `/[admin] delete` | *(3.19.0)* With no player argument, soft-deletes the island you are **standing on** after confirmation (refused if it still has a team) | | `/[admin] undelete` | *(3.19.0)* Clears the pending-deletion status of the island you are **standing on**, leaving it unowned, before its region files are purged | | `/[admin] register ` | Registers an unowned island to a player. On an island pending deletion this now shows a confirmation prompt and cancels the deletion instead of refusing | +| `/[admin] setrank [island owner | x,y,z]` | *(3.23.0)* Sets a team member's rank; works from the console. The rank can be a keyword (`member`, `sub-owner`, `trusted`, `coop`, or any addon rank without the `ranks.` prefix), the translated rank name, or its number, case-insensitively; an unknown rank lists the valid ones. With no island argument it acts on the island the player is a *member* of (not one they own), so it cannot demote an owner. Name the island's owner, or its centre as `x,y,z`, to choose a specific island. The `owner`, `mod` and `admin` ranks are refused โ€” use `team setowner` to transfer ownership | | `/[admin] setrange ` | Changes a player's island protection range | | `/[admin] range removebonus [id]` | Removes all bonus protection ranges from a single island, or just those for a given id | | `/[admin] range purgebonus ` | Removes a bonus range id from **every** island in the world โ€” ideal after uninstalling an addon that granted bonus ranges. The scan runs asynchronously so it won't freeze large servers | @@ -106,7 +107,47 @@ This reloads BentoBox and all addons, including locales. Note that some changes ## Changelog -!!! note "What's new in v3.22.4" +!!! note "What's new in v3.23.3 โ€” obsidian dupe fix & Command Ranks template" + **Released:** 2026-10-03 + + A bug-fix and panels release. No `config.yml` or locale changes. Compatibility: Paper Minecraft 1.21.5 โ€“ 26.3, Java 25+. + + - ๐Ÿ› **Obsidian scooping dupe fixed.** With OBSIDIAN_SCOOPING, the lava was handed out one tick after the click without re-checking, so mining the obsidian in that tick gave both the obsidian and the lava, and moving the bucket out of the hand could give lava without using a bucket. Both are now re-checked first. **Updating is recommended for every server with OBSIDIAN_SCOOPING enabled.** + - โš™๏ธ **Customisable Command Ranks panel.** Laid out by the new `panels/command_ranks_panel.yml` (written on first start; a game mode's own copy takes precedence), with `COMMAND`, `NEXT` and `PREVIOUS` buttons. It now pages at 45 commands โ€” the old panel silently dropped every command after the 49th. See [Customizing the Command Ranks panel](../Island-Protection,-Flags-&-Ranks.md#customizing-the-command-ranks-panel). + - โœจ **Settings panel improvements.** `/island settings` opens in the Basic/Advanced/Expert mode the player last chose, and the Protection and Settings tabs share one mode (the admin panel still opens in Expert). Command Ranks hides sub-commands the player has no permission for (ops still see everything). The Break Spawners icon no longer shows vanilla's spawn egg tooltip. + - ๐Ÿ› **Multiverse `auto-load` respected.** Since 3.22.0 the Multiverse hook reset `auto-load: false` on every BentoBox world at every startup. It is now set only when BentoBox first imports a world; existing Multiverse entries are left as configured. + - ๐Ÿงฉ **Addon API:** the admin `deaths set|add|remove|reset` commands fire `PlayerDeathsChangedEvent` (world, player, action, amount, old and new counts), so Level can follow admin changes. It is not fired for natural deaths. + + [Release v3.23.3](https://github.com/BentoBoxWorld/BentoBox/releases/tag/3.23.3) + +??? note "What's new in v3.23.1 โ€” Minecraft 26.3 & template-driven settings panels" + **Released:** 2026-09-25 + + Compatibility: Paper Minecraft 1.21.5 โ€“ 26.3, Java 25+. + + - ๐ŸŽฎ **Minecraft 26.3 "Wilderness Bound" support.** The new cushions are protected by existing flags โ€” placing needs PLACE_BLOCKS, hitting or shooting needs BREAK_BLOCKS, and sitting needs RIDING โ€” and straw beds are protected by BED, so visitors can no longer sleep in (and use up) an island's straw beds. No new flags. At release, Paper 26.3 was only available as alpha builds (tested on build 41). + - โš™๏ธ๐Ÿ”ก **Customisable settings panels.** `/island settings` and `/admin settings` are built from `panels/settings_panel.yml` and `panels/admin_settings_panel.yml`, written on first start. Tab layout, pinned flags, the panel title and the order of a flag's lore can be customised; the defaults look exactly like the old panels. See [Customizing the Settings Panel](../Island-Protection,-Flags-&-Ranks.md#customizing-the-settings-panel). + - ๐Ÿ› **Deleted islands no longer count against a player.** After a reset or `/[admin] delete`, the island stayed in the per-player index until restart, which blocked transfers ("player already owns N islands") and confused `/[admin] delete`. + - ๐Ÿ› A template button's `fallback:` record now renders correctly. + + ๐Ÿ”ก **Locale note.** One new key, `panels.settings.title`, sets the settings panel title separately from the tab names. Custom locale files without it fall back to the bundled text. The flag lore layout (`protection.panel.flag-item.description-layout`) can now use the `[ranks]` and `[tooltips]` placeholders, but is unchanged unless you opt in. + + [Release v3.23.1](https://github.com/BentoBoxWorld/BentoBox/releases/tag/3.23.1) + +??? note "What's new in v3.23.0 โ€” console-ready setrank" + **Released:** 2026-09-19 + + Compatibility: Paper Minecraft 1.21.x โ€“ 26.2, Java 25+. + + - ๐Ÿ”ก **`/[admin] setrank` works from the console.** New syntax `/[admin] setrank [island owner | x,y,z]`, backwards compatible. Ranks can be given by keyword, translated name or number; the right island is picked when the player owns one island and is a member of another; and an island can be named by its centre. Tab completion was off by one and is fixed. The affected player is told their rank changed โ€” see the [command table](#per-game-mode-admin-commands) above. + - ๐Ÿ’ก **Behaviour change:** with no island argument, `setrank` now acts on the island the player is a *member* of rather than their own island, so it can no longer accidentally demote an owner. Setting `owner` is refused with a pointer to `setowner`. + - ๐Ÿ› **Metadata console spam fixed.** Player and island metadata maps are now thread-safe. A corrupted map previously threw `NoSuchElementException` on every player move (seen via Border) until restart. + + ๐Ÿ”ก **Locale note.** `commands.admin.setrank` gained `cannot-set-owner`, `already-rank` and `admin-changed-rank`; `unknown-rank` now takes `[rank]` and `[ranks]`. All 24 bundled locales are updated; add the new keys to any custom locale file. + + [Release v3.23.0](https://github.com/BentoBoxWorld/BentoBox/releases/tag/3.23.0) + +??? note "What's new in v3.22.4" **Released:** 2026-09-06 A bug-fix and performance release. Compatibility: Paper Minecraft 1.21.x โ€“ 26.2, Java 25+. diff --git a/docs/addons/TopBlock/index.md b/docs/addons/TopBlock/index.md index a7aeaeb0..5951e8c5 100644 --- a/docs/addons/TopBlock/index.md +++ b/docs/addons/TopBlock/index.md @@ -161,6 +161,17 @@ Placeholders are registered separately for each game mode TopBlock has hooked, u ## Changelog +??? note "What's new in v2.1.2" + **Released:** 2026-09-26 + + Patch release โ€” no config, locale or data format changes; a drop-in replacement for 2.1.1. + + - ๐Ÿ› **No more main-thread database reads during the top ten refresh.** 2.1.1 moved the game mode's island data read off the main thread, but matching each entry to its BentoBox island still ran there. That loaded every offline island from the database on the first refresh after a restart, and ran one existence query per stale AOneBlock/ChunkBlock entry every refresh (a problem on MySQL and other SQL backends). Island lookups now run in the async refresh task, unknown islands are skipped without touching the database, and islands are no longer pulled into BentoBox's cache just to build the top ten. + + If you are still on 2.1.0 and seeing lag spikes every 5 minutes, upgrade now. + + [Release v2.1.2](https://github.com/BentoBoxWorld/TopBlock/releases/tag/2.1.2) + ??? note "What's new in v2.1.1" **Released:** 2026-08-27 diff --git a/docs/gamemodes/AOneBlock/index.md b/docs/gamemodes/AOneBlock/index.md index b62db5fb..5c57a20f 100644 --- a/docs/gamemodes/AOneBlock/index.md +++ b/docs/gamemodes/AOneBlock/index.md @@ -54,24 +54,28 @@ Each entry in the `phases:` list takes these fields: | `length` | Number of blocks in the phase. | | `enabled` | Optional, defaults to `true`. Set `false` to leave a phase out. | | `requiredMinecraftVersion` | Optional. The phase is skipped โ€” taking up no blocks at all โ€” on servers older than this version. | +| `addedIn` | Optional, shipped index only. The addon version that first shipped the phase. Used once, when upgrading an index written before `shippedPhases` existed, to tell new phases apart from ones an admin removed. | Start blocks are **computed**: they are the running sum of the lengths of the enabled phases above, starting at 0. That means phases can be reordered freely and a skipped phase collapses out of the progression. After the last phase the block count jumps to `gotoAtEnd`. A top-level `adminLengths: true` is written automatically the first time you edit a length in `/[admin_command] phases`. From then on reconciliation never recomputes lengths, so your values survive later file additions, renames and upgrades. +A top-level `shippedPhases` list is also written automatically (since 1.28.0). It records every phase this server has been offered from the addon jar. Leave it in place: it is how AOneBlock tells a phase you removed on purpose from a new one shipped in an upgrade. + #### Reconciliation !!! note "Since 1.26.1 the phases folder is the source of truth" The index is reconciled with the files actually on disk on every load, and on every save from the admin panel, so what `/[admin_command] phases` shows is what your server really runs. Watch the startup log for lines beginning `Phase index:` โ€” they say exactly what was changed. - An entry whose file was **renamed across addon versions** is re-pointed at your file by phase name, so the phase loads again. -- An entry whose file is **missing but shipped in the jar** is restored automatically. This is what makes new phases appear on upgraded servers, since files in `phases/` are never overwritten. +- An entry whose file is **missing but shipped in the jar** is restored automatically, since files in `phases/` are never overwritten. +- *(1.28.0)* A **phase shipped in a newer addon version** is added once, on the first start after the upgrade, if it is not in the index and not yet in `shippedPhases`. It goes straight after the phase that precedes it in the shipped order, even if you have moved that phase, and its phase and chest files are copied into `phases/`. The log shows `Phase index: added new phase `. - **Custom phase files** dropped into the folder are added automatically. A numeric key slots in at its legacy start block; anything else is appended at the end for you to arrange in the panel. - Entries whose files are gone for good are removed with a warning, so the panel never lists phases that do not exist. - When repair was needed, lengths are recomputed from your files' legacy start-block keys, preserving the layout your server actually ran before the index existed โ€” unless `adminLengths` is set. !!! warning "Deleting a phase" - To remove a phase permanently, delete its files, or toggle it off in `/[admin_command] phases`. Deleting only its index entry does not work โ€” reconciliation re-adds any phase file it finds in the folder. + To remove a phase permanently, delete its index entry **and** its files; because it is already listed in `shippedPhases`, it will not come back on later upgrades. To just turn a phase off, toggle it off in `/[admin_command] phases`. Deleting only its index entry does not work โ€” reconciliation re-adds any phase file it finds in the folder. A malformed index falls back to the old direct file loading, so a bad edit cannot leave the addon stuck. @@ -518,14 +522,14 @@ By default, BentoBox GameMode addons comes with [default placeholders set](../.. Please add it to the list [here](https://github.com/BentoBoxWorld/AOneBlock/issues). ??? question "What phases are there?" - There are 20 shipped phases, in this order: Plains, Underground, Winter, Ocean, Jungle, Swamp, Dungeon, Desert, The Nether, Plenty, Desolation, Deep Dark, The End, Lush Caves, Dripstone Caves, Mangrove Swamp, Meadow, Cherry Grove, Jagged Peaks, and Sulfur Caves. + There are 21 shipped phases, in this order: Plains, Underground, Winter, Ocean, Jungle, Swamp, Dungeon, Desert, The Nether, Plenty, Desolation, Deep Dark, The End, Lush Caves, Dripstone Caves, Mangrove Swamp, Meadow, Cherry Grove, Jagged Peaks, Sulfur Caves, and Dappled Forest. Each phase features a set of blocks, items, and mobs appropriate for the setting. - Sulfur Caves requires Minecraft 26.2 or later. On older servers it is skipped and Jagged Peaks runs to the loop point instead. You can reorder, disable and resize phases yourself with `/[admin_command] phases`, and add your own phase files to the `phases` folder. + Sulfur Caves requires Minecraft 26.2 or later, and Dappled Forest requires Minecraft 26.3 or later. On older servers they are skipped and take up no blocks, so the previous phase runs to the loop point instead. You can reorder, disable and resize phases yourself with `/[admin_command] phases`, and add your own phase files to the `phases` folder. ??? question "How many blocks are there in all the phases?" - 15,500 blocks with the shipped phases on a Minecraft 26.2+ server, or 15,000 without the Sulfur Caves phase. + 16,000 blocks with the shipped phases on a Minecraft 26.3+ server, 15,500 on 26.2 (no Dappled Forest), or 15,000 on older servers (no Sulfur Caves either). ??? question "What happens after the last phase?" The phases repeat โ€” the block count jumps back to the `gotoAtEnd` value in `phases_index.yml`, which is 0 by default. @@ -923,3 +927,17 @@ AOneBlock has some custom events that are called only in AOneBlock. But BentoBox - ๐Ÿ”ก **Traditional Chinese (`zh-TW`) completed** by @qwe664 โ€” the 26 keys missing since 1.27.0 added and terminology revised. [Release v1.27.1](https://github.com/BentoBoxWorld/AOneBlock/releases/tag/1.27.1) + +!!! warning "What's new in v1.28.0 โ€” Dappled Forest phase added on first start" + **Released:** 2026-09-26 + + Compatibility: BentoBox API 3.22.0+ ยท Minecraft 26.x or 1.21.5+ (Sulfur Caves needs 26.2+, Dappled Forest needs 26.3+) ยท Java 25. + + - ๐Ÿ‚ **Dappled Forest phase** for Minecraft 26.3. It follows Sulfur Caves for 500 blocks, so the loop back to Plains moves from block 15500 to 16000. Poplar logs, yellow, orange and red poplar leaves (persistent, so they don't decay), leaf litter, red shrubs and wool stairs in all 16 colours; sheep, pigs, chickens, cows, rabbits and foxes plus the usual hostile mobs; chests with poplar saplings, shelf mushrooms, cushions, straw beds, a copper axe, an iron spear and more. On servers older than 26.3 the phase is skipped and takes up no blocks. + - ๐Ÿ”บ **New phases now reach existing servers.** `phases_index.yml` gains a `shippedPhases` list, and a phase shipped in a later version is added to the index once, straight after the phase before it in the shipped order. Phases you removed stay removed. See [Reconciliation](#reconciliation). + - ๐Ÿ› The block-break handler no longer throws a NullPointerException when no phase covers the current block count (for example a `gotoAtEnd` below the first phase, or phase files that failed to load). AOneBlock logs an error with the island and block number and cancels the break, so the magic block isn't lost. + - โš™๏ธ The comments on the `deaths` settings in `config.yml` now explain which settings still affect island levels under [Level](../../addons/Level/index.md) 2.29.0. Only comments changed. + + ๐Ÿ”บ **Dappled Forest is added to your phase order on the first start** (log: `Phase index: added new phase Dappled Forest`) and its files are copied into `phases/`. Your existing order, lengths and enabled flags are not changed. If you don't want it, disable it in `/[admin_command] phases`. + + [Release v1.28.0](https://github.com/BentoBoxWorld/AOneBlock/releases/tag/1.28.0) diff --git a/docs/gamemodes/AcidIsland/Commands.md b/docs/gamemodes/AcidIsland/Commands.md index b9dcacfd..040a13b3 100644 --- a/docs/gamemodes/AcidIsland/Commands.md +++ b/docs/gamemodes/AcidIsland/Commands.md @@ -136,8 +136,8 @@ -/acid setrank -set a player's rank on their island +/acid setrank [island owner | x,y,z] +set a player's rank on their island - works from the console; the rank can be a keyword (member, sub-owner, trusted, coop), name or number. Name the owner or the centre x,y,z to pick a specific island diff --git a/docs/gamemodes/AcidIsland/index.md b/docs/gamemodes/AcidIsland/index.md index 8d6f7f09..dd9d235d 100644 --- a/docs/gamemodes/AcidIsland/index.md +++ b/docs/gamemodes/AcidIsland/index.md @@ -178,6 +178,18 @@ Other addons can hook into the geyser offering mechanic with two events, both ad ## Changelog +??? note "What's new in v2.1.2 โ€” sulfur vents on Minecraft 26.3" + **Released:** 2026-09-25 + + A bug-fix release for Minecraft 26.3. No config or locale changes. Compatibility: BentoBox API 3.14.0 ยท Minecraft 1.21.5 โ€“ 26.3 (sulfur sea and geysers need 26.2+) ยท Java 21. + + - ๐Ÿ› **Sulfur vents generate intact on 26.3.** Vanilla biome decoration ran after AcidIsland built the sea and overwrote every vent cap, leaving plain sulfur with no bubbling, gas or geysers, plus one `ServerInternalException ... PotentSulfurBlockEntity` warning per vent. Vents are now placed after decoration. + - โš™๏ธ The `deaths` comments in `config.yml` now explain which settings affect island levels under [Level](../../addons/Level/index.md) 2.29.0. No settings or defaults changed. + + ๐Ÿ”บ **Only newly generated chunks are fixed.** Vents in chunks already generated on 26.3 keep their plain caps. Because vents are now placed later, a given seed puts vents in different spots than in 2.1.1. + + [Release v2.1.2](https://github.com/BentoBoxWorld/AcidIsland/releases/tag/2.1.2) + !!! warning "What's new in v2.1.1 โ€” vents trade instead of gamble (delete `geyser-loot.yml`)" **Released:** 2026-07-26 diff --git a/docs/gamemodes/BSkyBlock/Commands.md b/docs/gamemodes/BSkyBlock/Commands.md index 60b2b2e1..9c8aa2a8 100644 --- a/docs/gamemodes/BSkyBlock/Commands.md +++ b/docs/gamemodes/BSkyBlock/Commands.md @@ -131,8 +131,8 @@ bskyblock.mod.team -/bsbadmin setrank -set a player's rank on their island +/bsbadmin setrank [island owner | x,y,z] +set a player's rank on their island - works from the console; the rank can be a keyword (member, sub-owner, trusted, coop), name or number. Name the owner or the centre x,y,z to pick a specific island bskyblock.admin.setrank diff --git a/docs/gamemodes/Boxed/Commands.md b/docs/gamemodes/Boxed/Commands.md index bebc97ae..aef3814c 100644 --- a/docs/gamemodes/Boxed/Commands.md +++ b/docs/gamemodes/Boxed/Commands.md @@ -64,6 +64,11 @@ All the commands are the same as other game modes, like BSkyBlock. +/boxadmin place [x y z] [rotation] [mirror] [NO_MOBS] +place a structure from the seed world into the current box; use ~ for the current coordinate. NO_MOBS (3.4.1+) suppresses the structure's built-in mobs. /boxadmin place undo removes the last placement +boxed.commands.boxadmin.place + + /boxadmin range Admin island range command @@ -129,8 +134,8 @@ All the commands are the same as other game modes, like BSkyBlock. boxed.admin.register -/boxadmin setrank -set a player's rank on their island +/boxadmin setrank [island owner | x,y,z] +set a player's rank on their island - works from the console; the rank can be a keyword (member, sub-owner, trusted, coop), name or number. Name the owner or the centre x,y,z to pick a specific island diff --git a/docs/gamemodes/Boxed/index.md b/docs/gamemodes/Boxed/index.md index b769ab94..3c046ffa 100644 --- a/docs/gamemodes/Boxed/index.md +++ b/docs/gamemodes/Boxed/index.md @@ -139,6 +139,19 @@ Placeholders can be found [here](Placeholders). ## Changelog +??? note "What's new in v3.4.1" + **Released:** 2026-09-25 + + A maintenance release. Requires BentoBox **3.17.0** or newer. Compatibility: Paper 1.21.x โ€“ 26.x ยท Java 21. + + - ๐Ÿ› **No more `contloc out of spec` crash on enable.** On first boot an explorer map rolled from a loot chest could search far outside the seed area, where continentalness drops below -1.2, and BentoBox skipped Boxed. Out-of-range values now fall into the outermost bands. + - ๐Ÿ› **`/boxadmin place ... NO_MOBS` works.** The 7th argument was rejected before it could be read; it is now accepted and no longer carries over into later placements. + - ๐Ÿ› A missing pair of parentheses picked the wrong biome in some erosion level 5 seed areas. Only seed worlds generated after the upgrade are affected. + - โš™๏ธ Clearer `area.deaths` comments in `config.yml`, explaining which death settings affect island levels under [Level](../../addons/Level/index.md) 2.29.0 and which only affect BentoBox's death counter and `%boxed_deaths%`. Only comments changed. + - Releases are now also published to CurseForge and Hangar. + + [Release v3.4.1](https://github.com/BentoBoxWorld/Boxed/releases/tag/3.4.1) + ??? note "What's new in v3.4.0" **Released:** 2026-05-30 diff --git a/docs/gamemodes/Poseidon/Commands.md b/docs/gamemodes/Poseidon/Commands.md index 5634e67d..4495110d 100644 --- a/docs/gamemodes/Poseidon/Commands.md +++ b/docs/gamemodes/Poseidon/Commands.md @@ -121,8 +121,8 @@ poseidon.mod.team -/padmin setrank -set a player's rank on their realm +/padmin setrank [island owner | x,y,z] +set a player's rank on their realm - works from the console; the rank can be a keyword (member, sub-owner, trusted, coop), name or number. Name the owner or the centre x,y,z to pick a specific realm poseidon.admin.setrank diff --git a/docs/gamemodes/SkyGrid/Commands.md b/docs/gamemodes/SkyGrid/Commands.md index 3409a67e..9ea49dee 100644 --- a/docs/gamemodes/SkyGrid/Commands.md +++ b/docs/gamemodes/SkyGrid/Commands.md @@ -103,8 +103,8 @@ skygrid.mod.team -/sgadmin setrank -set a player's rank on their area +/sgadmin setrank [island owner | x,y,z] +set a player's rank on their area - works from the console; the rank can be a keyword (member, sub-owner, trusted, coop), name or number. Name the owner or the centre x,y,z to pick a specific area skygrid.admin.setrank diff --git a/docs/gamemodes/StrangerRealms/Commands.md b/docs/gamemodes/StrangerRealms/Commands.md index 019be45e..af54d58e 100644 --- a/docs/gamemodes/StrangerRealms/Commands.md +++ b/docs/gamemodes/StrangerRealms/Commands.md @@ -275,8 +275,8 @@ tr> strangerrealms.mod.team -/stranger setrank -set a player's rank on their claim +/stranger setrank [island owner | x,y,z] +set a player's rank on their claim - works from the console; the rank can be a keyword (member, sub-owner, trusted, coop), name or number. Name the owner or the centre x,y,z to pick a specific claim strangerrealms.admin.setrank diff --git a/docs/gamemodes/StrangerRealms/index.md b/docs/gamemodes/StrangerRealms/index.md index cd8fc248..b4d54aa4 100644 --- a/docs/gamemodes/StrangerRealms/index.md +++ b/docs/gamemodes/StrangerRealms/index.md @@ -90,6 +90,15 @@ Permissions can be found [here](Permissions). **Compatibility:** BentoBox API 3.9.0+, Minecraft 1.21.10+, Java 21. +??? note "What's new in v1.0.6 โ€” Paper 26.3 fix" + **Released:** 2026-09-26 + + See the full notes: [Release 1.0.6](https://github.com/BentoBoxWorld/StrangerRealms/releases/tag/1.0.6) + + - ๐Ÿ› **No more sculk sensor warnings when the Upside Down is created on Paper 26.3.** Vanilla cave carvers ran after StrangerRealms placed its sculk sensors and replaced some with lava, and Paper logged a `ServerInternalException` (*"Trying to set block entity SculkSensorBlockEntity ..."*) for each one. Sensors are now placed by a block populator after carvers and decoration. Density is unchanged, and already-generated chunks are not changed. + + **Compatibility:** BentoBox API 3.9.0+, Minecraft 1.21.10+ (including 26.1.x, 26.2 and 26.3), Java 21. + ## Translations {{ translations("StrangerRealms") }} diff --git a/docs/index.md b/docs/index.md index 0f43ff34..c70a01c8 100644 --- a/docs/index.md +++ b/docs/index.md @@ -34,7 +34,7 @@ hide:
game modes
-
MC 1.15 → 26.2.x
+
MC 1.15 → 26.3.x
supported