docs: MiniMessage, message delivery tags, flag placeholders, Island Defaults tab, blueprint format by Copilot · Pull Request #39 · BentoBoxWorld/docs

Copilot · 2026-04-06T23:25:22Z

PR #2910 – Document new locale message delivery tags ([actionbar], [title], [subtitle], [sound:...]) in Translate-BentoBox-and-addons.md
PR #2903 – Document that MiniMessage is now used for all locale strings in Translate-BentoBox-and-addons.md
PR #2913 – Document new flag state placeholders (%[gamemode]_flag_<name>%) in Placeholders.md
PR #2912 – Document new "Island Defaults" tab in Admin Settings GUI in Island-Protection,-Flags-&-Ranks.md
PR #2911 – Update blueprint file format documentation (.blu → .blueprint plain JSON) in Blueprints.md and Blueprint-Specification-v1.md
Address review feedback:
- Removed incorrect island.blueprint filename from "Incomplete bundles" fallback sentence
- Fixed Island Defaults version tag from "2.x" to "3.14.0"
- Expanded Island Defaults description to cover settings flags (true/false toggle) alongside protection flags
- Updated Placeholders.md to say "protection flag and settings flag" (not just protection)
- Clarified that [subtitle] is not standalone — it only works as a separator inside a [title] message; added empty-title example
- Added & color codes alongside § in the backwards-compatibility note

…ag placeholders, Island Defaults, blueprint format Agent-Logs-Url: https://github.com/BentoBoxWorld/docs/sessions/93844fe5-42fe-4df2-ba08-2f00867e6bfc Co-authored-by: tastybento <4407265+tastybento@users.noreply.github.com>

tastybento · 2026-04-06T23:43:51Z


 ## Incomplete bundles
-Bundles must always have an Overworld/Normal world blueprint. If they do not, then the default island (island.blu) blueprint will be used and an error logged in the console.
+Bundles must always have an Overworld/Normal world blueprint. If they do not, then the default island (`island.blueprint`) blueprint will be used and an error logged in the console.


This text is wrong. Remove it. The text below it is correct.

Removed the (island.blueprint) filename reference — the sentence now just says "the default island blueprint will be used". Fixed in ad94d68.

tastybento · 2026-04-06T23:44:26Z

+
+### Island Defaults
+
+!!! new "Added in BentoBox 2.x"


This is wrong. It is being added in BentoBox 3.14.0

Fixed — version updated to 3.14.0 in ad94d68.

tastybento · 2026-04-06T23:45:32Z

+
+Previously, these defaults could only be changed in the gamemode's `config.yml`. Now they can be changed directly in-game by opening `/[admin_command] settings` and navigating to the **Island Defaults** tab (tab 3).
+
+Each protection flag is listed with its current default rank. Clicking on a flag cycles the default rank through the rank ladder. Changes are saved immediately to the world settings and take effect for all **new** islands created after the change. Existing islands are not affected.


This is true, but Island Settings flag defaults can also be changed and have a true/false setting.

Updated in ad94d68 — the description now covers both cases: protection flags cycle through rank ladder, and island settings flags toggle true/false.

tastybento · 2026-04-06T23:46:02Z


+### Flag placeholders
+
+Every protection flag registered in a gamemode also exposes a placeholder. The placeholder name is `flag_` followed by the lower-case flag ID:


Not just protection flag, but settings flag too.

Fixed in ad94d68 — intro now reads "Every protection flag and settings flag registered in a gamemode also exposes a placeholder."

tastybento · 2026-04-06T23:47:47Z

+
+### `[title]` and `[subtitle]`
+
+Sends the message as a **title** overlay on screen. Use `[title]` for the large text and `[subtitle]` for the smaller text below it. They can be used together in the same string.


[subtitle] is not a standalone delivery type — it only works as a separator inside a [title]...[subtitle]... message. Without [title] it falls through to the chat path.

So your an example could be:

scooping: '[title][subtitle]Changing obsidian back into lava!'
That gives you an empty title and the text as the subtitle.

Fixed in ad94d68 — the section now clearly states that [subtitle] is not a standalone delivery type and only works as a separator inside a [title] message. Added the empty-title example you suggested ("[title][subtitle]You scooped the lava!").

… subtitle clarification, settings flag coverage Agent-Logs-Url: https://github.com/BentoBoxWorld/docs/sessions/be13355d-41ce-4c8f-a275-9bb4f6beebd7 Co-authored-by: tastybento <4407265+tastybento@users.noreply.github.com>

