用途
该技能面向《上古卷轴5:天际》的 Papyrus 脚本开发工作,覆盖脚本的创建、修复、编译与校验,以及任务、别名、魔法效果、MCM Helper 集成和存档安全的事件逻辑。
主要能力
- 创建、修复、编译和校验 Papyrus 脚本。
- 处理任务(quest)、别名(alias)、魔法效果(magic effect)和表单(form)相关逻辑。
- 集成 MCM Helper 配置菜单,并以 SKI_ConfigBase 作为旧版回退。
- 维护存档安全的升级逻辑与事件生命周期。
- 内置调试日志开关,通过 Debug.OpenUserLog 与 Debug.TraceUser 输出版本、设置、状态变化和失败查找。
使用方式
开发者需提供以下输入:精确的 Skyrim 运行时与编译器;源脚本、导入根目录、flags 文件与输出目录;所属任务、别名、魔法效果或表单;所需的脚本扩展库及其版本;存档升级预期。随后按工作流映射脚本生命周期与外部调用、检查依赖声明脚本、在版本化工作区修改源码、以显式导入顺序编译(例如 scripts/compile_papyrus.ps1 或项目等价脚本),并在编译成功后进一步检查 VMAD 挂载、属性、事件注册、存档升级与运行时日志,最后按既定策略打包匹配的 PSC 与 PEX。
架构规则要点
选择与行为匹配的最小生命周期所有者;优先使用事件与注册回调而非轮询循环;对象不再拥有监听器或计时器时予以注销;避免在高频事件中执行昂贵操作;将属性与 VMAD 挂载视为插件契约的一部分;可选依赖使用 Game.GetFormFromFile 或经过验证的软依赖模式;除非提供迁移方案,否则跨更新保持属性名与持久状态不变。
调试与证据
从首个构建起提供默认关闭的调试开关(MCM 开关或 GlobalVariable)。开启后通过统一辅助函数写入用户日志,日志路径为 Documents\My Games\Skyrim Special Edition\Logs\Script\User<ModName>.0.log,并需在 [Papyrus] 中启用 bEnableLogging=1(使用 Debug.Trace 时还需 bEnableTrace=1)。版本敏感事实按证据层级核实:当前项目的环境与任务文件、对应版本的官方上游文档或源码、用户已安装模组库中的已知可用文件(只读)、以及直接检查相关的 ESM、ESP、DLL、脚本、日志或归档;并在 VALIDATION.md 中记录证据路径或 URL。
适用场景与限制
该技能适用于 Papyrus 脚本的创建、修复、编译校验与运行时排错,以及 MCM 配置菜单与存档兼容性维护。成人内容项目需保留明确的技术字符串、事件与预期行为,但须排除儿童种族、儿童角色、年龄模糊角色和真实人物性内容。工具未提供具体的收费、价格或额外平台信息。