AnywherePalbox

AnywherePalbox

只需一个快捷键,即可在几乎任何地方打开帕鲁世界的原始帕鲁箱界面,无需在当前地点放置或与实体帕鲁箱进行互动。

任意帕鲁终端箱

按下快捷键即可从几乎任何位置打开《幻兽帕鲁》原版终端箱界面——无需在当前地点放置或与之交互。

任意帕鲁终端箱不会创建自定义菜单、复制组件或模仿终端箱。它让《幻兽帕鲁》打开游戏自身使用的内部帕鲁存储菜单,因此熟悉的界面和正常的存储行为仍由游戏本身控制。

默认快捷键:K

重要提示:选择一种安装方式

请选择 Nexus/手动安装 Steam 创意工坊安装中的一种。不要同时保留两个副本。重复的 Lua 模组可能会注册两次快捷键,导致不可预期的行为。

主要功能

  • 按下 K 键打开原版终端箱/帕鲁存储菜单。
  • 通过游戏的 HUD 服务使用《幻兽帕鲁》现有的 WBP_PalStorageMenu
  • 不添加、克隆或替换任何用户界面。
  • 复用已加载世界/公会中已有的终端箱存储上下文。
  • 安全地搜索兼容的游戏对象和函数,而非依赖单一脆弱的对象路径。
  • 缓存运行时成功发现的结果,以加快后续打开速度。
  • 包含对玩家有效性、世界就绪状态和菜单已打开状态的检查。
  • 配置中可选的骑行、地下城和战斗限制。
  • 包含详细的 [AnywherePalbox] 日志记录,用于故障排查。
  • 不修改存档数据或终端箱内容。

工作原理

当按下 K 键时,模组会验证本地玩家是否存在、世界是否已就绪且没有其他菜单已打开。然后解析《幻兽帕鲁》自身的 HUD 服务和帕鲁存储菜单类,获取有效的终端箱存储上下文,并调用原始菜单路径。

游戏负责绘制菜单、读取存储数据、处理转移和关闭界面。任意帕鲁终端箱仅提供到达该现有功能的额外途径。

当前世界或公会必须至少存在一个可用的终端箱/存储上下文。 模组不会创建免费存储容器。

系统要求

  • Windows 版《幻兽帕鲁》。
  • 兼容《幻兽帕鲁》的 RE-UE4SS 安装。
  • 已在 《幻兽帕鲁》v1.0.1.100619UE4SS 3.0.1 上测试。

自动安装程序支持 Steam 和 Windows Xbox 应用/PC Game Pass 布局。Xbox 主机版本无法加载 UE4SS Lua 模组。

自动安装(推荐)

  1. 下载并解压缩完整的 Nexus 存档。
  2. 完全关闭《幻兽帕鲁》和 PalServer。
  3. 双击 Install-AnywherePalbox.cmd
  4. 检查检测到的游戏和 UE4SS 位置。
  5. 启动《幻兽帕鲁》,加载世界,然后按 K 键。

安装程序会自动:

  • 发现主 Steam 安装路径和其他 Steam 库;
  • 在所有驱动器中检查常见的 Xbox PC / Game Pass 位置;
  • 在与正确的《幻兽帕鲁》可执行文件相邻的位置找到 UE4SS Mods 目录;
  • 创建现有任意帕鲁终端箱安装和 UE4SS 模组列表的时间戳备份;
  • 安装并启用模组;
  • 使用 SHA-256 验证每个已安装的文件。

备份存储在:

%LOCALAPPDATA%\AnywherePalbox\Backups

如果您的自定义路径未被检测到,请将《幻兽帕鲁》游戏文件夹拖放到 Install-AnywherePalbox.cmd 上,或运行:

Install-AnywherePalbox.cmd -GameRoot "D:\Games\Palworld"

对于非标准 UE4SS 位置:

Install-AnywherePalbox.cmd -GameRoot "D:\Games\Palworld" -UE4SSRoot "D:\Tools\UE4SS"

可在不修改文件的情况下测试检测:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\Install-AnywherePalbox.ps1" -DetectOnly

CMD 是双击启动器。其包含的 PowerShell 后端执行检测、备份、安装、激活和验证。通常不需要互联网连接或管理员权限。

手动安装

  1. 为《幻兽帕鲁》安装兼容的 RE-UE4SS 构建。
  2. 将随附的 AnywherePalbox 文件夹复制到 UE4SS 的 Mods 目录中。
  3. mods.jsonmods.txt 中启用 AnywherePalbox(如果您的 UE4SS 版本需要)。
  4. 启动游戏并加载世界。

典型的 Steam 布局:

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

最终文件夹必须包含:

AnywherePalbox\
    modinfo.json
    README.md
    config.lua
    Scripts\
        main.lua
        logger.lua
        helpers.lua

不要安装为 Mods\AnywherePalbox\AnywherePalbox;额外的嵌套文件夹会阻止 UE4SS 加载脚本。

使用方法

  1. 启动《幻兽帕鲁》。
  2. 完全进入世界。
  3. K 键。
  4. 正常使用并关闭原版终端箱界面。

在游戏仍在加载、玩家对象无效或已打开其他菜单时,快捷键会被有意忽略。

配置

关闭游戏并编辑 AnywherePalbox\config.lua

