从零到精通：5步搭建PKHeX-Plugins宝可梦数据自动化工作台

从零到精通：5步搭建PKHeX-Plugins宝可梦数据自动化工作台

【免费下载链接】PKHeX-PluginsPlugins for PKHeX项目地址: https://gitcode.com/gh_mirrors/pk/PKHeX-Plugins

一份完整的手动宝可梦数据编辑记录是什么样的？对六项个体值逐一核对、反复确认性格与特性组合、对照技能学习表计算可学等级、再检查捕获地点是否与游戏版本匹配……完成这一套流程通常要花掉10分钟，而一旦弄错一个环节，整只宝可梦就得推倒重来。

PKHeX-Plugins就是为解决这类重复劳动而生的开源插件集合。它依附于PKHeX运行，用自动化手段替代手工调整，把"合法化一只宝可梦"从10分钟压缩到几秒钟。本文将从安装部署讲起，带你完整走完搭建、使用、调优与扩展的全过程。

一、先搞清楚：PKHeX-Plugins到底做什么

PKHeX-Plugins本质上是PKHeX的增强插件包，它调用PKHeX.Core与PKHeX的IPlugin接口，为程序挂载一系列自动化能力。它的核心价值可以用一句话概括：

让"合法"这件事不再依赖人工经验，而是交给与官方同源的合法性算法。

项目采用模块化设计，不同能力分门别类存放在各自目录中：

• PKHeX.Core.AutoMod/AutoMod/Legalization/：合法化核心逻辑，包括Legalizer.cs等算法文件，负责生成与修正
• AutoLegalityMod/Plugins/：所有插件的入口实现，每个文件对应一个功能菜单
• AutoLegalityMod/GUI/：WinForms界面，负责设置面板与LiveHeX等交互窗口

这种分层让普通用户只动菜单、进阶用户改配置、开发者写插件，互不干扰。

二、5步完成环境搭建

1. 准备编译环境

项目基于.NET开发，需要Visual Studio 2022或同等IDE，并安装.NET 7.0 SDK。常规版本依赖NuGet上的PKHeX.Core包，多数情况下直接编译即可通过。

2. 获取项目源码

git clone https://gitcode.com/gh_mirrors/pk/PKHeX-Plugins

3. 编译生成插件

用Visual Studio打开PKHeX-Plugins.sln，右键解决方案选择"重新生成"。编译完成后，AutoLegality插件的输出文件位于：

• AutoLegalityMod\bin\Release\net7.0-windows\AutoModPlugins.dll

如果常规编译因PKHeX.Core版本不兼容而失败，可以改用"边缘构建"方式：先编译最新版PKHeX的PKHeX.Core工程，将产出的PKHeX.Core.dll替换NuGet缓存中对应版本，再重新生成本解决方案。

4. 安装到PKHeX

在PKHeX.exe所在目录新建plugins文件夹，把编译好的插件DLL放进去。若从网上下载的插件，还需在文件属性中执行"解除锁定"。

5. 启动验证

运行PKHeX.exe，在顶部工具 > Auto-Legality Mod菜单下应能看到全部插件项。加载存档后即可逐个体验。

三、日常高频功能：四类自动化场景实战

场景一：一键合法化当前宝可梦

选中一只状态异常的宝可梦，点击菜单中的"Legalize Active Pokemon"。插件会先做合法性分析，合法则跳过，不合法则自动修正，并再次校验结果。若修正失败，会弹出提示并附上排查指引。

场景二：整箱批量修复

点开"Legalize Active Pokemon"时，配合修饰键可以切换处理范围：

• 普通点击：只处理当前选中的宝可梦
• 按住Ctrl点击：处理当前箱子全部宝可梦
• 按住Shift+Ctrl点击：处理所有箱子的所有宝可梦

处理完成后，插件会弹出统计信息，告诉你本次共修复了多少只。

场景三：从Showdown文本导入队伍

在浏览器中复制一套Showdown格式的队伍文本，回到PKHeX按下Ctrl+I，插件会解析剪贴板并逐只生成合法宝可梦。按Shift再触发，则会弹出文件选择框，从txt文件读取数据。这只一种反向操作："Export Box to ALM Showdown Template"可以把当前箱子导出为标准模板文本，方便外部分享与备份。

场景四：一键生成完整图鉴

