圆转纯熟

一份直击核心的入门介绍。看完这一篇，你就知道它是什么、能干什么、为谁而做。

版本：1.0.0 ｜插件 GUID：`com.skyshield.scripthook`

SkyShieldTrainerScriptHook 是一个”功能桥梁”DLL——它把 SkyShieldTrainer 训练器的核心能力（回血、传送、生成物品、屏幕提示）打包成稳定的 C# 接口，让任何第三方开发者写自己的 Mod 时，一行代码就能调用这些功能。

二、用一个

比喻理解

把 SkyShieldTrainer 想象成一家装修好的厨房，里面有各种强大的厨具（回血、传送、生成物品……）。

过去：这些厨具都锁在厨房里，只有主人（训练器自己）能用。
现在：ScriptHook 相当于在厨房墙上开了一个标准化的传菜口（API）。外面的人（第三方 Mod）不需要进厨房、不需要知道厨具怎么造，只要对着传菜口喊一句”给我回满血”，功能就实现了。

                    ┌─────────────────────────────┐    第三方 Mod  ───▶ │  ScriptHook（标准传菜口/API） │ ───▶  游戏生效    (别人写的)       └─────────────────────────────┘                        SkyShieldHook.Api.Character.Heal();

三、它到底是什么（技术定义）

维度	说明
本质	一个独立的 BepInEx 插件 DLL（`SkyShieldTrainerScriptHook.dll`）
作用	对外暴露稳定的 C# API，供其他 Mod 调用游戏增强功能
目标框架	.NET Framework 4.8
运行环境	SPT（Single Player Tarkov）+ BepInEx
独立性	完全独立工程，不依赖主训练器源码，可单独安装、单独编译
加载方式	游戏启动时由 BepInEx 加载，`Awake` 时注册 API 到静态门面

四、它能做什么（四大能力）

ScriptHook 目前对外开放四个模块：

模块	能力	典型用途
🩺 角色/生命 `Character`	回血、补水补能、无限体力、零负重、无敌、清负面效果	一键”上帝模式”
🚀 传送 `Teleport`	传送到坐标 / 撤离点 / Boss / 准星 / 随机点	快速转移、探图
📦 生成 `Spawn`	按模板 ID 生成物品到背包或地面	发放物资、刷道具
💬 HUD 提示 `Hud`	屏幕弹出提示卡片	给操作做视觉反馈

完整函数清单见 API_Reference.md。

五、为什么需要它（解决什么问题）

没有 ScriptHook 时

想给游戏加个”按键回血”功能，开发者得：

自己研究游戏内部的 HealthController 结构；
自己写反射、处理不同游戏版本差异；
每个想做类似功能的人，都要把这些坑重踩一遍。

有了 ScriptHook 后

if (SkyShieldHook.IsReady && SkyShieldHook.Api.InRaid)     SkyShieldHook.Api.Character.Heal();   // 就这一行

底层的反射、版本兼容、防卡处理，ScriptHook 都封装好了。开发者只管调用，不管实现。

六、谁会用到它

人群	怎么用
Mod 开发者	引用本 DLL，快速做出带增强功能的 Mod，不必重复造轮子
玩家	安装别人基于 ScriptHook 写的 Mod，享受功能
学习者	参考它理解”插件如何对外暴露 API”“训练器功能如何工程化封装”

七、它是怎么工作的（30 秒原理）

游戏启动    │    ├─ BepInEx 加载 ScriptHook（先）    │     └─ Awake() 里把 API 实例注册到 SkyShieldHook.Api    │    ├─ BepInEx 加载 你的 Mod（后，靠 [BepInDependency] 保证顺序）    │     └─ Update() 里判断 SkyShieldHook.IsReady 后调用    │    └─ 你调用 Api.Character.Heal()          └─ ScriptHook 内部通过运行时反射操作游戏对象 → 生效

三个关键点：

静态门面 SkyShieldHook.Api——全局唯一访问点。
就绪判断 IsReady——确保 API 已注册。
战局判断 InRaid——大部分功能要求在战局内。

八、它不是什么（边界澄清）

❌ 不是独立的作弊菜单——它没有自己的 UI 主菜单，是”给别人调用的库”。
❌ 不是主训练器的替代品——它是主训练器能力的”对外接口层”。
❌ 暂不包含 ESP/自瞄等逐帧渲染功能——这类功能不适合做成函数调用（见 PLAN.md 的边界说明）。
❌ 不做存档离线编辑（技能/任务/商人等）——留待后续版本。

九、下一步读什么

你想做的事	去读
查每个函数怎么用	API_Reference.md
学怎么写 Mod 接入它	Integration_Guide.md
搭建编译/开发环境	Environment_Setup.md
了解项目设计与规划	PLAN.md

十、最小体验（贴上就能跑）

using BepInEx; using SkyShieldTrainerScriptHook.Api; using UnityEngine; [BepInPlugin("com.example.hello", "HelloScriptHook", "1.0.0")] [BepInDependency("com.skyshield.scripthook")] public class Hello : BaseUnityPlugin {     void Update()     {         if (SkyShieldHook.IsReady && Input.GetKeyDown(KeyCode.H))         {             SkyShieldHook.Api.Character.Heal();             SkyShieldHook.Api.Hud.Notify("已回满血！", Color.green, 2f);         }     } }

这就是 SkyShieldTrainerScriptHook——让功能触手可及的那座桥。

在下载地址中存有文件【需要开发经验比较好理解】：

API_Reference.md[ 对外暴露的所有公开接口]

Environment_Setup本文档指导你从零搭建开发环境：既包括，也包括。]

Integration_Guide本文档教第三方开发者如何从零创建一个自己的 Mod，并接入 SkyShieldTrainerScriptHook.dll.md[BepInEx、请您先自主学习基础电脑技能知识

补充：

我在现实中，遇到太多太多，双击安装器，解压目录，文件格式是md就打不开，什么是根目录，什么是请您先自主学习基础电脑技能知识！！！！我都被问烦了，特意写，特意明确告知此类玩家，请您先自主学习基础电脑技能知识！！！！