return {
    Hotkey = "K",
    EnableLogging = true,
    DisableWhileMounted = false,
    DisableInDungeon = false,
    DisableDuringCombat = false
}
  • Hotkey:用于打开终端箱的键盘按键。
  • EnableLogging:将详细状态和错误消息写入 UE4SS 日志。
  • DisableWhileMounted:骑乘时阻止快捷键。
  • DisableInDungeon:在地下城内阻止快捷键。
  • DisableDuringCombat:检测到战斗时阻止快捷键。

更改配置后重启游戏。运行时配置重载和游戏内按键重新绑定功能未包含在 1.0.0 版本中。

多人游戏

任意帕鲁终端箱在本地客户端运行,并打开游戏的正常存储界面。实际的帕鲁存储访问、复制、所有权和权限仍由《幻兽帕鲁》和当前服务器控制。

单人游戏已验证通过。多人游戏行为可能因服务器规则、反作弊配置、其他模组和游戏更新而异。仅在服务器所有者允许的情况下在客户端安装。本模组不旨在绕过公会访问或服务器权限。

性能

模组在空闲时不进行持续的世界扫描。发现过程在启动时以及快捷键需要有效上下文时发生。成功的对象和函数会被缓存以供后续使用。首次加载世界后打开可能会稍慢,因为《幻兽帕鲁》需要加载原始菜单资源;后续打开应该会更快。

如果按 K 键导致短暂卡顿但菜单未出现,请检查日志。这通常意味着请求了原始 UI 资源,但有效的世界/存储上下文不可用,或在游戏更新后发生了变化。

兼容性

任意帕鲁终端箱最可能与以下模组冲突:

  • 替换帕鲁存储菜单的模组;
  • 改变终端箱存储上下文或公会所有权逻辑的模组;
  • 替换《幻兽帕鲁》HUD/菜单堆栈的模组;
  • 全局注册相同快捷键的模组;
  • 安装第二个任意帕鲁终端箱副本的模组。

模组避免使用硬编码的对象实例,并使用多个受保护的查找路径,但没有任何调用 Unreal 内部函数的 Lua 模组能保证免受每次《幻兽帕鲁》更新的影响。在重大更新后,请在报告故障前检查 UE4SS.log

已知限制

  • 世界必须完全加载。
  • 世界或公会必须存在有效的终端箱/存储上下文。
  • 模组不会创建终端箱或存储容器。
  • 尚未包含手柄绑定支持。
  • 更改快捷键需要编辑 config.lua 并重启游戏。
  • 不支持 Xbox 主机;Windows 上的 Xbox PC / Game Pass 在 UE4SS 兼容时受安装程序支持。
  • 多人游戏结果取决于服务器和游戏权限。

故障排除

按 K 键无反应

  • 确认世界已完全加载。
  • 确认 UE4SS 已加载 AnywherePalbox。
  • 验证文件夹没有嵌套两次。
  • 按 K 键前关闭任何现有菜单。
  • 确认世界/公会具有有效的终端箱存储上下文。
  • 在 UE4SS.log 中搜索 [AnywherePalbox]

安装程序找不到《幻兽帕鲁》

  • 将实际的《幻兽帕鲁》文件夹拖放到 Install-AnywherePalbox.cmd 上。
  • 或手动传递 -GameRoot 参数。
  • 对于非常规库,向 PowerShell 脚本传递 -AdditionalSearchRoot 参数。

找到《幻兽帕鲁》但未找到 UE4SS

  • 首先安装兼容《幻兽帕鲁》的 RE-UE4SS 构建。
  • 确认 UE4SS.dll 和 Mods 文件夹属于同一个游戏二进制目录。
  • 如果使用自定义布局,使用 -UE4SSRoot 传递确切的 UE4SS 根目录。

出现短暂卡顿但菜单未打开

  • 保持日志记录启用,并检查“Opening Palbox”之后的行。
  • 安装后重新加载世界一次。
  • 在不使用其他 UI 或终端箱模组的情况下测试。
  • 《幻兽帕鲁》更新后,内部菜单类或服务可能需要兼容性工作。

未出现日志行

  • 模组未加载或在 UE4SS 中被禁用。
  • 检查 mods.json / mods.txt 和文件夹名称。
  • 确保 Lua 脚本位于 AnywherePalbox\Scripts 下。

更新

关闭游戏并运行新的安装程序。它会先备份之前的模组再替换。在恢复旧的 config.lua 之前,请先查看新版本发布说明中的配置选项,因为可能添加了新设置。

卸载

  1. 关闭《幻兽帕鲁》。
  2. 从 UE4SS Mods 目录中删除 AnywherePalbox 文件夹。
  3. 如有必要,从 mods.json / mods.txt 中删除或禁用 AnywherePalbox 条目。

任意帕鲁终端箱不会将自定义数据写入您的存档,因此无需进行存档清理。

版本信息

  • 模组版本:1.0.0
  • 运行时测试:UE4SS 3.0.1
  • 游戏构建已验证:《幻兽帕鲁》v1.0.1.100619
  • 默认快捷键:K

报告问题时,请附上《幻兽帕鲁》构建版本、UE4SS 版本、安装来源以及 UE4SS.log 中所有 [AnywherePalbox] 行。