"Generate Living Dex"会依据当前存档的游戏版本，自动生成全套宝可梦填入箱子。可配合设置指定是否包含全部形态、是否尝试闪光形态，以及是否仅限该版本原生图鉴。此外"Download MGDB"可从联网数据库拉取配信活动宝可梦（Mystery Gift）数据，补全活动图鉴。

四、进阶调优：让生成结果更贴合你的需求

插件运行后会在PKHeX.exe同目录生成almconfig.json配置文件，里面集中了全部可调参数。值得优先关注的几项：

• 训练家信息：默认OT名为ALM，可修改默认训练家名、TID与SID；也可开启"按trainers文件夹使用自定义训练家数据"
• 生成偏好：是否优先按指定游戏版本生成、是否自动补全合法缎带、是否设置对战可用标记、是否按颜色自动匹配精灵球
• 合法性策略：每个宝可梦的生成超时时间（默认15秒）、遭遇方式的优先级顺序（蛋/定点/交换/野生/配信）、是否允许跨HOME转移生成
• 图鉴细节：Living Dex是否包含全部形态、是否生成闪光或阿尔法版本
• 其他：是否开启彩蛋、IV标记配色方案、Smogon导入前是否逐个确认

配置文件采用JSON格式，字段语义清晰，直接编辑后重启PKHeX即生效。

界面与提示文本支持多语言，语言包位于AutoLegalityMod/Resources/text/目录，覆盖中、英、日、韩、法、德、意、西八种语言，跟随PKHeX的本地化方案自动切换。

五、开发者视角：如何新增一个插件功能

想为项目贡献新功能，只需三步：

1. 继承基类：新建类继承AutoModPlugin，实现Name与Priority两个属性，并覆写AddPluginControl方法，把自定义菜单项挂到"Auto-Legality Mod"下拉菜单下
2. 复用基础设施：基类已为你初始化SaveFileEditor（存档读写）、PKMEditor（宝可梦视图）与设置对象，直接调用即可
3. 参照现有实现：项目里的LegalizeBoxes.cs、SmogonGenner.cs都是清晰范例——前者展示了修饰键判定与批量处理，后者演示了联网数据获取与导入流程

项目附带AutoModTests测试工程，覆盖合法性判定、逻辑函数、队伍生成等多个维度，开发时跑一遍测试能有效防止回归。

六、常见问题速查

Q：启动时提示"插件版本与PKHeX版本不匹配"怎么办？先确认当前PKHeX是否与插件使用同一版本的PKHeX.Core。提示框中会同时显示ALM版本号与Core版本号，若不一致，请升级PKHeX或改用边缘构建方式重新编译插件。

Q：批量合法化具体会改动哪些字段？系统按游戏规则自动调整个体值与努力值、性格与特性、技能组合与PP、捕获信息与训练家数据等。若当前提供的信息无法构成合法个体，插件会明确报错而非强行生成。

Q：生成的宝可梦如何二次确认合法性？项目采用的合法性判定与官方游戏同源，生成即通过校验。你仍可在生成后使用PKHeX自带的合法性检查功能做人工复核。

Q：哪些游戏版本受支持？主流3DS与Switch世代主系列游戏均可，包括剑/盾、晶灿钻石/明亮珍珠、传说阿尔宙斯、朱/紫等。LiveHeX等联网功能需要Switch已安装sys-botbase（或USB-Botbase）并配置IP与端口。

七、开始搭建你的自动化工作台

从单只修正到整箱批量处理，从Showdown文本导入到完整图鉴生成，PKHeX-Plugins把宝可梦数据管理从"手工校验"变成"声明即得"——你只需要告诉它想要什么，剩下的合法化逻辑交给它。

最后两条重要提醒：其一，所有操作都在存档上进行，动手前务必先备份原始存档文件，并在测试存档上验证功能效果；其二，联网类功能（Smogon导入、MGDB下载、LiveHeX连接）需要稳定的网络环境，离线状态下请优先使用本地合法化与图鉴生成功能。

安装好插件、加载一份测试存档，从"Legalize Active Pokemon"开始你的第一只自动化宝可梦吧。

【免费下载链接】PKHeX-PluginsPlugins for PKHeX项目地址: https://gitcode.com/gh_mirrors/pk/PKHeX-Plugins