Cobblemon Expeditions

Cobblemon Expeditions

派遣你的宝可梦执行限时远征，赢取战利品和经验值，并提升排名！

Cobblemon Expeditions 是一款适用于 Minecraft 1.21.1 的 Fabric 和 NeoForge 模组，为 Cobblemon 添加了远征系统。玩家可以与不同等级的远征公告板互动，派遣电脑中的宝可梦执行限时任务。请谨慎选择队伍——属性克制、个体值、努力值和环境危害都会影响成功几率。

客户端和服务器均需安装。

⚔️ 功能特色

核心玩法

• 5 种公告板等级 – 铜、铁、金、钻石和下界合金。更高等级可解锁难度更高的远征、被动加成和更多模式。
• 11 项远征 – 8 项标准远征（森林采集、海岸勘察、洞穴探险、树果园采收、火山勘察、深海潜航、冰封遗迹、究极异兽裂隙）以及 3 场 Boss 战。
• TEP 系统 – 队伍远征战力根据属性优势、个体值、努力值、队伍人数、危害减免和强化加成计算。
• 4 种结果等级 – 远征结果分为 GREAT、SUCCESS、PARTIAL 或 FAIL，各自对应不同数量和品质的战利品。
• 宝可梦与玩家经验值 – 宝可梦可获得经验值，玩家在领取奖励时可获得原版经验值。
• 金钱奖励 – 远征可向 CobbleDollars 或 Impactor 发放金钱，具体取决于服务器使用哪一种经济系统。支持全面配置，详见下方的经济系统支持部分。

公告板升级

• 原地升级 – 使用方块材料即可将公告板从铜升级至下界合金，无需拆除。整个 3×2 多方块结构会原地变换。
• 等级加成 – 每次升级都会带来被动加成：增加远征栏位、缩短远征时间、提升战利品品质和 GREAT 成功率、改善危害减免，并解锁新模式。
• 升级路线 – 铜 → 铁（8 个铁块）→ 金（8 个金块）→ 钻石（8 个钻石块）→ 下界合金（8 个下界合金块）。

Boss 远征

• 3 场 Boss 战 – 传说目击、巨人巢穴和究极虫洞。这些高风险、高回报的终局挑战需要强大的队伍战力。
• 入场消耗 – 开始 Boss 远征需要消耗物品（默认：附魔金苹果）。可按远征分别配置。
• 每周冷却 – 每次尝试 Boss 远征后，需等待 1 周才能再次挑战。
• 专属战利品 – 大师球、特性膏药、讲究道具、生命宝珠、气势披带、薄荷、下界之星等。

疲劳系统

• 宝可梦疲劳 – 宝可梦每次远征后都会积累疲劳，每级疲劳会使其 TEP 贡献降低 10%。
• 精疲力竭 – 疲劳达到最高等级（5 级）后，宝可梦会精疲力竭，在休息前无法参加远征。
• 自然恢复 – 疲劳每小时恢复 1 级。Boss 远征造成的疲劳翻倍。
• 防止刷取 – 防止玩家无休止地派遣同一只宝可梦，鼓励培养多样化的队伍。

强化道具

• 5 种可购买的强化道具 – 使用原版物品购买强化道具，之后可随时自由启用或停用。还可叠加使用，制定专属策略。
• 🪶 迅捷羽毛（16 根羽毛）- 探险速度提升 15%
• 🍀 幸运护符（4 个兔子脚）- 战利品品质提升 15%，数量提升 10%
• 💎 能量水晶（16 个紫水晶碎片）- 每只宝可梦增加 5 TEP，成功率提升 5%
• 🔔 宁神铃（1 个钟）- 每次探险的疲劳值增长减少 1 点
• 🔍 学者透镜（1 个望远镜）- 获得的阶级经验提升 25%
• 数据驱动 – 服务器管理员可以创建自定义强化道具，自由设定物品成本和效果组合。

探险模式

