Palworld 安装器 - Mod Organizer 2 插件

描述

这是一个为《幻兽帕鲁》及《幻兽帕鲁》专用服务器设计的 Mod Organizer 2 插件套件。它会在安装时处理 Mod 压缩包，并将其内容重写为《幻兽帕鲁》实际所需的目录结构，从而让你无需手动重新打包压缩包，也不用费力将 .pak 和 main.lua 文件移动到正确的文件夹中。

该套件有两个部分：

• **《幻兽帕鲁》**及《幻兽帕鲁》专属服务器的游戏定义，以便 MO2 将其作为游戏实例进行管理。
• 幻兽帕鲁安装程序，一个自定义安装程序，用于整理存档文件、选择正确的平台版本（Steam 或 Xbox）、将 .pak 文件与对应的 .utoc/.ucas/JSON 文件分组，并将所有内容路由到正确目标位置。

当安装位置明确时，安装将静默运行。当存在实际选择（多个 pak 文件、自定义路径、模糊的脚本模组）时，会弹出一个包含合理默认预填项的小对话框。

安装说明

你需要先安装 MO2，并已设置好《幻兽帕鲁》（或幻兽帕鲁服务器）实例，这个插件才能发挥实际作用。

1. 安装游戏定义

将这两个文件复制到 MO2 现有的 basic_games 插件中：

• plugins/basic_games/games/game_palworld.py
• plugins/basic_games/games/game_palworld_server.py

它们放入 <MO2 install>/plugins/basic_games/games/ 目录。不要放在其他位置。
重新启动 MO2。现在创建一个新实例时，应该会看到 Palworld 和 Palworld 专用服务器。

2. 安装 PalworldInstaller

将整个 plugins/PalworldInstaller/ 文件夹复制到 <MO2 install>/plugins/ 中。最终效果应类似于：

<MO2 install>/plugins/PalworldInstaller/
├── __init__.py
├── installer.py
└── ui/
    ├── __init__.py
    └── dialog.py

重启 MO2。

3. 配置你的平台

打开设置 → 插件 → PalworldInstaller，然后设置平台以匹配你的安装：

• palworld_platform — steam（默认）或 xbox
• palworld_server_platform — steam（默认）或 xbox

如果你使用的是 Xbox 主机版本或 PC Game Pass 版本（两者都使用 WinGDK 运行时），请选择 Xbox。如果你只管理其中一个游戏，请保持另一个设置不变。

就这样。将 Palworld 模组压缩包放入 MO2 中，安装程序会自动处理。

主要特色

• 自动存档分类 — 识别包含 .pak、main.lua 或松散根目录 .json 文件的存档，并将其重写为《幻兽帕鲁》预期的布局（Content/Paks/...、Binaries/Win64/Mods// 等）。
• 平台感知变体选择 — 如果存档同时包含 {STEAM} 和 {XBOX} 文件夹，插件将保留与您的平台设置匹配的变体，并丢弃其他变体。
• 尽可能静默安装 — 单个结构清晰、无歧义的 pak 包无需提示即可安装。仅在需要做出实际选择时才会弹出对话框。
• 文件分组 — 一个 .pak 文件及其对应的 .utoc/.ucas 文件（以及与之关联的 AnimJSON/ 或 SwapJSON/ 目录）被视为一个整体，并会被统一处理。
• 智能路由默认设置 — *_P.pak 文件及含有同名 JSON 目录的 pak 文件默认为 ~mods/；裸 pak 文件默认为 LogicMods/；散落的根目录 .json 文件归入 LogicMods/。对话框将自动填充这些默认路径。
• 重新安装连续性 — 当对话框出现时，之前对同一模组所做的选择会被记住并预先填写。
• FOMOD 依赖 — 当压缩包是 FOMOD 包时，插件会退让并让 MO2 的 FOMOD 安装器处理它。此行为可配置。
• UE4SS 引导程序跳过 — 包含 ue4ss.dll 的档案被直接传递，因为它们属于 UE4SS 引导程序而非模组有效负载。
• 旧版 {GAMEPASS} 支持 — 使用已弃用的 {GAMEPASS} 标记的旧存档仍然有效；它们会被视为 {XBOX}，并在日志中显示一行弃用警告。

要求

• Mod Organizer 2 — 一个足够新的版本，需附带 PyQt6 和 mobase Python 绑定。仅支持旧版 PyQt5 的构建将无法运行。
• MO2 的 basic_games 插件 — 默认随 MO2 附带。Palworld 的游戏定义会接入此插件；没有它，游戏将无法被识别。
• 《幻兽帕鲁》或《幻兽帕鲁》专用服务器 — 实际游戏安装，使用 MO2 进行管理。安装程序仅对管理这两款游戏之一的实例生效。
• Windows 系统 — MO2 可在 Windows 上运行。除了上述文件复制外，无需额外设置。

安装程序本身不需要额外的模组或框架。如果你想要实际运行 Lua 脚本模组（main.lua），你需要在幻兽帕鲁的游戏目录中单独安装 UE4SS——但这是幻兽帕鲁模组的运行需求，而非本插件的必要条件。

鸣谢

该插件灵感来源于 AbsolutePhoenyx 的原版 MO2 Palworld 安装器。两个项目之间没有共享代码，但 AbsolutePhoenyx 的工作表明，为 MO2 构建一个 Palworld 感知的安装器是值得的，并为本插件复现的行为提供了参考。感谢您开辟了道路。