SuperAPI AI 工具集

skyrim-plugin-authoring

编程与开发

查看项目

更新于 10-30 16:19

技能介绍

本技能用于《上古卷轴5:天际》插件(ESP、ESL、ESM)的编写与修补,涵盖主文件、记录和 VMAD,依赖类型化工具与结构化校验,适用于文本框架无法安全表达所需改动的情形。

用途与决策顺序:首先确认是否确实需要插件,能用 SPID、KID、SkyPatcher、FLM、BOS、CDF 或 Papyrus 运行时查找安全表达时优先采用这些方式。需要类型化记录创建或覆盖时,优先使用锁定到目标游戏发布版本的 Mutagen C# 工具或 Synthesis 补丁。处理已有插件时,应加载工作区副本,除非计划明确要求变更,否则保留主文件、标志、未知子记录和覆盖身份。原始二进制处理只允许用于范围狭窄、完全明确且具备解析器、夹具测试、前后结构审计和字节级差异的转换,不能作为默认写入方式。若所选类型化库无法表示所需记录族,应停止而非自行拼装字节。

所需输入:目标运行时与插件类型;源插件及必需主文件;含 EditorID 或已解析 FormID 的精确记录计划;存档兼容性要求;脚本与 VMAD 要求;预期新记录数量与轻量插件资格。

插件默认值:资料要求阅读 references/plugin-invariants.md。传统轻量插件使用 HEDR 1.70 和新的本地 ID 0x800-0xFFF;扩展轻量输出使用 HEDR 1.71 和本地 ID 0x001-0xFFF,当使用任何低于 0x800 的本地 ID 时,Skyrim.esm 必须是第一个主文件,并需校验完整主文件链。

工作流程:可用 forge plugin-info <plugin> 获取头部与主文件摘要;生成机器可读的记录计划;在隔离项目中用类型化写入器实现;用同一库重新加载产物并比对目标记录;运行 scripts/audit_plugin_headers.py(有主文件时提供 --master-root);修改校验器后运行 scripts/test_plugin_header_fixtures.py;单独编译随附的 Papyrus 脚本;验证主文件、记录数、FormID 分配、ESL 标志与归档路径;记录未经 xEdit 或 Creation Kit 语义校验的部分。

限制:导航网格、面部生成、复杂对话或场景数据、不支持的 VMAD 结构,除非存在实际编写与校验路径,否则不得宣称完成。版本敏感事实应依据活动项目的 ENVIRONMENT.md、TASK.md、已安装框架版本与构建文件,或对应版本的官方上游文档与源码,并在 VALIDATION.md 中记录证据路径。VMAD 校验须覆盖字符串编码、对象格式、属性数据顺序、脚本与属性可见性以及主文件与本地 FormID 归属;SEQ 须作为经验证的二进制产物处理,不得输出 ASCII FormID 或臆造 SEQS 头部;HEDR 计数须按精确解析器或工具约定审计;须保留不可变原件与父件,并将缺陷分类为继承、已修复、新引入或未验证。