迷踪闪烁

✨ Serena's Enchanted Teleport ✨

点选。中键点击。闪现。

光标传送 • 世界 + 当前地图 • Withergate 魔法 • 场景内安全

Serena's Enchanted Teleport 为《Sun Haven》添加了快速魔法闪现功能。将鼠标指向世界中的任意位置，然后按下鼠标中键即可传送到该处。

当地图打开时，同样的操作也适用，你可以指向当前区域内的目的地，直接闪现过去。

每次闪现使用《Sun Haven》自带的 Withergate 传送魔法，简化为快速的消失和到达效果，与游戏风格浑然一体。

这是同区域闪现，并非跨城镇快速旅行。 它绝不会加载其他城镇、区域或场景。

✦ ───────────────────── ✦

🪄 主要功能 🪄

• 传送到光标处 — 指向世界中的某处，按下鼠标中键即可闪现到精确位置。
• 当前地图传送 — 打开地图，指向当前区域内的目的地，按下鼠标中键即可传送过去。
• 原生 Withergate 魔法 — 使用《Sun Haven》现有的 Withergate 传送法术效果作为消失与到达的视觉效果。
• 精确目标定位 — 使用《Sun Haven》的世界平面光标转换机制，而非将每个目的地吸附到导航格中心。
• 阻挡位置检测 — 具有活动导航网格的区域会拒绝被阻挡或超出区域范围的目的地。
• 无随机重定向 — 无效目的地会被拒绝并显示游戏内通知，而不会将你送到其他地方。
• 安全保护 — 在对话、过场动画、场景加载、场景切换、其他传送进行中或闪现动画期间，传送会被禁止。
• 无魔力消耗或距离限制 — 在当前场景内的任何有效位置都可以闪现。当前动画结束后即可再次使用闪现。
• 存档安全 — 不会修改任务、解锁项、位置或存档数据。

✦ ───────────────────── ✦

🖱️ 如何进行闪现 🖱️

在世界中闪现

1. 将鼠标指向你计划前往的目的地。
2. 按下鼠标中键。
3. 如果目的地有效，你的角色将使用 Withergate 传送效果闪现到该处。

背包打开时，世界闪现功能会暂时禁用。

从地图闪现

1. 打开《Sun Haven》的地图。
2. 确保显示的地图对应你当前所在的区域。
3. 指向该地图内的一个目的地。
4. 按下鼠标中键。
5. 闪现成功后，地图会关闭，你将回到世界中的所选目的地。

地图闪现仅在当前场景提供可用的本地地图位置转换功能时有效。

✦ ───────────────────── ✦

🗺️ 仅限当前区域 🗺️

Enchanted Teleport 绝不会加载另一个场景、城镇或区域。

你不能用它从 Sun Haven 传送到 Withergate、Nel'Vari 或其他独立区域。跨区域传送被有意排除在外，以避免不安全的场景加载和存档相关问题。

如果地图显示的区域与你当前所在位置不符，传送将被拒绝。

✦ ───────────────────── ✦

🌿 目的地安全 🌿

当当前区域提供活动导航网格时，模组会在移动你的角色之前检查所选目的地。

被阻挡的位置和可用区域之外的点会被拒绝。模组不会将你的目的地吸附到其他格子，也不会静默地将你重定向到最近的有效位置。

部分农场场景不提供《Sun Haven》的可选导航网格。在这些区域，模组会保留你的精确光标位置，而不进行额外的阻挡位置校验。在这些农场周围闪现时，请选择合理的开阔地面。

✦ ───────────────────── ✦

🔮 Withergate 传送魔法 🔮

默认情况下，每次成功的闪现都会使用《Sun Haven》原生的 Withergate 传送法术效果。

该效果被加速为快速的消失与到达序列，你的角色在移动过程中会短暂隐形。

如果配置中禁用了原生传送视觉效果——或者该效果无法加载——移动仍会在没有视觉效果的情况下完成。

✦ ───────────────────── ✦

📦 前置要求 📦

• 通过 Steam 在 Windows 上运行的《Sun Haven》。
• 已正确安装 Sun Haven BepInEx 5.4.23.5 整合包。

✨ 安装方法 ✨

1. 如果尚未安装 Sun Haven BepInEx 5.4.23.5 整合包，请先安装。
2. 下载主文件。
3. 将压缩包内的 BepInEx 文件夹解压到你的《Sun Haven》主游戏文件夹中。
4. 确认 DLL 文件位于：

Sun Haven\BepInEx\plugins\Serena's Enchanted Teleport.dll

1. 启动《Sun Haven》并加载一个角色。
2. 指向附近的某个位置，按下鼠标中键进行闪现。

✦ ───────────────────── ✦

⚙️ 配置选项 ⚙️

配置文件在模组首次运行后生成：

Sun Haven\BepInEx\config\serena.sunhaven.enchantedteleport.cfg

• Enabled = true — 启用或禁用整个模组。
• MouseButton = 2 — 选择用于传送的鼠标按键。2 代表中键或滚轮按键。设为 -1 可禁用该快捷键。
• WorldTeleport = true — 启用正常游戏过程中的光标传送。
• MapTeleport = true — 启用从当前本地地图进行传送。
• UseNativeTeleportVisuals = true — 启用《Sun Haven》的 Withergate 传送效果。
• DebugLogging = false — 向 BepInEx 日志中添加额外的诊断信息。

该模组目前仅支持鼠标输入。它不包含键盘或手柄按键绑定。

✦ ───────────────────── ✦

🌙 兼容性与限制 🌙

• 传送仅限于当前所在场景。
• 该模组不提供跨城镇旅行、路径点、可解锁目的地或传统快速旅行。
• 无导航网格的农场区域将接受精确光标位置，不提供导航网格场景中可用的阻挡位置校验。
• 背包打开时，世界传送会被禁用。
• 该模组不包含专门的多人游戏同步功能。多人游戏兼容性目前尚未测试。
• 修改玩家移动、地图输入、传送状态或相同界面方法的模组可能产生冲突。
• 《Sun Haven》的重大更新可能需要本模组进行审查和更新。

✦ ───────────────────── ✦

🧹 卸载方法 🧹

删除以下文件：

Sun Haven\BepInEx\plugins\Serena's Enchanted Teleport.dll

你也可以删除生成的配置文件：

Sun Haven\BepInEx\config\serena.sunhaven.enchantedteleport.cfg

该模组不会向你的角色存档中添加任何内容，因此可以在不遗留任务、解锁项或传送目的地的前提下安全移除。

✦ ───────────────────── ✦

🛠️ 故障排查与 Bug 报告 🛠️

如果按下鼠标中键没有反应：

1. 确认 BepInEx 是否正确加载。
2. 确认 Serena's Enchanted Teleport.dll 位于 BepInEx\plugins 文件夹中。
3. 确保你已完全加载角色。
4. 尝试在当前区域内选择一个开阔的目的地。
5. 尝试世界闪现前请先关闭背包。
6. 如果使用地图，请确认地图显示的是你当前所在的区域。
7. 确认配置中 Enabled、WorldTeleport 或 MapTeleport 没有被禁用。

报告问题时，请附上你的模组版本号、问题发生的区域、是使用世界闪现还是地图闪现，以及以下文件中相关的内容：

BepInEx\LogOutput.log

✦ ───────────────────── ✦

🌸 致谢 🌸

由 Serena Enchanted 制作。

愿每一段旅程都只隔一次闪现之遥。