Release 3.23.7

Release Highlights

A small fix release for servers moving to Minecraft 26.3 that kept an old locale file.

• 🔺 Protection flags look like they can't be changed — on servers whose locale files were first written by BentoBox 3.12 or earlier, every rank in a protection flag's lore showed in the same cyan, so allowed, blocked and minimum ranks looked identical. Clicking a flag changed it, but nothing on screen showed the change, and it looked as if the click did nothing. Fixed: old locale files show green, red and dark green ranks again.
• 🔡 Click hints restored in nine languages — Czech, German, Spanish, French, Italian, Japanese, Latvian, Polish and Turkish were missing the "Left click / Right click" hints on protection flags and the "Click to toggle / open" hints on settings, so players weren't told how to change a flag. They now match English.

Compatibility

✔️ Paper Minecraft 1.21.5 – 26.3
✔️ Java 25+

Upgrading

1. As always, take backups just in case. (Make a copy of everything!)
2. Stop the server.
3. Replace the BentoBox jar with this one.
4. 🔡 Refresh your locale files (see below) — strongly recommended if you have upgraded from an older BentoBox.
5. Restart the server.
6. You should be good to go!

🔺 BentoBox never overwrites existing locale text. On each start, new keys are added to the files in plugins/BentoBox/locales/, but entries that already exist are left exactly as they are, so that your edits survive updates. A server that has been upgraded over many versions therefore still shows the wording and formatting of the version it was first installed with, and misses every fix to existing messages since. If your island settings panel shows all ranks in one color or has no click hints, your locale files are out of date.

To refresh them: stop the server, rename plugins/BentoBox/locales/BentoBox/ (for example to BentoBox-old), start the server so the current files are written, then copy any custom edits back across. Addons keep their locale files alongside it in plugins/BentoBox/locales/<AddonName>/, and the same applies there.

🔡 Locale note: the protection.panel.flag-item description-layout, setting-layout and menu-layout entries changed in cs, de, es, fr, it, ja, lv, pl and tr, and blocked-rank changed in tr. No keys were added or removed.

There are no config.yml or panel template changes in this release.

Legend

• 🔡 locale files may need to be regenerated or updated.
• ⚙️ config options have been removed, renamed, or added.
• 🔺 special attention needed.

---

Bug Fixes

🔺 Rank Colors Lost With Old Locale Files

[39f8041f6]

Locale files from before the MiniMessage migration in 3.13.0 write rank lines as a color prefix with the rank name appended, e.g. allowed-rank: '&3 - &a'. BentoBox translated the prefix first and appended the name afterwards, and the color conversion drops a color code with no text after it. Every rank therefore came out in the prefix color (cyan), whether it was allowed or blocked. The rank name is now appended before the colors are converted. This affected the island settings panel, the team GUI rank filter and the command ranks panel; all three now share one helper, Flag.getRankLine(User, String, String).

🔡 Missing Click Hints and Broken Layouts in Some Locales

[39f8041f6]

Nine bundled locales had no click instructions on flag items. They have been added, matching en-US. The Italian layouts had been collapsed onto a single line, running the "Permesso per:" label into the description; they are multi-line again. The Turkish blocked-rank entry had lost its [rank] placeholder, so blocked rank names showed without color; it has been restored.

---

What's Changed

• 🔺🔡 Fix rank colors with old locale files; add missing click hints by @tastybento in 39f8041f6

Thanks to SimulakruM on Discord for the clear report and screenshot.

Full Changelog: 3.23.6...3.23.7