【4.0.13-2026-08-03 更新SPT客户端 BepInEx 插件 SkyShieldTrainer免费单机并适配【Fika 和 Neko】联机下使用

---

非外挂，是 BepInEx 插件加载的客户端 mod，通过客户端接口来实现，只能 4.0.13 版适配。

---

📌 关于 SkyShieldTrainer

SkyShieldTrainer 是一款基于 BepInEx 的 SPT（Single Player Tarkov）战术辅助插件。它不是外挂，不注入进程，不修改游戏内存，而是通过 BepInEx 框架在 Unity 运行时进行功能扩展。

核心定位：为 SPT 玩家提供单机及联机场景下的战术辅助功能，涵盖天气/时间控制、Loot ESP、人物生成、保镖 AI、特殊子弹、存档安全编辑、品牌欢迎消息与配件兼容辅助、菜单音效等模块。

适配版本：SPT-AKI 4.0.13 / EFT 0.16.9.40087

兼容：Fika 2.3.4（软依赖）/ NekoNx（软依赖）

---

🔧 更新文档 2.1

本次更新涵盖 A、B、C、D、F、G 六个批次的功能修复与新增。所有已实施批次均通过自动测试与实机验收。

批次状态总览

批次	范围	状态
A	天气/时间、Loot ESP、世界交互、负重、移动	✅ 已完成
B	人物生成、真正 PMC、保镖跟随与保护	✅ 已完成
C	六种特殊子弹与命中路由	✅ 已完成
D	存档副本与安全合并	✅ 已完成
F	品牌欢迎消息 + 装备兼容辅助高亮	✅ 已完成
G	菜单音效系统	✅ 已完成

自动测试与构建

• 自动测试：191/191 通过（A 批次 10 项 + B 批次 59 项 + C 批次 80 项 + F/G 批次 42 项）

• 客户端 Release 构建：0 警告 0 错误

• 服务端 Release 构建：0 警告 0 错误

• 安装器 Release 构建：0 警告 0 错误

---

A 批次：核心功能修复

修复天气、时间、Loot ESP、世界交互、负重、移动等单机核心问题。

A1 天气：修正天气类型映射，雨天/雾天/阴天按实际类型生效；雾天不再强制黑屏。

A2 系统时间：使用游戏真实世界时间源，去除本地时钟漂移，HUD 显示的小时、分钟、秒准确无误。

A3 Loot ESP：接入真实价格数据；图标改为物品真实 prefab 图标缓存，告别方框占位。

A4 世界交互：

• 自动开门改为直接调用 WorldInteractiveObjects() + SetDoorState()，通过 Player.vmethod_1 完成完整开门交互，避免反射卡顿。

• 空投 ESP 修复绘制路径，支持飞机、箱体和名称同时显示。

• 穿墙模式修复关闭流程，确保玩家碰撞状态正确恢复。

A5 负重：去除错误的”负重为零”覆盖逻辑；”清除超重”正确重置负重状态。

A6 移动：修正跳跃冲量参数；修复速度倍率应用位置，消除小碎步并实现真实加速。

---

B 批次：人物生成与保镖系统

实现服务端权威人物生成、真正 PMC 身份、三名保镖跟随与保护 AI。

服务端权威 Profile 生成：

• 新增 SPT .NET 9 服务端 Profile 生成模块。

• 客户端只接受服务端权威 Profile，删除旧客户端生成和调试生成回退。

• 建立精确 Role/Side/IsPmc 映射：只有 pmcUSEC 和 pmcBEAR 是 PMC。

• 增加 Profile、Customization、Inventory 和 prefab 严格校验。

Bundle 预载与资源互斥：

• AI 资源加载使用 GetAllPrefabPaths(false) 精确获取。

• 新增 60 秒联动取消机制，超时自动终止加载。

• Bundle 加载采用 16 项批量处理 + 超时递归二分搜索报告阻塞资源。

