NPC核心

【标题】
《7 Days to Die》NPC 角色系统核心框架 MOD 使用指南
【核心介绍】
提供可扩展的 NPC 角色基础架构，支持自定义人形/动物角色、高级 AI 行为、派系关系、雇佣跟随、血月攻击等完整功能，供其他模组作者复用开发。
【安装指南】
1. 必须同时安装两个核心模组：「0-SCore」（含 C 代码）与「0-XNPCCore」（含 XML 模板），缺一不可；
2. 「0-SCore」版本必须严格匹配游戏版本（例：游玩 v2.0 游戏时，须使用 v2.0.x 版本的「0-SCore」；加载新版将导致错误）；
3. 将两个模组文件夹同时放入游戏根目录 /mods 文件夹，并确保加载顺序为：`0-SCore` → `0-XNPCCore`（序号自动保障）；
4. 扩展包（如「1-士兵包」「2-士兵派系包」）需按前缀数字升序安装（即 `0-` → `1-` → `2-`），否则无法识别。
【功能详情】
✅ 已优化
– NPC 支持原版全部人形功能：骨骼动画、根运动、车辆碰撞、布娃娃效果、数百种反应动画、肢体斩首与血腥效果（XML 可重贴图扩展外观）；
– 全新 UAI 人工智能系统：实时决策（攻击/逃跑/掠夺/跟随/武器距离优化）、POI 潜伏兼容、血月主动攻击；
– 雇佣系统：NPC 可成为忠诚同伴，支持命令跟随/停留、图标化完全控制；
– 派系系统：NPC 分属不同派系（友好/敌对），敌对者追击更积极；
– 安全机制：NPC 卡住、失联或死亡时自动传送至玩家床铺；
– 移动协同：步行跟随同步节奏，乘车时自动隐藏，下车后立即回归；
– 自我治疗 + 医疗包互助；
– 逼真空闲行为（聊天、漫步）、蹲下同步、武器切换（支持部分玩家武器）；
– POI 路径可为每个 NPC 单独定制；
– 架构模块化：新增角色/行为仅需添加对应 XML 或脚本。
❌ 未修改
– 动物类 NPC 不支持布娃娃效果；
– NPC 无需喂养或供水（当前版本无此功能，未来可能添加）。
✨ 额外调整
– 提供独立 Unity 教程项目（含控制器、模板、脚本），降低新角色开发门槛；
– 新控制器已优化，彻底解决原版常见动画异常问题。
【使用要求】
– 必须运行游戏 A16 或更高版本（v2.0 及以上推荐）；
– 不兼容旧版 SCore：若游戏为 v2.0，则「0-SCore」必须为 v2.0.x 分支，严禁混用跨版本文件。
【兼容性说明】
– 兼容范围：所有遵循 `0-`/`1-`/`2-` 命名规范的官方及社区扩展包（如「1-蜘蛛包」「2-士兵派系包」）；
– 不兼容模组：直接修改底层 AI 控制器或覆盖 `EntityClass` 核心定义的模组（例：早期自定义 EAI 替换模组）；
– 暂未推出兼容补丁。
【注意事项】
– 加载顺序错误（如 `0-XNPCCore` 在 `0-SCore` 前）会导致 NPC 无法生成；
– 动物 NPC 无法被“公爵”（Duke）类指令指挥，请使用肉类交互尝试雇佣；
– 部分自定义武器需在 XML 中显式启用，非全部玩家武器默认可用；
– POI 内 NPC 行为严格依赖其体积属性配置，修改 POI 时请同步检查 NPC 路径定义。
【更新日志】
– 2023 年 11 月 5 日 新增武器切换功能，支持将玩家武器导入 NPC 存储并启用；
– 2023 年 9 月 12 日 重构控制器模块，修复蹲下不同步、动画穿模等高频问题；
– 2023 年 7 月 20 日 开放 Unity 教程项目，含完整 NPC 创建工作流示例。