各位，欢迎来到赛博魔法时代。CAF-CustomActionFramework-自定义作战框架允许你直接通过简单的 XML 配置，在《七日杀》中实现极具想象力的夸张技能与特效，同时将对电脑 CPU 的性能负担降至最低。告别传统的“开枪-掉血”单一战斗模式，开启充满战略、规划与视觉盛宴的全新玩法。

本框架重写了游戏的飞行物与范围伤害底层逻辑，让《七日杀》的战斗效果如同《暗黑破坏神》或《流放之路》等游戏。

核心特性：

• 满屏特效，告别卡顿：以往在游戏中制造大范围连环爆炸会导致严重的掉帧，因为引擎需要计算每一个方块的物理受损。本框架将“华丽的视觉特效”与“繁重的地形物理计算”彻底剥离。哪怕你创造出每秒触发十几次、覆盖几十米的核爆级大招，游戏的帧率依然稳如泰山，但这同时意味着所有特效都无法对地形造成任何伤害和改变，这是必要的代价，如果追求对地形的破坏，请使用原版爆炸代码和自定义爆炸特效。

• 原汁原味的物理打击反馈虽然剥离了对方块的演算，但打击感没有丝毫妥协。框架保留了对生物实体（丧尸、动物）的互动，所有的法术和爆炸都会根据距离中心点的远近，自动计算击退推力。一发重炮下去，丧尸依然会被炸飞、掀翻并触发真实的“布娃娃（Ragdoll）”倒地效果。

• 化身战术大师：阵地与空间控制通过全新的 SpawnZone（滞留雷达）机制，你可以改变战场的地形格局。在地上留下一道阻断尸潮的火墙、为队友铺设一个持续回血的阵法，或者给丧尸挂上一团会传染并跟随的追踪毒气。配合精准的敌我识别，新的战斗体验强调走位与空间控制的博弈。

• 生生不息的连锁反应：分裂与追踪你的武器不再是直来直去的子弹。通过 CustomProjectile 系统，一发母弹在命中目标后，可以向四周散射出数十发带有“自动索敌”功能的小飞弹；而这些小飞弹落地后，还能原地生成持续的燃烧圈或爆炸。一次开火，即可引发极具观赏性的清场级连锁反应。

• 所见即所得的几何打击框架打破了原版只能进行“圆球形”判定的限制。无论是长达 50 米的一线激光（长方体），还是大面积喷吐的霰弹与龙息（扇形/锥体）。

  

开发指南

由于开发指令非常多，也主要面向Mod开发者，因此我开了一个新的帖子，里面记录了所有参数，格式和代码示例。
开发者们请移步至文章：基于 XML 驱动的自定义战斗架构：瞬时范围伤害、多级分裂飞行物与持续性滞留伤害场 （直接点击文字跳转）

目前的问题：

1. 已经实装武器融合系统 -04/12/2026

2.开发计划 ：未来会加入天基武器/弹幕 例如陨石，激光柱等，可以开发出例如呼叫空中支援，空中轰炸等

3.有什么BUG或兼容性问题请私信或下面评论。

更新日志：

V1.1.0

04/12/2026

1. 更新了整体代码稳定性，减少了爆红风险

2. 修复了子级飞行物继承母体飞行物的持续时间导致子级飞行物存活事件过长的问题

3. 新增武器融合系统，现在你不再需要通过调用MiniEvent形式来触发飞行物特效了，可以直接在武器的property里的action 0和action 1中直接编辑。 具体请看上面的开发指南。这也意味着现在所有Ranged的远程枪械武器都有实体弹道了，射程不在由MaxRanage判定，而是根据你设置的子弹初速度，子弹下坠重力和子弹存活时间决定。

4. 新增的武器融合系统允许你用左键（原本瞄准键）发射弹药了，你可以创造双模式攻击武器，左键突突突，右键龙息弹轰轰轰。

5. 新增的武器融合系统允许你的武器针对不同弹药发射出不同弹幕效果，你可以通过自定义新的特种弹药或原版的HP/AP弹药施加额外的弹幕效果。

6. 正式更名框架名称为CustomActionFramework-自定义作战框架，因为这个框架逐渐变得更加全能，特效只是其中一个。

V1.1.1

04/17/2026

1. 修复了滞留性持续范围场在设置了紧贴地面参数后仍然会堆叠到空中的bug，现在生成贴地范围场时，会寻找击中坐标点以下20米的可附着地面。

2. 武器融合系统也支持飞行物触发滞留性持续范围场了，调用参数代码请查询开发指南，或直接在相关参数前面加”CAF_”即可，如： CAF_ZoneLifetime=5启动范围场。

