
动画框架
让动画模组协同工作而非相互覆盖,并允许它们添加或替换动画片段而无需附带游戏完整的片段索引。
查看大图[size=5]前言[/size]
《天国:拯救 II》的动画模组会替换整个游戏文件:动画数据库和片段索引。两个模组若修改同一文件便无法同时生效,因此最后安装的模组会覆盖其他模组,其余模组则失效。
[b]Animation Framework[/b] 让它们可以协同工作。模组只需提供其更改的内容,框架会把每个模组的更改合并到游戏加载的内容中。仍然提供完整文件的模组也会被合并。
它本身不会带来任何可见的变化:请为需要它的模组安装它。对于模组作者,它还提供了制作动画模组的工具:片段编译器、检查器、动作制作器、从动作捕捉重定向,以及一个 Blender 插件(见下方“面向模组作者”)。
有疑问、想分享模组或想法?加入 Discord 上的 [url=https://discord.gg/wzhhsQRnkZ]KCD 模组社区[/url]。
[youtube]D-ySAs1s0oM[/youtube]
[size=5]主要功能[/size]
[list]
[][b]模组协同:[/b] 来自每个模组的数据库、片段、标签、事件和骨架更改都会合并,而提供同一文件完整副本的模组(First Person Overhaul、Greatswords、True Combat Overhaul、Very Important Activities、Swords on the Back)会被合并,而不是互相覆盖[/]
[][b]新增和替换片段:[/b] 模组提供的每个 .caf 都能播放,无需提供游戏的整个片段索引,包括游戏保存在 .dba 包中的片段[/]
[][b]通过脚本播放动画:[/b] [b]human:PlayAnim[/b] 和 [b]StopAnim[/b] 也能作用于 NPC,可在角色正在执行的动作之上播放,新动作会获得游戏在任务和 NPC 行为中播放它们所需的行[/]
[][b]第三人称动画和自定义标签:[/b] 仅在摄像机模组从外部显示亨利时播放的选项,或仅在模组自身状态开启时播放的选项[/]
[][b]模组制作器:[/b] 在游戏中、从命令行、在窗口中或从 Blender 将片段变成完成的模组,并支持在游玩时重新加载片段[/]
[]当日志中两个模组更改同一内容时,日志会指明胜出的模组[/]
[][url=https://github.com/tkhquang/KCD2Tools]开源[/url],基于 [url=https://github.com/tkhquang/DetourModKit]DetourModKit[/url] 构建[/]
[/list]
[size=5]要求[/size]
[list]
[]Steam 版《天国:拯救 II》[/]
[]KCSE 版本需要 [url=https://www.nexusmods.com/kingdomcomedeliverance2/mods/3332]Kingdom Come Script Extender (KCSE)[/url],ASI 版本需要 ASI 加载器,例如 [url=https://github.com/ThirteenAG/Ultimate-ASI-Loader/releases]Ultimate ASI Loader[/url](x64)。[/]
[/list]
[size=5]安装[/size]
两个主文件是同一个模组。[b]请安装其中一个,不要两个都装。[/b]
b Animation Framework[/b],默认版本:用模组管理器安装,或解压到你的 [b]Mods[/b] 文件夹。
[spoiler]
[code]
<KC:D 2 folder>/
|-- Bin/
| \-- Win64MasterMasterSteamPGO/
| |-- WHGame.dll (game file)
| \-- KCD2_AnimationFramework.log (created when the mod loads)
\-- Mods/
\-- animation_framework/
|-- mod.manifest
\-- KCSE/
\-- Plugins/
|-- KCD2_AnimationFramework.dll (this mod)
|-- KCD2_AnimationFramework.ini (settings)
\-- KCD2_AnimationFramework_License.txt[/code][/spoiler]
b Animation Framework[/b],适用于没有 KCSE 的玩家:解压到包含 [b]WHGame.dll[/b] 的文件夹中,与你的 ASI 加载器放在一起。
[spoiler]
[code]
Bin/Win64MasterMasterSteamPGO/
|-- WHGame.dll (game file)
|-- dinput8.dll (ASI loader)
|-- KCD2_AnimationFramework.asi (this mod)
|-- KCD2_AnimationFramework.ini (settings)
\-- KCD2_AnimationFramework.log (created when the mod loads)[/code][/spoiler]
卸载时,删除模组文件夹(KCSE 版本),或删除 WHGame.dll 旁所有 [b]KCD2_AnimationFramework*[/b] 文件(ASI 版本)。其他文件(工具和 Blender 插件)仅用于制作模组。
[size=5]配置[/size]
模组旁的 [b]KCD2_AnimationFramework.ini[/b] 可开启或关闭每个部分。更改在下次游戏启动时生效。
[spoiler]
[list]
[][b]AnimationPatches[/b] - 数据库补丁、片段替换和整文件合并[/]
[][b]ModClips[/b] - 模组的片段和片段索引[/]
[][b]SkeletonMerge[/b] - 多个模组提供的完整骨架会逐骨骼合并[/]
[][b]NpcActions[/b] - 在 NPC 上使用 PlayAnim 和 StopAnim[/]
[][b]ThirdPersonVariants[/b] - 第三人称动画(需要 AnimationPatches)[/]
[][b]CustomTags[/b] - 模组自己的动画标签(需要 AnimationPatches);[b][CustomTags][/b] 部分可为它们排序([b]Priority[/b])并关闭([b]Disabled[/b])[/]
[/list][/spoiler]
[size=5]第三人称动画[/size]
支持的摄像机模组是 [url=https://www.nexusmods.com/kingdomcomedeliverance2/mods/3263]Proper Third Person View (TPV Camera)[/url]。当它从外部显示亨利时,标记为 [b]thirdPerson[/b] 的动画选项会代替游戏自带的动画播放;在第一人称下,游戏自带的动画会播放。其他摄像机模组需要通过 [b]mod_camera_view[/b] 控制台变量公开其视角;规则见 [url=https://github.com/tkhquang/KCD2Tools/blob/main/AnimationFramework/README.md]README[/url]。
[size=5]面向模组作者[/size]
模组只需提供其更改的内容:以游戏文件加你的模组 id 命名补丁,例如 [b]Animations/Mannequin/ADB/kcd_male_database__mymod.adb[/b],并只放入你添加、替换或移除的选项。[url=https://github.com/tkhquang/KCD2Tools/blob/main/AnimationFramework/docs/MODDING.md]模组制作指南[/url]涵盖了所有规则。
[spoiler]
[list]
[][b]在游戏中:[/b] 将 .caf 放入框架的 DEV 文件夹并运行 [b]animfw_reload_clips[/b] 即可无需重启播放;[b]animfw_check_clip[/b] 会打印会导致其损坏的问题;[b]animfw_make_mod[/b] 会将其转换为按游戏动作方式设置的新动作,[b]animfw_pack_mod[/b] 写出完成的模组[/]
[][b]工具(其他文件):[/b] [b]animfw.exe[/b],命令行工具,可在游戏未运行时完成相同工作,无需 rc.exe 即可编译 Blender 导出文件(.i_caf),并保留全身片段所需的每一根骨骼,还可将动作捕捉和其他骨架的动画(BVH、FBX:Mixamo、SMPL、Unreal、CMU、100STYLE)重定向到亨利的骨架上。[b]AnimFW Studio[/b](animfw-studio.exe)可在带人体模型预览的窗口中完成这些工作,[b]animfw mcp[/b] 可将其提供给 AI 助手[/]
[][b]Blender 插件(其他文件):[/b] 适用于 [url=https://www.nexusmods.com/kingdomcomedeliverance2/mods/3639]Bohemian Animator[/url] 构建的骨架:在几秒内导出、检查并在运行中的游戏里于亨利身上播放该动作,将动作捕捉重定向到骨架,制作并打包模组。在游戏中播放使用 [url=https://github.com/yobson1/kcd2lua]KCD2 Lua 运行器[/url][/]
[/list][/spoiler]
[size=5]故障排除[/size]
[list]
[]检查 WHGame.dll 旁的 [b]KCD2_AnimationFramework.log[/b]:它会列出合并的每个补丁、注册的每个模组片段以及模组之间的每个冲突。[/]
[]在 [Settings] 下设置 LogLevel = DEBUG 并重启游戏以获取更多细节。[/]
[/list]请[url=https://github.com/tkhquang/KCD2Tools/issues]报告问题[/url],并附上日志、INI、游戏/模组版本和复现步骤,或在 [url=https://discord.gg/wzhhsQRnkZ]KCD 模组社区[/url] Discord 中提问。
[size=5]致谢与许可[/size]
使用 [url=https://github.com/tkhquang/DetourModKit]DetourModKit[/url] 构建核心功能。
[list]
[][url=https://github.com/ThirteenAG/Ultimate-ASI-Loader]Ultimate ASI Loader[/url],作者 ThirteenAG - ASI 加载层[/]
[][url=https://github.com/cursey/safetyhook]SafetyHook[/url],作者 cursey - 钩子[/]
[][url=https://github.com/zyantific/zydis]Zydis[/url] / [url=https://github.com/zyantific/zycore-c]Zycore[/url],作者 Florian Bernd 与 Joel Hoener - SafetyHook 使用的反汇编[/]
[][url=https://github.com/brofield/simpleini]SimpleIni[/url],作者 Brodie Thiesfield - INI 配置[/]
[][url=https://github.com/ufbx/ufbx]ufbx[/url],作者 Samuli Raivio - 工具中的 FBX 读取[/]
[][url=https://github.com/raysan5/raylib]raylib[/url]、[url=https://github.com/ocornut/imgui]Dear ImGui[/url] 和 [url=https://github.com/raylib-extras/rlImGui]rlImGui[/url] - Studio 窗口;[url=https://github.com/nlohmann/json]nlohmann/json[/url] - 工具的 MCP 服务器[/]
[]SirVanir - [url=https://www.nexusmods.com/kingdomcomedeliverance2/mods/3639]Bohemian Animator[/url],与 Blender 桥接配合使用的 Blender 插件[/]
[]Ian Mason - [url=https://zenodo.org/records/8127870]100STYLE[/url] 动作捕捉(CC BY 4.0),在展示视频中进行了重定向[/]
[]Warhorse Studios - 《天国:拯救 II》[/]
[/list]
[b]许可:[/b] MIT。第三方声明见 [b]KCD2_AnimationFramework_License.txt[/b]。
我所有的《天国:拯救 II》模组和工具都可以在这个 [url=https://github.com/tkhquang/KCD2Tools]GitHub 仓库[/url]中找到。欢迎贡献或提出改进建议!
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。