BlazeandCave's Advancements Pack Random Challenge

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.

> Tested on: Tested on: installed in your world’s `datapacks/` folder. > Tested on: a texture pack that hides the bossbar, e.g. %%MD1%% > Tested on: Paper (1.21.8).

---

Features

- Localization – pick a random BACAP advancement for yourself. - Localization – pick a random BACAP advancement for the whole server (enable the Localization to sync advancements between players). - Localization – colored title & description based on the BACAP category. - Localization – see the advancement’s individual criteria: - Sidebar scoreboard with ✓/✗ markers. - Paginated chest GUI. - Localization – simple in-game timer in the action bar: start / stop / status / reset. - Localization – players can vote to skip the current global challenge. - Localization – 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:

```yaml 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!