tastybento · 2026-04-06T23:52:02Z

+my-message: "<gradient:gold:yellow>Island Name</gradient>"
+```
+
+Legacy `§` color codes are still supported for backwards compatibility and will be automatically converted to MiniMessage format when loaded.


Change to:
Legacy § or & color codes are still supported for backwards compatibility and will be automatically converted to MiniMessage format when loaded.

Updated in 809e22f.

Agent-Logs-Url: https://github.com/BentoBoxWorld/docs/sessions/cc2722c5-92e1-473e-9ffb-30cfe6afd555 Co-authored-by: tastybento <4407265+tastybento@users.noreply.github.com>

Initial plan

da5f971

Copilot AI assigned Copilot and tastybento Apr 6, 2026

Copilot started work on behalf of tastybento April 6, 2026 23:25 View session

Copilot AI linked an issue Apr 6, 2026 that may be closed by this pull request

Update docs #38

Closed

Copilot AI changed the title ~~[WIP] Update documentation to reflect new features and MiniMessage usage~~ docs: MiniMessage, message delivery tags, flag placeholders, Island Defaults tab, blueprint format Apr 6, 2026

Copilot AI requested a review from tastybento April 6, 2026 23:29

Copilot finished work on behalf of tastybento April 6, 2026 23:29

tastybento marked this pull request as ready for review April 6, 2026 23:39

tastybento requested changes Apr 6, 2026

View reviewed changes

Copilot started work on behalf of tastybento April 6, 2026 23:48 View session

Copilot finished work on behalf of tastybento April 6, 2026 23:50

Copilot AI requested a review from tastybento April 6, 2026 23:50

tastybento requested changes Apr 6, 2026

View reviewed changes

Copilot started work on behalf of tastybento April 6, 2026 23:52 View session

docs: add & color code support note to MiniMessage section

809e22f

Agent-Logs-Url: https://github.com/BentoBoxWorld/docs/sessions/cc2722c5-92e1-473e-9ffb-30cfe6afd555 Co-authored-by: tastybento <4407265+tastybento@users.noreply.github.com>

tastybento approved these changes Apr 6, 2026

View reviewed changes

Copilot finished work on behalf of tastybento April 6, 2026 23:53

Copilot AI requested a review from tastybento April 6, 2026 23:53

tastybento merged commit 026b0d5 into master Apr 6, 2026

tastybento deleted the copilot/update-docs-mini-message branch April 6, 2026 23:53

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: MiniMessage, message delivery tags, flag placeholders, Island Defaults tab, blueprint format#39

docs: MiniMessage, message delivery tags, flag placeholders, Island Defaults tab, blueprint format#39
tastybento merged 4 commits into
masterfrom
copilot/update-docs-mini-message

Copilot AI commented Apr 6, 2026 •

edited

Loading

Uh oh!

tastybento Apr 6, 2026

Uh oh!

Copilot AI Apr 6, 2026

Uh oh!

tastybento Apr 6, 2026

Uh oh!

Copilot AI Apr 6, 2026

Uh oh!

tastybento Apr 6, 2026

Uh oh!

Copilot AI Apr 6, 2026

Uh oh!

tastybento Apr 6, 2026

Uh oh!

Copilot AI Apr 6, 2026

Uh oh!

tastybento Apr 6, 2026

Uh oh!

Copilot AI Apr 6, 2026

Uh oh!

tastybento Apr 6, 2026

Uh oh!

Copilot AI Apr 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		Previously, these defaults could only be changed in the gamemode's `config.yml`. Now they can be changed directly in-game by opening `/[admin_command] settings` and navigating to the Island Defaults tab (tab 3).

		Each protection flag is listed with its current default rank. Clicking on a flag cycles the default rank through the rank ladder. Changes are saved immediately to the world settings and take effect for all new islands created after the change. Existing islands are not affected. No newline at end of file


		### Flag placeholders

		Every protection flag registered in a gamemode also exposes a placeholder. The placeholder name is `flag_` followed by the lower-case flag ID:


		### `[title]` and `[subtitle]`

		Sends the message as a title overlay on screen. Use `[title]` for the large text and `[subtitle]` for the smaller text below it. They can be used together in the same string.

Uh oh!

Conversation

Copilot AI commented Apr 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tastybento Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

tastybento Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

tastybento Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

tastybento Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

tastybento Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

tastybento Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 6, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Apr 6, 2026 •

edited

Loading