Cobblemon Trainers

为你的 Cobblemon 世界添加真正的宝可梦训练家——每位训练家只需一个 JSON 文件。

_{兼容版本 · Minecraft 1.21.1 · Fabric – Neoforge · Cobblemon 1.8.1 · Java 21 · 客户端和服务器均需安装}

与众不同之处

训练家绝不会自行生成。这是最初就定下的设计，而且没有任何设置
可以改变这一点：世界不会到处都是无人问津、站在生物群系里的训练家。训练家只会在有人
希望他们出现时现身——无论是管理员，还是玩家自己。

管理员方面，有两种方式可以在世界中安排训练家：

• /cobblemontrainers spawn 可立即在当前位置生成一位训练家，用于测试或活动；
• 训练家生成器方块会为训练家安排一个固定据点。它不可见，会记住要召唤哪位训练家，并在训练家不在时让他们回来——无论是被击败、走远了，还是因为区块未加载而消失。这就是冠军能一直待在道馆里的原因。

而且，配置好的方块会连同设置一起保存在结构中。只要把它放进已保存的建筑里，
每个生成出来的副本都会自带专属训练家。只需建一次，就能打造一座训练家村庄。

对玩家来说，遇见训练家的方式截然不同：一切都通过对战手机进行，
它是一件物品，而不是一条命令。

对战手机可以合成：四个角放铁锭，四条边放铜锭，中间放一个
你选择的树果。黑色、蓝色、绿色、粉色、红色、白色和黄色树果都能合成对应颜色的对战手机。手机的屏幕边框和界面颜色会与机身配色相匹配，但每种颜色打开的训练家列表都相同。

打开对战手机，从列表中选择一位训练家，然后呼叫他们。但训练家只会来到他们说好的地点：夜晚的恶地、雷雨天气、某个结构，或末地。他们的页面会显示地点，旁边就是呼叫按钮；如果你不在指定地点，拒绝回应时会明确说明缺少什么。想找到训练家，就要查看他们的页面并前往正确地点——在你这么做之前，世界始终空空如也。

你将获得

• 真正的训练家对战 – 右键即可发起单打、双打或三打对战，配有对战音乐；对于需要对战开场画面的训练家，还会显示黑白风格的对战双方界面。
• 呼叫后就会前来的训练家 – 使用对战手机，无论他们说好会在哪里出现。
• 待在原地的训练家 – 隐形方块会让训练家永久留在指定位置。
• 直接粘贴 Showdown 队伍 – 复制导出内容，粘贴即可。
• 随心选择皮肤 – 可以使用 Minecraft 账号的皮肤，也可以上传自己的 PNG 图片。
• 盔甲、精灵球、超级手环 – 训练家会穿戴其整合包配置的装备，包括关键道具；装备可放在身体的七个位置：脸部、胸部、手腕、前臂、手部、腰带和脚踝。
• 胜利奖励 – 胜利后获得物品，可设置为只领取一次或每次胜利都领取。
• 游戏内进度追踪 – 使用对战手机，每位玩家都有自己的进度面板。
• 联盟，而不只是训练家 – 支持分类、锁定和进度成就。
• 可调整的 AI – 提供多个难度等级，可为每位训练家单独设置。
• 地区形态和自制宝可梦 – 支持 Cobblemon 中的任意形态，包括其他整合包添加的形态。
• 可翻译文本 – 名称和对话会以每位玩家自己的语言显示。
• 预置八位训练家 – 已准备好接受挑战，并位于各自的标签页中。

详细介绍

真正的训练家对战。右键点击训练家，即可开启一场真正的 Cobblemon 对战，
支持单打、双打或三打，也可选择让双方队伍等级统一为 50。对战音乐会盖过其他所有声音，
并在对战以任何方式结束时停止。对战会从你当前选中的宝可梦开始，而不是队伍中的第一只。

响应召唤的训练师。为训练师指定一个地点——生物群系、建筑、区域、
时间或天气——任何玩家只要身处其中，就能通过对战手机召唤他们前来。若不指定地点，他们就会待在管理员放置他们的地方。
待在原地的训练师。