• 每个 Profile 只提交一次原生完整 Bundle 请求，防止递归重入共享 PoolManager。

保镖生成与跟随：

• 三名保镖使用一次请求和独立 NavMesh 扇形落点。

• 生成回调绑定独立不可变上下文，消除连续请求串线。

• 增加原生友军和 follower 初始化。

Boss 与 Bot 分组：

• Boss 激活：asAlly 与 shallBeGroup 分离；敌对 bossGluhar 使用原生 BotBoss.SetBoss。

• Bot 分组生成：确保 GroupId/TeamId 字段兼容；标识同步失败不阻塞激活。

• 人物、保镖、Boss 三类 ESP 图标均已确认生效。

---

C 批次：特殊子弹系统

实现七种子弹模式与命中路由，所有模式可逐个实机验收。

模式	名称	效果
C0	普通子弹	恢复正常，不附加任何插件效果
C1	爆炸弹	命中后小范围爆炸，真实爆炸组件 + 视觉 + 声音 + 单次范围伤害
C2	燃烧弹	命中后灼烧 5 秒，持续燃烧 + 正确伤害归属
C3	穿墙标记弹	命中目标标记 25 秒，穿透语义 + 真实目标标记 + ESP 消费
C4	EMP 干扰弹	6 米范围干扰电子/AI，不只是钝击伤害
C5	冲击波弹	7 米范围径向冲击 + 适量伤害
C6	吸血弹	命中后回复生命，只在有效命中后恢复明确总量

命中路由架构：每颗被追踪子弹独立 Patch EftBulletClass.Update 检查终止状态；一次命中一次路由，去重处理；模式切换和状态恢复集中管理。

权威边界：单机和 Fika 主机负责世界伤害、AI 状态、爆炸和冲击；Fika 主机广播视觉和临时状态。

已知问题：冲击波弹视觉脉冲生效，actual damage/motion 未完全生效，单目标 try/catch 隔离就位，后续批次按需根治。

---

D 批次：存档副本与安全合并

将 52 个存档菜单操作改造成”游戏运行时只编辑副本，关服后由独立应用安全合并”的可验证存档系统。

工作区架构：

用户选择 SPT 根目录 + Profile
        ↓
创建工作区
  base.json           不可变基线
  working.json        菜单只修改此副本
  manifest.json       强类型、按顺序记录操作
  workspace.json      Profile 身份、路径、哈希、时间和版本
        ↓
关闭 EscapeFromTarkov.exe 与 SPT.Server.exe
        ↓
双击 SkyShieldProfileMerge.exe
        ↓
读取 latest profile
  → 身份与结构校验
  → base / working / latest 三方领域合并
  → 冲突则停止并输出报告
  → 自动备份 + 临时写入 + 原子替换 + 失败回滚

安全原则：

• 现有真实 Profile 在游戏和服务器运行期间始终只读。

• 无权威数据模型的按钮显示明确不支持原因，不伪报成功。

• 禁止整档覆盖；采用三方领域合并 + 冲突检测 + 原子替换 + 失败回滚。

---

F 批次：品牌欢迎与装备兼容辅助

F1 品牌欢迎消息：SPT 服务端加载 Global Locale 时，将原 Beta 警告标题和说明替换为内置品牌消息。同步替换 4 个键：BetaTitle / BetaDesc / WrongGameVersionText / WrongGameVersionHeader。中文 Locale 用中文目录，其他 Locale 用英文安全目录；不包含 URL、域名、Discord 邀请码或外部广告。

F2 装备兼容高亮：在库存、商人、改枪和检查窗口提供配件兼容、替换与冲突高亮。支持三态语义（兼容/替换/冲突）、双向扫描（武器+配件、配件+配件）、事件驱动重算。

⚠️ 重要：只 Patch TraderDealScreen 公共方法；EditBuildScreen / ModdingScreenSlotView / ItemSpecificationPanel / InfoWindow 会导致严重 UI 卡死，不要 Patch。

