Cobblemon Economy

Cobblemon Economy

Cobblemon Economy is the all-in-one economy core for Cobblemon servers. It 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.

Why Cobblemon Economy

• One economy core for your server instead of fragmented balances.
• Bridge support for CobbleDollars and Impactor, so many existing economy-dependent mods keep working.
• Main-currency switch with per-world config (cobeco, cobbledollars, impactor).
• PvE progression rewards (capture, battle, raid dens, battle tower) plus rotating quest boards.
• Production-friendly: JSON config, hot reload tools, SQLite persistence.

Discord (Support)

Join here: https://discord.gg/zxZXcaTHwe

What You Get

• PokeDollars + PCO currencies
• Buy and sell NPC shops with pagination
• Quest NPCs with configurable mission boards
• Command-based shop items (sell commands, not only items)
• Capture/discovery/battle rewards + multipliers
• Raid Dens reward compatibility
• Battle Tower PCO rewards + completion bonus
• Cross-economy bridge + API sync support
• Switchable main backend: cobeco, cobbledollars, impactor (per world)

Quest NPC System (0.0.16)

• One NPC entity, two roles: SHOP or QUEST (no duplicate entity type).
• Per-world quest files with full data-driven behavior:
• quests.json: objectives, rewards, repeatability, cooldowns, prerequisites.
• quest_npcs.json: NPC pool, max active quests, visible board size, rotation strategy.
• Quest objective coverage includes:
• Capture filters (species, type, ball, dimension/dimensions, shiny, labels).
• Progression events (battle_win, raid_win, tower_win, fossil_revive).
• Reward model supports:
• Currency rewards (pokedollars, pco) and optional command rewards per quest.
• Prerequisite chains, repeat policies, time limits, and cooldown lockouts.
• Custom quest board UX:
• Up to 4 missions visible by default (configurable per NPC).
• Detailed objective text (species/type/ball/location/shiny/labels).
• Time remaining, cooldown remaining, and clear action states.
• Rotation system:
• Shared board for all players or per-player board (configurable via sharedRotation).
• Rotation mode is exactly MIDNIGHT or HOURS (rotationMode).
• MIDNIGHT: rotates on next local server midnight.
• HOURS: rotates every rotationHours block (minimum 1).
• Cancelled/expired quests can be blocked until next rotation.

How To Set A Quest NPC (Summon + Bind)

• Spawn a shopkeeper NPC:
• Use the spawn egg cobblemon-economy:shopkeeper_spawn_egg, or
• Run /summon cobblemon-economy:shopkeeper.
• Check available quest NPC profiles with /eco questnpc list.
• Get a Quest NPC setter item with /eco questnpc get <id>.
• Right-click the spawned shopkeeper with that setter to switch it to QUEST role and bind questNpcId.
• Optional: switch the same NPC back to a normal shop with /eco shop get <shopId> then right-click.

Minimal quest_npcs.json Example

{
  "quest_npcs": {
    "safari_guide": {
      "displayName": "Safari Guide",
      "skin": "shopkeeper",
      "maxActive": 2,
      "visibleQuests": 4,
      "sharedRotation": true,
      "rotationMode": "MIDNIGHT",
      "rotationHours": 24,
      "questPool": ["safari_water_10", "safari_bug_12"]
    }
  }
}

Configuration Warning

• Configuration support is limited.
• No hand-holding for custom config troubleshooting: test changes incrementally on a staging world/server.
• If a custom setup fails, validate JSON syntax, quest IDs, npc IDs, and objective keys first.

Installation

1. Put cobblemon-economy-0.0.16.jar in mods/.
2. Start the server once.
3. Edit world/config/cobblemon-economy/config.json.
4. Restart server (or /eco reload for config-only edits).

File Layout (Per World)

• world/config/cobblemon-economy/config.json
• world/config/cobblemon-economy/shops.json
• world/config/cobblemon-economy/quests.json
• world/config/cobblemon-economy/quest_npcs.json
• world/config/cobblemon-economy/milestone.json
• world/config/cobblemon-economy/economy.db
• world/config/cobblemon-economy/quests.db
• world/config/cobblemon-economy/skins/*.png

main_currency is also per-world because it lives in this world config folder.