一个隐形刷怪方块会将一名训练师固定在
原地：击败他后他会回来，把他带走后他也会返回。右键点击即可配置，
设置会保存在建筑内——因此每个生成出来的建筑副本都会自带一名训练师。

直接粘贴 Showdown 队伍。直接复制 Pokémon Showdown 的导出内容：道具、
特性、性格、EV/IV、招式、闪光状态和昵称。无法识别的行会被忽略，所以可以直接使用。区域形态和自制宝可梦可通过一行
来设置，语法与Aspects:
/pokespawn

相同。随心使用皮肤。通过用户名或 UUID 借用 Minecraft 账号的皮肤，也可以将自己的
PNG 放进整合包。自定义纹理由服务器发送，因此即使其他玩家没有安装你的整合包，也能看到这些皮肤。

奖励与一次性 Boss。胜利后发放物品——每次获胜都发，或每种奖励仅在首次
获胜时发放。奖励可以在领取之前保密。通过
让冠军成为每位玩家只能挑战一次的对手。"rematch": "never"

奖励正是为此而设：可以反复挑战的训练师是一种刷取
的方式，而由数据包
决定具体刷什么。训练师每次获胜都发浆果，就像一座可以亲自游玩的种植园，不必干等收获；其他训练师则可以奖励矿石、只能通过这种方式获得的资源，或推进进度所需的物品。模组本身不提供这些循环——它只提供接口，剩下的交给整合包。

在游戏内追踪进度。对战手机物品会为每位玩家提供独立的进度面板：每个整合包一个标签页，每个类别都有标题，显示每位训练师的皮肤、他们还欠你什么，以及你是否击败过他们。

击败训练师后，即可查看他们的完整队伍，包括模型、形态和闪光宝可梦。
管理员也可以通过/cobblemontrainers list
查看相同信息。进度会随
地图保存，并在/reload及重启后保留。

不止训练师，还有联盟。使用文件夹将训练师分入不同类别；可以设置解锁条件——徽章、进度，或八场胜利——还可以为任何一场胜利关联普通的 Minecraft 进度。

可调节的 AI。每位训练师都能单独设置难度，从初级对手到全力争胜的冠军。难度与宝可梦等级互不影响，因此低等级训练师也能带来真正的挑战。

支持文本翻译。训练师名称和对话支持翻译键，因此每位玩家都能以自己的语言阅读——包括头顶显示的名称。

内置八位训练师。
模组自带八位训练师，放在独立标签页中：他们都是经典训练师，等级为 80，各自会在一个生物群系中响应召唤；还有一位等级 100 的训练师，只有击败前面这些训练师后才能解锁，并且只会在末地响应召唤。

命令

/cobblemontrainers spawn <id> [<x> <y> <z>]
/cobblemontrainers list [<player>]
/cobblemontrainers defeat <id|all> [<players>] [reset]
/cobblemontrainers debugai

每条命令的详细说明请见
命令页面。
所有命令都需要 2 级权限（管理员）。自动补全会列出所有已加载训练师的完整
ID，并同时搜索 ID 的两部分——输入<pack>:<trainer>即可找到jac
my_pack:jacinthe

。对战手机

/cobblemontrainers list供管理员使用。对战手机
(cobblemon-trainers:battle_phone)则是其他玩家共用的图鉴：右键点击即可查看这个世界中列出的所有训练师，每个数据包
对应一个标签页，每个类别都有一个标题，每位训练师都显示自己的皮肤和状态——已击败、彻底击败、仍未击败，或因条件未满足而锁定，并列出
缺少的条件。

点击一行，训练师信息就会显示在右侧页面：等级、队伍人数，以及六个尚未解锁的栏位。获胜后，这些栏位便会展示宝可梦的模型，包括形态和闪光形态。物品
本身不储存任何内容——它读取的是服务器数据——所以丢失物品也不会丢失任何信息。你可以在
Cobblemon Trainers创造模式物品栏标签页中找到它，或者：

