ImmersiveLevitate_Addon_MagicArcher

一个小型配套模组，感谢原作者

[url=https://www.nexusmods.com/dragonsdogma2/mods/525]IMMERSIVE Levitate by BeerShigachi[/url] 是实现这一切的基础模组。请先下载并支持原版模组。飞行体验及其可配置的移动/耐力功能均属于该项目；这个小型附加模组只是将魔弓手接入其中。

我作为 IMMERSIVE Levitate 的粉丝，为自己的个人游玩制作了这个模组，并在此分享，以防其他玩家觉得有用。这是一个非官方配套模组，并非官方更新或经认可的发布版本。如果原版模组添加了等效的魔弓手支持，我打算停用此附加模组，在 Nexus 允许的范围内将其从公开渠道下架，并引导用户改用原版。感谢 BeerShigachi 制作了这款我一直想继续使用的模组。

[b]功能[/b]
在安装了 IMMERSIVE Levitate 的情况下，让玩家控制的魔弓手能够启动原生悬浮。使用你映射的跳跃按键，包括控制器重新映射。普通地面跳跃仍由游戏控制。此版本仅支持魔弓手，不支持所有武器或随从。

[b]前置需求[/b]
- Dragon's Dogma 2 (PC)
- [url=https://www.nexusmods.com/dragonsdogma2/mods/8]REFramework[/url]
- [url=https://www.nexusmods.com/dragonsdogma2/mods/525]IMMERSIVE Levitate 3.4.0[/url]，需单独安装并启用
- [url=https://www.nexusmods.com/site/mods/818]Fluffy Mod Manager[/url]，用于打包安装
此附加模组不需要 ScriptCore。请勿将其与 Better Levitate / All Weapon Levitate 组合使用。其他悬浮或动作/输入模组可能会冲突；未经测试的任意组合未经验证。

[b]安装与首次设置[/b]
1. 关闭游戏。按照各自作者的说明安装 REFramework 和 IMMERSIVE Levitate。
2. 将此 ZIP 添加到 Fluffy Mod Manager，并启用 ImmersiveLevitate_Addon_MagicArcher。
3. 以法师或巫师身份启动游戏并悬浮一次。在 REFramework 的 Script Generated UI 中，检查此附加模组是否显示 "Calibrated"。
4. 切换为魔弓手。校准结果会被保存，因此通常只需执行一次。

[b]操作[/b]
- 在地面按跳跃：普通跳跃。
- 松开，然后在空中再次按跳跃：开始悬浮。
- 按住第二次按下：上升。
- 松开：悬停。
- 使用移动输入：移动和转向。
- 悬停时再次按跳跃：取消悬浮。
- 取消后松开并再次按下：重新悬浮，受 IMMERSIVE 的限制约束。
使用 IMMERSIVE 的设置来调整速度、高度和耐力。此附加模组不会减少坠落伤害。在救援/接住或动作被打断后，请安全落地、恢复正常控制并松开跳跃键，然后再尝试。

[b]更新 / 卸载[/b]
关闭游戏，在 Fluffy 中禁用旧版本，然后启用新的 ZIP。在 Fluffy 中禁用此附加模组即可卸载。reframework/data/ILBridge 下的设置会被有意保留。请勿将手动副本与 Fluffy 管理的副本同时安装。下载内容仅包含此附加模组原有的 Lua 文件和文档；不包含原版模组的脚本、REFramework 二进制文件、游戏文件、个人设置或日志。

[b]初始 alpha 版：已测试范围与限制[/b]
版本 0.1.0-alpha.6。在我自己的配置中，我确认了魔弓手悬浮、重新映射后的三角键按住上升、松开悬停、转向，以及在随从接住后重新使用。接住/重试修复已于 2026 年 9 月 25 日确认。自动化 Lua 测试覆盖 82 项断言；这些不能替代实际游玩测试。
测试环境：IMMERSIVE Levitate 3.4.0；REFramework 提交 d1461375aee4ec3f313170f8eaad12064eb542d9（构建于 2026 年 9 月 16 日；标签 v1.5.9.1 加 507 次提交）；DD2.exe 文件版本 3.2.0.0，TDB 83。
完整的键盘、死亡/读档重载、战斗/梯子、耐力和长时间游玩回归测试矩阵仍不完整。不保证未来游戏或依赖项更新兼容。此附加模组会检查所需的 API 签名，并在功能不可用时显示原因。

[b]故障排除与报告[/b]
检查 REFramework > Script Generated UI > ImmersiveLevitate_Addon_MagicArcher。"Release current action (recovery)" 可请求释放卡住的动作。安装更改后请重启游戏。报告时请附上附加模组/IMMERSIVE/REFramework/游戏版本、职业、输入设备和跳跃映射、确切步骤，以及显示的状态/错误。"Write diagnostics" 会保存 reframework/data/ILBridge/diagnostics.json；分享前请检查，并移除你不想公开的任何内容。

[b]鸣谢[/b]
BeerShigachi：IMMERSIVE Levitate，不可或缺的原版模组与灵感来源。
praydog 及 REFramework 贡献者：REFramework。
FluffyQuack：Fluffy Mod Manager。
0pi0n：此独立配套模组、个人游玩测试与发布。在 AI 编码辅助（OpenAI Codex）下开发。
不主张与原作者有任何关联或获得其认可。

[b]日本語[/b]
本家 IMMERSIVE Levitate（BeerShigachi氏）を愛用する一ユーザーが、個人プレイ用に作ったマジックアーチャー向けの非公式追加MODです。本家の機能と作者への敬意を前提として公開しています。本家に同等機能が実装された場合は、本追加MODの公開を取り下げる予定です（Nexusの保存・アーカイブ仕様に従います）。まず本家を導入し、ぜひそちらを応援してください。
最初にメイジ／ソーサラーで一度浮遊して「Calibrated」を確認後、マジックアーチャーへ変更してください。ジャンプ→離す→空中で再度ジャンプで浮遊開始、押し続けると上昇、離すと高度維持、次のジャンプで解除します。全武器版ではありません。導入手順の日本語版はZIP内の reframework/data/ILBridge/docs/README.md にあります。