丢弃物品快捷键

掉落物品快捷键

掉落物品快捷键 是一个轻量级的 UE4SS Lua 模组，适用于《幻兽帕鲁》，让你只需悬停鼠标并按下单个按键即可将背包中的物品丢到地上——无需拿起物品并点击丢弃菜单。

将鼠标悬停在背包（或箱子）中的任意物品上，使其信息提示框显示，按下快捷键，该物品便会丢到世界上。它使用游戏自身的复制丢弃请求，因此物品会从背包中移除并生成在地上，与原始丢弃流程完全一致，且支持多人游戏。

---

## 功能说明

* 只需一次按键即可丢弃鼠标当前悬停的物品
* F（默认）—— 将整组物品全部丢到地上
* G（默认）—— 从悬停的格子中只丢弃一个物品
* H（默认）—— 丢弃一半的物品（向下取整）
* 仅在物品信息提示框显示时触发，因此不会在空格处误触发
* 当鼠标离开格子或窗口关闭时清除目标，防止意外丢弃
* 使用与原始丢弃流程相同的复制请求（RequestDrop_ToServer）
* 不会修改存档文件
* 可选的调试日志输出

---

## 工作原理

当鼠标停留在物品格子上时，游戏会通过 PalHUDService:ShowCommonItemInfo 显示其提示框，其中 DisplayData.TargetItemSlot 即为悬停的格子。模组会记录该格子，并在 HideCommonItemInfo 时将其清除。

按下快捷键时，模组通过网络发送器解析你的角色的 UPalNetworkItemComponent，并调用 RequestDrop_ToServer，传入悬停的格子、丢弃数量以及你的位置——这与真实的丢弃操作发送的请求完全相同。

---

## 配置

打开 DropItemHotkey/Scripts/config.lua：

```lua return { -- 将背包（或箱子）中的物品悬停，按下此键可丢弃 -- 整组物品到地上。使用 UE4SS 键名 -- （F、G、DELETE、NUMPAD_ONE……）。设置为 false 或 "" 以禁用。 Key = "F",

-- 同上，但只从悬停的格子中丢弃一个物品。
-- 设置为 false 或 "" 以禁用。
KeyDropOne = "G",

-- 同上，但丢弃一半的物品（向下取整）。
-- 设置为 false 或 "" 以禁用。
KeyDropHalf = "H",

-- 鼠标离开格子后，悬停目标在此秒数内仍有效。
-- 防止鼠标不在任何格子时意外丢弃。
HoverTimeoutSeconds = 0.75,

-- 在 UE4SS 控制台输出详细日志。
Debug = false,

}

<br />*   `Key` — 丢弃整组物品的快捷键。可映射为任何 UE4SS 键名，如 `F`、`DELETE` 或 `NUMPAD_ONE`。设置为 `false` 或空字符串可禁用。
<br />*   `KeyDropOne` — 只丢弃悬停格子中一个物品的快捷键。设置为 `false` 或空字符串可禁用。
<br />*   `KeyDropHalf` — 丢弃一半物品（向下取整）的快捷键。设置为 `false` 或空字符串可禁用。
<br />*   `HoverTimeoutSeconds` — 鼠标离开格子后，上次悬停的格子保持有效的时间，以避免意外丢弃。

<br />更改配置后，请完全重启《幻兽帕鲁》。

<br />---

<br />## **安装位置**

<br />*   **仅客户端：是。** 在每位希望使用快捷键的玩家电脑上安装。
<br />*   **仅服务器：否。** 这是一个客户端便利模组。
<br />*   **客户端和服务器均需安装：否。** 加入的玩家无需在服务器上安装该模组。
<br />*   **原生 Linux 游戏客户端：不支持。** UE4SS 依赖仅限 Windows 的 DLL 注入。请使用 Windows 客户端，或通过 Proton 运行。

<br />由于模组发送的复制丢弃请求与原始操作相同，多人游戏主机或专用服务器无需安装此模组。每位希望使用快捷键的玩家只需在本地安装。

<br />---

<br />## **安装方法**

<br />**Vortex**

<br />1.  安装或更新 [**Palworld Vortex Extension**](https://www.nexusmods.com/site/mods/770) 至 0.2.1 或更高版本，然后让 Vortex 管理《幻兽帕鲁》。
<br />2.  使用本文件的 **Mod Manager Download**，然后点击 **安装**、**启用** 和 **部署模组**。
<br />3.  Vortex 会自动安装兼容的 UE4SS 依赖（如需），并自动注册此 Lua 模组。部署后请完全重启《幻兽帕鲁》。

<br />**手动安装**

<br />1.  安装 [**Palworld experimental build of UE4SS**](https://github.com/Okaetsu/RE-UE4SS/releases/tag/experimental-palworld)。此软件包包含《幻兽帕鲁》专用的 `MemberVariableLayout` 配置，用以正确读取游戏对象。
<br />2.  下载并解压模组压缩包。
<br />3.  将 `DropItemHotkey` 文件夹复制到：

<br />```
Palworld/Pal/Binaries/Win64/ue4ss/Mods/

安装后的文件结构应如下所示：

``` Palworld/Pal/Binaries/Win64/ue4ss/Mods/DropItemHotkey/enabled.txt Palworld/Pal/Binaries/Win64/ue4ss/Mods/DropItemHotkey/Scripts/main.lua Palworld/Pal/Binaries/Win64/ue4ss/Mods/DropItemHotkey/Scripts/config.lua Palworld/Pal/Binaries/Win64/ue4ss/Mods/DropItemHotkey/Scripts/common.lua

<br />`common.lua` 是模组压缩包中包含的必需支持文件。请将其与 `main.lua` 放在同一 `Scripts` 文件夹中；无需单独的库模组或额外下载。

<br />压缩包中包含的 `enabled.txt` 可在当前 UE4SS 布局下启用该模组。如果你的 UE4SS 安装使用 `mods.txt`，请添加：

<br />```
DropItemHotkey : 1

安装后请完全重启《幻兽帕鲁》。

---

## 需求

* 《幻兽帕鲁》（Steam）
* Palworld experimental build of UE4SS

---

## 多人游戏

此模组仅读取悬停的 UI 格子，并发送与原始操作相同的丢弃请求。实际物品移除和世界生成遵循主机或服务器上《幻兽帕鲁》的正常复制规则。

除非其他玩家也希望使用快捷键，否则他们无需安装此模组。

---

## 功能范围

* 仅丢弃当前鼠标悬停的单个物品格子
* 不会自动排序、批量丢弃或在容器之间转移物品
* 不会直接更改背包逻辑或存档数据
* 不会绕过丢弃请求执行的任何物品权限检查

---

## 调试

在 config.lua 中将 Debug = true 设置为 true，即可记录按键按下、悬停格子捕获以及丢弃请求是否成功。成功丢弃会记录类似 Dropped N item(s) from slot X 的消息。调试输出默认禁用。

---

## 兼容性

专为当前 Steam 版本《幻兽帕鲁》以及发布时的 UE4SS 版本设计。未来的游戏更新可能改变物品信息提示框功能或丢弃请求签名，届时需要更新模组。

---

## 卸载

从 UE4SS Mods 目录中删除 DropItemHotkey 文件夹，如果之前添加过，则从 mods.txt 中移除其条目。

---

## 💜 支持我的工作

如果你喜欢我的模组并希望支持未来的开发，可通过以下方式支持我：

https://ko-fi.com/burdock12