Mazzle的射程测定器

概述

RangeFinder 是一款能生成夺目游戏内可视化效果的模组，用于显示角色移动或攻击时可达到的最远距离。这让玩家能更好地评估风险并规划策略。RangeFinder 也允许您自动化移动并撤销您的操作。如果您玩过基于网格的回合制战斗游戏，例如最终幻想系列或幽浮2，它们通常会高亮显示您可到达的格子以及敌人在下一回合能攻击到的格子。本模组正是尝试将类似功能带入《博德之门3》这个复杂得多的世界。

公告

版本 2.0 已发布 - 2025年12月25日

所有输入延迟已消除！

异步处理 RangeFinder 的处理过程现已异步化，因此不再会干扰玩家的操作。这使得所有 RangeFinder 处理都很容易中断，并允许《博德之门3》（和其他模组）在生成可视化效果的同时执行其自身的操作。

用户/游戏活动监控 为了确定创建和取消可视化效果的最佳时机，RangeFinder 现在会监控用户与游戏的交互以及游戏是否正在执行某些活动。它只会在活动间歇时自动执行操作，并在检测到活动时取消可视化效果。

移动监控 RangeFinder 的移动监控已被一个更强大的新版本所取代，该版本可以检测所有移动，包括不涉及寻路的移动。

更快的可视化效果

自适应范围探测 现在使用了一种新算法，可以减少对环境检查的数量，并显着加快某些可视化效果的速度。此改进仅适用于根据施法者高度优势获得距离奖励的范围，例如远程攻击、跳跃和飞行。其他范围不受影响。

精简界面（术语更直观，设置更简单）

更简单的术语 实时可视化现在只是“您法术的自动可视化”。即时可视化现在简称为“一键可视化”，因为它们本质上是一种生活质量快捷方式。

减少自动隐藏 RangeFinder 默认不再自动隐藏可视化效果。（不过，清洁模式仍然可用。它被视为更高级的用法，需要手动启用。专注模式已完全移除。）

精简设置 重新组织了MCM设置和某些选项卡。移除了几个看起来没什么用的设置。移除了允许您加载完全不同设置配置的MCM设置（完整、手动、精简）。移除了动态更改其他MCM设置/选项卡可见性的MCM设置（显示高级设置）。

完整手柄支持

RangeFinder 现已支持手柄。已添加手柄图标，当您进入手柄模式时，RangeFinder 将自动：

• 如果您尚未将 RangeFinder 法术添加到快捷栏，则会自动在径向菜单中添加/移除这些法术。
• 自动退出清洁模式，该模式无法使用手柄操作。

新的生活质量功能

减少消息提示 新增选项可减少反馈消息的频繁程度。这将停止一些可能在一段时间后变得重复的反馈消息。

进度条 原本卡顿的动画忙碌图标已被外观更佳、更可靠的进度条所取代。此进度条响应更灵敏，并且不应意外残留。

自动隐藏窗口 每当您进入游戏的菜单系统时，所有 RangeFinder 窗口现在都会自动隐藏。

MazzleDocs 集成 教程和文档现在使用 MazzleDocs 以获得更好的体验。它的效果和外观都更好了。（现在是必需的。）教程已针对新的精简系统和术语进行了重新组织。所有图片现在都会缩放以适应窗口大小。

排队反馈 头顶显示系统现在会将消息排队，以便在当前消息完成后打印下一条。

BUG修复

侏儒和半身人支持 现在支持侏儒和半身人。显然他们跳跃的距离不如其他种族那么远。模组中有一个基于模型大小添加的跳跃奖励，我已对其进行调整以处理较小的模型。

其他修复

• 法术准备时的自动可视化不再在5秒后隐藏。只要您处于法术准备状态，它们就会保持显示。
• 法术准备时的自动可视化不再会移除现有的可视化效果。
• 所有自动化移动现在都能更好地检测失败并妥善处理。失败原因现在会打印到控制台中。

