Cobblemon Economy

# Cobblemon Economy

[!(https://img.shields.io/badge/Minecraft-1. 21. 1-3C8527?logo=minecraft&logoColor=white)](https://www.minecraft.net/) [!(https://img.shields.io/badge/Loader-Fabric-DBD0B4)](https://fabricmc.net/) [!(https://img.shields.io/badge/Discord-Join%20Support-5865F2?logo=discord&logoColor=white)](https://discord.gg/zxZXcaTHwe) [!(https://img.shields.io/badge/Bridge-CobbleDollars%20%2B%20Impactor-1F8B4C)](#main-currency-modes) [!(https://img.shields.io/badge/Use%20Case-Cobblemon%20Servers-2D7D9A)](#what-you-get)

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 `. - 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 ` then right-click.

### Minimal `quest_npcs.json` Example ```json { "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.

### How Each Config Works - `