Combat Framework：面向 Unity 的第三人称角色控制器与战斗系统框架

Combat Framework 是一套面向 Unity 的第三人称角色控制器与战斗系统框架，它将玩家角色的创建、NPC 的战斗行为配置、近战与远程武器的动画管理、以及从上至下的视角切换全部封装为一个以点击操作为主的生成器系统。你不需要从零编写角色移动、武器动画状态机或敌人行为树——框架将“创建一个可战斗的角色”简化为在编辑器中点几下鼠标，选择一个骨架类型（人形或通用），分配武器并设定行为参数，角色就能在场景中开始响应输入并参与战斗。

这套框架的定位非常明确：它不是某个特定类型游戏的模板，而是一个角色创建器和战斗逻辑层的集合。它通过内建的触发器/动作系统将移动、攻击、攀爬、库存、场景切换和多人网络同步等子系统串联起来。在渲染管线上，框架本身不依赖特定管线——它与内置渲染管线、URP 和 HDRP 均兼容，示例场景使用内置管线制作。当前已验证的 Unity 版本包括 2022.3.36f1 和 6000.3.10f1。多人模式通过 Photon PUN 2 实现。

🧬 角色创建器：玩家与 NPC 的点击生成

Combat Framework 将玩家和 NPC 的创建流程统一为同一个生成器界面。你提供角色模型和动画资源，框架接管以下配置：为玩家角色选择第三人称或俯视视角模式；为 NPC 设定阵营、巡逻路径、侦测范围和战斗倾向；将武器绑定到角色的手部骨骼槽位，并为每把武器指定独立的攻击动画集。

玩家角色创建支持人形骨架——任何符合 Unity 人形绑定的模型都可以被驱动。NPC 创建同时支持人形和通用骨架，这意味着动物、怪物或机械敌人也可以接入战斗系统，只要它们使用 Unity 支持的绑定类型。所有动画均使用根运动驱动角色位移，攻击时的步伐与武器的挥舞距离由动画本身的位移数据控制，而非脚本强制移动角色位置，这通常意味着更准确的打击判定和更少的“滑步”现象。

⚔️ 武器动画管理：每把武器独立动画集

框架对武器系统的处理方式体现了“以动画定义手感”的设计思路。每把武器都可以拥有独立的一套攻击动画——一把长剑的挥舞弧线、一把匕首的突刺速度和一把斧头的重劈节奏各自不同，这些差异不是通过脚本参数模拟，而是直接使用不同的动画序列来表现。当你为角色更换武器时，对应的攻击动画集也同步切换，使武器之间的手感差异化建立在真实的动画数据之上。

战斗系统同时支持近战和远程两种模式。近战方面，攻击判定、连击窗口和命中反馈由框架的触发器系统管理。远程方面，投掷物或子弹的生成、弹道和命中效果通过相同的触发/动作系统配置。这两种战斗模式可以在同一个角色上共存——角色可以先用弓箭远程消耗，再拔剑近身交战。

🎬 触发/动作系统与场景交互

Combat Framework 的核心驱动引擎是一套触发器与动作系统。触发器定义“什么时候发生”——进入区域、按下按键、命中敌人、生命值低于阈值；动作定义“发生什么”——播放动画、生成特效、扣减生命、播放音效、激活物体。这两者通过蓝图式节点连接，形成复杂的交互链。

框架内置了大量预置动作，同时开放了自定义动作的创建入口。你可以用这套系统定义：攀爬边缘检测与攀爬动作的触发条件；场景过渡触发器的位置和加载逻辑；库存界面打开时的物品列表生成与选择确认；移动端虚拟摇杆的输入映射与操作响应。边缘攀爬功能通过射线检测识别前方障碍物的高度和边缘类型，然后播放对应的攀爬或翻越动画。俯视视角模式则共享同一套角色控制器，仅改变摄像机方向和输入映射，角色的移动、攻击和交互逻辑不变。

🌐 多人网络与移动端支持

多人模式通过 Photon PUN 2 实现，这是一个成熟的 Unity 多人网络中间件。框架已经将角色移动、攻击、生命值变化、库存操作和场景切换等关键逻辑进行了网络同步配置，不需要从裸 RPC 开始搭建。场景过渡系统与多人网络兼容——多个玩家可以在同一时间进入同一个关卡过渡区域，各自的加载状态由 PUN 的房主-客户端架构管理。

移动端支持覆盖了输入控制和 UI 两个方面。内建的移动端控件提供虚拟摇杆和攻击按钮的预制件，输入映射已完成与角色控制器的对接。库存界面和触发器系统在移动端的触摸交互下正常工作，不需要额外适配。

📚 场景示例与学习资源

包体内含第三人称和俯视视角两套完整示例场景，可以直接运行以评估角色控制、战斗手感和 NPC 行为的表现。用户手册以 PDF 形式提供，覆盖从角色创建到触发器配置的完整流程。代码文档对框架内各模块的 API 和继承关系进行了说明。多个演示视频和持续更新的 YouTube 频道为上手学习提供了视觉化的引导路径。