• 8 种模式 – 每种模式都会改变探险规则，并带来实质性的取舍。每次探险之间都可以自由切换。
• ⚡ 快速部署 – 速度提升 15%，但战利品减少 10%
• 🔎 深度搜寻 – 战利品增加 15%，但速度降低 15%
• 🛡️ 安全行动 – 危险降低 50%，获得优秀结果的几率略低
• 🎯 专精合约 – 属性加成提升 12%（上限 36%），属性不匹配的宝可梦加成降低 5%
• 📦 批量后勤 – 探险栏位增加 1 个，战利品品质降低 12%
• 🏺 遗迹猎人 – 稀有战利品增加 20%，但速度降低 20%，成功率上限为 90%
• 📚 训练任务 – 宝可梦经验提升 75%，战利品减少 15%
• 💊 野外医疗 – 危险降低 10%，战利品减少 5%
• 阶级解锁 – 随着升级探险板，模式会逐步解锁，形成有意义的成长循环。

危险

• 7 种危险类型 – 炎热、寒冷、中毒、塌方、水域、电击和黑暗。
• 属性减免 – 每种危险都可由特定宝可梦属性应对。未能抵御的危险会降低 TEP 分数。
• 数据驱动 – 可自定义危险类型的属性抗性和惩罚数值。

阶级成长

• 探险阶级经验 – 通过获得经验提升探险阶级。更高阶级可解锁新的探险板阶层和更具挑战性的内容。
• 额外栏位 – 更高阶级可增加同时进行的探险栏位。

便捷功能

• 音效 – 为开始探险、领取奖励、升级探险板、购买强化道具、发生错误等操作提供丰富的音效反馈。
• 3×2 多方块探险板 – 可合成的精美方块，宽 3 格、高 2 格，并采用符合阶层的材质。钻石和下界合金探险板还带有动态屏幕效果。
• 搜索与筛选 – 按类型筛选探险，按名称搜索宝可梦，并自动选择最佳队伍。
• 探险列表选项 – 隐藏尚未达到阶级要求的探险，并切换按战力从高到低或从低到高排序。阶级未解锁的项目会显示为灰色，并提前注明所需阶级，而不是等选好队伍后才告知。这两个选项均按玩家分别保存，并会在不同游戏会话间保留。
• 合成配方 – 全部 5 个阶层的探险板均可使用对应阶层的材料合成。

自定义

• 完全数据驱动 – 所有探险、战利品表、模式、危险和强化均通过 JSON 数据包定义，并可在游戏内编辑。
• 游戏内管理员编辑器 – 管理员可以实时创建、编辑和删除探险、战利品表、模式、危险和强化——无需重启。
• 命令奖励 – 战利品条目可以运行命令而不是掉落物品，因此任何经济或第三方奖励系统都能工作：代币、箱子钥匙、权限，任何东西。命令仅对领取玩家运行，支持 {player}、{uuid} 和 {count} 占位符，并且可以像任何其他奖励一样在管理员 GUI 中编辑。
• 高度可配置 – 数十个配置选项，用于 TEP 计算、成功阈值、战利品缩放、等级进度、疲劳率、Boss 冷却、防滥用等。

💰 经济支持

探险可以将金钱奖励支付到 CobbleDollars 或 Impactor。两者都是可选的，且一次只支付其中一个，因此板上显示的数量保持真实。支持 Minecraft 1.21.1 的 Impactor 5.3.5 在 Fabric 和 NeoForge 上可用，且只需安装在服务端。没有这两个模组时，探险只是不给钱。

设置位于 config/cobblemon_expeditions.json 的 pokeDollars 部分。编辑后运行 /expedition reload。

