# CobblemonQuests<\/p>\n
The engagement loop your Cobblemon server needs. Daily, weekly,
\nelite, hidden, and **repeatable** quests, server-wide community
\ngoals, leaderboards, configurable sound effects, and a complete
\nin-game authoring + customization toolkit \u2014 all built on a clean
\nsingle-screen GUI that admins can rearrange slot-by-slot from
\nconfig without touching Java.<\/p>\n
## Feature highlights<\/p>\n
### For players<\/p>\n
– **6 quest types** \u2014 Daily, Weekly, Elite Weekly, Hidden,
\n Repeatable, and Normal (chain steps).
\n – **Repeatable quests** never rotate. Run them as many times as
\n you like; lifetime run counts are tracked per quest and shown
\n on the tile.
\n – **Elite weekly** \u2014 one extra-difficult weekly with significantly
\n better rewards, displayed in a dedicated slot with glow.
\n – **Hidden quests** unlock invisibly when triggers match (catch
\n count, species, dimension, etc.) and live in a dedicated Hidden
\n viewer GUI alongside trophy tiles for ones you’ve already
\n completed.
\n– **15 objective types** \u2014 catch, battle NPC, defeat wild
\n (separately tracked from PvE wins), level up, gain levels, evolve,
\n hatch eggs, throw Pok\u00e9 Balls, use experience candies, visit
\n biomes \/ dimensions (with anti-ping-pong dedup), catch shiny,
\n catch legendary, complete PokeHunts, complete raids.
\n– **Single 6-row quest GUI** \u2014 everything visible at once: leaderboard
\n tile + reset timers on row 0, dailies on rows 1\u20132, weeklies on
\n rows 3\u20134, streak \/ milestones \/ hidden \/ repeatable \/ close on
\n row 5. No more digging through sub-pages.
\n– **Server Quests** \u2014 shared server-wide objectives with a live boss
\n bar. Every player contributes. Duration from 1 hour to 1 week.
\n Top-3 contributors get bonus rewards; offline contributors are
\n paid out on next login via a queued-rewards system.
\n Contribution leaderboard with player heads + medals.
\n– **Leaderboards** \u2014 top-16 player-head pyramid with own-rank glow.
\n Ties are now broken by who reached the value first (timestamp-
\n based), so racing past a friend keeps you on top.
\n– **Sound + visual effects** \u2014 configurable sounds on quest complete,
\n claim, milestone, streak advance, hidden discovered, chain
\n advance, and community-goal complete. Title \/ subtitle flashes on
\n major events.
\n– **Claim system** \u2014 completed quests glow `\u2605 READY \u2605`; claim
\n individually or hit Claim All. Auto-mode available.
\n– **Daily streak** + **lifetime milestones** \u2014 reward consistency.
\n Milestone GUI is paginated and fully configurable.
\n– **Reroll system** with hard per-rotation caps \u2014 `daily-per-day`
\n and `weekly-per-week` (default 1 each). No paid fallback. Counters
\n are consumed *before* the roll and refunded if the pool can’t
\n produce a replacement, so concurrent clicks can’t double-spend.
\n– **Chat reward banners** \u2014 every reward payout shows a one-line
\n confirmation: `\u2605 +250 Stars` \/ `$ +5000 PokeDollars`. Format
\n fully customizable per-server.<\/p>\n
### For admins<\/p>\n
– **In-game customization of literally every player-facing string, ### Rewards<\/p>\n – **Pok\u00e9Dollars** (Impactor primary currency) ### Integrations<\/p>\n – **Impactor** \u2014 Pok\u00e9Dollar + Stars currency, soft dependency. ### Security & reliability<\/p>\n – **Permission re-checked on every action** \u2014 mid-session demotions Reset a player’s dailies Reset a player’s weeklies Print Stars balance + lifetime `\/cq` is a shorter alias for `\/quests`.<\/p>\n ## Compatibility<\/p>\n – **Minecraft 1.21.1 \/ Fabric** ## Roadmap<\/p>\n – **Party \/ multiplayer quests** \u2014 coming with the party-system update ## License<\/p>\n MIT \u2014 fork, modify, redistribute.<\/p>\n","protected":false},"excerpt":{"rendered":" Drop-in daily & weekly quest system with configurable rewards, streaks, milestones and hidden quests.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"cobblemonquests","_minecraft_project_id":"4ShL0DGz","_minecraft_author":"souljagger","_minecraft_license":"MIT","_minecraft_downloads":162,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"cobblemonquests.zip","_minecraft_size_bytes":17709973,"_minecraft_version_count":19,"_minecraft_updated_at":"2026-05-16T14:22:11.906948Z","_minecraft_date_created":"2026-05-01T06:40:14.358013Z","_minecraft_date_modified":"2026-05-07T20:50:12.235036Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/cobblemonquests","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-02T00:18:04+00:00","_minecraft_import_hash":"5615171d3dab344d48b9c207957cd43b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97],"mod_loader":[99],"minecraft_version":[37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-43357","mod","type-mod","status-publish","hentry","mod_category-fabric","mod_loader-fabric","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n slot, item, color, and button**. No jar editing, no Java. Every
\n GUI is its own HOCON file under `config\/cobblemonquests\/gui\/`:
\n – `main_menu.conf`, `detail_menu.conf`, `stats_menu.conf`,
\n `milestone_menu.conf`, `leaderboard_menu.conf`,
\n `repeatable_menu.conf`
\n – Set the `slot` (0\u201353) of every button. Set the `rows` (1\u20136) of
\n every menu. Toggle any button’s `visible` flag. Replace the
\n glass-pane filler with any item id. Customize progress-bar
\n characters, colors, length, brackets. Reorder quest name parts
\n via `name-format`. Sort quests by progress \/ rarity \/
\n alphabetical \/ status \/ id.
\n– **Custom Command Buttons** \u2014 drop unlimited extra buttons into
\n any GUI: store links, Discord, voting, vanilla command shortcuts.
\n Each entry takes `slot`, `item`, `name`, `lore`, `glow`, and a
\n `command` template with `{player}` substitution.
\n– **Event Command Hooks** \u2014 fire console commands when any of
\n these events happen: `quest-complete`, `milestone-reached`,
\n `streak-milestone`, `claim`. Wire up Discord webhooks, broadcast
\n messages, grant external items \u2014 all without recompiling.
\n– **Admin right-click quick actions** \u2014 right-click any quest tile
\n with admin perms to open Complete \/ Reset Progress \/ View
\n Details inline.
\n– **Quest Browser** \u2014 tabbed by type (All \/ Daily \/ Weekly \/
\n Normal \/ Elite \/ Hidden \/ Repeat), filtered by rarity + category,
\n sortable, paginated. Scales to hundreds of quests.
\n– **Quest Editor + Quest Creation Wizard** \u2014 full in-game CRUD.
\n Cycle type \/ category \/ rarity, set targets, build rewards via
\n the 4-step wizard, save to disk, duplicate, delete (two-click
\n confirm), live preview.
\n– **4-Step Reward Wizard** \u2014 pick category (Currency \/ Items \/
\n Crate Keys \/ Commands) \u2192 browse + select (item browser with
\n All \/ Cobblemon \/ Balls \/ Candies \/ Vanilla tabs and full
\n registry pagination) \u2192 set quantity \u2192 recap + confirm.
\n– **Per-reward `display` override** \u2014 replace any reward’s lore
\n text with custom MiniMessage. Perfect for branded rewards or
\n hiding raw `padmin givekey` commands behind a clean
\n `
\n– **Reward display rename map** \u2014 `rewards.display-names` maps any
\n item id or key id to a custom name globally. Servers can ship a
\n fully branded tooltip set without per-reward edits.
\n– **Chain Browser + Editor + Wizard** (admin-side) \u2014 full in-game
\n chain authoring with step picker, inline quest creation, reorder
\n arrows, difficulty tags, loopable toggle, chain-completion
\n rewards.
\n– **Server Quest Browser + Editor + Wizard** \u2014 create server-wide
\n goals with objective type, target, duration (1h to 1 week), base
\n rewards, and top-3 contributor bonus rewards. **Active Goal
\n Management dashboard**: stop, reset, boost progress, view
\n contributors live.
\n– **Player Management GUI** \u2014 inspect any online player: active
\n quests, streak, Stars balance, total completed, repeatable run
\n counts. Admin actions: grant Stars, reset dailies \/ weeklies,
\n wipe player data (two-click confirm). Admin perms re-checked
\n on every click \u2014 a mid-session demotion takes effect immediately.
\n– **Config Editor** \u2014 multi-page hub: Reroll Caps \/ Pool Weights \/
\n Toggles \/ GUI Layout. Each is a clean sub-page with Save.
\n– **GUI Layout Editor** \u2014 visual 54-slot grid. Click any slot to
\n cycle its role. Save writes to `gui\/player_main.conf` and
\n auto-reloads.
\n– **Diagnostics & test commands**:
\n – `\/quests admin debug events` \u2014 per-tracker fire counts +
\n last-fired timestamps + last detail. Triage “my quests aren’t
\n progressing” reports in seconds.
\n – `\/quests admin debug stars
\n Stars balance + lifetime earnings.
\n – `\/quests admin testkey
\n crate-key bridge live to verify your template without waiting
\n for a quest.
\n – `\/quests admin testcommand
\n command-reward template through the same SafeDispatch pipeline
\n rewards use.<\/p>\n
\n– **Stars** \u2014 now dispatched through a configurable economy command
\n (default: `eco deposit {amount} {currency} {player}`) so a real
\n Impactor currency account is what updates. The local JSON ledger
\n is mirrored only as a leaderboard cache.
\n– **Items** \u2014 any Minecraft \/ Cobblemon item id, with overflow
\n handling.
\n– **Crate keys** \u2014 global command template plus a per-key override
\n map (`integrations.crate-key-commands`) so `lunar` can route to
\n Pebble’s Crates and `vote` to ExcellentCrates on the same server
\n with no branching elsewhere. Default template targets Pebble’s
\n Crates (`padmin givekey {player} {amount} {key}`) out of the box.
\n– **Custom commands** \u2014 console execution with `{player}`
\n placeholder, run through a unified `SafeDispatch` pipeline that
\n catches typos, missing nodes, and re-entry instead of silently
\n swallowing them.
\n– All grants are atomic, audit-logged with 8-char transaction IDs,
\n and **resilient to offline players** \u2014 community-goal payouts and
\n star rewards queue into `pendingRewards` and deliver on next
\n login with a `\u2605 You have rewards waiting! \u2605` chat banner.<\/p>\n
\n– **PokeHunts** \u2014 auto-hooks if loaded; quest type
\n `COMPLETE_POKEHUNT`.
\n– **Raids** \u2014 auto-hooks if loaded; quest type `COMPLETE_RAID`.
\n– **LuckPerms** \u2014 optional, used for permission node lookups; falls
\n back to op-level cleanly with a one-time WARN if the provider
\n fails.
\n– **Pebble’s Crates \/ ExcellentCrates \/ CMI** \u2014 any crate plugin
\n works via the per-key override map.
\n– **Public API** \u2014 any mod can call `ExternalEventApi` to feed
\n quest progress without a classpath dependency.<\/p>\n
\n work. Every admin GUI has an internal `requiresAdmin()` guard on
\n every `open()` and click.
\n– **Bypass permissions are explicit-only AND now config-gated.**
\n `cobblemonquests.bypass.reroll-cost` and
\n `cobblemonquests.bypass.rate-limit` only take effect when the
\n matching `permissions.bypass.*` flag in `config.conf` is set to
\n `true`. Granting the LP node alone is no longer sufficient \u2014 so a
\n forgotten wildcard inheritance can’t silently disable the new
\n reroll caps.
\n– **Per-player rate limits** on rerolls and admin commands.
\n– **Audit log** at `logs\/cobblemonquests-audit.log` records every
\n quest assignment, completion, reward grant, reroll, admin action,
\n hidden discovery, milestone crossing, **community-goal mutation,
\n config reload, and admin test command** with an 8-char base36
\n transaction id.
\n– **Snapshot at assignment** \u2014 quest definitions snapshot at
\n assignment time so config edits never retroactively change a
\n payout.
\n– **Anti-exploit dedup** on “visit N biomes \/ dimensions” objectives
\n \u2014 only distinct biome \/ dimension ids count. Ping-pong farming
\n is dead.
\n– **`SafeDispatch`** \u2014 single canonical path for every console
\n command the mod runs (rewards, stars, crate keys). Treats result
\n `< 1` as a hard failure with a WARN carrying the resolved\n command string. Re-entry guards prevent infinite loops if a\n reward template accidentally calls back into the mod.\n\n## One-line elevator pitch\n\nTurn your Cobblemon server into a place players log in for tomorrow,\nnot just today.\n\n## Setup\n\n1. Drop `cobblemonquests-1.8.0.jar` into `mods\/` next to Cobblemon\n and (optionally) Impactor.\n2. Start the server. A default config, sample quests (9 dailies,\n 7 weeklies, 1 elite, 1 hidden, 3 repeatables), a starter chain,\n and 2 server-quest templates are written on first boot.\n3. OPs can run `\/quests` to see the player hub and `\/quests admin`\n for the admin panel.\n4. Use the in-game wizards to create quests, chains, and server\n quests \u2014 or edit `config\/cobblemonquests\/` files by hand.\n5. Use the in-game Config Editor to tune reroll caps, pool weights,\n and toggles \u2014 or edit `config.conf` and run\n `\/quests admin reload`.\n\n## Commands\n\n```\n\/quests Open the quest hub\n\/quests stats Open the stats page\n\/quests leaderboard Open the leaderboard\n\/quests reroll
\n\/quests admin Open admin panel
\n\/quests admin reload Reload config + quests
\n\/quests admin give <\/p>\n Give a quest to a player
\n\/quests admin complete <\/p>\n Force-complete a quest
\n\/quests admin reset <\/p>\n
\n\/quests admin resetweek <\/p>\n
\n\/quests admin goal set
\n\/quests admin goal stop Stop the active server quest
\n\/quests admin goal reset Reset server quest progress
\n\/quests admin goal progress
\n\/quests admin debug events Tracker activity dashboard
\n\/quests admin debug stars <\/p>\n
\n\/quests admin testkey <\/p>\n
\n\/quests admin testcommand <\/p>\n
\n“`<\/p>\n
\n– Hard dependencies: Cobblemon 1.7.3+, Fabric API, Java 21
\n– Soft dependencies: Impactor (Pok\u00e9Dollar + Stars currency),
\n LuckPerms (perm nodes + prefix), PokeHunts (auto-hook),
\n Raids (auto-hook), any crate plugin (Pebble’s, ExcellentCrates,
\n CMI, etc. \u2014 configurable per key)
\n– **Coexists peacefully** with PokeBuilder and StaffChat (both also
\n from souljagger).<\/p>\n
\n– **NPC interaction** \u2014 right-click a Cobblemon NPC to open `\/quests`
\n– **Quest shop** \u2014 spend Stars on exclusive items
\n– **Seasonal \/ event quests** \u2014 time-limited quest pools
\n– **Player-facing chains UI** \u2014 chain backend + admin authoring is
\n shipped today; player viewer returns alongside the party update<\/p>\n