# Cobblemon Economy<\/p>\n
\n
\n
\n
\n<\/p>\n
Cobblemon Economy is the all-in-one economy core for Cobblemon servers.
\nIt gives you modern NPC shops, dual currencies, a full Quest NPC progression layer, and a compatibility bridge so you can keep mod compatibility while still using CobEco as your main economy.<\/p>\n
## Why Cobblemon Economy
\n– One economy core for your server instead of fragmented balances.
\n– Bridge support for CobbleDollars and Impactor, so many existing economy-dependent mods keep working.
\n– Main-currency switch with per-world config (`cobeco`, `cobbledollars`, `impactor`).
\n– PvE progression rewards (capture, battle, raid dens, battle tower) plus rotating quest boards.
\n– Production-friendly: JSON config, hot reload tools, SQLite persistence.<\/p>\n
## Discord (Support)
\n**Join here:** https:\/\/discord.gg\/zxZXcaTHwe<\/p>\n
## What You Get
\n– PokeDollars + PCO currencies
\n– Buy and sell NPC shops with pagination
\n– Quest NPCs with configurable mission boards
\n– Command-based shop items (sell commands, not only items)
\n– Capture\/discovery\/battle rewards + multipliers
\n– Raid Dens reward compatibility
\n– Battle Tower PCO rewards + completion bonus
\n– Cross-economy bridge + API sync support
\n– Switchable main backend: `cobeco`, `cobbledollars`, `impactor` (per world)<\/p>\n
## Quest NPC System (0.0.16)
\n– One NPC entity, two roles: `SHOP` or `QUEST` (no duplicate entity type).
\n– Per-world quest files with full data-driven behavior:
\n – `quests.json`: objectives, rewards, repeatability, cooldowns, prerequisites.
\n – `quest_npcs.json`: NPC pool, max active quests, visible board size, rotation strategy.
\n– Quest objective coverage includes:
\n – Capture filters (`species`, `type`, `ball`, `dimension`\/`dimensions`, shiny, labels).
\n – Progression events (`battle_win`, `raid_win`, `tower_win`, `fossil_revive`).
\n– Reward model supports:
\n – Currency rewards (`pokedollars`, `pco`) and optional command rewards per quest.
\n – Prerequisite chains, repeat policies, time limits, and cooldown lockouts.
\n– Custom quest board UX:
\n – Up to 4 missions visible by default (configurable per NPC).
\n – Detailed objective text (species\/type\/ball\/location\/shiny\/labels).
\n – Time remaining, cooldown remaining, and clear action states.
\n– Rotation system:
\n – Shared board for all players or per-player board (configurable via `sharedRotation`).
\n – Rotation mode is exactly `MIDNIGHT` or `HOURS` (`rotationMode`).
\n – `MIDNIGHT`: rotates on next local server midnight.
\n – `HOURS`: rotates every `rotationHours` block (minimum 1).
\n – Cancelled\/expired quests can be blocked until next rotation.<\/p>\n
## How To Set A Quest NPC (Summon + Bind) ### Minimal `quest_npcs.json` Example ## Configuration Warning ## Installation ## File Layout (Per World) `main_currency` is also **per-world** because it lives in this world config folder.<\/p>\n ### How Each Config Works ## Quick Start (5 Minutes) ## Commands ### Admin ## Main Currency Modes “`json Valid values: Behavior: In practice: you can choose CobEco as your main economy and still keep broad compatibility with mods that expect CobbleDollars\/Impactor-style flows.<\/p>\n ## Rewards Multipliers: ## Milestones Example: ## Shop Item Types ### Component item ### Command item ## Integrations ## Placeholder API ## Troubleshooting ## Need Help? ## Acknowledgements Mod for adding Economy and Shops fully customisable to a Cobblemon Modpack<\/p>\n","protected":false},"featured_media":42443,"template":"","meta":{"_minecraft_slug":"cobblemon-economy","_minecraft_project_id":"zfVCrbFk","_minecraft_author":"Ryvexam","_minecraft_license":"MIT","_minecraft_downloads":13551,"_minecraft_follows":6,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"cobblemon-economy.zip","_minecraft_size_bytes":60086080,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T00:07:20.872941Z","_minecraft_date_created":"2026-01-29T06:39:42.080817Z","_minecraft_date_modified":"2026-03-13T15:30:44.978059Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/cobblemon-economy","_minecraft_icon_attachment_id":42443,"_minecraft_imported_at":"2026-06-01T23:40:16+00:00","_minecraft_import_hash":"8ccc8cbb92b7072d018fab26d7d997a6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,97,126,92],"mod_loader":[99],"minecraft_version":[37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-42442","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-fabric","mod_category-management","mod_category-utility","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– Spawn a shopkeeper NPC:
\n – Use the spawn egg `cobblemon-economy:shopkeeper_spawn_egg`, or
\n – Run `\/summon cobblemon-economy:shopkeeper`.
\n– Check available quest NPC profiles with `\/eco questnpc list`.
\n– Get a Quest NPC setter item with `\/eco questnpc get
\n– Right-click the spawned shopkeeper with that setter to switch it to `QUEST` role and bind `questNpcId`.
\n– Optional: switch the same NPC back to a normal shop with `\/eco shop get
\n“`json
\n{
\n “quest_npcs”: {
\n “safari_guide”: {
\n “displayName”: “Safari Guide”,
\n “skin”: “shopkeeper”,
\n “maxActive”: 2,
\n “visibleQuests”: 4,
\n “sharedRotation”: true,
\n “rotationMode”: “MIDNIGHT”,
\n “rotationHours”: 24,
\n “questPool”: [“safari_water_10”, “safari_bug_12”]
\n }
\n }
\n}
\n“`<\/p>\n
\n– Configuration support is limited.
\n– No hand-holding for custom config troubleshooting: test changes incrementally on a staging world\/server.
\n– If a custom setup fails, validate JSON syntax, quest IDs, npc IDs, and objective keys first.<\/p>\n
\n1. Put `cobblemon-economy-0.0.16.jar` in `mods\/`.
\n2. Start the server once.
\n3. Edit `world\/config\/cobblemon-economy\/config.json`.
\n4. Restart server (or `\/eco reload` for config-only edits).<\/p>\n
\n– `world\/config\/cobblemon-economy\/config.json`
\n– `world\/config\/cobblemon-economy\/shops.json`
\n– `world\/config\/cobblemon-economy\/quests.json`
\n– `world\/config\/cobblemon-economy\/quest_npcs.json`
\n– `world\/config\/cobblemon-economy\/milestone.json`
\n– `world\/config\/cobblemon-economy\/economy.db`
\n– `world\/config\/cobblemon-economy\/quests.db`
\n– `world\/config\/cobblemon-economy\/skins\/*.png`<\/p>\n
\n– `config.json`
\n – Global economy behavior (currencies, rewards, multipliers, profiling).
\n – Does **not** need to contain shops anymore.
\n– `shops.json`
\n – All shop definitions (`title`, `currency`, `items`, limits, linked shops, etc.).
\n – **Backward compatibility:** if this file is missing, the mod loads legacy `config.json.shops` and auto-creates `shops.json`.
\n– `quests.json`
\n – Quest definitions and objectives.
\n – Supports capture filters (species, type, ball, `dimension` or `dimensions`, shiny, labels).
\n – Supports event objectives: `battle_win`, `raid_win`, `tower_win`, `fossil_revive`.
\n – Per-quest control: `repeatable`, `repeatPolicy`, `cooldownMinutes`, `timeLimitMinutes`, `requiresCompleted`.
\n – Supports rewards (`pokedollars`, `pco`, optional command list).
\n– `quest_npcs.json`
\n – Quest NPC definitions (display name, skin, dialogue lines, quest pool, max active quests).
\n – Board\/rotation control: `visibleQuests`, `sharedRotation`, `rotationMode` (`MIDNIGHT`\/`HOURS`), `rotationHours`.
\n – One NPC can offer a list of multiple quests via `questPool`.
\n– `milestone.json`
\n – Unique-capture milestone rewards.<\/p>\n
\n1. Start server once to generate defaults.
\n2. Open `config.json` and set:
\n“`json
\n{
\n “main_currency”: “cobeco”
\n}
\n“`
\n3. Add one test item to any shop.
\n4. Join server and run `\/bal`.
\n5. Buy\/sell to confirm economy flow.<\/p>\n
\n### Player
\n– `\/bal` or `\/balance`
\n– `\/pco`
\n– `\/pay
\n– `\/eco reload`
\n– `\/eco shop list`
\n– `\/eco shop get
\n– `\/eco quest list`
\n– `\/eco questnpc list`
\n– `\/eco questnpc get
\n– `\/eco skin
\n– `\/eco item`
\n– `\/balance
\n– `\/pco
\nConfigure in `config.json`:<\/p>\n
\n{
\n “main_currency”: “cobeco”
\n}
\n“`<\/p>\n
\n– `cobeco` (default)
\n– `cobbledollars`
\n– `impactor`<\/p>\n
\n– `cobeco`: CobEco DB is authoritative; balances are mirrored to CobbleDollars and Impactor when present, and bridge hooks keep external transactions synced back into CobEco.
\n– `cobbledollars`: CobEco balance operations route to CobbleDollars.
\n– `impactor`: CobEco balance operations route to Impactor primary currency.<\/p>\n
\nMain reward keys:
\n– `battleVictoryReward`
\n– `raidDenVictoryReward`
\n– `captureReward`
\n– `newDiscoveryReward`
\n– `battleVictoryPcoReward`
\n– `battleTowerCompletionPcoBonus`<\/p>\n
\n– `shinyMultiplier`
\n– `radiantMultiplier`
\n– `legendaryMultiplier`
\n– `paradoxMultiplier`<\/p>\n
\nFile: `world\/config\/cobblemon-economy\/milestone.json`<\/p>\n
\n“`json
\n{ “10”: 300, “50”: 700, “100”: 1500, “200”: 3000 }
\n“`<\/p>\n
\n### Standard item
\n“`json
\n{ “id”: “minecraft:diamond”, “name”: “Diamond”, “price”: 1000 }
\n“`<\/p>\n
\n“`json
\n{
\n “id”: “academy:booster_pack”,
\n “name”: “Booster Pack”,
\n “price”: 200,
\n “components”: {
\n “academy:booster_pack”: “”base””
\n }
\n}
\n“`<\/p>\n
\n“`json
\n{
\n “type”: “command”,
\n “command”: “crate key give vote 1 %player%”,
\n “price”: 100,
\n “displayItem”: {
\n “material”: “supplementaries:key”,
\n “displayname”: “Vote Crate Key”,
\n “enchantEffect”: true
\n }
\n}
\n“`<\/p>\n
\n– CobbleDollars (bridge + conversion, transaction sync support)
\n– Impactor (bridge + conversion, transaction sync support)
\n– Cobblemon Raid Dens (raid win rewards)
\n– Cobblemon Battle Tower (PCO rewards on tower wins + completion bonus)
\n– Star Academy (optional)
\n– Placeholder API (optional)
\n– YAWP (optional)<\/p>\n
\nRecommended namespace: `cobeco`
\n– `cobeco:balance`
\n– `cobeco:balance_symbol`
\n– `cobeco:pco`
\n– `cobeco:pco_symbol`<\/p>\n
\n– Command missing after update: restart server fully (not only `\/eco reload`).
\n– Economy bridge not active: verify target mod is loaded and version-compatible.
\n– Wrong backend behavior: check `main_currency` in world config.
\n– Existing world does not show new default quest pools: your `quests.json` \/ `quest_npcs.json` already exists; merge manually or regenerate after backup.<\/p>\n
\nDiscord support: https:\/\/discord.gg\/zxZXcaTHwe<\/p>\n
\nThanks to Rikunji for their contributions to the project.<\/p>\n","protected":false},"excerpt":{"rendered":"