如何制作自己的训练师整合包

最简单的方法是使用在线编辑器：
训练师的每个字段都能在表单中编辑，旁边附有说明；对战界面可实时预览场景；你可以将自己的对战音乐和训练师皮肤直接放入
整合包，翻译文本，然后下载整个整合包。下载内容为可直接放入 mods/ 的 .zip 文件，
sounds.json 和语言文件也会自动生成。编辑器完全在浏览器中运行——无需账号，
也不会上传任何内容。

详细信息请参阅数据包文档

超级进化、Z招式、极巨化与太晶化

只要允许，训练师就会使用对战机制。在其 battle
区块的 "gimmicks" 列表中添加 "mega"、"zmove"、"max" 和 "terastal" 即可。

太晶化只需要 Cobblemon。在宝可梦条目中添加一行 Tera Type:，再添加
"gimmicks": ["terastal"]。训练师会暂缓使用这一次太晶化机会，直到它判断时机已到：
比如原本准备使用的招式可以一击制胜，或是对手原本能将它击倒的攻击在其太晶属性下不再致命。Z招式和极巨化也会在类似的时机使用——
抓住原本错失的击倒机会，或是扭转原本会失利的回合。

超级进化则不同——它不消耗回合，所以一有机会就会发动。
给宝可梦一块超级石，并添加 "gimmicks": ["mega"] 即可。

这三种机制都需要Cobblemon: Mega Showdown，但它并非必需：没有它，模组仍会正常加载和运行，表现与之前完全相同；队伍还可以指定一个
Fallback Item:，让宝可梦改持合理的替代物品，而不是无法使用的超级石或晶石。

完整指南：对战机制文档

已知限制

• 形态通过其 aspects 声明（Aspects: alolan），而不是使用 Showdown 名称后缀（Raichu-Alola）——无法区分这种后缀和名称中本身带连字符的宝可梦（Ho-Oh、Porygon-Z）。
• player_username 和 player_uuid 皮肤通过 Mojang API 获取，因此需要网络连接和已有账号。获取失败时，训练师会保留默认皮肤，失败原因会写入日志。texture 类型只需要在你的整合包中放入一张图片。
• 只有安装了模组的玩家才能听到对战音乐：音乐由他们的客户端播放，因此才能循环播放，并让游戏自带的音乐一直等到对战结束后再恢复。

鸣谢

由 Mathéo（matheo-1712）开发。

使用条款

• 整合包：可以。你可以在任何整合包中使用此模组，无论整合包是公开还是私有、免费还是收费。无需征求许可，也无需发送消息。
• 服务器：可以。可以在你喜欢的任何服务器上运行。
• 数据包：可以。使用此模组制作的训练师包归你所有——你可以随意分发。
• 重新上传：不可以。请勿将此模组重新发布到 Modrinth、CurseForge 或任何其他分发网站、镜像站或带广告的下载页面。请改为链接到此页面——这样大家都能获得原版文件、正确的版本以及对应的更新日志。

链接

• 源代码与问题反馈： github.com/matheo-1712/cobblemon-trainers
• 完整文档： 维基——涵盖每个字段、location 区块，以及每种 AI 难度的作用
• 示例包： 每个版本发布时，都会在资源文件中与 jar 一同提供可下载版本——一个文件夹即可同时作为数据包和资源包使用，并涵盖所有选项。

可供游玩的训练师包

Cobblemon : Mega Trainers → 一个 Cobblemon Trainers 数据包，为 Cobblemon: Mega Showdown 中的每种 Mega Evolution 各加入一名训练师，作者是matheo-1712

这里会列出使用此模组制作的训练师包，让你无需自己编写就能挑战训练师。制作了想要列在这里的训练师包？请在 GitHub 上提交问题并附上链接。

发现错误，或有训练师无法加载？请在 GitHub 上提交问题，并附上你的 JSON 和
服务器日志——模组会指出出错文件的名称。