Release 1.16.1

🎁 What's new

ControlPanel 1.16.1 fixes the most-reported annoyance with the addon: editing controlPanelTemplate.yml and running bbox reload did nothing. Panels live in BentoBox's database and the template was only ever a one-time seed, so template edits were silently ignored unless you ran the confirmation-gated cp import command. Reload now re-imports the template, and the template file name is configurable.

This release also drops the minimum BentoBox version from 3.10.0 back to 2.7.1. 1.16.0 shipped with an api-version of 3.10.0 even though nothing in the code needed it, which made BentoBox refuse to load the addon (INCOMPATIBLE) on servers that can't run BentoBox 3.10+ — notably Minecraft 1.21.4 servers, which top out at BentoBox 3.7.4. Those servers can now use the current ControlPanel again.

✨ Highlights

🔺 ⚙️ bbox reload re-imports the template (#41)

• bbox reload now wipes each active game mode's stored panels and re-imports them from the template file, so template edits take effect without cp import.
• Because the reload wipes first, panels you removed from the template also disappear instead of lingering in the database.
• New template-file option in config.yml (default controlPanelTemplate.yml). Reload, importControlPanels and the admin import command all honour it, so you can point the addon at your own file.

🔺 Minimum BentoBox version lowered to 2.7.1

• addon.ymlapi-version is now 2.7.1 (was 3.10.0). The addon is still built against BentoBox 3.10.0 / Paper 1.21.11, but it uses no API newer than 2.7.1.
• Verified against BentoBox 3.7.4 and 3.8.1 on Paper 1.21.4: no missing classes, methods or fields.

🔡 Locales

• Updated Traditional Chinese (zh-TW.yml) translations, thanks to @qwe664 (#43).

🛠 Housekeeping

• CurseForge and Hangar publishing now run from GitHub Actions on release, using the jar attached to the release (#38, #39, #40, #42).

⚙️ Compatibility

✔️ BentoBox 2.7.1 or later (verified with 3.7.4 on Minecraft 1.21.4)
✔️ Minecraft 1.21.4 – 26.2
✔️ Java 21

🔺 Updating — important notes

🔺 Reload now overwrites stored panels. The panels in the database are replaced by the template on every bbox reload. If you have been relying on database-only panel changes (anything not in controlPanelTemplate.yml), put them in the template before updating or they will be lost on the next reload.

⚙️ New config key.template-file is added to config.yml with the default controlPanelTemplate.yml; existing installs keep working with no changes.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Drop the new jar into the addons folder and remove the old one
4. Start the server

Legend

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

What's Changed

• 🔺 ⚙️ Reload re-imports control panels from the template file by @tastybento in #41
• 🔺 Lower minimum BentoBox version to 2.7.1 and bump to 1.16.1 by @tastybento in ef9c192
• 🔡 Update Chinese translations in zh-TW.yml by @qwe664 in #43
• Add CurseForge publish workflow (publishes the release asset) by @tastybento in #38
• ci: bump pinned reusable workflow to fe4b1f0 by @tastybento in #39
• ci: bump pinned publish-platforms.yml to ca2dcd1 by @tastybento in #40
• ci: bump publish-platforms pin to the multipart-JSON fix by @tastybento in #42

Full Changelog: 1.16.0...1.16.1

Release 1.16.0

Highlights

• Right-click & shift-click command support — Panel buttons can now trigger different commands based on click type (left-click, right-click, shift-click), giving server admins much more flexibility in their control panel layouts.
• ItemsAdder integration — Buttons can now use custom ItemsAdder items as icons, enabling richer visual customization.
• Multi-slot button support — Buttons can now span multiple inventory slots using range syntax (e.g., 1-3), simplifying panel configuration.
• Java 21 & Minecraft 1.21 — Upgraded to Java 21 and the latest Paper/BentoBox APIs.

Updating

Compatibility

✔️ BentoBox API 3.10.0
✔️ Minecraft 1.21
✔️ Java 21

Changelog

Legend

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

⚙️ New config options: right_click_command and shift_click_command for panel buttons.

What's Changed

• Add ItemsAdder support and general code improvements by @K0bus in #33
• Add JUnit 5 test suite (97 tests) by @tastybento in #34
• Add right-click and shift-click command support for panel buttons in #35

Full Changelog: 1.14.0...1.16.0

Release 1.14.0

Updating

Compatibility

✔️ BentoBox API 2.7.1
✔️ Minecraft 1.21.3
✔️ Java 17

Changelog

Legend

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

What's Changed

• Version 1.14.0 by @tastybento in #32

Full Changelog: 1.13.1...1.14.0

Release 1.13.1

This release just adds or updates language files for Chinese, French, German, Polish, Russian, Hong Kong, and Indonesian.

Updating

1. Stop the server
2. Copy this addon into the BentoBox/addons folder
3. (Optional) Delete or move the BentoBox/locales/ControlPanel folder so that updated files will be generated
4. Restart the server
5. You should be good to go!

Compatibility

✔️ BentoBox API 2.0.0
✔️ Minecraft 1.20.4
✔️ Java 17

Changelog

Legend

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

What's Changed

• 🔡 Create zh-CN.yml by @katorly in #20
• 🔡 French translation by @gitlocalize-app in #22
• 🔡 Polish translation by @gitlocalize-app in #23
• 🔡 Update DE by @gitlocalize-app in #26
• 🔡 Update RU by @gitlocalize-app in #27
• 🔡 Add locale of Chinese-Hong Kong (zh-HK) by @JamesMCL44 in #29
• 🔡 Added Bahasa Indonesia by @DustyGanteng in #30

New Contributors

• @katorly made their first contribution in #20
• @JamesMCL44 made their first contribution in #29
• @DustyGanteng made their first contribution in #30

Full Changelog: 1.13.0...1.13.1

Release 1.13.0

Compatibility

✔️ BentoBox API 1.14.0
✔️ Minecraft 1.15.2

Changelog

Legend

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

New Features

• Translate de.yml via GitLocalize (commit: 35a5880)
• Czech translation. Credit @Polda18 (commit: bf92abe)
• Implement auto-importing on first startup all control panels. (commit: 51329a3)
• Translate ko.yml via GitLocalize (commit: 83b5976)
• Translate zh-TW.yml via GitLocalize (commit: 1d75e1d)
• Various bug fixes

ControlPanel 1.7.0

This is a pretty basic control panel that allows configuring custom GUI that is accessible from /[gamemode] cp command. It contains the same features as it was in ASkyBlock, but in extra with better description customization (supports placeholders), and ability to define multiple control panels which can be changed by adding or removing permission to a player.

Compatibility

✔️ BentoBox API 1.7.0
✔️ Minecraft 1.14.5

Changelog

Legend

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

New Features

• Ability to define ControlPanel item:
  • Item slot in GUI
  • Item icon in GUI
  • Item lore description in GUI
  • Command that will be triggered when a player clicks on an item.
• Description supports:
  • placeholders that start and ends with %
  • new line element that is represented with |
  • Minecraft color and formatting codes that starts with &
• Command supports:
  • any command that is available on the server
  • run as a console if it starts with [server]. example : [server] op [player]
  • getting a username for a player with [player]. example: [server] kill [player]
  • getting BentoBox GameMode starting command with [label]. example: [label] challenges
• Ability to define multiple control panels:
  • Users will access to ControlPanel with permission that they have: [gamemode].controlpanel.panel.[suffix]
• Has english, latvian, spanish and franch translations.

Release 1.16.1

🎁 What's new

ControlPanel 1.16.1 fixes the most-reported annoyance with the addon: editing controlPanelTemplate.yml and running bbox reload did nothing. Panels live in BentoBox's database and the template was only ever a one-time seed, so template edits were silently ignored unless you ran the confirmation-gated cp import command. Reload now re-imports the template, and the template file name is configurable.

This release also drops the minimum BentoBox version from 3.10.0 back to 2.7.1. 1.16.0 shipped with an api-version of 3.10.0 even though nothing in the code needed it, which made BentoBox refuse to load the addon (INCOMPATIBLE) on servers that can't run BentoBox 3.10+ — notably Minecraft 1.21.4 servers, which top out at BentoBox 3.7.4. Those servers can now use the current ControlPanel again.

✨ Highlights

🔺 ⚙️ bbox reload re-imports the template (#41)

• bbox reload now wipes each active game mode's stored panels and re-imports them from the template file, so template edits take effect without cp import.
• Because the reload wipes first, panels you removed from the template also disappear instead of lingering in the database.
• New template-file option in config.yml (default controlPanelTemplate.yml). Reload, importControlPanels and the admin import command all honour it, so you can point the addon at your own file.

🔺 Minimum BentoBox version lowered to 2.7.1

• addon.ymlapi-version is now 2.7.1 (was 3.10.0). The addon is still built against BentoBox 3.10.0 / Paper 1.21.11, but it uses no API newer than 2.7.1.
• Verified against BentoBox 3.7.4 and 3.8.1 on Paper 1.21.4: no missing classes, methods or fields.

🔡 Locales

• Updated Traditional Chinese (zh-TW.yml) translations, thanks to @qwe664 (#43).

🛠 Housekeeping

• CurseForge and Hangar publishing now run from GitHub Actions on release, using the jar attached to the release (#38, #39, #40, #42).

⚙️ Compatibility

✔️ BentoBox 2.7.1 or later (verified with 3.7.4 on Minecraft 1.21.4)
✔️ Minecraft 1.21.4 – 26.2
✔️ Java 21

🔺 Updating — important notes

🔺 Reload now overwrites stored panels. The panels in the database are replaced by the template on every bbox reload. If you have been relying on database-only panel changes (anything not in controlPanelTemplate.yml), put them in the template before updating or they will be lost on the next reload.

⚙️ New config key.template-file is added to config.yml with the default controlPanelTemplate.yml; existing installs keep working with no changes.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Drop the new jar into the addons folder and remove the old one
4. Start the server

Legend

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

What's Changed

• 🔺 ⚙️ Reload re-imports control panels from the template file by @tastybento in #41
• 🔺 Lower minimum BentoBox version to 2.7.1 and bump to 1.16.1 by @tastybento in ef9c192
• 🔡 Update Chinese translations in zh-TW.yml by @qwe664 in #43
• Add CurseForge publish workflow (publishes the release asset) by @tastybento in #38
• ci: bump pinned reusable workflow to fe4b1f0 by @tastybento in #39
• ci: bump pinned publish-platforms.yml to ca2dcd1 by @tastybento in #40
• ci: bump publish-platforms pin to the multipart-JSON fix by @tastybento in #42

Full Changelog: 1.16.0...1.16.1

Release 1.16.0

Highlights

• Right-click & shift-click command support — Panel buttons can now trigger different commands based on click type (left-click, right-click, shift-click), giving server admins much more flexibility in their control panel layouts.
• ItemsAdder integration — Buttons can now use custom ItemsAdder items as icons, enabling richer visual customization.
• Multi-slot button support — Buttons can now span multiple inventory slots using range syntax (e.g., 1-3), simplifying panel configuration.
• Java 21 & Minecraft 1.21 — Upgraded to Java 21 and the latest Paper/BentoBox APIs.

Updating

Compatibility

✔️ BentoBox API 3.10.0
✔️ Minecraft 1.21
✔️ Java 21

Changelog

Legend

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

⚙️ New config options: right_click_command and shift_click_command for panel buttons.

What's Changed

• Add ItemsAdder support and general code improvements by @K0bus in #33
• Add JUnit 5 test suite (97 tests) by @tastybento in #34
• Add right-click and shift-click command support for panel buttons in #35

Full Changelog: 1.14.0...1.16.0

Release 1.14.0

Updating

Compatibility

✔️ BentoBox API 2.7.1
✔️ Minecraft 1.21.3
✔️ Java 17

Changelog

Legend

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

What's Changed

• Version 1.14.0 by @tastybento in #32

Full Changelog: 1.13.1...1.14.0

Release 1.13.1

This release just adds or updates language files for Chinese, French, German, Polish, Russian, Hong Kong, and Indonesian.

Updating

1. Stop the server
2. Copy this addon into the BentoBox/addons folder
3. (Optional) Delete or move the BentoBox/locales/ControlPanel folder so that updated files will be generated
4. Restart the server
5. You should be good to go!

Compatibility

✔️ BentoBox API 2.0.0
✔️ Minecraft 1.20.4
✔️ Java 17

Changelog

Legend

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

What's Changed

• 🔡 Create zh-CN.yml by @katorly in #20
• 🔡 French translation by @gitlocalize-app in #22
• 🔡 Polish translation by @gitlocalize-app in #23
• 🔡 Update DE by @gitlocalize-app in #26
• 🔡 Update RU by @gitlocalize-app in #27
• 🔡 Add locale of Chinese-Hong Kong (zh-HK) by @JamesMCL44 in #29
• 🔡 Added Bahasa Indonesia by @DustyGanteng in #30

New Contributors

• @katorly made their first contribution in #20
• @JamesMCL44 made their first contribution in #29
• @DustyGanteng made their first contribution in #30

Full Changelog: 1.13.0...1.13.1

Release 1.13.0

Compatibility

✔️ BentoBox API 1.14.0
✔️ Minecraft 1.15.2

Changelog

Legend

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

New Features

• Translate de.yml via GitLocalize (commit: 35a5880)
• Czech translation. Credit @Polda18 (commit: bf92abe)
• Implement auto-importing on first startup all control panels. (commit: 51329a3)
• Translate ko.yml via GitLocalize (commit: 83b5976)
• Translate zh-TW.yml via GitLocalize (commit: 1d75e1d)
• Various bug fixes

ControlPanel 1.7.0

This is a pretty basic control panel that allows configuring custom GUI that is accessible from /[gamemode] cp command. It contains the same features as it was in ASkyBlock, but in extra with better description customization (supports placeholders), and ability to define multiple control panels which can be changed by adding or removing permission to a player.

Compatibility

✔️ BentoBox API 1.7.0
✔️ Minecraft 1.14.5

Changelog

Legend

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

New Features

• Ability to define ControlPanel item:
  • Item slot in GUI
  • Item icon in GUI
  • Item lore description in GUI
  • Command that will be triggered when a player clicks on an item.
• Description supports:
  • placeholders that start and ends with %
  • new line element that is represented with |
  • Minecraft color and formatting codes that starts with &
• Command supports:
  • any command that is available on the server
  • run as a console if it starts with [server]. example : [server] op [player]
  • getting a username for a player with [player]. example: [server] kill [player]
  • getting BentoBox GameMode starting command with [label]. example: [label] challenges
• Ability to define multiple control panels:
  • Users will access to ControlPanel with permission that they have: [gamemode].controlpanel.panel.[suffix]
• Has english, latvian, spanish and franch translations.

Release 1.16.1

🎁 What's new

ControlPanel 1.16.1 fixes the most-reported annoyance with the addon: editing controlPanelTemplate.yml and running bbox reload did nothing. Panels live in BentoBox's database and the template was only ever a one-time seed, so template edits were silently ignored unless you ran the confirmation-gated cp import command. Reload now re-imports the template, and the template file name is configurable.

This release also drops the minimum BentoBox version from 3.10.0 back to 2.7.1. 1.16.0 shipped with an api-version of 3.10.0 even though nothing in the code needed it, which made BentoBox refuse to load the addon (INCOMPATIBLE) on servers that can't run BentoBox 3.10+ — notably Minecraft 1.21.4 servers, which top out at BentoBox 3.7.4. Those servers can now use the current ControlPanel again.

✨ Highlights

🔺 ⚙️ bbox reload re-imports the template (#41)

• bbox reload now wipes each active game mode's stored panels and re-imports them from the template file, so template edits take effect without cp import.
• Because the reload wipes first, panels you removed from the template also disappear instead of lingering in the database.
• New template-file option in config.yml (default controlPanelTemplate.yml). Reload, importControlPanels and the admin import command all honour it, so you can point the addon at your own file.

🔺 Minimum BentoBox version lowered to 2.7.1

• addon.ymlapi-version is now 2.7.1 (was 3.10.0). The addon is still built against BentoBox 3.10.0 / Paper 1.21.11, but it uses no API newer than 2.7.1.
• Verified against BentoBox 3.7.4 and 3.8.1 on Paper 1.21.4: no missing classes, methods or fields.

🔡 Locales

• Updated Traditional Chinese (zh-TW.yml) translations, thanks to @qwe664 (#43).

🛠 Housekeeping

• CurseForge and Hangar publishing now run from GitHub Actions on release, using the jar attached to the release (#38, #39, #40, #42).

⚙️ Compatibility

✔️ BentoBox 2.7.1 or later (verified with 3.7.4 on Minecraft 1.21.4)
✔️ Minecraft 1.21.4 – 26.2
✔️ Java 21

🔺 Updating — important notes

🔺 Reload now overwrites stored panels. The panels in the database are replaced by the template on every bbox reload. If you have been relying on database-only panel changes (anything not in controlPanelTemplate.yml), put them in the template before updating or they will be lost on the next reload.

⚙️ New config key.template-file is added to config.yml with the default controlPanelTemplate.yml; existing installs keep working with no changes.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Drop the new jar into the addons folder and remove the old one
4. Start the server

Legend

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

What's Changed

• 🔺 ⚙️ Reload re-imports control panels from the template file by @tastybento in #41
• 🔺 Lower minimum BentoBox version to 2.7.1 and bump to 1.16.1 by @tastybento in ef9c192
• 🔡 Update Chinese translations in zh-TW.yml by @qwe664 in #43
• Add CurseForge publish workflow (publishes the release asset) by @tastybento in #38
• ci: bump pinned reusable workflow to fe4b1f0 by @tastybento in #39
• ci: bump pinned publish-platforms.yml to ca2dcd1 by @tastybento in #40
• ci: bump publish-platforms pin to the multipart-JSON fix by @tastybento in #42

Full Changelog: 1.16.0...1.16.1

Release 1.16.0

Highlights

• Right-click & shift-click command support — Panel buttons can now trigger different commands based on click type (left-click, right-click, shift-click), giving server admins much more flexibility in their control panel layouts.
• ItemsAdder integration — Buttons can now use custom ItemsAdder items as icons, enabling richer visual customization.
• Multi-slot button support — Buttons can now span multiple inventory slots using range syntax (e.g., 1-3), simplifying panel configuration.
• Java 21 & Minecraft 1.21 — Upgraded to Java 21 and the latest Paper/BentoBox APIs.

Updating

Compatibility

✔️ BentoBox API 3.10.0
✔️ Minecraft 1.21
✔️ Java 21

Changelog

Legend

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

⚙️ New config options: right_click_command and shift_click_command for panel buttons.

What's Changed

• Add ItemsAdder support and general code improvements by @K0bus in #33
• Add JUnit 5 test suite (97 tests) by @tastybento in #34
• Add right-click and shift-click command support for panel buttons in #35

Full Changelog: 1.14.0...1.16.0

Release 1.14.0

Updating

Compatibility

✔️ BentoBox API 2.7.1
✔️ Minecraft 1.21.3
✔️ Java 17

Changelog

Legend

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

What's Changed

• Version 1.14.0 by @tastybento in #32

Full Changelog: 1.13.1...1.14.0

Release 1.13.1

This release just adds or updates language files for Chinese, French, German, Polish, Russian, Hong Kong, and Indonesian.

Updating

1. Stop the server
2. Copy this addon into the BentoBox/addons folder
3. (Optional) Delete or move the BentoBox/locales/ControlPanel folder so that updated files will be generated
4. Restart the server
5. You should be good to go!

Compatibility

✔️ BentoBox API 2.0.0
✔️ Minecraft 1.20.4
✔️ Java 17

Changelog

Legend

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

What's Changed

• 🔡 Create zh-CN.yml by @katorly in #20
• 🔡 French translation by @gitlocalize-app in #22
• 🔡 Polish translation by @gitlocalize-app in #23
• 🔡 Update DE by @gitlocalize-app in #26
• 🔡 Update RU by @gitlocalize-app in #27
• 🔡 Add locale of Chinese-Hong Kong (zh-HK) by @JamesMCL44 in #29
• 🔡 Added Bahasa Indonesia by @DustyGanteng in #30

New Contributors

• @katorly made their first contribution in #20
• @JamesMCL44 made their first contribution in #29
• @DustyGanteng made their first contribution in #30

Full Changelog: 1.13.0...1.13.1

Release 1.13.0

Compatibility

✔️ BentoBox API 1.14.0
✔️ Minecraft 1.15.2

Changelog

Legend

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

New Features

• Translate de.yml via GitLocalize (commit: 35a5880)
• Czech translation. Credit @Polda18 (commit: bf92abe)
• Implement auto-importing on first startup all control panels. (commit: 51329a3)
• Translate ko.yml via GitLocalize (commit: 83b5976)
• Translate zh-TW.yml via GitLocalize (commit: 1d75e1d)
• Various bug fixes

ControlPanel 1.7.0

This is a pretty basic control panel that allows configuring custom GUI that is accessible from /[gamemode] cp command. It contains the same features as it was in ASkyBlock, but in extra with better description customization (supports placeholders), and ability to define multiple control panels which can be changed by adding or removing permission to a player.

Compatibility

✔️ BentoBox API 1.7.0
✔️ Minecraft 1.14.5

Changelog

Legend

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

New Features

• Ability to define ControlPanel item:
  • Item slot in GUI
  • Item icon in GUI
  • Item lore description in GUI
  • Command that will be triggered when a player clicks on an item.
• Description supports:
  • placeholders that start and ends with %
  • new line element that is represented with |
  • Minecraft color and formatting codes that starts with &
• Command supports:
  • any command that is available on the server
  • run as a console if it starts with [server]. example : [server] op [player]
  • getting a username for a player with [player]. example: [server] kill [player]
  • getting BentoBox GameMode starting command with [label]. example: [label] challenges
• Ability to define multiple control panels:
  • Users will access to ControlPanel with permission that they have: [gamemode].controlpanel.panel.[suffix]
• Has english, latvian, spanish and franch translations.

Release 1.16.1

🎁 What's new

ControlPanel 1.16.1 fixes the most-reported annoyance with the addon: editing controlPanelTemplate.yml and running bbox reload did nothing. Panels live in BentoBox's database and the template was only ever a one-time seed, so template edits were silently ignored unless you ran the confirmation-gated cp import command. Reload now re-imports the template, and the template file name is configurable.

This release also drops the minimum BentoBox version from 3.10.0 back to 2.7.1. 1.16.0 shipped with an api-version of 3.10.0 even though nothing in the code needed it, which made BentoBox refuse to load the addon (INCOMPATIBLE) on servers that can't run BentoBox 3.10+ — notably Minecraft 1.21.4 servers, which top out at BentoBox 3.7.4. Those servers can now use the current ControlPanel again.

✨ Highlights

🔺 ⚙️ bbox reload re-imports the template (#41)

• bbox reload now wipes each active game mode's stored panels and re-imports them from the template file, so template edits take effect without cp import.
• Because the reload wipes first, panels you removed from the template also disappear instead of lingering in the database.
• New template-file option in config.yml (default controlPanelTemplate.yml). Reload, importControlPanels and the admin import command all honour it, so you can point the addon at your own file.

🔺 Minimum BentoBox version lowered to 2.7.1

• addon.ymlapi-version is now 2.7.1 (was 3.10.0). The addon is still built against BentoBox 3.10.0 / Paper 1.21.11, but it uses no API newer than 2.7.1.
• Verified against BentoBox 3.7.4 and 3.8.1 on Paper 1.21.4: no missing classes, methods or fields.

🔡 Locales

• Updated Traditional Chinese (zh-TW.yml) translations, thanks to @qwe664 (#43).

🛠 Housekeeping

• CurseForge and Hangar publishing now run from GitHub Actions on release, using the jar attached to the release (#38, #39, #40, #42).

⚙️ Compatibility

✔️ BentoBox 2.7.1 or later (verified with 3.7.4 on Minecraft 1.21.4)
✔️ Minecraft 1.21.4 – 26.2
✔️ Java 21

🔺 Updating — important notes

🔺 Reload now overwrites stored panels. The panels in the database are replaced by the template on every bbox reload. If you have been relying on database-only panel changes (anything not in controlPanelTemplate.yml), put them in the template before updating or they will be lost on the next reload.

⚙️ New config key.template-file is added to config.yml with the default controlPanelTemplate.yml; existing installs keep working with no changes.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Drop the new jar into the addons folder and remove the old one
4. Start the server

Legend

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

What's Changed

• 🔺 ⚙️ Reload re-imports control panels from the template file by @tastybento in #41
• 🔺 Lower minimum BentoBox version to 2.7.1 and bump to 1.16.1 by @tastybento in ef9c192
• 🔡 Update Chinese translations in zh-TW.yml by @qwe664 in #43
• Add CurseForge publish workflow (publishes the release asset) by @tastybento in #38
• ci: bump pinned reusable workflow to fe4b1f0 by @tastybento in #39
• ci: bump pinned publish-platforms.yml to ca2dcd1 by @tastybento in #40
• ci: bump publish-platforms pin to the multipart-JSON fix by @tastybento in #42

Full Changelog: 1.16.0...1.16.1

Release 1.16.0

Highlights

• Right-click & shift-click command support — Panel buttons can now trigger different commands based on click type (left-click, right-click, shift-click), giving server admins much more flexibility in their control panel layouts.
• ItemsAdder integration — Buttons can now use custom ItemsAdder items as icons, enabling richer visual customization.
• Multi-slot button support — Buttons can now span multiple inventory slots using range syntax (e.g., 1-3), simplifying panel configuration.
• Java 21 & Minecraft 1.21 — Upgraded to Java 21 and the latest Paper/BentoBox APIs.

Updating

Compatibility

✔️ BentoBox API 3.10.0
✔️ Minecraft 1.21
✔️ Java 21

Changelog

Legend

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

⚙️ New config options: right_click_command and shift_click_command for panel buttons.

What's Changed

• Add ItemsAdder support and general code improvements by @K0bus in #33
• Add JUnit 5 test suite (97 tests) by @tastybento in #34
• Add right-click and shift-click command support for panel buttons in #35

Full Changelog: 1.14.0...1.16.0

Release 1.14.0

Updating

Compatibility

✔️ BentoBox API 2.7.1
✔️ Minecraft 1.21.3
✔️ Java 17

Changelog

Legend

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

What's Changed

• Version 1.14.0 by @tastybento in #32

Full Changelog: 1.13.1...1.14.0

Release 1.13.1

This release just adds or updates language files for Chinese, French, German, Polish, Russian, Hong Kong, and Indonesian.

Updating

1. Stop the server
2. Copy this addon into the BentoBox/addons folder
3. (Optional) Delete or move the BentoBox/locales/ControlPanel folder so that updated files will be generated
4. Restart the server
5. You should be good to go!

Compatibility

✔️ BentoBox API 2.0.0
✔️ Minecraft 1.20.4
✔️ Java 17

Changelog

Legend

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

What's Changed

• 🔡 Create zh-CN.yml by @katorly in #20
• 🔡 French translation by @gitlocalize-app in #22
• 🔡 Polish translation by @gitlocalize-app in #23
• 🔡 Update DE by @gitlocalize-app in #26
• 🔡 Update RU by @gitlocalize-app in #27
• 🔡 Add locale of Chinese-Hong Kong (zh-HK) by @JamesMCL44 in #29
• 🔡 Added Bahasa Indonesia by @DustyGanteng in #30

New Contributors

• @katorly made their first contribution in #20
• @JamesMCL44 made their first contribution in #29
• @DustyGanteng made their first contribution in #30

Full Changelog: 1.13.0...1.13.1

Release 1.13.0

Compatibility

✔️ BentoBox API 1.14.0
✔️ Minecraft 1.15.2

Changelog

Legend

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

New Features

• Translate de.yml via GitLocalize (commit: 35a5880)
• Czech translation. Credit @Polda18 (commit: bf92abe)
• Implement auto-importing on first startup all control panels. (commit: 51329a3)
• Translate ko.yml via GitLocalize (commit: 83b5976)
• Translate zh-TW.yml via GitLocalize (commit: 1d75e1d)
• Various bug fixes

ControlPanel 1.7.0

This is a pretty basic control panel that allows configuring custom GUI that is accessible from /[gamemode] cp command. It contains the same features as it was in ASkyBlock, but in extra with better description customization (supports placeholders), and ability to define multiple control panels which can be changed by adding or removing permission to a player.

Compatibility

✔️ BentoBox API 1.7.0
✔️ Minecraft 1.14.5

Changelog

Legend

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

New Features

• Ability to define ControlPanel item:
  • Item slot in GUI
  • Item icon in GUI
  • Item lore description in GUI
  • Command that will be triggered when a player clicks on an item.
• Description supports:
  • placeholders that start and ends with %
  • new line element that is represented with |
  • Minecraft color and formatting codes that starts with &
• Command supports:
  • any command that is available on the server
  • run as a console if it starts with [server]. example : [server] op [player]
  • getting a username for a player with [player]. example: [server] kill [player]
  • getting BentoBox GameMode starting command with [label]. example: [label] challenges
• Ability to define multiple control panels:
  • Users will access to ControlPanel with permission that they have: [gamemode].controlpanel.panel.[suffix]
• Has english, latvian, spanish and franch translations.

Release 1.16.1

🎁 What's new

ControlPanel 1.16.1 fixes the most-reported annoyance with the addon: editing controlPanelTemplate.yml and running bbox reload did nothing. Panels live in BentoBox's database and the template was only ever a one-time seed, so template edits were silently ignored unless you ran the confirmation-gated cp import command. Reload now re-imports the template, and the template file name is configurable.

This release also drops the minimum BentoBox version from 3.10.0 back to 2.7.1. 1.16.0 shipped with an api-version of 3.10.0 even though nothing in the code needed it, which made BentoBox refuse to load the addon (INCOMPATIBLE) on servers that can't run BentoBox 3.10+ — notably Minecraft 1.21.4 servers, which top out at BentoBox 3.7.4. Those servers can now use the current ControlPanel again.

✨ Highlights

🔺 ⚙️ bbox reload re-imports the template (#41)

• bbox reload now wipes each active game mode's stored panels and re-imports them from the template file, so template edits take effect without cp import.
• Because the reload wipes first, panels you removed from the template also disappear instead of lingering in the database.
• New template-file option in config.yml (default controlPanelTemplate.yml). Reload, importControlPanels and the admin import command all honour it, so you can point the addon at your own file.

🔺 Minimum BentoBox version lowered to 2.7.1

• addon.ymlapi-version is now 2.7.1 (was 3.10.0). The addon is still built against BentoBox 3.10.0 / Paper 1.21.11, but it uses no API newer than 2.7.1.
• Verified against BentoBox 3.7.4 and 3.8.1 on Paper 1.21.4: no missing classes, methods or fields.

🔡 Locales

• Updated Traditional Chinese (zh-TW.yml) translations, thanks to @qwe664 (#43).

🛠 Housekeeping

• CurseForge and Hangar publishing now run from GitHub Actions on release, using the jar attached to the release (#38, #39, #40, #42).

⚙️ Compatibility

✔️ BentoBox 2.7.1 or later (verified with 3.7.4 on Minecraft 1.21.4)
✔️ Minecraft 1.21.4 – 26.2
✔️ Java 21

🔺 Updating — important notes

🔺 Reload now overwrites stored panels. The panels in the database are replaced by the template on every bbox reload. If you have been relying on database-only panel changes (anything not in controlPanelTemplate.yml), put them in the template before updating or they will be lost on the next reload.

⚙️ New config key.template-file is added to config.yml with the default controlPanelTemplate.yml; existing installs keep working with no changes.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Drop the new jar into the addons folder and remove the old one
4. Start the server

Legend

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

What's Changed

• 🔺 ⚙️ Reload re-imports control panels from the template file by @tastybento in #41
• 🔺 Lower minimum BentoBox version to 2.7.1 and bump to 1.16.1 by @tastybento in ef9c192
• 🔡 Update Chinese translations in zh-TW.yml by @qwe664 in #43
• Add CurseForge publish workflow (publishes the release asset) by @tastybento in #38
• ci: bump pinned reusable workflow to fe4b1f0 by @tastybento in #39
• ci: bump pinned publish-platforms.yml to ca2dcd1 by @tastybento in #40
• ci: bump publish-platforms pin to the multipart-JSON fix by @tastybento in #42

Full Changelog: 1.16.0...1.16.1

Release 1.16.0

Highlights

• Right-click & shift-click command support — Panel buttons can now trigger different commands based on click type (left-click, right-click, shift-click), giving server admins much more flexibility in their control panel layouts.
• ItemsAdder integration — Buttons can now use custom ItemsAdder items as icons, enabling richer visual customization.
• Multi-slot button support — Buttons can now span multiple inventory slots using range syntax (e.g., 1-3), simplifying panel configuration.
• Java 21 & Minecraft 1.21 — Upgraded to Java 21 and the latest Paper/BentoBox APIs.

Updating

Compatibility

✔️ BentoBox API 3.10.0
✔️ Minecraft 1.21
✔️ Java 21

Changelog

Legend

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

⚙️ New config options: right_click_command and shift_click_command for panel buttons.

What's Changed

• Add ItemsAdder support and general code improvements by @K0bus in #33
• Add JUnit 5 test suite (97 tests) by @tastybento in #34
• Add right-click and shift-click command support for panel buttons in #35

Full Changelog: 1.14.0...1.16.0

Release 1.14.0

Updating

Compatibility

✔️ BentoBox API 2.7.1
✔️ Minecraft 1.21.3
✔️ Java 17

Changelog

Legend

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

What's Changed

• Version 1.14.0 by @tastybento in #32

Full Changelog: 1.13.1...1.14.0

Release 1.13.1

This release just adds or updates language files for Chinese, French, German, Polish, Russian, Hong Kong, and Indonesian.

Updating

1. Stop the server
2. Copy this addon into the BentoBox/addons folder
3. (Optional) Delete or move the BentoBox/locales/ControlPanel folder so that updated files will be generated
4. Restart the server
5. You should be good to go!

Compatibility

✔️ BentoBox API 2.0.0
✔️ Minecraft 1.20.4
✔️ Java 17

Changelog

Legend

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

What's Changed

• 🔡 Create zh-CN.yml by @katorly in #20
• 🔡 French translation by @gitlocalize-app in #22
• 🔡 Polish translation by @gitlocalize-app in #23
• 🔡 Update DE by @gitlocalize-app in #26
• 🔡 Update RU by @gitlocalize-app in #27
• 🔡 Add locale of Chinese-Hong Kong (zh-HK) by @JamesMCL44 in #29
• 🔡 Added Bahasa Indonesia by @DustyGanteng in #30

New Contributors

• @katorly made their first contribution in #20
• @JamesMCL44 made their first contribution in #29
• @DustyGanteng made their first contribution in #30

Full Changelog: 1.13.0...1.13.1

Release 1.13.0

Compatibility

✔️ BentoBox API 1.14.0
✔️ Minecraft 1.15.2

Changelog

Legend

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

New Features

• Translate de.yml via GitLocalize (commit: 35a5880)
• Czech translation. Credit @Polda18 (commit: bf92abe)
• Implement auto-importing on first startup all control panels. (commit: 51329a3)
• Translate ko.yml via GitLocalize (commit: 83b5976)
• Translate zh-TW.yml via GitLocalize (commit: 1d75e1d)
• Various bug fixes

ControlPanel 1.7.0

This is a pretty basic control panel that allows configuring custom GUI that is accessible from /[gamemode] cp command. It contains the same features as it was in ASkyBlock, but in extra with better description customization (supports placeholders), and ability to define multiple control panels which can be changed by adding or removing permission to a player.

Compatibility

✔️ BentoBox API 1.7.0
✔️ Minecraft 1.14.5

Changelog

Legend

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

New Features

• Ability to define ControlPanel item:
  • Item slot in GUI
  • Item icon in GUI
  • Item lore description in GUI
  • Command that will be triggered when a player clicks on an item.
• Description supports:
  • placeholders that start and ends with %
  • new line element that is represented with |
  • Minecraft color and formatting codes that starts with &
• Command supports:
  • any command that is available on the server
  • run as a console if it starts with [server]. example : [server] op [player]
  • getting a username for a player with [player]. example: [server] kill [player]
  • getting BentoBox GameMode starting command with [label]. example: [label] challenges
• Ability to define multiple control panels:
  • Users will access to ControlPanel with permission that they have: [gamemode].controlpanel.panel.[suffix]
• Has english, latvian, spanish and franch translations.

Release 1.16.1

🎁 What's new

ControlPanel 1.16.1 fixes the most-reported annoyance with the addon: editing controlPanelTemplate.yml and running bbox reload did nothing. Panels live in BentoBox's database and the template was only ever a one-time seed, so template edits were silently ignored unless you ran the confirmation-gated cp import command. Reload now re-imports the template, and the template file name is configurable.

This release also drops the minimum BentoBox version from 3.10.0 back to 2.7.1. 1.16.0 shipped with an api-version of 3.10.0 even though nothing in the code needed it, which made BentoBox refuse to load the addon (INCOMPATIBLE) on servers that can't run BentoBox 3.10+ — notably Minecraft 1.21.4 servers, which top out at BentoBox 3.7.4. Those servers can now use the current ControlPanel again.

✨ Highlights

🔺 ⚙️ bbox reload re-imports the template (#41)

• bbox reload now wipes each active game mode's stored panels and re-imports them from the template file, so template edits take effect without cp import.
• Because the reload wipes first, panels you removed from the template also disappear instead of lingering in the database.
• New template-file option in config.yml (default controlPanelTemplate.yml). Reload, importControlPanels and the admin import command all honour it, so you can point the addon at your own file.

🔺 Minimum BentoBox version lowered to 2.7.1

• addon.ymlapi-version is now 2.7.1 (was 3.10.0). The addon is still built against BentoBox 3.10.0 / Paper 1.21.11, but it uses no API newer than 2.7.1.
• Verified against BentoBox 3.7.4 and 3.8.1 on Paper 1.21.4: no missing classes, methods or fields.

🔡 Locales

• Updated Traditional Chinese (zh-TW.yml) translations, thanks to @qwe664 (#43).

🛠 Housekeeping

• CurseForge and Hangar publishing now run from GitHub Actions on release, using the jar attached to the release (#38, #39, #40, #42).

⚙️ Compatibility

✔️ BentoBox 2.7.1 or later (verified with 3.7.4 on Minecraft 1.21.4)
✔️ Minecraft 1.21.4 – 26.2
✔️ Java 21

🔺 Updating — important notes

🔺 Reload now overwrites stored panels. The panels in the database are replaced by the template on every bbox reload. If you have been relying on database-only panel changes (anything not in controlPanelTemplate.yml), put them in the template before updating or they will be lost on the next reload.

⚙️ New config key.template-file is added to config.yml with the default controlPanelTemplate.yml; existing installs keep working with no changes.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Drop the new jar into the addons folder and remove the old one
4. Start the server

Legend

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

What's Changed

• 🔺 ⚙️ Reload re-imports control panels from the template file by @tastybento in #41
• 🔺 Lower minimum BentoBox version to 2.7.1 and bump to 1.16.1 by @tastybento in ef9c192
• 🔡 Update Chinese translations in zh-TW.yml by @qwe664 in #43
• Add CurseForge publish workflow (publishes the release asset) by @tastybento in #38
• ci: bump pinned reusable workflow to fe4b1f0 by @tastybento in #39
• ci: bump pinned publish-platforms.yml to ca2dcd1 by @tastybento in #40
• ci: bump publish-platforms pin to the multipart-JSON fix by @tastybento in #42

Full Changelog: 1.16.0...1.16.1

Release 1.16.0

Highlights

• Right-click & shift-click command support — Panel buttons can now trigger different commands based on click type (left-click, right-click, shift-click), giving server admins much more flexibility in their control panel layouts.
• ItemsAdder integration — Buttons can now use custom ItemsAdder items as icons, enabling richer visual customization.
• Multi-slot button support — Buttons can now span multiple inventory slots using range syntax (e.g., 1-3), simplifying panel configuration.
• Java 21 & Minecraft 1.21 — Upgraded to Java 21 and the latest Paper/BentoBox APIs.

Updating

Compatibility

✔️ BentoBox API 3.10.0
✔️ Minecraft 1.21
✔️ Java 21

Changelog

Legend

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

⚙️ New config options: right_click_command and shift_click_command for panel buttons.

What's Changed

• Add ItemsAdder support and general code improvements by @K0bus in #33
• Add JUnit 5 test suite (97 tests) by @tastybento in #34
• Add right-click and shift-click command support for panel buttons in #35

Full Changelog: 1.14.0...1.16.0

Release 1.14.0

Updating

Compatibility

✔️ BentoBox API 2.7.1
✔️ Minecraft 1.21.3
✔️ Java 17

Changelog

Legend

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

What's Changed

• Version 1.14.0 by @tastybento in #32

Full Changelog: 1.13.1...1.14.0

Release 1.13.1

This release just adds or updates language files for Chinese, French, German, Polish, Russian, Hong Kong, and Indonesian.

Updating

1. Stop the server
2. Copy this addon into the BentoBox/addons folder
3. (Optional) Delete or move the BentoBox/locales/ControlPanel folder so that updated files will be generated
4. Restart the server
5. You should be good to go!

Compatibility

✔️ BentoBox API 2.0.0
✔️ Minecraft 1.20.4
✔️ Java 17

Changelog

Legend

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

What's Changed

• 🔡 Create zh-CN.yml by @katorly in #20
• 🔡 French translation by @gitlocalize-app in #22
• 🔡 Polish translation by @gitlocalize-app in #23
• 🔡 Update DE by @gitlocalize-app in #26
• 🔡 Update RU by @gitlocalize-app in #27
• 🔡 Add locale of Chinese-Hong Kong (zh-HK) by @JamesMCL44 in #29
• 🔡 Added Bahasa Indonesia by @DustyGanteng in #30

New Contributors

• @katorly made their first contribution in #20
• @JamesMCL44 made their first contribution in #29
• @DustyGanteng made their first contribution in #30

Full Changelog: 1.13.0...1.13.1

Release 1.13.0

Compatibility

✔️ BentoBox API 1.14.0
✔️ Minecraft 1.15.2

Changelog

Legend

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

New Features

• Translate de.yml via GitLocalize (commit: 35a5880)
• Czech translation. Credit @Polda18 (commit: bf92abe)
• Implement auto-importing on first startup all control panels. (commit: 51329a3)
• Translate ko.yml via GitLocalize (commit: 83b5976)
• Translate zh-TW.yml via GitLocalize (commit: 1d75e1d)
• Various bug fixes

ControlPanel 1.7.0

This is a pretty basic control panel that allows configuring custom GUI that is accessible from /[gamemode] cp command. It contains the same features as it was in ASkyBlock, but in extra with better description customization (supports placeholders), and ability to define multiple control panels which can be changed by adding or removing permission to a player.

Compatibility

✔️ BentoBox API 1.7.0
✔️ Minecraft 1.14.5

Changelog

Legend

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

New Features

• Ability to define ControlPanel item:
  • Item slot in GUI
  • Item icon in GUI
  • Item lore description in GUI
  • Command that will be triggered when a player clicks on an item.
• Description supports:
  • placeholders that start and ends with %
  • new line element that is represented with |
  • Minecraft color and formatting codes that starts with &
• Command supports:
  • any command that is available on the server
  • run as a console if it starts with [server]. example : [server] op [player]
  • getting a username for a player with [player]. example: [server] kill [player]
  • getting BentoBox GameMode starting command with [label]. example: [label] challenges
• Ability to define multiple control panels:
  • Users will access to ControlPanel with permission that they have: [gamemode].controlpanel.panel.[suffix]
• Has english, latvian, spanish and franch translations.

Release 1.16.1

🎁 What's new

ControlPanel 1.16.1 fixes the most-reported annoyance with the addon: editing controlPanelTemplate.yml and running bbox reload did nothing. Panels live in BentoBox's database and the template was only ever a one-time seed, so template edits were silently ignored unless you ran the confirmation-gated cp import command. Reload now re-imports the template, and the template file name is configurable.

This release also drops the minimum BentoBox version from 3.10.0 back to 2.7.1. 1.16.0 shipped with an api-version of 3.10.0 even though nothing in the code needed it, which made BentoBox refuse to load the addon (INCOMPATIBLE) on servers that can't run BentoBox 3.10+ — notably Minecraft 1.21.4 servers, which top out at BentoBox 3.7.4. Those servers can now use the current ControlPanel again.

✨ Highlights

🔺 ⚙️ bbox reload re-imports the template (#41)

• bbox reload now wipes each active game mode's stored panels and re-imports them from the template file, so template edits take effect without cp import.
• Because the reload wipes first, panels you removed from the template also disappear instead of lingering in the database.
• New template-file option in config.yml (default controlPanelTemplate.yml). Reload, importControlPanels and the admin import command all honour it, so you can point the addon at your own file.

🔺 Minimum BentoBox version lowered to 2.7.1

• addon.ymlapi-version is now 2.7.1 (was 3.10.0). The addon is still built against BentoBox 3.10.0 / Paper 1.21.11, but it uses no API newer than 2.7.1.
• Verified against BentoBox 3.7.4 and 3.8.1 on Paper 1.21.4: no missing classes, methods or fields.

🔡 Locales

• Updated Traditional Chinese (zh-TW.yml) translations, thanks to @qwe664 (#43).

🛠 Housekeeping

• CurseForge and Hangar publishing now run from GitHub Actions on release, using the jar attached to the release (#38, #39, #40, #42).

⚙️ Compatibility

✔️ BentoBox 2.7.1 or later (verified with 3.7.4 on Minecraft 1.21.4)
✔️ Minecraft 1.21.4 – 26.2
✔️ Java 21

🔺 Updating — important notes

🔺 Reload now overwrites stored panels. The panels in the database are replaced by the template on every bbox reload. If you have been relying on database-only panel changes (anything not in controlPanelTemplate.yml), put them in the template before updating or they will be lost on the next reload.

⚙️ New config key.template-file is added to config.yml with the default controlPanelTemplate.yml; existing installs keep working with no changes.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Drop the new jar into the addons folder and remove the old one
4. Start the server

Legend

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

What's Changed

• 🔺 ⚙️ Reload re-imports control panels from the template file by @tastybento in #41
• 🔺 Lower minimum BentoBox version to 2.7.1 and bump to 1.16.1 by @tastybento in ef9c192
• 🔡 Update Chinese translations in zh-TW.yml by @qwe664 in #43
• Add CurseForge publish workflow (publishes the release asset) by @tastybento in #38
• ci: bump pinned reusable workflow to fe4b1f0 by @tastybento in #39
• ci: bump pinned publish-platforms.yml to ca2dcd1 by @tastybento in #40
• ci: bump publish-platforms pin to the multipart-JSON fix by @tastybento in #42

Full Changelog: 1.16.0...1.16.1

Release 1.16.0

Highlights

• Right-click & shift-click command support — Panel buttons can now trigger different commands based on click type (left-click, right-click, shift-click), giving server admins much more flexibility in their control panel layouts.
• ItemsAdder integration — Buttons can now use custom ItemsAdder items as icons, enabling richer visual customization.
• Multi-slot button support — Buttons can now span multiple inventory slots using range syntax (e.g., 1-3), simplifying panel configuration.
• Java 21 & Minecraft 1.21 — Upgraded to Java 21 and the latest Paper/BentoBox APIs.

Updating

Compatibility

✔️ BentoBox API 3.10.0
✔️ Minecraft 1.21
✔️ Java 21

Changelog

Legend

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

⚙️ New config options: right_click_command and shift_click_command for panel buttons.

What's Changed

• Add ItemsAdder support and general code improvements by @K0bus in #33
• Add JUnit 5 test suite (97 tests) by @tastybento in #34
• Add right-click and shift-click command support for panel buttons in #35

Full Changelog: 1.14.0...1.16.0

Release 1.14.0

Updating

Compatibility

✔️ BentoBox API 2.7.1
✔️ Minecraft 1.21.3
✔️ Java 17

Changelog

Legend

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

What's Changed

• Version 1.14.0 by @tastybento in #32

Full Changelog: 1.13.1...1.14.0

Release 1.13.1

This release just adds or updates language files for Chinese, French, German, Polish, Russian, Hong Kong, and Indonesian.

Updating

1. Stop the server
2. Copy this addon into the BentoBox/addons folder
3. (Optional) Delete or move the BentoBox/locales/ControlPanel folder so that updated files will be generated
4. Restart the server
5. You should be good to go!

Compatibility

✔️ BentoBox API 2.0.0
✔️ Minecraft 1.20.4
✔️ Java 17

Changelog

Legend

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

What's Changed

• 🔡 Create zh-CN.yml by @katorly in #20
• 🔡 French translation by @gitlocalize-app in #22
• 🔡 Polish translation by @gitlocalize-app in #23
• 🔡 Update DE by @gitlocalize-app in #26
• 🔡 Update RU by @gitlocalize-app in #27
• 🔡 Add locale of Chinese-Hong Kong (zh-HK) by @JamesMCL44 in #29
• 🔡 Added Bahasa Indonesia by @DustyGanteng in #30

New Contributors

• @katorly made their first contribution in #20
• @JamesMCL44 made their first contribution in #29
• @DustyGanteng made their first contribution in #30

Full Changelog: 1.13.0...1.13.1

Release 1.13.0

Compatibility

✔️ BentoBox API 1.14.0
✔️ Minecraft 1.15.2

Changelog

Legend

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

New Features

• Translate de.yml via GitLocalize (commit: 35a5880)
• Czech translation. Credit @Polda18 (commit: bf92abe)
• Implement auto-importing on first startup all control panels. (commit: 51329a3)
• Translate ko.yml via GitLocalize (commit: 83b5976)
• Translate zh-TW.yml via GitLocalize (commit: 1d75e1d)
• Various bug fixes

ControlPanel 1.7.0

This is a pretty basic control panel that allows configuring custom GUI that is accessible from /[gamemode] cp command. It contains the same features as it was in ASkyBlock, but in extra with better description customization (supports placeholders), and ability to define multiple control panels which can be changed by adding or removing permission to a player.

Compatibility

✔️ BentoBox API 1.7.0
✔️ Minecraft 1.14.5

Changelog

Legend

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

New Features

• Ability to define ControlPanel item:
  • Item slot in GUI
  • Item icon in GUI
  • Item lore description in GUI
  • Command that will be triggered when a player clicks on an item.
• Description supports:
  • placeholders that start and ends with %
  • new line element that is represented with |
  • Minecraft color and formatting codes that starts with &
• Command supports:
  • any command that is available on the server
  • run as a console if it starts with [server]. example : [server] op [player]
  • getting a username for a player with [player]. example: [server] kill [player]
  • getting BentoBox GameMode starting command with [label]. example: [label] challenges
• Ability to define multiple control panels:
  • Users will access to ControlPanel with permission that they have: [gamemode].controlpanel.panel.[suffix]
• Has english, latvian, spanish and franch translations.

Release 1.16.1

🎁 What's new

ControlPanel 1.16.1 fixes the most-reported annoyance with the addon: editing controlPanelTemplate.yml and running bbox reload did nothing. Panels live in BentoBox's database and the template was only ever a one-time seed, so template edits were silently ignored unless you ran the confirmation-gated cp import command. Reload now re-imports the template, and the template file name is configurable.

This release also drops the minimum BentoBox version from 3.10.0 back to 2.7.1. 1.16.0 shipped with an api-version of 3.10.0 even though nothing in the code needed it, which made BentoBox refuse to load the addon (INCOMPATIBLE) on servers that can't run BentoBox 3.10+ — notably Minecraft 1.21.4 servers, which top out at BentoBox 3.7.4. Those servers can now use the current ControlPanel again.

✨ Highlights

🔺 ⚙️ bbox reload re-imports the template (#41)

• bbox reload now wipes each active game mode's stored panels and re-imports them from the template file, so template edits take effect without cp import.
• Because the reload wipes first, panels you removed from the template also disappear instead of lingering in the database.
• New template-file option in config.yml (default controlPanelTemplate.yml). Reload, importControlPanels and the admin import command all honour it, so you can point the addon at your own file.

🔺 Minimum BentoBox version lowered to 2.7.1

• addon.ymlapi-version is now 2.7.1 (was 3.10.0). The addon is still built against BentoBox 3.10.0 / Paper 1.21.11, but it uses no API newer than 2.7.1.
• Verified against BentoBox 3.7.4 and 3.8.1 on Paper 1.21.4: no missing classes, methods or fields.

🔡 Locales

• Updated Traditional Chinese (zh-TW.yml) translations, thanks to @qwe664 (#43).

🛠 Housekeeping

• CurseForge and Hangar publishing now run from GitHub Actions on release, using the jar attached to the release (#38, #39, #40, #42).

⚙️ Compatibility

✔️ BentoBox 2.7.1 or later (verified with 3.7.4 on Minecraft 1.21.4)
✔️ Minecraft 1.21.4 – 26.2
✔️ Java 21

🔺 Updating — important notes

🔺 Reload now overwrites stored panels. The panels in the database are replaced by the template on every bbox reload. If you have been relying on database-only panel changes (anything not in controlPanelTemplate.yml), put them in the template before updating or they will be lost on the next reload.

⚙️ New config key.template-file is added to config.yml with the default controlPanelTemplate.yml; existing installs keep working with no changes.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Drop the new jar into the addons folder and remove the old one
4. Start the server

Legend

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

What's Changed

• 🔺 ⚙️ Reload re-imports control panels from the template file by @tastybento in #41
• 🔺 Lower minimum BentoBox version to 2.7.1 and bump to 1.16.1 by @tastybento in ef9c192
• 🔡 Update Chinese translations in zh-TW.yml by @qwe664 in #43
• Add CurseForge publish workflow (publishes the release asset) by @tastybento in #38
• ci: bump pinned reusable workflow to fe4b1f0 by @tastybento in #39
• ci: bump pinned publish-platforms.yml to ca2dcd1 by @tastybento in #40
• ci: bump publish-platforms pin to the multipart-JSON fix by @tastybento in #42

Full Changelog: 1.16.0...1.16.1

Release 1.16.0

Highlights

• Right-click & shift-click command support — Panel buttons can now trigger different commands based on click type (left-click, right-click, shift-click), giving server admins much more flexibility in their control panel layouts.
• ItemsAdder integration — Buttons can now use custom ItemsAdder items as icons, enabling richer visual customization.
• Multi-slot button support — Buttons can now span multiple inventory slots using range syntax (e.g., 1-3), simplifying panel configuration.
• Java 21 & Minecraft 1.21 — Upgraded to Java 21 and the latest Paper/BentoBox APIs.

Updating

Compatibility

✔️ BentoBox API 3.10.0
✔️ Minecraft 1.21
✔️ Java 21

Changelog

Legend

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

⚙️ New config options: right_click_command and shift_click_command for panel buttons.

What's Changed

• Add ItemsAdder support and general code improvements by @K0bus in #33
• Add JUnit 5 test suite (97 tests) by @tastybento in #34
• Add right-click and shift-click command support for panel buttons in #35

Full Changelog: 1.14.0...1.16.0

Release 1.14.0

Updating

Compatibility

✔️ BentoBox API 2.7.1
✔️ Minecraft 1.21.3
✔️ Java 17

Changelog

Legend

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

What's Changed

• Version 1.14.0 by @tastybento in #32

Full Changelog: 1.13.1...1.14.0

Release 1.13.1

This release just adds or updates language files for Chinese, French, German, Polish, Russian, Hong Kong, and Indonesian.

Updating

1. Stop the server
2. Copy this addon into the BentoBox/addons folder
3. (Optional) Delete or move the BentoBox/locales/ControlPanel folder so that updated files will be generated
4. Restart the server
5. You should be good to go!

Compatibility

✔️ BentoBox API 2.0.0
✔️ Minecraft 1.20.4
✔️ Java 17

Changelog

Legend

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

What's Changed

• 🔡 Create zh-CN.yml by @katorly in #20
• 🔡 French translation by @gitlocalize-app in #22
• 🔡 Polish translation by @gitlocalize-app in #23
• 🔡 Update DE by @gitlocalize-app in #26
• 🔡 Update RU by @gitlocalize-app in #27
• 🔡 Add locale of Chinese-Hong Kong (zh-HK) by @JamesMCL44 in #29
• 🔡 Added Bahasa Indonesia by @DustyGanteng in #30

New Contributors

• @katorly made their first contribution in #20
• @JamesMCL44 made their first contribution in #29
• @DustyGanteng made their first contribution in #30

Full Changelog: 1.13.0...1.13.1

Release 1.13.0

Compatibility

✔️ BentoBox API 1.14.0
✔️ Minecraft 1.15.2

Changelog

Legend

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

New Features

• Translate de.yml via GitLocalize (commit: 35a5880)
• Czech translation. Credit @Polda18 (commit: bf92abe)
• Implement auto-importing on first startup all control panels. (commit: 51329a3)
• Translate ko.yml via GitLocalize (commit: 83b5976)
• Translate zh-TW.yml via GitLocalize (commit: 1d75e1d)
• Various bug fixes

ControlPanel 1.7.0

This is a pretty basic control panel that allows configuring custom GUI that is accessible from /[gamemode] cp command. It contains the same features as it was in ASkyBlock, but in extra with better description customization (supports placeholders), and ability to define multiple control panels which can be changed by adding or removing permission to a player.

Compatibility

✔️ BentoBox API 1.7.0
✔️ Minecraft 1.14.5

Changelog

Legend

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

New Features

• Ability to define ControlPanel item:
  • Item slot in GUI
  • Item icon in GUI
  • Item lore description in GUI
  • Command that will be triggered when a player clicks on an item.
• Description supports:
  • placeholders that start and ends with %
  • new line element that is represented with |
  • Minecraft color and formatting codes that starts with &
• Command supports:
  • any command that is available on the server
  • run as a console if it starts with [server]. example : [server] op [player]
  • getting a username for a player with [player]. example: [server] kill [player]
  • getting BentoBox GameMode starting command with [label]. example: [label] challenges
• Ability to define multiple control panels:
  • Users will access to ControlPanel with permission that they have: [gamemode].controlpanel.panel.[suffix]
• Has english, latvian, spanish and franch translations.