为什么要使用 RangeFinder？

[图片1] [图片2] [图片3] [图片4] [图片5]

如何使用此模组？

了解此模组的最佳方式是完成游戏内教程。它将一步步教您如何使用 RangeFinder 及其功能。安装 RangeFinder 后首次启动游戏时，教程将自动打开。您可以随时通过添加到快捷栏的按钮重新打开它。您的进度将会被保存。

RangeFinder 还提供游戏内文档，以获取更深入的信息和详细的版本说明。您也可以在本 Nexus 页面的“文章”选项卡中找到文档和教程的副本。（我建议使用游戏内版本。）

一些已知问题

多人游戏

• RangeFinder 从未在多人游戏中进行过测试。如果您尝试过或者有兴趣帮助测试多人游戏功能，请告诉我。

手柄

• RangeFinder 从未使用手柄进行过测试，代码中也没有明确支持。目前无法从手柄访问迷你快捷栏界面。实时可视化效果应该仍然有效。
• 话虽如此，使用手柄的玩家应该可以访问 RangeFinder 原始的基于法术的界面。您可以在MCM设置的“界面”下启用基于法术的界面。它在那里被称为“原始界面”。

注意 更长的错误和已知问题列表可以在游戏内文档的“技术”部分找到。

路线图

以下是如果时间和兴趣允许，我可能会做的一些事情。

现有功能的改进

• 在球体迷你快捷栏上添加更多信息，说明哪些因素影响了范围，例如任何移动增益。
• 为产生范围效果或灵气效果的法术增加 SpellCast 可视化，显示由此产生的效果能达到的额外范围。（超出法术范围边缘的效果半径的1/2。）
• 当角色的移动在世界中产生任何效果时，可选择取消“撤销”状态。
• 提高算法速度。
• 提高某些特殊场景的准确性。（例如，攀爬悬崖后的范围，狭小空间等。）
• 改进地表惩罚成本估算。
• 能够更改可视化中操作的顺序（值得吗？）。
• 更多不寻常的范围，例如可视化下一回合没有敌人能攻击到的区域、不受攻击的安全区域、反向远程攻击劣势范围。

新功能

• 自由寻路在必要时添加跳跃。这将使自由寻路更有价值。
• 将传送法术作为一种新的移动形式。
• 包含基于传送的移动攻击。不幸的是，有些法术的行为类似于跳跃/飞行/冲锋攻击法术，但实际上是作为传送法术实现的，例如所有掘地法术和龙飞。
• 能够将飞行整合到连击可视化中，而不是移动中。
• 选择强制寻路始终完全避开敌人的借机攻击。
• 每当您使用“前进”时，队伍成员会自动创建相应的路径，使您的队伍能够编队移动。如果我们允许自由寻路在必要时添加跳跃，这将提供比《博德之门3》目前提供的更强大的队伍跟随功能。
• 使远程攻击可视化忽略被遮蔽/您无法射入的区域。
• 将近战范围的魔法法术作为一种新的近战攻击形式。需要一个类似于我们用于移动攻击的开关。

注意： 如果您对新功能或改进有想法，请随时分享。任何反馈都值得感谢。

致谢

Norbyte 显然，他出色的 ScriptExtender、他众多的在线资源和他的许多工具为《博德之门3》模组社区贡献良多，但他也直接帮助了此模组，反复让《博德之门3》引擎的新方面可见或添加了使此模组良好运行所需的新功能。在他开放寻路和射线投射之前，RangeFinder 尝试使用 Osi 调用来手动计算所有内容。那个版本速度较慢，使用了更复杂繁琐的算法，并且有几个显著的局限性。

Focus 通过查看他的代码，我学到了比其他任何模组都多的关于如何使用SE与《博德之门3》交互的知识。在我终于上Discord后，他不遗余力地帮助我解决了几个问题。他总是准备好攻克下一个问题。而且，他是我的第一个也是主要测试者。