3. MiniEvent触发的飞行弹幕（也就是trigger_effect)现在也可以设置射线击中判定了，现在可以通过弹幕击中敌人来触发相关动作（如加buff，回血，或再次触发弹幕等）

4. 瞬时范围伤害（AOEDamage）现在可以支持动态数据传入，例如damage=”@Cvar_name”, 支持动态传入的数据有：伤害，放大倍率，范围，击飞力度，滞留性持续范围场的持续时间，伤害，频率。

V1.2.0

04/21/2026

本次更新对自定义远程武器框架（武器融合系统）进行了更新，现在枪械开火不但可以自定义飞行物，也可以自定义瞬时范围伤害，让霰弹枪等字面意义上造成范围伤害，就算枪械不需要范围伤害，也可以将伤害设置为0，只挂载特效，这样直接当作自定义枪口火焰的功能。

示例图：现在狙击炮加入了开火特效，只要给特效加上伤害和击退，这把狙击枪可以直接把枪管塞进僵尸嘴里。

1.  开火逻辑：双轨弹药识别系统-引入 CAF_Proj_Ammo 与 CAF_AOE_Ammo 参数。系统现在支持根据弹药类型动态决定触发逻辑：可单独触发飞行物、单独触发枪口气浪，或两者同步触发。

2. BUG修复：空间定位修正- 针对七日杀坐标偏移机制进行了重构。所有物理判定均在绝对世界坐标系下进行，解决了在长距离移动后判定漂移的问题。

3. 事件锁机制（Trigger Lock）： 引入基于时间的 MinEvent 触发冷却器（默认 0.1s）。当 自定义枪械造成范围伤害 同时命中大量目标时，系统将限制 onSelfPrimaryActionRayHit 的上报频率，有效防止音效爆音、Buff 重复堆叠引发的逻辑死循环及性能抖动。

4. 武器融合系统计算公式更新： 重新设计了伤害堆叠逻辑。公式：最终伤害 = (武器面板基础值 * 倍率) + 额外固定值。

5. 加算分离： 投射物（Projectile）与气浪（AOE）的面板继承开关及其转换倍率已完全独立，支持在 XML 中分别调节。

6. 性能与服务器优化，针对仅作为“视觉特效”使用的 AOE 进行了优化。若伤害、击退及 Buff 均为空，系统将直接跳过物理扫描逻辑。动态网络权限管理： 加入了 hasAuthority 判定。所有的物理伤害结算与 MinEvent 派发均由客户端或服务器的权威端执行，支持专用服务器（Dedicated Server）稳定搭载（具体效果需要测试）。

新增的XML参数请移步至开发指南了解。

目前已知问题： 单机模式由自定义特效造成的击杀无法被视为玩家击杀效果，服务器会造成僵尸0血但仍然活动的问题。

V1.2.1

04/22/2026

1. 修复了所有自定义伤害特效无法造成击杀和经验获取问题

2. 瞬时范围伤害增加了肢解概率参数，现在可以像真正的爆炸物一样触发肢解了 （具体参数参考指南更新）

3. 新增了伤害类型，可以定义该次伤害为具体伤害类型：（如 Bashing, Piercing, Slashing）。影响护甲计算。

4. 优化了服务器兼容性

V2.0.0

05/08/2026

1. 新增特效透明度与亮度控制（触发事件型）

为 法阵特效 增加了 particle_alpha 和 particle_brightness 参数。

为 自定义飞行物 增加了飞行物特效的 particle_alpha、particle_brightness 参数，以及命中后爆炸特效的 hit_particle_alpha、hit_particle_brightness 参数。

可在不修改原始 Unity 特效文件的情况下批量调整特效，有效避免特效过多造成的光污染。

部署示例：

• 法阵:

particle_alpha="0.3"
particle_brightness="0.6"

• 飞行物:

particle_alpha="0.5"
particle_brightness="0.3"
hit_particle_alpha="0.5"
hit_particle_brightness="0.3"

所有数值设为 1 时表示保持默认特效状态。

2. CAF 随机词条模块（调试阶段）

此为试验性模块，目前仍在开发中，尚未正式上线。

该模块属于未来 V2.5.0 版本的核心内容，参考暗黑破坏神和流放之路的玩法，允许玩家对武器进行洗练词条、附魔、提取词条、锁定词条等操作。

目前已完成了核心逻辑设计，结合 CAF 超过 300 个自定义参数，潜力巨大，并且支持录入原版被动词条。

注意： 由于可能与其他词条类 MOD 冲突，请勿在生产环境或重要存档中强行调出该模块，以免损坏存档。