宝可梦经济

宝可梦经济

用于在Cobblemon模组包中添加经济和商店的模组，完全可自定义

经济

宝可梦经济预览查看大图

Cobblemon Economy

Minecraft Loader Discord Economy Bridge Server Ready

Cobblemon Economy 是面向 Cobblemon 服务器的一体化经济核心模组。 它提供现代 NPC 商店、双货币、完整的任务 NPC 进度体系，以及一个兼容桥接层，让你在将 CobEco 作为主要经济系统的同时，仍能保持与其他模组的兼容性。

为什么选择 Cobblemon Economy

  • 一个服务器只需一个经济核心，告别分散的余额管理。
  • 支持 CobbleDollars 和 Impactor 的桥接，让许多依赖经济的现有模组可以继续工作。
  • 主货币切换，支持按世界配置（cobeco、cobbledollars、impactor）。
  • PvE 进度奖励（捕获、对战、raid 巢穴、对战塔）以及轮换任务板。
  • 适合生产环境：JSON 配置、热重载工具、SQLite 持久化。

Discord（支持）

加入这里: https://discord.gg/zxZXcaTHwe

你能获得什么

  • PokeDollars 和 PCO 双货币
  • 带分页功能的购买/出售 NPC 商店
  • 带可配置任务板的任务 NPC
  • 基于指令的商店物品（销售指令，而不仅仅是物品）
  • 捕获/发现/对战奖励 + 倍率
  • Raid 巢穴奖励兼容
  • 对战塔 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）以及每个任务可选指令奖励。
    • 前置链、重复策略、时间限制和冷却锁定。
  • 自定义任务板 UX：
    • 默认最多显示 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 设置物品。
  • 右键点击已生成的商店老板，使用该设置物品将其切换为 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 和目标键。

安装方法

  1. 将 cobblemon-economy-0.0.16.jar 放入 mods/ 文件夹。
  2. 启动服务器一次。
  3. 编辑 world/config/cobblemon-economy/config.json.
  4. 重启服务器（或仅配置更改时使用 /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 分钟）

  1. 启动服务器一次以生成默认配置。
  2. 打开 config.json 并设置：
{
  "main_currency": "cobeco"
}
  1. 向任意商店添加一个测试物品。
  2. 加入服务器并运行 /bal.
  3. 测试购买/出售以确认经济系统正常。

指令

玩家

  • /bal 或 /balance
  • /pco
  • /pay <玩家> <金额>

管理员

  • /eco reload
  • /eco shop list
  • /eco shop get <id>
  • /eco quest list
  • /eco questnpc list
  • /eco questnpc get <id>
  • /eco skin <名称>
  • /eco item
  • /balance <玩家> <add|remove|set> <金额>
  • /pco <玩家> <add|remove|set> <金额>

主货币模式

在 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": "Vote Crate Key",
    "enchantEffect": true
  }
}

集成

  • CobbleDollars（桥接 + 转换、交易同步支持）
  • Impactor（桥接 + 转换、交易同步支持）
  • Cobblemon Raid Dens（raid 胜利奖励）
  • Cobblemon Battle Tower（对战塔胜利 PCO 奖励 + 通关奖励）
  • Star Academy（可选）
  • Placeholder API（可选）
  • YAWP（可选）

Placeholder API

推荐命名空间：cobeco

  • cobeco:balance
  • cobeco:balance_symbol
  • cobeco:pco
  • cobeco:pco_symbol

故障排除

  • 更新后指令缺失：完全重启服务器（不仅仅是 /eco reload）。
  • 经济桥接未激活：确认目标模组已加载且版本兼容。
  • 后端行为异常：检查世界配置中的 main_currency.
  • 已有世界不显示新的默认任务池：你的 quests.json / quest_npcs.json 已存在；手动合并或在备份后重新生成。

需要帮助？

Discord 支持：https://discord.gg/zxZXcaTHwe

致谢

感谢 Rikunji 对该项目的贡献。