Nerp/Rakor/Maleenka 非常感谢“光之大师”，他帮助我弄清楚了模组的一些关键方面，即让光束看起来好看，并让球体在任何距离都可见。

Volition 感谢他制作的MCM，它不仅对用户很好，对模组作者也很好。（能够为算法的每个方面设置参数真是太好了。这确实帮助我有效地看到什么有效，什么无效。）他还为MCM添加了几个功能，使 RangeFinder 更有效、更易于使用。

LaughingLeader 是Discord上最慷慨、最好奇、知识最渊博的人之一。他总有答案和代码可以随时分享。

Wesslen 感谢他的测试反馈以及在法术准备时创建可视化效果的绝妙建议。

测试者们 非常感谢所有帮助我寻找错误和提高可用性的测试者：Focus、Wesslen、Di Illuminati、Nerp。

特别感谢： BG3 CMTY Discord 在Discord上有人可以聊天和询问模组问题，让我更容易继续做这个模组。

Shivero 球体效果（在光束之前，它曾是标记位置的主要效果，视觉效果非常醒目）是基于他的VFX_Library中的头顶灯泡效果。这个项目在工具包可用之前就开始了，如果没有他，我永远也不会知道如何自己创建那样的光。

Ghostboats 感谢他的Visual Studio插件。它使模组制作的某些方面变得容易得多，为我节省了大量时间。他还直接修复或添加了一些在开发过程中对我有帮助的东西。

RangeFinder 许可协议

版权所有 (c) Mazzle 2025

1. 未经作者明确书面许可，您不得创建此模组的衍生版本。
2. 未经作者明确书面许可，您不得复制此模组中使用的核心功能、技术或视觉机制。
3. 您可以在不相关的模组中重用少量代码片段，前提是获得许可并注明原作者。
4. 您可以创建依赖于此模组（例如，通过 MazzleLib）或与之交互的模组，只要它们不复制或取代其核心功能。
5. 如果作者停止开发，此许可协议将来可能会更改。
6. 对于任何定制安排，请直接联系作者。

我的其他模组

游戏工具

• EZ-Manipulator (用于移动、缩放、旋转角色、物品和场景的操控器)
• Fricken FreeCam (自由移动相机)
• MF Radio (游戏内收音机，可播放原生和下载的音乐)
• RangeFinder (可视化移动范围和攻击，规划/自动化移动)
• Tav's Journal (创建带照片的游戏内日志，导出和分享)
• Tav's Clock (一个可放置在任何地方的小时钟和会话计时器)

QOL

• EZ-Undo (撤销您本回合的所有移动)
• Group Climbing Fix (允许多个角色同时攀爬梯子)
• Level Directory (让您安全地传送到任何关卡或安装的自定义关卡，而不会弄乱故事进度)
• M&M Group Climbing Fix (Mac兼容模组，允许多个角色同时攀爬梯子)
• No More Mod warning (抑制模组冲突警告)

库和外部工具

• MazzleDocs (用于显示精美游戏内文档、教程或完整模组GUI的库)
• MazzleLib (我的其他模组的核心库)
• My Assistant Ken (帮助其他模组与Noesis交互的库)
• Oops All Characters (with Simple NPC/Enemy Spawner) (让您在任何关卡生成大多数角色)
• Photo Hub (外部工具和模组，允许模组访问您的截图和图像)
• Music Hub (下载和转换音乐并使其可用于《博德之门3》)

面向模组作者的模组

• Court of Intense Judgment Outfit Reviewer (生成角色，让服装模组作者看到所有身体类型上的服装效果)
• Image Importer (用于将图像导入模组的模组制作工具)
• KnowEasier Noesis Debugger (用于检查《博德之门3》原生GUI的模组制作工具)

支持此模组

如果您觉得这个模组有用，请考虑捐款。

[捐款按钮图片]