CustomActionFramework

CustomActionFramework

CAF 通过 XML 配置实现了复杂技能和效果的创建,同时最大限度地降低了 CPU 负载。它重写了底层的弹头和范围效果(AoE)逻辑,以支持 ARPG 风格的战斗机制。

实用工具

投射物3 合并包 激光

连锁爆炸2 刀光

描述

CAF(自定义动作框架) for 7 Days to Die

CAF 通过 XML 配置实现复杂技能和效果的创建,同时最大限度地减少 CPU 负载。它重写了底层的抛射物和范围效果(AoE)逻辑,以支持 ARPG 风格的战斗机制。

核心功能:

  • 性能优化: 将视觉效果与体素物理计算分离。这允许实现高频率、大规模的范围效果而不会导致帧率下降。因此,这些自定义效果无法破坏或改变地形(如需破坏地形,请使用原版爆炸机制)。
  • 实体物理: 保留与生物实体的物理交互。爆炸和效果会根据与中心的距离计算击退力,对僵尸和动物施加定向推力并产生布娃娃效果。
  • 生成区域机制: 引入持续存在的区域效果。模组开发者可以配置静态火墙、治疗区域或可附着、可传播的状态效果。包含用于空间控制的敌我识别功能。
  • 自定义抛射物系统: 支持复杂的抛射物行为,例如分裂、自动追踪和连锁反应。主抛射物在击中时可以生成次级追踪抛射物,后者可进一步触发范围效果或持续区域。
  • 几何体命中框: 扩展了原版的球形命中检测。支持可自定义的伤害区域形状,包括长方体棱柱(用于光束攻击)和锥体(用于霰弹扩散或喷吐攻击)。

架构与模块

本指南详细介绍了框架三个核心模块的 XML 接口。复杂的底层逻辑可以通过 XML 属性完全执行,无需编写 C# 代码:

  • MinEventActionAOEDamage:即时目标范围伤害触发器(支持击退物理和持续伤害场)。
  • MinEventActionCustomProjectile:自定义物理抛射物发射器(支持追踪能力和连锁分裂)。
  • MinEventActionSpawnZone:独立的持续区域生成器。

CAF 战斗框架 V2.0.0 - 重大革新更新 V2.0.0 更新是对框架核心射击逻辑的彻底改造。它引入了一个集中管理系统以消除 XML 冗余,一个全新的智能武器生态系统,以及针对多人游戏稳定性和性能的深度优化。

1. 核心架构:中枢系统

之前,使用自定义开火模块需要在 items.xml 中的 Action 0 下直接定义超过 100 个参数,导致文件庞大且难以管理。 中枢(中央调度器)系统解决了这个问题:

  • 集中控制: 武器现在只需调用 ItemActionFireModuleHub。中枢会根据您的配置自动将逻辑路由到子模块(标准、动态、激光等)。
  • 外部模板(CAF_Templates.xml): 所有开火参数现在都从物品文件中移出,放入专门的模板文件中。
  • 模块化可重用性: 多个武器现在可以引用单个“开火模板”。这显著减少了冗余的 XML 编码,并使整体平衡调整更加容易。

2. 性能与兼容性:快照机制

为确保高性能并与原版武器附件(模组)完全兼容,我们实现了快照系统:

  • 性能优化: 当手持武器时,系统会将所有基础属性、模板数据和当前物品修改器打包成一个“快照缓存”。在开火期间,引擎直接从此缓存读取数据,而不是每帧重新计算 100 多个参数,从而大幅降低 CPU 开销。
  • 动态适应: 当你添加或移除武器附件时,快照会自动刷新。模组开发者现在可以使用原版修改器动态更改 CAF 参数(例如,使用瞄准镜模组改变激光颜色,或使用握把模组提高射速上限)。
  • 多人游戏线程安全: 快照严格绑定到 EntityID。每个玩家和 NPC 都有自己独特的缓存 ID,完全防止在多人游戏环境中玩家之间的数据“渗透”或污染。

3. 新子系统:智能武器模块

智能武器模块允许实现突破传统物理弹药限制的高科技武器机制。

  • 虚拟弹匣与自动充能: 武器可以在背包中没有物理弹药的情况下运作。在一段设定的不射击延迟后,弹匣会随时间自动恢复。
  • 能量池: 充能逻辑可以绑定到一个“全局能量池”(例如基于 CVar 的电池或护盾值)。如果能量池为空,武器将停止充能。
  • UI 自定义: 包括隐藏原版弹药栏的选项,并为制导/追踪武器提供 UI“锁定环”参数。
  • 动态变量支持: 弹匣容量和充能速率完全支持 CVar 输入,并与原版修改器调整兼容(_add 和 _mult)。
  • 当前状态: 已与动态远程模块完全集成。其他模块(如激光)已连接,但目前处于“微调”阶段。

4. 高级开火模块

所有现有的射击逻辑都已彻底改造,并新增了三个不同的模块:

  • 动态远程模块: 允许可变的射速(例如,按住扳机的时间越长,射击速度越快)。包含用于蓄力/充能音效和最大速度视觉特效的专用挂钩。
  • 瞬间激光模块: 基于射线检测的系统,使用线渲染器。支持穿透、反弹、自定义厚度和视觉持续。
  • 持续激光模块: 一种持续的光束攻击。改进了光束发射器跟随枪口的效果,并在弹药耗尽时自动清理。

AP AP image image

5. 抛射物与 AI 增强

MinEventActionCustomProjectile 的更新:

  • 横扫盒碰撞: 为高速抛射物添加了连续碰撞检测(CCD)。这可以防止抛射物在高速下“穿透”薄墙或小型敌人命中框。
  • AI 集成: 开火模块现已完全暴露给实体系统。僵尸和 NPC 现在可以使用这些武器模块,从而允许模组开发者创建具有复杂“弹幕”模式或追踪攻击的 Boss。

6. 精确命中检测

一种用于准确检测肢体/身体部位的新工具:

  • 精确扫描: 当抛射物或激光击中目标时,系统会扫描碰撞体的标签和名称,以区分头部、身体和其他肢体。
  • 原版协同: 正确地将身体部位标签传递给原版伤害系统,确保爆头倍率和肢体切断触发机制能够与框架武器精确配合。

安装说明

将压缩包直接解压到你的 7 Days to Die 的 Mods 文件夹中。

开发指南:请查看下载中的 PDF 附件

视觉免责声明: 预览 GIF 和图片中显示的 VFX(视觉效果)仅用于演示目的。这些资源不包含在框架下载包中。本模组仅提供实现此类效果所需的逻辑和 XML 结构。

————————————————————————————————————————————————————————————— 在 Ko-fi 上支持我: https://ko-fi.com/nanami1278

在爱发电上支持我: https://www.ifdian.net/a/nanami1278?utm_source=copylink&utm_medium=link