Cobblemon Economy

作者：Ryvexam

为 Cobblemon 整合包添加完全可自定义的经济系统和商店模组

模组 Fabric 实用服务器工具管理经济附属

截图

介绍

介绍由机器翻译自 Modrinth 原页面，仅供参考。

Cobblemon Economy

Cobblemon Economy 是 Cobblemon 服务器的一体化经济核心。
它为你提供现代化的 NPC 商店、双货币系统、完整的任务 NPC 成长体系，以及兼容性桥接功能，让你在保持模组兼容性的同时，仍可使用 CobEco 作为主要经济系统。

为什么选择 Cobblemon Economy

为服务器提供统一的经济核心，告别彼此割裂的余额系统。
支持桥接 CobbleDollars 和 Impactor，让许多依赖现有经济系统的模组继续正常运行。
可切换主货币，并支持按世界配置（cobeco、cobbledollars、impactor）。
PvE 成长奖励（捕捉、对战、突袭巢穴、对战塔），以及轮换任务板。
适用于正式运营：JSON 配置、热重载工具、SQLite 持久化存储。

Discord（支持）

加入链接： https://discord.gg/zxZXcaTHwe

你将获得

PokeDollars + PCO 货币
支持分页的 NPC 买卖商店
可配置任务板的任务 NPC
基于命令的商店物品（出售命令，而不仅限于物品）
捕捉/发现/对战奖励 + 倍率
兼容突袭巢穴奖励
对战塔 PCO 奖励 + 完成奖励
跨经济系统桥接 + API 同步支持
可切换的主后端：cobeco、cobbledollars、impactor（按世界配置）

任务 NPC 系统（0.0.16）

一个 NPC 实体，两种角色：SHOP 或 QUEST（不使用重复的实体类型）。
每个世界独立的任务文件，行为完全由数据驱动：
quests.json：目标、奖励、可重复性、冷却时间、前置条件。
quest_npcs.json：NPC 池、活跃任务上限、任务板可见数量、轮换策略。
任务目标涵盖：
捕捉筛选条件（species、type、ball、dimension/dimensions、闪光、标签）。
进度事件（battle_win、raid_win、tower_win、fossil_revive）。
奖励模型支持：
货币奖励（pokedollars、pco），每个任务还可选配命令奖励。
前置任务链、重复规则、时限和冷却锁定。
自定义任务板体验：
默认最多显示 4 个任务（可按 NPC 配置）。
详细的目标文本（种类/类型/球/地点/闪光/标签）。
显示剩余时间、剩余冷却时间和明确的操作状态。
轮换系统：
所有玩家共享任务板，或每位玩家使用独立任务板（通过 sharedRotation 配置）。
轮换模式仅限 MIDNIGHT 或 HOURS（rotationMode）。
MIDNIGHT：在下一个服务器本地午夜轮换。
HOURS：每隔 rotationHours 小时轮换一次（最少为 1）。
已取消或过期的任务可以设为在下次轮换前不可接取。

如何设置任务 NPC（召唤 + 绑定）

生成商店 NPC：
使用刷怪蛋 cobblemon-economy:shopkeeper_spawn_egg，或
运行 /summon cobblemon-economy:shopkeeper。
使用 /eco questnpc list 查看可用的任务 NPC 配置。
使用 /eco questnpc get <id> 获取任务 NPC 设置器物品。
手持设置器右键点击已生成的商店 NPC，即可将其切换为 QUEST 角色并绑定 questNpcId。
可选：使用 /eco shop get <shopId> 获取普通商店设置器，然后右键点击同一个 NPC，即可将其切换回普通商店。

`quest_npcs.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"]
    }
  }
}

配置警告

配置支持有限。
自定义配置问题不会提供逐步指导：请在测试世界/服务器中逐步测试改动。
如果自定义配置无法正常运行，请先检查 JSON 语法、任务 ID、NPC ID 和目标键。

安装

将 cobblemon-economy-0.0.16.jar 放入 mods/。
启动服务器一次。
编辑 world/config/cobblemon-economy/config.json。
重启服务器（仅修改配置时，也可使用 /eco reload）。

文件布局（每个世界）

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 也是每个世界独立的，因为它位于该世界的配置文件夹中。

各配置文件的作用

config.json
全局经济行为（货币、奖励、倍率、性能分析）。
不再需要包含商店配置。
shops.json
所有商店定义（title、currency、items、限制、关联商店等）。
向后兼容：如果缺少此文件，模组会加载旧版 config.json.shops，并自动创建 shops.json。
quests.json
任务定义和目标。
支持捕捉筛选条件（物种、类型、球、dimension 或 dimensions、闪光、标签）。
支持事件目标：battle_win、raid_win、tower_win、fossil_revive。
单个任务的控制选项：repeatable、repeatPolicy、cooldownMinutes、timeLimitMinutes、requiresCompleted。
支持奖励（pokedollars、pco、可选的命令列表）。
quest_npcs.json
任务 NPC 定义（显示名称、皮肤、对话内容、任务池、最多同时进行的任务数）。
公告板/轮换控制：visibleQuests、sharedRotation、rotationMode（MIDNIGHT/HOURS）、rotationHours。
一个 NPC 可以通过 questPool 提供多个任务。
milestone.json
首次捕捉奖励。

快速开始（5 分钟）

启动一次服务器以生成默认配置。
打开 config.json 并设置：

{
  "main_currency": "cobeco"
}

在任意商店中添加一个测试物品。
加入服务器并运行 /bal。
进行购买/出售，确认经济功能正常。

命令

玩家

/bal 或 /balance
/pco
/pay <player> <amount>

管理员

/eco reload
/eco shop list
/eco shop get <id>
/eco quest list
/eco questnpc list
/eco questnpc get <id>
/eco skin <name>
/eco item
/balance <player> <add|remove|set> <amount>
/pco <player> <add|remove|set> <amount>

主货币模式

在 config.json 中配置：

{
  "main_currency": "cobeco"
}

有效值：

cobeco（默认）
cobbledollars
impactor

行为说明：

cobeco：CobEco 数据库为权威数据源；如果存在 CobbleDollars 和 Impactor，余额也会同步到这两个模组，并通过桥接钩子将外部交易同步回 CobEco。
cobbledollars：CobEco 的余额操作会转交给 CobbleDollars。
impactor：CobEco 的余额操作会转交给 Impactor 的主货币。

实际使用中，你可以选择 CobEco 作为主经济系统，同时仍与依赖 CobbleDollars/Impactor 风格交易流程的模组保持广泛兼容。

奖励

主要奖励键：

battleVictoryReward
raidDenVictoryReward
captureReward
newDiscoveryReward
battleVictoryPcoReward
battleTowerCompletionPcoBonus

倍率：

shinyMultiplier
radiantMultiplier
legendaryMultiplier
paradoxMultiplier

里程碑

文件：world/config/cobblemon-economy/milestone.json

示例：

{ "10": 300, "50": 700, "100": 1500, "200": 3000 }

商店物品类型

标准物品

{ "id": "minecraft:diamond", "name": "Diamond", "price": 1000 }

组件物品

{
  "id": "academy:booster_pack",
  "name": "Booster Pack",
  "price": 200,
  "components": {
    "academy:booster_pack": "\"base\""
  }
}

命令物品

{
  "type": "command",
  "command": "crate key give vote 1 %player%",
  "price": 100,
  "displayItem": {
    "material": "supplementaries:key",
    "displayname": "投票箱钥匙",
    "enchantEffect": true
  }
}