幻兽帕鲁安装器 - Mod Organizer 2 插件

描述

《幻兽帕鲁》及《幻兽帕鲁》专用服务器的Mod Organizer 2插件套件。安装时自动处理Mod压缩包，将其内容重写成游戏实际需要的目录结构，无需手动重新打包或自行将.pak与main.lua文件移至正确文件夹。

套房分为两部分：

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

当安装路径明确时，安装过程将静默进行。若需手动选择（如多个资源包、自定义路径、模组冲突等），则会弹出简洁对话框，并自动填入默认配置。

安装说明

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

安装游戏定义

将这两个文件复制到MO2已有的basic_games插件中。

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

将它们放入 <MO2安装目录>/plugins/basic_games/games/ 内，请勿放在其他位置。

重启MO2后，创建新实例时应会显示《幻兽帕鲁》及《幻兽帕鲁》专用服务器。

2. 安装《幻兽帕鲁》安装程序

将整个 plugins/PalworldInstaller/ 文件夹复制到 <MO2安装目录>/plugins/ 中。最终路径应如下所示：

<MO2安装目录>/plugins/PalworldInstaller/
├── __init__.py
安装程序.py
```yaml
└── ui/
```
    ```
├── __init__.py
```
    dialog.py

重启MO2。

3. 配置你的平台

打开设置 → 插件 → Palworld安装器，将平台设置为与你安装版本一致：

• 幻兽帕鲁平台 — Steam（默认）或 Xbox
• 幻兽帕鲁服务器平台 — Steam（默认）或 Xbox
  

若使用Xbox主机版或PC Game Pass版（两者均使用WinGDK运行时），请选择Xbox选项。若仅管理两款游戏中的一款，其他设置无需改动。

就是这样。把幻兽帕鲁的模组压缩包拖进MO2，安装程序会自动处理后续步骤。

主要特色

• 自动存档整理 — 认领包含 .pak、main.lua 或根目录松散 .json 文件的档案，并将其重写为《幻兽帕鲁》的标准布局（如 Content/Paks/...、Binaries/Win64/Mods/<mod名称>/ 等）。
• 平台感知变体选择 — 若某个存档同时包含 {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的基础游戏插件 — 默认随 MO2 附带。幻兽帕鲁的游戏定义需依赖此插件；若无该插件，游戏将无法被识别。
• 《幻兽帕鲁》或《幻兽帕鲁》专用服务器 — 实际安装好的游戏本体，已配置MO2进行管理。安装程序仅对管理这两个游戏之一的实例启用。
• Windows — MO2 运行于 Windows 系统，除上述文件复制外无需额外安装。
  

安装程序本身无需额外模组或框架。若需运行Lua脚本模组（main.lua），则须单独在《幻兽帕鲁》游戏目录中安装UE4SS——此为《幻兽帕鲁》模组运行需求，与本插件无关。

喊话

此插件灵感来源于 绝对凤凰很抱歉，您提供的文本内容似乎不完整。请确认是否遗漏了需要翻译的原文内容。 《幻兽帕鲁》MO2安装程序两个项目之间没有共享任何代码，但AbsolutePhoenyx的工作证明了为MO2打造一款适配《幻兽帕鲁》的安装程序是值得的，也为本插件所实现的功能提供了参考。感谢你铺路架桥。