关键物品掉落

描述

KeyItemDrop 允许通过《幻兽帕鲁》的标准背包界面丢弃选定的关键物品。

拖拽一个被允许的关键物品到现有的丢弃区域，《幻兽帕鲁》会执行其正常的服务器授权丢弃操作。该物品会被服务器移除，并创建为一个可复制的世界物品，其他玩家可以拾取。

此模组不会手动删除物品、生成重复物品或直接修改存档数据。

只有 allowed_items.json 中列出的物品 ID 才能使用自定义丢弃路径。所有其他关键物品默认仍被阻止。

---

安装说明

1. 在安装或测试任何与背包相关的模组之前，请先备份你的《幻兽帕鲁》存档。
2. 为《幻兽帕鲁》安装 UE4SS。KeyItemDrop 是在 UE4SS 3.0.1 上开发和测试的。
3. 将下载的压缩包解压到：

   Palworld\Pal\Binaries\Win64\ue4ss\Mods\
   

4. 验证完整安装包含以下文件：

   Palworld\Pal\Binaries\Win64\ue4ss\Mods\KeyItemDrop\enabled.txt
   Palworld\Pal\Binaries\Win64\ue4ss\Mods\KeyItemDrop\Scripts\allowed_items.json
   Palworld\Pal\Binaries\Win64\ue4ss\Mods\KeyItemDrop\Scripts\allowlist.lua
   Palworld\Pal\Binaries\Win64\ue4ss\Mods\KeyItemDrop\Scripts\common.lua
   Palworld\Pal\Binaries\Win64\ue4ss\Mods\KeyItemDrop\Scripts\config.lua
   Palworld\Pal\Binaries\Win64\ue4ss\Mods\KeyItemDrop\Scripts\main.lua
   Palworld\Pal\Binaries\Win64\ue4ss\Mods\KeyItemDrop\Scripts\network.lua
   

5. 完全重启《幻兽帕鲁》客户端。

文件中自带的空 enabled.txt 文件会告诉 UE4SS 自动加载 KeyItemDrop。通常你无需编辑 mods.txt 或 mods.json。

在测试环境中，无需安装专用服务器。安装或更新客户端 Lua 模组后，也无需重启专用服务器。

---

更新

1. 完全关闭《幻兽帕鲁》客户端。
2. 用新版本替换现有的 KeyItemDrop 文件夹。
3. 重新启动《幻兽帕鲁》。

如果你自定义过 allowed_items.json，请在替换模组文件夹前备份它。

---

卸载

完全关闭《幻兽帕鲁》并删除：

Palworld\Pal\Binaries\Win64\ue4ss\Mods\KeyItemDrop\

或者，移除或重命名 enabled.txt 以阻止 UE4SS 加载该模组。

在 mods.txt 中设置 KeyItemDrop : 0 将不会禁用该模组，只要 enabled.txt 仍存在于模组文件夹中。

---

使用方法

1. 打开背包。
2. 选择“关键物品”标签页。
3. 将一个被允许的物品拖拽到常规的“丢弃”区域。
4. 《幻兽帕鲁》会使用其现有的服务器授权丢弃系统，在世界中创建该物品。

支持《幻兽帕鲁》的标准堆叠拆分控制。例如，你可以按住 Shift 键从较大的堆叠中拖出一个物品，并精确地丢弃一个。

---

配置

允许列表保存在：

KeyItemDrop\Scripts\allowed_items.json

示例：

{
  "allowedStaticItemIds": [
    "UnlockEquipmentSlot_Weapon_01",
    "UnlockEquipmentSlot_Weapon_02"
  ]
}

每次新的背包拖拽开始时，该 JSON 文件都会重新加载。

模组加载过一次后，你可以直接编辑并保存允许列表，无需重启客户端，只需再次拖拽物品即可。

文件必须包含有效的 JSON。请不要添加注释或尾随逗号。

如果 JSON 变得无效，模组会保留最后有效的允许列表，而不是允许未知物品。

---

调试日志

按 F9 键启用诊断日志。

当拖拽一个当前未被允许的物品时，日志会将其确切的静态物品 ID 显示为 ALLOWLIST_CANDIDATE。

你可以将此 ID 复制到 allowed_items.json 中。

再次按 F9 键可禁用诊断日志。

---

主要特性

• 使用《幻兽帕鲁》的常规背包拖拽式界面
• 使用现有的服务器授权物品丢弃 RPC
• 创建可复制的世界物品，其他玩家可以拾取
• 不会手动移除或生成背包物品
• 每次拖拽操作仅发送一个丢弃请求
• 支持从较大的堆叠中丢弃一个物品
• 可配置的 JSON 允许列表
• 无需重启客户端即可实时重新加载允许列表
• 未知的关键物品默认仍被阻止
• 自动关闭已知的原版关键物品提示
• 默认关闭日志输出
• F9 调试开关，可捕获物品 ID
• 无每帧轮询或日志输出
• 在测试环境中无需安装专用服务器模组

---

要求

• 《幻兽帕鲁》Steam 客户端
• Windows 系统
• UE4SS（RE-UE4SS Okaetsu Experimental-Palworld）
• 已在《幻兽帕鲁》1.0.1 版本上测试
• 已在 UE4SS 3.0.1 版本上测试
• 已在连接到 Windows 专用服务器时测试

不保证与其他《幻兽帕鲁》或 UE4SS 版本的兼容性。

更改 Lua 文件或更新模组后，请完全重启《幻兽帕鲁》客户端。

目前仅自动关闭英文和德文版本的原版关键物品提示。使用其他游戏语言时，物品可能仍会成功丢弃，但提示对话框仍会保持可见。

重要提示： 在测试新添加的关键物品 ID 之前，请务必备份你的存档。某些关键物品可能会影响进程或解锁系统，并且不一定会作为世界掉落物进行过测试。

---

鸣谢

感谢：

• UE4SS 开发者和贡献者 创建了 Lua 脚本和模组框架。
• Okaetsu 维护了针对《幻兽帕鲁》的实验性 UE4SS 构建。
• 《幻兽帕鲁》模组社区提供的文档、研究和测试。