NonRTX - RE2R 自定义动画框架(CAF)

NonRTX - RE2R 自定义动画框架(CAF)

包含RE3吉尔闪避动作 - 该模组为《生化危机2 重制版》的非光线追踪版本提供了一个添加自定义动画的框架。该模组几乎完全由我与一组Claude Opus 4.6智能体协作开发,我担任统筹协调和质量保证的角色。

游戏玩法

完整免责声明

首先,这是针对游戏的非RTX版本,这些只是我当时安装的内容。不要询问RTX版本,我将来可能会做,也可能不会。整个项目都在GitHub上,任何感兴趣的人都可以接手。这个项目在使用Claude制作时成本非常高,在功能尚未完全完成之前,我不想费心去移植。

而且,由于我没有进行完整的游玩测试来检验这个,我更愿意修复bug,所以尽管报告问题吧,理想情况下要附带日志文件和问题的详细描述。老实说,我是一个程序员,不是动画师。这个模组有很多功能和内容,我因为自己知识有限没能进行合适的测试,所以我想大家可以尽情尝试各种玩法并报告问题。就把自己当成授权的QA测试员吧。

从代码角度而言,这个模组的几乎所有方面都是由Claude Opus 4.6代理团队开发的。这主要是出于兴趣爱好以及一个测试项目,目的是评估该模型的能力。我用了3.5天时间让Claude完成了这个模组的开发。我在两个周末各运行了14小时,几乎完全扮演协调者的角色,告诉它要做什么、制定计划,并大体上引导它沿着更高效的路径前进。同时,我还担任了QA测试员,通过运行游戏和测试功能来协助调试。我个人并未亲自编写该模组的任何代码。如果你对此感到不适,请直接略过。

我希望未来能够探索添加声音注入和面部动画支持功能。

自定义动画框架 (CAF) v1.0.0 — RE2 重制版

GitHub:https://github.com/godlock2000-eng/ResidentEvil2_CustomAnimationFramework_NonRTX

针对用户

自定义动画框架通过REFramework为《生化危机2 重制版》添加了事件驱动的动画系统。该框架附带一个《生化危机3》风格的闪避包,使克莱尔和里昂拥有四方向翻滚闪避(前、后、左、右),通过按V键加WASD键激活。闪避动作包含根运动与墙壁碰撞检测,可配置速度和距离,并在REFramework菜单的"CAF Mod API v1.0"下提供实时设置面板。

安装方法:将压缩包解压至《生化危机2 重制版》游戏目录,其中reframework/和natives/文件夹会自动合并到已有文件夹。
需预先安装REFramework。
打开REFramework菜单(按Insert键)可调整闪避设置:动画速度、翻滚距离、混合帧数、冷却时间、按键绑定和根运动开关。
设置内容会跨游戏存档保留。

自定义动画框架(CAF)— 安装指南

要求

  • 生化危机2 重制版 非RTX版本 (Steam)
  • 来自 GitHub 的 REFramework 非 RTX 版本

安装

  1. 将此压缩包解压到你的《生化危机2 重制版》游戏文件夹中
  2. 文件夹结构应合并,以便最终得到:
<game_root>/reframework/autorun/CAF_ModAPI.lua
<game_root>/reframework/autorun/CAF_re3_dodge_settings.lua
<game_root>/reframework/data/CAF_mods/re3_dodge/manifest.json
<game_root>/natives/x64/CAF_custom/dodge_front.motlist.85
<game_root>/natives/x64/CAF_custom/dodge_front.motbank.1

(以及闪避后退、闪避左移、闪避右移的变体)

  1. 启动游戏。按下 Insert 键打开 REFramework 菜单。
  2. 在菜单中查找"CAF Mod API v1.0"。RE3闪避包应该出现在"已加载的模组"下。

控制(RE3躲避包)

  • V + W = 前翻滚
  • V + S = 向后闪避
  • V + A = 左侧翻滚
  • V + D = 右侧翻滚闪避
  • 在闪避过程中按下V键+新方向键,可中断当前动作并向该方向闪避

设置

打开 REFramework 菜单 > CAF Mod API v1.0 > RE3 闪避包设置:

  • 速度:动画播放速度(默认 2.0)
  • 距离:闪避移动的距离(默认2.5米)
  • 混合帧:过渡平滑度(默认值 0)
  • 冷却时间:最小闪避间隔(默认为0秒)
  • 闪避键:点击重新绑定(默认V键)
  • 根运动:切换角色移动开关
  • 调试日志:开启详细日志记录到 re2_framework_log.txt

卸载

从你的游戏文件夹中删除这些文件:

  • reframework/autorun/CAF_ModAPI.lua
  • reframework/autorun/CAF_re3_dodge_settings.lua
  • reframework/autorun/CAF_ModAPI/API.lua
  • reframework/data/CAF_mods/(整个文件夹)
  • natives/x64/CAF_custom/(整个文件夹)

给模组制作者

CAF 提供了一套完整的 Lua API,用于在《生化危机2 重制版》中注册和播放自定义动画,无需编写任何引擎代码。创建模组包的方法是将 manifest.json 文件放入 reframework/data/CAF_mods/your_mod/ 目录中——框架会在启动时自动发现并加载该文件。每个清单定义了动画(资源库路径、动作ID、结束帧、速度、FSM模式、根运动)、事件绑定(按键输入、伤害事件、敌人接近)以及可选的连击/组合序列。

包含的Python工具链(mot_writer.py、motbank_writer.py、dump_to_motlist.py)可将动画数据转换为RE引擎的.motlist.85和.motbank.1二进制文件。您可以从运行时骨骼转储(使用附带的DodgeDumper Lua脚本)、Blender导出或任何产生逐骨骼四元数+位置关键帧数据的工具中获取动画数据。该工具链支持80+骨骼、可变帧数及多种编码格式。

Lua API 提供了播放/停止/绑定函数、基于优先级的事件总线(开/关/发射)、在正常移动基础上播放动画的层叠模式,以及带有输入缓冲和计时窗口的连击/连锁系统。MOD可通过CAF.registerModUI()注册自定义UI面板,用于按MOD设置并自动持久化保存。完整可运行的MOD包请参考examples/re3_dodge/文件夹,完整API文档请查阅GitHub维基页面。