Skip to content

docs: rewrite Multilingual as the Languages & Messages admin guide - #128

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

tastybento merged 1 commit into
masterfrom
docs/languages-guide

Conversation

@tastybento

Copy link
Copy Markdown
Member

Rewrites BentoBox/About/Multilingual.md (same URL, nav title "Languages & Messages") as an admin guide, and refocuses Translate-BentoBox-and-addons.md on contributors.

Languages & Messages covers:

  • the 25 bundled languages and the default language (general.default-language)
  • how players choose a language, and the fallback chain
  • where the locale files live, how to change, hide or check messages, and what happens to your edits when you update
  • MiniMessage and legacy colours, delivery tags ([actionbar], [title]/[subtitle], [sound:…]), clickable tags ([run_command:], [suggest_command:], [open_url:], [copy_to_clipboard:], [hover:]), and troubleshooting

Corrections, checked against BentoBox source (LocalesManager, User):

  • Players change language with /island language. The old page said /bentobox locale, which is the admin tool that analyses locale files for missing keys.
  • pt-BR was missing from the language list.
  • The config path is general.default-language.
  • Fallback is player's language → server default → en-US. BentoBox doesn't detect the client's Minecraft language.
  • Locale files are in plugins/BentoBox/locales/BentoBox/ and locales/<AddonName>/. On load, only missing keys are added from the jar, so admin edits survive updates. It also means improved wording in new releases doesn't replace old text, which the troubleshooting section explains.
  • Blank messages aren't sent (User.sendMessage), which gives admins a way to hide a message.
  • The clickable tags weren't documented before.

Translating BentoBox now has a title and intro, the status tables, and a short "How to help" section with the old guidelines tidied (typos fixed). The MiniMessage and delivery-tag sections moved to the admin guide, which it links to.

zensical build passes (2 existing Biomes anchor warnings).

🤖 Generated with Claude Code

Default and per-player language, where locale files live, changing and
hiding messages, how updates merge, formatting, delivery and clickable
tags, troubleshooting. Translating page keeps contributor guidance and
status tables. Checked against BentoBox source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tastybento
tastybento merged commit 4b06608 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