需要先安装 BepInExPack_Silksong。已装可跳过。
把 BepInEx/plugins/soul_swap.dll 复制（覆盖）到 <游戏目录>/BepInEx/plugins/。启动游戏即生效，无需额外开关。
| 按键 | 作用 |
|---|---|
Alt+H |
附体范围内最近的敌人；再按一次解除（回到 Hornet） |
A / D |
操控敌人左右移动 |
Space |
跳跃 |
J |
放敌人的攻击招式（连按会依次换别的招式） |
L |
放敌人的技能招式（连按同样轮换） |
附体后你操控最近的敌人；原来的 Hornet 变成 AI 对手，会先原地停顿约 2 秒再开始追你、砍你。
J/L 是把招式交给敌人自己的状态机执行，所以动作、位移、判定、弹幕与它平时放同一招一致；一次按键只执行一次招式，不会接着自己出招。
附体期间敌人不会自己走动、不会自己攻击；只有它按 J/L 放出的招式才打得到你。
放招那一下移动交给招式本身——带冲刺/前冲的招式会真的冲出去。
你操控的敌人被打死时：解除附体、你回到 Hornet（不会跟着死），敌人自己走死亡流程。
敌人自身没有重力（飞行敌人，或空中招式临时关掉重力）时会补上重力，能正常落回地面。
切换场景、Hornet 死亡、或再次按 Alt+H 都会解除附体。
首次启动生成 <游戏目录>/BepInEx/config/com.modcraft.soul_swap.cfg，常用几项（改完重启游戏生效）：
| 配置项 | 默认 | 说明 |
|---|---|---|
Hotkey |
Alt+H |
附体/解除快捷键 |
MaxDistance |
25 |
最大附体距离；0 = 不限距离 |
EnemyMoveSpeed |
9 |
操控敌人的移动速度 |
LoopMoveAnimation |
true |
移动动画是一次性位移动画时连续续播（例如蕾丝） |
EnemyGravityScale |
1 |
敌人自身没有重力时补上的重力；0 = 不干预（会悬空） |
AllowAbilityChaining |
false |
招式结束后是否允许状态机自己继续连招 |
HornetAiStartDelaySeconds |
2 |
AI 霍妮特开始行动前的停顿时间 |
HornetAutoJump |
false |
AI 霍妮特是否跟着你一起跳 |
不同敌人的招式结构差异很大：招式命名不规范、或没有独立攻击判定的敌人，J/L 效果可能不理想。
走路/转向动画取自敌人自身的运动组件与巡逻动作；完全自定义命名又没有这些组件的敌人可能没有走路动画。
不修改存档；解除附体时会把敌人的 AI、重力、动画与判定还原。