| 设置 | 值 | 默认值 | 作用 |
| ——- | —— | ——- | ———— |
| enabled | true 或 false | true | false 关闭所有金钱奖励。 |
| provider | auto、cobbledollars、impactor、none | auto | 哪个经济系统获得支付。 |
| scale | 一个数字，0 或更大 | 1.0 | 乘以每个探险的金钱以适配你的经济。 |
| impactorCurrency | impactor:dollars、dollars 或空 | 空 | 仅 Impactor。使用哪种货币支付。空则使用 Impactor 的主要货币。 |
| failMultiplier | 一个数字 | 0.0 | 失败时支付的金钱份额。 |
| partialMultiplier | 一个数字 | 0.5 | 部分成功时支付的金钱份额。 |
| successMultiplier | 一个数字 | 1.0 | 成功时支付的金钱份额。 |
| greatMultiplier | 一个数字 | 1.5 | 大成功时支付的金钱份额。 |

选择经济系统

| provider | 支付方 |
| ———- | —- |
| auto | 如果安装了 CobbleDollars 则用它，否则用 Impactor。已经在用 CobbleDollars 的服务器不会看到变化。 |
| cobbledollars | 仅 CobbleDollars。 |
| impactor | 仅 Impactor。如果你同时运行两个模组并想要 Impactor，请使用此项。 |
| none | 无人。没有金钱奖励。 |

• 大写字母和空格会被忽略。拼写错误的值，或未安装的模组，不会支付任何东西，并在启动时在服务器日志中打印警告。
• 每个探险都有自己的基础金额（poke_dollars）。支付的金钱是该基础金额乘以结果倍率，再乘以 scale，向下取整。
• 一个宝可梦美元和一个 Impactor 美元很少等值，这就是 scale 的用途。例如 0.01 将 45000 的 Boss 奖励在成功时变为 450。0 不支付任何东西，负值或非数值不支付任何东西并发出警告。
• impactorCurrency 接受完整键（impactor:dollars）或仅名称（dollars）。如果两种货币共享一个名称，请使用完整键。未知货币不支付任何东西并发出警告。

这是一个 Impactor 服务器的示例：货币价值是宝可元的十倍：

"pokeDollars": {
  "enabled": true,
  "provider": "impactor",
  "scale": 0.1,
  "impactorCurrency": "dollars"
}

须知

• 更改仅适用于更改后完成的远征。已在玩家收件箱中等待领取的奖励会保留原有金额。
• 如果奖励无法发放（被其他模组取消、账户达到 Impactor 的余额上限，或无法连接 Impactor），服务器日志会记录玩家、金额和原因，并向玩家发送聊天消息。
• 无论使用哪种经济系统，面板都会将金额标记为“宝可元”。

🌐 多服务器网络

正在运行多台服务器？远征数据可以随玩家在服务器之间同步，包括等级、经验值、进行中的远征、奖励收件箱、疲劳值、Boss 冷却时间、增幅和宝可梦锁定状态。正在远征的宝可梦会在所有服务器上保持锁定；如果远征在玩家身处另一台服务器时结束，则会在玩家下次登录时结算。

此功能默认关闭。单台服务器完全无需配置。

设置（共享目录）

1. 确保所有服务器使用相同的模组版本，并且远征、战利品表和模式 JSON 完全一致。

1. 为所有服务器指定一个都能访问的目录，例如绑定挂载、NFS 导出，或者在 Pterodactyl 这类面板中，挂载一个同时连接到节点和每台服务器的目录。

1. 在每台服务器上编辑 config/cobblemon_expeditions.json：

"storage": {
  "backend": "shared_file",
  "sharedDirectory": "shared/cobblemon_expeditions",
  "autoSaveSeconds": 60
}

sharedDirectory 是相对于服务器工作目录的路径。每台服务器都必须将其解析到同一个物理文件夹，并且能够向其中写入文件。

1. 重启所有服务器，并检查每个控制台是否都显示相同的路径：

Shared expedition storage at .../shared/cobblemon_expeditions
Expedition storage backend 'shared_file' active; player records load on join

如果某台服务器仍显示 'world' active，说明它没有读取到配置，或者无法访问共享目录——它会继续静默地使用自己的世界存档。