---

G 批次：菜单音效系统

为 IMGUI 菜单系统增加四向导航音效、回车确认音效，以及 F9/F12 菜单开关音效。

七类音效事件：

事件	触发	波形	时长
NavigateVertical	上/下方向键	800Hz 单频	0.06s
NavigateHorizontal	左/右方向键翻页	700Hz 单频	0.06s
Confirm	Enter / 小键盘 5	500+700Hz 和弦	0.12s
MenuOpen	F9 打开主菜单	400→800Hz 上升扫频	0.20s
MenuClose	F9 关闭主菜单	800→400Hz 下降扫频	0.15s
FlyMenuOpen	F12 打开飞行菜单	600→1000Hz 上升扫频	0.18s
FlyMenuClose	F12 关闭飞行菜单	1000→400Hz 下降扫频	0.15s

技术方案：采用 AudioClip.Create + SetData 程序化生成 PCM 正弦波，支持单频、和弦、扫频三种波形，同步生成即时可用，无需文件 IO、嵌入资源或协程。

核心经验（6 轮实机验收）：

1. AudioClip 必须懒加载：BepInEx Main.Awake 阶段 Unity 音频系统未就绪，AudioClip.Create + SetData 会静默返回空壳 clip（samples=0），必须延迟到用户首次按键时生成。

2. AudioSource native 生命周期需显式管理：场景切换可能销毁 native 对象，EnsureSourceAlive + RebuildSource 自动检查并重建。

3. 诊断优于猜测：前 3 轮失败均因猜测盲修，第 5 轮通过综合诊断日志一次性定位根因。

---

🖥️ 安装器使用指南

SkyShieldTrainer 安装器（RuntimeShell.exe）是独立的 WPF 桌面程序，所有部署文件内嵌其中，单文件分发。

核心特点

• 自动检测：自动查找游戏目录、检测进程占用、识别已安装版本

• 智能按钮：根据状态自动切换为”安装 / 升级 / 降级 / 修复”

• 双路径一致性：客户端 DLL 同时部署到根目录和子目录，哈希完全一致

• 驻留监控：安装完成后可隐藏后台，游戏退出后自动清理部署文件

• 安全卸载：默认只删 DLL，保留配置、快捷键和语言包

首次安装步骤

1. 关闭游戏：确保所有游戏进程（EscapeFromTarkov、SPT.Server、SPT.Launcher）已退出

2. 运行安装器：双击 RuntimeShell.exe，自动检测游戏目录

3. 确认选项：

• ✅ 双路径一致性部署（推荐）

• ✅ 部署服务端模组（品牌欢迎消息必需）

• ✅ 部署保镖 AI 适配器（需 BigBrain 插件）

• ✅ 保留 keyMenu.xml 自定义设置

4. 点击安装：1-3 秒完成，查看 SHA256 部署报告

5. 启动游戏：完成页点击”🚀 启动游戏”

升级与修复

安装器会自动识别版本状态：

状态	按钮显示	说明
全新安装	“安装”	目录下无 SkyShieldTrainer
升级	“升级到 v2.1.0”	内嵌版本更高，自动备份旧版
降级	“降级 ⚠️”	内嵌版本更低，需二次确认
修复	“修复 / 重新安装”	版本相同，重新部署不覆盖配置

卸载

点击红色”卸载”按钮，默认模式为安全卸载（只删 DLL，保留配置、快捷键、语言包）。可选深度清理模式恢复到未安装状态。

更多功能

“更多 ▼” 菜单提供：

• 🔧 一键修复安装

• ↩️ 一键回滚到最近备份

• 📂 打开插件日志目录（排查问题必备）

• ⚙️ 打开插件配置文件

• 🔌 一键强制结束所有游戏进程

---

🎮 Fika + NekoNx 兼容层

SkyShieldTrainer 通过软依赖兼容 Fika 和 NekoNx 联机模式：

