Home›Java›Mods›Cobblemon Economy
Cobblemon Economy
ModsJava

Cobblemon Economy

by RyvesMods · on CurseForge

⬇ Download on CurseForge
Open in MC Java ModsGet it on Google Play →

Cobblemon Economy

Minecraft Loader Discord

Cobblemon Economy is an all-in-one economy + shop + quest layer for Cobblemon servers.

This page is a strict admin guide: install, required/optional mods, shops, skins, quantity controls, quests, JSON config examples, and current hard limits. If a behavior is not described here, do not assume it is supported.

1) Required and Optional Dependencies

Required

Optional integrations

Raid and Battle Tower notes

2) Installation

  1. Drop cobblemon-economy-<version>.jar into mods/.
  2. Start server once.
  3. Edit files in world/config/cobblemon-economy/.
  4. Use /eco reload after JSON edits (full restart is safest after major changes).

What /eco reload does:

What /eco reload does not do:

3) Files and What They Do

Per world folder:

3.1) Capture reward keys in config.json

To make the reward rules easier to read, the generated config now uses explicit capture-related keys:

Exact payout behavior with default values:

Special multiplier rule:

Important scope note:

Legacy keys are still read for compatibility:

When the config is rewritten, Cobblemon Economy saves the explicit key names.

Recommended strict Pokedex-only setup:

{
  "capture_event_base_reward": 100,
  "capture_multi_reward": 0
}

With that setup:

3.2) Manual vs automatic files

4) Core Commands

Player

Admin

5) Shop System (Creation, Binding, Quantity, Buy/Sell)

5.1 Create a shop in JSON

Edit shops.json:

{
  "shops": {
    "general_shop": {
      "title": "General Shop",
      "currency": "POKE",
      "skin": "shopkeeper",
      "skinModel": "steve",
      "isSellShop": false,
      "items": [
        { "id": "minecraft:diamond", "name": "Diamond", "price": 1000 },
        { "id": "cobblemon:poke_ball", "name": "Poke Ball", "price": 200 }
      ]
    }
  }
}

Important fields:

Shop item behavior (exact):

Not supported / do not rely on this in shops:

components JSON string rule:

5.2 Bind a shop to an NPC

  1. Spawn NPC (shopkeeper_spawn_egg or /summon cobblemon-economy:shopkeeper).
  2. Run /eco shop get <shopId>.
  3. Right-click NPC with the setter item.

5.3 Set NPC skin

  1. Put skin file in world/config/cobblemon-economy/skins/ (example: nurse.png).
  2. Run /eco skin nurse.
  3. Right-click NPC with the Skin Setter.

You can also define defaults in JSON per shop or quest NPC:

5.4 Change buy quantity in GUI

5.5 Sell shops

For a sell shop:

Sell matching rule:

5.6 Wildcards, loot tables, and command-item limits

6) Quest System (How It Works)

Quest system uses 2 files:

Flow:

  1. Player opens board.
  2. Accepts quest.
  3. Progress updates from captures/battles/raids/tower/fossil events.
  4. Quest becomes claimable when all objectives are complete.
  5. Player claims rewards.

Lifecycle rules that matter:

7) quests.json (Exact Authoring Guide)

Top-level key must be quests.

{
  "quests": {
    "my_quest_id": {
      "name": "My Quest",
      "repeatPolicy": "DAILY",
      "repeatable": true,
      "timeLimitMinutes": 1440,
      "cooldownMinutes": 0,
      "requiresCompleted": [],
      "objectives": [],
      "rewards": {
        "pokedollars": 2000,
        "pco": 0,
        "commands": []
      }
    }
  }
}

Quest definition behavior:

Recommended quest presets:

Objective types

Filter logic:

Capture/fossil filters

Use any combination:

Exact support by objective type:

Quest reward commands:

Example: shiny Gyarados quest

{
  "quests": {
    "catch_shiny_gyarados": {
      "name": "Red Leviator",
      "repeatPolicy": "DAILY",
      "repeatable": true,
      "objectives": [
        {
          "type": "capture",
          "count": 1,
          "species": ["cobblemon:gyarados"],
          "shiny": true
        }
      ],
      "rewards": {
        "pokedollars": 15000,
        "pco": 120,
        "commands": []
      }
    }
  }
}

Yes: this setup shows a shiny Gyarados preview on the quest board.

Example: raid and tower objectives

{
  "quests": {
    "raid_runner": {
      "name": "Raid Runner",
      "repeatPolicy": "DAILY",
      "repeatable": true,
      "objectives": [
        { "type": "raid_win", "count": 3 }
      ],
      "rewards": { "pokedollars": 6000, "pco": 60, "commands": [] }
    },
    "tower_runner": {
      "name": "Tower Runner",
      "repeatPolicy": "DAILY",
      "repeatable": true,
      "objectives": [
        { "type": "tower_win", "count": 2 }
      ],
      "rewards": { "pokedollars": 5000, "pco": 80, "commands": [] }
    }
  }
}

8) quest_npcs.json (Board/NPC Definitions)

{
  "quest_npcs": {
    "safari_guide": {
      "displayName": "Safari Guide",
      "skin": "shopkeeper",
      "skinModel": "alex",
      "maxActive": 2,
      "visibleQuests": 6,
      "sharedRotation": true,
      "rotationMode": "MIDNIGHT",
      "rotationHours": 24,
      "questPool": [
        "catch_shiny_gyarados",
        "raid_runner",
        "tower_runner"
      ]
    }
  }
}

Field behavior:

Board behavior notes:

Bind an NPC to a quest profile:

  1. /eco questnpc list
  2. /eco questnpc get <id>
  3. Right-click a shopkeeper NPC with the setter.

9) Main Currency Modes

Set in config.json:

{
  "main_currency": "cobeco"
}

Values:

Behavior:

10) Common JSON Mistakes (Avoid These)

11) Integrations Summary

12) Support

Discord support: https://discord.gg/zxZXcaTHwe

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Cobblemon Economy is a free Minecraft Java mod. Compatible with Minecraft 1.21.1. Downloaded 80,732 times (via CurseForge). Download it and open it directly in the game.

Explore more

All Mods for JavaAll Minecraft Java modsJava mods for 1.21