CobblemonQuests

[1.1.0] — 2026-04-17 — "Toolkit Update"

Big quality-of-life and functionality release. Closes the v1.0 spec gaps called out in the design doc and adds in-game authoring tools so a moderator can manage hundreds of quests without touching a HOCON file.

Added — Claim mechanic & Claim All

• New rewards.claim-mode config: manual (default) | auto.
  • Manual: completed quests enter a "READY TO CLAIM" state. The player clicks the Claim button on the quest detail GUI or the big CLAIM ALL button on the main menu (row 4) to receive rewards. Streak / milestone counters advance only at claim time.
  • Auto: 1.0 behavior — instant payout the moment the objective completes. Kept for upgraders who liked the original flow.
• Per-quest "Claim Main / Claim Bonus" buttons appear on the detail GUI when a quest is ready.
• Notifications: quest_ready / bonus_ready / quest_claimed / bonus_claimed / claim_all / nothing_to_claim.

Added — In-game admin authoring tools

• Quest Browser (/quests admin → Browse Quests): tabbed by type (All / Daily / Weekly / Elite / Hidden), filterable by rarity and category, sortable (id / rarity / category / type / completion count), paginated 27-per-page. Designed to scale to hundreds of quests.
• Quest Editor (click a quest in the browser): cycle type / category / rarity, bump target ±1 / ±10, toggle repeatable, add/remove rewards, save back to disk, Duplicate to a fresh id, two-click Delete with confirm. Live preview tile updates on every change.
• Quest Wizard (Browser → "+ New Quest" or admin hub → "+ New Quest"): step-through creation with live preview. Cycles every enum + cycles a sensible icon; defaults to a useful starter reward bundle. On Create, saves to quests/<id>.conf and opens the Editor for further tuning.
• Config Editor (admin hub → Edit Config): tune reroll prices (stars + pokedollars + free per day), pool rarity weights, claim mode, and progress bar toggle from in-game. Save writes back to config.conf.

Added — PokeHunts + Raids hooks

• New objective types: COMPLETE_POKEHUNT and COMPLETE_RAID.
• Reflective bridges (PokeHuntsBridge, RaidsBridge) attach to a loaded hunt/raid mod automatically when a recognized event class is on the classpath. No hard dependency.
• New public API: com.antigravity.cobblemonquests.tracker.ExternalEventApi with firePokeHuntCompleted(player[, huntId]) and fireRaidCompleted(player[, raidId]) so any third-party mod can feed quest progress directly without a class-path search.

Added — UI overhaul

• New GuiTheme + GuiButtons infrastructure: centralized palette, consistent themed buttons (Save / Cancel / Back / Reload / +/- numerics / tab / filter / sort) used by every admin GUI.
• Live tick refresh on the player main GUI: countdown timers count down in real time, progress updates without re-opening.
• New gui.show-progress-bar toggle (default ON). When on, a 10-segment gradient bar renders next to the textual 3/5. When off, only the numeric stays.
• Quest tiles now show category + rarity badge in the lore, and a glowing "★ READY ★" prefix in the title when claimable.
• Full-frame admin borders in distinct theme colors per area (browser/editor/wizard/config).
• Admin shortcut button on the player main GUI for users with cobblemonquests.admin.

Changed

• QuestRegistry exposes put(Quest) and delete(String) for in-place edits from the editor without re-reading the whole quests/ folder.
• Quest definitions can now be saved back via QuestPersister. NB: this round-trips through Configurate, which loses any HOCON comments in the file. If you maintain documented quest packs by hand, prefer to edit the file directly and run /quests admin reload rather than overwriting via the in-game editor.
• The progress dispatcher exposes a generic fireExternal(...) entry point that the new bridges (and any third-party caller via ExternalEventApi) use to feed custom objective progress.

Internal

• New QuestClaimService owns the claim-time bookkeeping (completion counts, streak/milestone advancement) — the tracker no longer touches that state directly. Auto vs manual mode is a single branch in ProgressTracker.onMainComplete.
• GuiTicker registers a 1 Hz END_SERVER_TICK listener; any BaseGui that implements LiveGui gets onTick() callbacks while open.
• The old QuestListGui is replaced by QuestBrowserGui and removed.

Notes for upgraders from 1.0

• Drop the new jar in mods/. Existing config.conf is forward- compatible — rewards.claim-mode defaults to manual (new behavior). Set to "auto" if you prefer the 1.0 instant-payout feel.
• Active quests in player data files migrate cleanly: any quest marked complete-but-unclaimed in the new schema enters the ready-to-claim queue.