ClickToThrowSphere

[b]ClickToThrowSphere — C++ v1.8.0[/b]

轻按 [b]Q[/b] 或手柄 [b]RB[/b] 一次即可瞄准帕鲁球。松开按键后你仍处于瞄准状态，直到你选择投掷或取消。

投掷、取消、帕鲁球消耗、捕捉计算、偷袭加成以及所有其他游戏行为，仍由幻兽帕鲁的原始逻辑处理。

[b]主要特性[/b]

• 轻按一次 Q 键即可瞄准，无需长按
• 支持键盘与鼠标
• 支持标准 Xbox 布局的手柄
• 在打开支持的菜单时，防止意外投掷
• 已在幻兽帕鲁 1.0 版本中测试
• 提供手动安装包
• 提供 Vortex 就绪安装包
• 未修改任何游戏数值或捕捉计算

[b]键盘与鼠标控制[/b]

• Q — 瞄准：轻按一次开始瞄准。松开 Q 后帕鲁球仍保持瞄准状态。
• 左键 — 投掷：释放内部保持的 Q 输入，让幻兽帕鲁执行正常的投掷动作。
• 右键 — 取消：使用幻兽帕鲁原始的右键取消行为。

以下是瞄准状态下受保护的默认菜单开启按键：

• Esc — 主菜单/暂停菜单
• Tab — 背包
• B — 建造菜单
• M — 地图
• T — 科技
• P — 帕鲁/队伍界面
• Enter — 聊天

当在瞄准状态按下这些按键时，模组会暂时拦截原始按键输入，发送幻兽帕鲁正常的右键取消指令，短暂等待取消生效，然后再次发送原始菜单键。

这可以防止幻兽帕鲁在切换到菜单或 UI 界面时，将保持的 Q 输入误判为投掷。

[b]手柄支持[/b]

支持标准 Xbox 手柄布局：

• RB — 瞄准：轻按一次瞄准。松开后 RB 仍保持逻辑上的按下状态。
• RT — 投掷：模组释放内部保持的 RB 状态，让幻兽帕鲁执行正常的投掷动作。
• LT — 取消：使用幻兽帕鲁原始的手柄取消行为。
• Start / Back / View / Share 等效按键 — 打开支持的菜单或地图：模组在允许请求的界面打开前，先取消瞄准状态。

RB 长按功能仅在幻兽帕鲁确认帕鲁球瞄准状态已实际开始后启用。这意味着在菜单中按下 RB 不会导致 RB 卡住或持续保持按下状态。

[b]按下手柄菜单键会发生什么？[/b]

正常情况下，打开菜单会使幻兽帕鲁释放保持的 RB 状态，游戏会将其视为一次帕鲁球投掷。

为防止这种情况，模组会：

1. 暂时对游戏隐藏 Start/Back 的屏幕输入
2. 保持 RB 按下状态，使其不会成为意外投掷
3. 使用原始的取消输入，发送简短的 LT 按下与释放脉冲
4. 等待幻兽帕鲁报告瞄准已结束
5. 重新发送原始的 Start/Back 屏幕输入

LT 输入以脉冲形式发送，而非持续按住，因此在取消过程中其他手柄输入不会锁定。

[b]工作原理[/b]

该模组主要在输入层面运作。

对于键盘控制，它将初始的 Q 按下传递给游戏，并拦截 Q 的松开。之后左键单击会发送幻兽帕鲁预期的投掷松开信号。

对于手柄，它修改幻兽帕鲁所见的 XInput 状态。在确认实际的帕鲁球瞄准后，RB 保持按下状态。RT 释放 RB 以实现正常投掷，而 LT 保持为正常的取消输入。

模组会观察幻兽帕鲁的瞄准开始和结束通知，确保在取消、闪避、打开菜单、切换世界或其他结束瞄准的操作后，其内部输入状态保持同步。

它不会直接替换幻兽帕鲁的投掷、捕捉、物品消耗或概率计算。

[b]要求[/b]

• 幻兽帕鲁 1.0
• 支持 C++ 模组的 UE4SS
• 官方 UE4SS v3.0.1 Beta #0 — Git SHA d935b5b
• 键盘“投掷帕鲁球”按键必须保持为 Q
• 需要默认的菜单按键以启用自动菜单保护
• 手柄支持假定为标准 Xbox 按钮布局

官方支持的 UE4SS 版本：

UE4SS v3.0.1 — d935b5b

实验性 UE4SS 构建使用不同的 C++ API，目前不受支持，即使其日志也显示“v3.0.1 Beta”。

[b]Vortex 安装[/b]

下载文件名中包含 [b]Vortex[/b] 的文件，并通过 Vortex 正常安装。

该包包含从幻兽帕鲁游戏目录开始的完整路径，应将模组安装到：

Pal\Binaries\Win64\Mods\ClickToThrowSphere

UE4SS 本身必须已提前单独安装。

确保 Vortex 管理的幻兽帕鲁路径与 Steam 启动的是同一安装目录。

[b]手动安装[/b]

1. 关闭幻兽帕鲁。
2. 下载手动安装包。
3. 将 [b]Mods[/b] 文件夹解压到：

Palworld\Pal\Binaries\Win64

最终的DLL路径应为：

Palworld\Pal\Binaries\Win64\Mods\ClickToThrowSphere\dlls\main.dll

无需手动编辑 mods.txt。附带的 enabled.txt 会启用该 C++ 模组。

[b]兼容性与限制[/b]

• 仅在幻兽帕鲁窗口处于前台时生效
• 已在幻兽帕鲁 1.0 中测试
• 已在官方 UE4SS v3.0.1 d935b5b 中测试
• 键盘菜单保护目前涵盖默认的 Esc、Tab、B、M、T、P 和 Enter 按键
• 无法自动检测自定义菜单按键绑定
• 手柄菜单保护涵盖 Start 和 Back/View/Share 等效的 XInput 按钮
• 包含多人游戏过滤功能，但尚未完全测试多人模式
• 不支持实验性 UE4SS 构建

[b]从旧版本更新[/b]

在更新前关闭幻兽帕鲁，然后用新版本替换现有的 ClickToThrowSphere 模组文件夹。

请勿混合使用不同版本的 DLL 文件。