Random BACAP Challenges

Turn BlazeandCave’s Advancement Pack into a rotating challenge system for you or your server.
Players (or everyone globally) get a random BACAP advancement to complete.

Requires: BlazeandCave’s Advancements Pack installed in your world’s datapacks/ folder.
Recommended: a texture pack that hides the bossbar, e.g. Invisible Boss Bars
Tested on: Paper (1.21.8).

---

Features

• Solo – pick a random BACAP advancement for yourself.
• Global challenges – pick a random BACAP advancement for the whole server
  (enable the BACAP Coop Mode to sync advancements between players).
• Bossbar UI – colored title & description based on the BACAP category.
• Components sidebar & GUI – see the advancement’s individual criteria:
  • Sidebar scoreboard with ✓/✗ markers.
  • Paginated chest GUI.
• Timer command – simple in-game timer in the action bar: start / stop / status / reset.
• Skip vote (global) – players can vote to skip the current global challenge.
• Filtering – include/exclude categories and IDs via config.
• Localization – English and German included; easy to extend.

---

Commands

/challenge start        # start or resume your personal challenge
/challenge next         # pick a new personal challenge
/challenge stop         # hide your personal challenge
/challenge status

/challenge global start # start a global challenge for all online players
/challenge global next
/challenge global stop
/challenge global skip  # vote to skip the current global challenge
/challenge global status

/challenge components true|false  # toggle the sidebar
/challenge components gui         # open the chest GUI for the current challenge

/timer start | stop | status | reset

All commands are usable by players by default.

---

Configuration (excerpt)

config.yml keys you’ll actually care about:

language: en            # en or de

filter:
  only_categories: []   # e.g. [redstone, technical]
  exclude_categories: []
  exclude_ids: []       # exact advancement IDs to exclude
  exclude_prefixes: []  # ID prefixes to exclude
  exclude_regex: []     # advanced filtering with regex

Tip: If you filter too aggressively, you might end up with very few available challenges.

---

Installation

1. Install BlazeandCave’s Advancement Pack in your world (world/datapacks/).
2. Drop this plugin JAR into plugins/ and restart.
3. (Optional) Tweak config.yml and restart/reload.
4. Use /challenge start (solo) or /challenge global start (for all).

---

Compatibility

• Built against the Bukkit/Adventure API and tested on Paper.
• Works alongside most gameplay plugins; it only reads BACAP advancements and shows UI.

---

Localization

Ships with English and German messages.

---

FAQ

Q: Do players need to download anything?
A: No. Only the server needs the plugin and the BACAP datapack.

Q: Can I restrict commands to specific groups?
A: By default everyone can use them. Use your permissions plugin to gate or alias commands.

Q: Which Minecraft versions are supported?
A: Tested on 1.21.x. If your BACAP pack is very old, the plugin will warn about possible incompatibilities.

---

This is my first plugin, please report bugs or request features on GitHub.
Enjoy the challenge grind!