[BepInDependency("com.fika.core", SoftDependency)]
[BepInDependency("com.nekoparty.core", SoftDependency)]
[BepInDependency("com.nekoparty.groupex", SoftDependency)]

五种游戏模式识别

• 单机 = SINGLE PLAYER

• 房主 = ◆ HOST（金色徽标）

• 无头房主进程 = ★ HEADLESS HOST（亮金徽标）

• 客机 = CLIENT（银色徽标）

• NekoNx 队长 = 追加 · PARTY LEADER

菜单头部实时显示身份徽标，方便确认当前模式。

权限分级（联机模式下）

级别	功能	单机	房主	无头房主	客机
L0	存档	✅	✅	✅	✅
L1	显示	✅	✅	✅	✅
L2	武器	✅	✅	✅	✅
L3	本地状态	✅	✅	✅	✅
L4	世界控制（天气/传送/生成/保镖）	✅	✅	✅	❌
L5	服务端管理	✅	✅	✅	❌

客机点 L4/L5 功能会弹红色提示”此功能仅房主可用”。

---

⚠️ 已知限制

1. 客机无法触发无头房主执行 L4 操作——需要跨端 RPC 通信协议，工作量大，暂未实现

2. Bundle 预加载在 Fika 客机模式未测试过

3. 存档修改仅本局内存生效，raid 结束回大厅后由服务器保存的 Profile 覆盖（SPT 服务器架构限制，客户端 mod 无法绕过）

4. 菜单启动页/主菜单背景劫持已移除——会挡战局摄像头，不适合

---

🎯 使用提示

快捷键	功能
F9	打开/关闭主菜单
F12	打开/关闭飞行菜单
上/下方向键	菜单上下导航
左/右方向键	菜单翻页
Enter / 小键盘 5	确认选择
Backspace	关闭飞行菜单

联机模式下如果发现某功能被拒绝，先看菜单头部身份徽标——如果显示 CLIENT，说明你不是房主，L4 世界控制类功能受限。

---

📝 更新日志

2026-07-15

• 新增 keyMenu.xml，可自行调控菜单按钮

• 战术雷达和 T 独自添加开关

• 修复选项提示错位问题

• 标题背景图更新

2026-07-30

• 修复 A 类 Bug：Bot 生成只有一把枪+衣服，没身体没头脸

• 修复 B 类 Bug：不会生成 PMC

• 修复 C 类 Bug：Boss 只会生成 Killa

• 修复 D 类 Bug：保镖生成后不在附近，且是敌方单位

• 修复飞行模式无法开镜（ADS）

• 修复夜视仪/T7 热成像功能状态错乱

• 修复开 DLSS 后透视方框错位

2026-08-03（v2.1）

• ✅ A 批次：天气/时间/Loot ESP/世界交互/负重/移动 6 项核心修复

• ✅ B 批次：服务端权威人物生成、真正 PMC、保镖跟随与保护、Boss 分组

• ✅ C 批次：7 种特殊子弹模式（爆炸/燃烧/穿墙标记/EMP/冲击波/吸血）

• ✅ D 批次：存档副本 + 三方领域合并 + 安全回滚

• ✅ F 批次：品牌欢迎消息 + 装备兼容辅助高亮

• ✅ G 批次：菜单音效系统（7 类音效事件，程序化 PCM 生成）

• ✅ 安装器升级为 v2.1：双路径部署、版本识别、驻留监控、一键回滚

• ✅ 191/191 自动测试通过

---

🔗 相关资源

• 语言文件：BepInEx\plugins\SkyShieldTrainer\Lang\ 下 cn.xml（中文）和 en.xml（英文），如需更多语言支持，自行创建翻译文件放入该文件夹即可

• 配置文件：游戏首次运行后在 BepInEx\config\ 下自动生成 SkyShieldTrainer_default.json

---

善语结善缘，恶言伤人心，拒绝网络暴力。

本文档由 SkyShield 2026 出品，仅供学习交流使用。