1. 使用一个账号进行测试：在一台服务器上开始远征，切换到另一台服务器，并确认面板显示远征仍在进行且等级相同。shared/cobblemon_expeditions/players/ 中每位玩家应恰好有一个 .dat 文件——同一玩家出现两个文件，表示其 UUID 在不同服务器上不一致，通常是因为 online-mode 设置不匹配。

如需关闭此功能，请在所有服务器上将 "backend": "world"，然后重启。每台服务器都会恢复使用自己的世界存档，其中仍保留着此前的数据。

已经在运行 Redis、Mongo 或 SQL？

存储层支持插件扩展。编写一个实现 ExpeditionDataStore 接口的小型附加模组，在模组初始化时使用 ExpeditionDataStores.register("mongo") { ... } 注册，然后在配置中设置 "backend": "mongo"。这样，远征面板就会直接从你已有的数据库读取和写入数据。

此模组不附带数据库驱动，因此不需要数据库驱动的玩家不会被捆绑额外文件。

完整的集成指南（包含可供参考的 Mongo 实现）：https://github.com/ZIPender/cobblemon_expeditions_doc/blob/main/storage-api.md

其中涵盖了完整接口、如何序列化记录（数据会经由 NBT 往返，因此无需接触内部实现）、防止两台服务器重复发放同一奖励的原子认领要求、Redis 持久性方面的注意事项，以及测试清单。

须知

• 切换到共享后端后，记录会从空白状态开始。不会自动导入——如果各服务器上的进度已经出现差异，就无法正确判断该以哪份数据为准。请先备份世界。
• 远征、战利品表和模式 JSON 仍按服务器分别保存。请在所有服务器上部署相同内容，并在同一处进行管理 GUI 编辑，否则各服务器的数据会逐渐不一致。
• 此功能同步的是远征数据，不是宝可梦。队伍和电脑盒仍需由你们网络自己的同步层负责。

🖥️ 告示板 GUI

右键点击远征告示板即可打开 GUI。浏览可用远征，从电脑盒中选择宝可梦，查看成功率，管理强化项，然后派遣它们出发！

🛠️ 管理员 GUI

管理员可以打开管理面板，实时编辑远征、战利品表、模式、危险因素和强化项。所有更改都会立即保存到 config/cobblemon_expeditions/ 文件夹。

📋 命令

| 命令 |权限 |说明 |
| ——————————– |———- |———————————————————————————— |
| /expedition check |所有人 |列出你的进行中远征，以及剩余时间、宝可梦数量和成功率。 |
| /expedition rewards |所有人 |列出等待在告示板领取的待领奖励。 |
| /expedition finish <player> |OP 等级 2 |立即强制完成某位玩家的所有进行中远征。 |
| /expedition reload |OP 等级 2 |从磁盘重新加载配置文件，无需重启服务器。也会重新应用经济设置。 |
| /expedition xp <player> <amount> |OP 等级 2 |为玩家增加远征等级经验值（会自动触发等级提升）。 |
| /expedition admin |OP 等级 2 |打开游戏内管理 GUI，以编辑远征、战利品表、模式和危险因素。 |

📦 安装

Fabric

1. 为 Minecraft 1.21.1 安装 Fabric 加载器（≥ 0.16.0）
2. 安装 Fabric API、Fabric Language Kotlin（≥ 1.13.0）和 Cobblemon（≥ 1.7.0）
3. 将 Fabric jar（cobblemon-expeditions-fabric-*.jar）放入 mods/ 文件夹

NeoForge

1. 为 Minecraft 1.21.1 安装 NeoForge 21.1.95+
2. 安装 Kotlin for Forge（≥ 5.7.0）和 Cobblemon（≥ 1.7.0）
3. 将 NeoForge 的 jar 文件（cobblemon-expeditions-neoforge-*.jar）放入你的 mods/ 文件夹

可选，用于金钱奖励：CobbleDollars 或 Impactor 5.3.5。Impactor 只需安装在服务端。

客户端和服务端都需要安装。