SuperAPI AI 工具集

skyrim-animation-behaviors

编程与开发

查看项目

更新于 10-30 16:19

技能介绍

用途

该技能面向《上古卷轴5:天际》模组开发与排障,用于创建或诊断动画与行为(behavior)集成,涉及 OAR、BFCO、Nemesis、Pandora、动画事件、条件、生成的行为输出等。

主要能力

层级分类

技能要求先对问题分层,包括:

  • OAR 条件与文件夹选择;
  • 动画文件与注解/事件数据;
  • 行为图源补丁;
  • Nemesis 或 Pandora 生成器输入/输出;
  • BFCO 或其他战斗框架契约;
  • 原生事件钩子或 Papyrus 监听器;
  • 行为图引用的缺失动画资源。

缺失 HKX 的处理

缺失的 .hkx 与缺失/生成的行为条目是两类不同的故障。对每个缺失动画路径,技能要求:

  • 规范化 meshes 下的相对路径;
  • 识别引用它的角色/生物行为图;
  • 通过松散文件冲突数据、归档清单和源清单定位所属模组;
  • 检查大小写与路径是否精确;
  • 判断该文件属于:已发布的源资源、生成的行为输出、可选补丁资源,还是对已移除动画的过期引用;
  • 修复所属源或依赖,仅在生成器确实拥有该缺失输出时才重新生成。

A-pose 抑制器只能报告或缓解症状,无法创建缺失的动画。

自定义生物路径(如 Actors<Creature>\Animations...)通常需要生物模组自带的移动集或兼容的生物行为补丁。不应将 Nemesis/Pandora 作为通用解决方案,因为它们无法凭空创造不存在的自定义资源。

使用方式

工作流

  1. 记录确切的框架与生成器版本。
  2. 检查源行为/模组文件,而不仅是生成输出。
  3. 从源文件或已知可用的文件中解析动画事件名称。
  4. 按图、节点、注解、条件优先级和输出归属映射冲突。
  5. 做一次源级修改,重新生成,并对比输出。
  6. 将生成输出保留在独立的版本化模组中。
  7. 测试第一/第三人称、性别变体、武器类别、NPC/玩家路径、生物、打断、成对动画及相关过渡。
  8. 将崩溃问题路由至 skyrim-crash-diagnostics。

验证

运行:

scripts\audit_missing_animations.py --log <APoseFix-log> --root <deployed-mod-root>

该脚本检查松散文件和可选提供的归档清单文本。它不解析 BSA 归档,必须相应标注归档覆盖情况。

适用场景

适用于天际模组开发中动画与行为集成的创建、诊断与排障,尤其是涉及 OAR、BFCO、Nemesis、Pandora 等框架的冲突定位、缺失动画资源排查、生成输出管理等。

限制

  • A-pose 抑制器无法创建缺失动画。
  • Nemesis/Pandora 不能凭空创造不存在的自定义资源。
  • 验证脚本不解析 BSA 归档,归档覆盖情况需另行标注。
  • 自定义生物路径通常需要生物模组自带的移动集或兼容补丁。