加尼黛莉亚 乐园净土音乐动作模组

【标题】
《星刃》「极乐净土」舞蹈动作 MOD 使用指南

【核心介绍】
为 Eve 添加 Garnidelia《极乐净土》完整舞蹈动作，支持键盘触发，含音乐自动播放功能。

【安装指南】

1. 下载并安装前置依赖：本 MOD 安装前，需同步安装前置依赖的 MOD「UE4SS（RE-UE4SS）」——推荐使用 v3.0.0 或更高版本；
2. 将模组文件夹「Gokurakujodo_P」完整复制至路径：`StellarBlade\SB\Content\Paks\LogicMods\`（即最终路径为：`StellarBlade\SB\Content\Paks\LogicMods\Gokurakujodo_P`）；
3. 必做配置：编辑 `ue4sssettings.ini` 文件（位于 `StellarBlade\SB\Binaries\Win64\ue4ss\`），确保以下参数已启用（其余保持默认）： ``` [Debug] ConsoleEnabled = 1 GuiConsoleEnabled = 1 GuiConsoleVisible = 1 GraphicsAPI = dx11 [Hooks] HookProcessInternal = 1 HookProcessLocalScriptFunction = 1 HookInitGameState = 1 HookLoadMap = 1 HookCallFunctionByNameWithArguments = 1 HookLocalPlayerExec = 1 HookAActorTick = 1 HookEngineTick = 1 HookGameViewportClientTick = 1 FExecVTableOffsetInLocalPlayer = 0x28 ``` 4. 将脚本文件「toggledev.vbs」放入 `StellarBlade\SB\Binaries\Win64\ue4ss\` 文件夹（与 `ue4ss.exe` 同级）；
4. （可选）如需启用 jiggle 物理效果，请先安装独立模组「Jiggle Physics for Stellar Blade」（NexusMods 链接）。

【功能详情】
✅ 已优化：Eve 全身舞蹈动作（含手部、躯干、腿部协调动画），适配原版模型比例；
✅ 已优化：内置《极乐净土》BGM，触发后自动循环播放至舞蹈结束；
✅ 已优化：双触发键支持——主用 数字键 5，无数字键盘用户可用 F1 键（已包含对应版本文件）；
❌ 未修改：角色基础模型、骨骼结构、材质贴图；
✨ 额外调整：舞蹈期间禁用玩家移动输入（防止动作中断），音乐播放逻辑与动画严格同步。

【使用要求】

• 必须安装游戏本体《星刃》（Stellar Blade）；
• 必须安装并正确配置「UE4SS（RE-UE4SS）」v3.0.0+；
• 系统需支持 DirectX 11（`GraphicsAPI = dx11` 为必需项）；
• 不支持 UE4SS 的旧版（如原生 UE4SS 或非 RE 分支版本）。

【兼容性说明】

• 兼容范围：所有未修改 `LogicMods` 加载逻辑的常规动作类、UI 类、音效类 MOD；
• 不兼容模组：修改 `AActor::Tick` 或 `UGameViewportClient::Tick` 行为的模组（如部分帧率解锁器、深度调试工具）；
• 暂未推出：与其他舞蹈动作模组的共存补丁；暂未推出音乐自动停止控制补丁。

【注意事项】

• 舞蹈过程中若手动退出或切出游戏，音乐不会自动停止（当前技术限制，需手动关闭音频或重启游戏）；
• 若触发无效，请确认 `ue4sssettings.ini` 中 `HookAActorTick = 1` 和 `HookLocalPlayerExec = 1` 已启用；
• 「F1 版本」与「数字键 5 版本」文件不可混用，仅保留其一即可；
• 请勿将 `Gokurakujodo_P` 放入 `/mods` 或 `/Paks/` 根目录，必须置于 `/Paks/LogicMods/` 子目录下。

【更新日志】

• 2024 年 4 月 12 日 初始发布，含数字键 5 / F1 双触发支持、内置音乐、基础 jiggle 兼容说明；
• 2024 年 4 月 15 日 补充 `ue4sssettings.ini` 关键参数清单，明确 `GraphicsAPI = dx11` 强制要求。