Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for BentoboxWorld
Avatar for BentoboxWorld
BentoboxWorld /

Challenges-For-BentoBox

Customizable challenge system for all BentoBox game modes. Set goals, grant rewards, and drive player progression.

Report Challenges-For-BentoBox?

Release
1.8.0

tastybento released Challenges-For-BentoBox version 1.8.0 on Today 4:05 AM

Release Highlights

  • ✨ Optional reward chance β€” each challenge can now roll a configurable chance to actually grant its reward, so rewards can be made rare or gambled for.
  • πŸ’Ž Island level rewards β€” completing challenges (and levels) can raise the island level directly via the Level addon.
  • πŸ”‘ Biome requirement for island challenges β€” island challenges can require the player to be standing in one of a chosen set of biomes, picked from a new in-GUI biome selector.
  • πŸ”‘ βš™οΈ πŸ”Ί Toggleable undeployed challenges β€” the long-unimplemented TOGGLEABLE view mode now works: players get a button to show or hide undeployed challenges for themselves.
  • βš™οΈ Default text colour β€” set one colour for all challenge description / reward text instead of prefixing every challenge by hand.
  • πŸ“Š Completion-percentage placeholders β€” new placeholders for how far a player has progressed through the challenges.
  • πŸ”‘ βš™οΈ Open the GUI off-island β€” an option to let players open the Challenges GUI even when they aren't standing on their island.

Compatibility

βœ”οΈ BentoBox 3.14.0 βœ”οΈ Minecraft 1.21.x βœ”οΈ Java 21

Upgrading

  1. As always, take backups just in case. (Make a copy of everything!)
  2. Stop the server.
  3. Replace the Challenges jar with this one.
  4. Restart the server.
  5. Review the notes below if you use undeployed challenges, custom locales, or a customised main panel.
  6. You should be good to go!

πŸ”Ί Toggleable undeployed challenges: the new show/hide button lives in the player panel template (panels/main_panel.yml). Servers that already have that file won't see the button until they either delete it so it regenerates, or add the TOGGLE_UNDEPLOYED button to it by hand. Fresh installs get it automatically. VISIBLE and HIDDEN modes are unchanged.

βš™οΈ New config keys: this release adds gui-settings.open-anywhere, gui-settings.description-color, gui-settings.reward-text-color, and a top-level include-undeployed. They are added to your config.yml automatically with safe defaults (no behaviour change).

πŸ”‘ Locale note: several locale keys were added (reward chance, biome selector, toggle button, confirmation instruction, and more). If you maintain custom translations, regenerate/merge them (e.g. via /sync-locales) so the new strings appear.

Legend

  • πŸ”‘ locale files may need to be regenerated or updated.
  • βš™οΈ config options have been added, renamed, or removed.
  • πŸ”Ί special attention needed.

New Features

✨ Optional per-challenge reward chance

[PR #412] Fixes #76

Challenges can now be given a percentage chance to grant their reward on completion. This lets you build "lucky" challenges where the reward isn't guaranteed β€” great for repeatable challenges and loot-style gameplay. Configurable per challenge in the admin editor.

πŸ’Ž Island level rewards

[PR #411] Fixes #279

Completing a challenge or level can now increase the island's level through the Level addon, so challenges can meaningfully feed into island progression instead of only handing out items/money/XP.

πŸ”‘ Biome requirement for island challenges

[PR #419] Fixes #335

Island challenges gain a "Required Biomes" option: the player must be standing in one of the chosen biomes to complete the challenge. Biomes are picked from a new paginated biome selector in the admin GUI (left-click to add, right-click to clear). Biomes are stored by key, so the data stays robust across versions and unknown biomes simply never match.

πŸ”‘ βš™οΈ πŸ”Ί Toggleable undeployed challenges

[PR #417] Fixes #175

The undeployed-view-mode: TOGGLEABLE setting was previously a no-op (it behaved like VISIBLE). It's now fully implemented: in TOGGLEABLE mode the player GUI shows a button that each player uses to show or hide undeployed challenges for themselves. The default is "shown", so it starts out like VISIBLE and players can tidy their view β€” handy for hyping upcoming challenges while letting players hide them.

βš™οΈ Default colour for description and reward text

[PR #418]

Two new settings β€” gui-settings.description-color and gui-settings.reward-text-color β€” apply a default colour to every line of a challenge's description / reward text, so you no longer have to prefix each challenge's text with the same colour code. A colour written in the text still overrides the default. (This re-adds, in a MiniMessage-friendly form, the useful half of the old lore-formatting PR #340.)

πŸ“Š Challenge completion-percentage placeholders

[PR #410] Fixes #352

New placeholders expose how much of the available challenges a player has completed as a percentage, for use in scoreboards, tab lists, and other placeholder-driven displays.

πŸ”‘ βš™οΈ Open the challenges GUI while off-island

[PR #407] Fixes #349

A new gui-settings.open-anywhere option lets players open the Challenges GUI without being on their island. Completion itself still requires being on the island when world protection is enabled.

Bug Fixes

Locked levels no longer show the unlock message

[PR #414] Fixes #323

A locked level was showing its "Congratulations…" unlock message in the lore while its status still read "locked". The unlock message is now only shown once the level is actually unlocked.

Player GUI honours the per-challenge removeWhenCompleted flag

[PR #406] Fixes #337

Completed one-time challenges flagged removeWhenCompleted now disappear from the player GUI as intended, instead of only respecting the global setting.

Level completion re-checked when an admin completes challenges

[PR #408] Fixes #385

Completing challenges for a player through admin mode now runs the level-completion check, so admin completions correctly count toward finishing a level.

"Ignore meta-data" compares the base potion type

[PR #409] Fixes #320

With the "ignore meta-data" option, potion requirements now compare the base potion type instead of treating potions as a blank item, so a required potion is matched correctly.

Other Improvements

  • πŸ”‘ Confirmation prompts now tell players to type confirm / cancel, so import/reset/wipe confirmations are no longer a guessing game [PR #415] Fixes #329
  • βš™οΈ The include-undeployed setting (whether undeployed challenges count toward level completion) is now shipped and documented in config.yml [PR #416] Fixes #179
  • Added tests verifying item/block/entity/money/XP are consumed correctly on completion [PR #413]
  • CI: bumped the pinned reusable workflow and publish-platforms pins [PR #404, PR #405]

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/Challenges/compare/1.7.0...1.8.0

Information

Published onJuly 26, 2026
Downloads0

Platforms

Paper Paper (1.21.5-26.2)