🐾 幻兽帕鲁服务器加 Mod 完整教程

一、前置知识 & 准备工作

1.1 Palworld Mod 是怎么工作的？

Palworld 使用 Unreal Engine 5 (UE5) 开发。Mod 的核心加载器叫做 UE4SS（Unreal Engine 4/5 Scripting System），它通过注入 DLL 的方式，在游戏/服务器启动时加载自定义 Lua 脚本和蓝图 Mod，从而实现对游戏逻辑的修改。

1.2 你需要准备的东西

二、安装 Palworld 专用服务器

2.1 Windows 服务器安装

C:\steamcmd\steamcmd.exe +force_install_dir C:\palworld_server +login anonymous +app_update 2394010 validate +quit

cd C:\palworld_server
PalServer.exe

# PowerShell（管理员）
New-NetFirewallRule -DisplayName "Palworld Server" -Direction Inbound -Protocol UDP -LocalPort 8211 -Action Allow

2.2 Linux 服务器安装（Ubuntu）

sudo dpkg --add-architecture i386
sudo apt update
sudo apt install steamcmd lib32gcc-s1 curl wget unzip -y

sudo useradd -m -s /bin/bash palworld
sudo -u palworld -i

steamcmd +force_install_dir /home/palworld/server +login anonymous +app_update 2394010 validate +quit

cd /home/palworld/server
./PalServer.sh

nano Pal/Saved/Config/LinuxServer/PalWorldSettings.ini

sudo ufw allow 8211/udp
sudo ufw enable

三、UE4SS — Mod 加载框架安装

UE4SS 是 Palworld Mod 的基石，几乎所有 Mod 都依赖它。它通过 xinput1_3.dll 代理注入实现 Mod 加载。

3.1 下载 UE4SS

前往 RE-UE4SS GitHub Releases，下载最新版本。

选择 UE4SS_vX.X.X.zip（非 UE4SS_Signatures 版本）。

当前推荐版本：v3.0.1+，确保兼容 Palworld 最新版本。

3.2 Windows 服务器安装 UE4SS

C:\palworld_server\Pal\Binaries\Win64\

Pal/Binaries/Win64/
├── xinput1_3.dll          ← UE4SS 核心 DLL（代理注入）
├── UE4SS.dll               ← UE4SS 主程序
├── dwmapi.dll              ← 辅助 DLL
├── UE4SS-settings.ini      ← UE4SS 配置文件（重要！）
├── uesave.dll              ← 存档工具（可选）
├── Mods/                   ← Mod 文件夹（可能需要手动创建）
│   ├── mods.txt            ← Mod 加载列表
│   └── shared/             ← 共享库目录
└── PalServer-Win64-Test.exe  ← 原服务器可执行文件

[General]
; 启用 GUI 控制台（服务器建议设为 0，因为没有桌面环境）
GuiConsoleEnabled = 0
; 启用控制台输出
ConsoleEnabled = 1

[Debug]
; 调试模式。测试时设为 1 方便排查，正式运行设为 0
ConsoleDebugConsoleEnabled = 0

[Engine]
; 使用 xinput 方式注入（服务器必须用这个）
UseUObjectArrayCache = 1

[Mods]
; Mod 加载目录
ModsFolderPath = Mods

# Mod名称 : 是否启用
# 示例（安装Mod后再改）：
MyFirstMod : 1

3.3 Linux 服务器安装 UE4SS

Linux 下 UE4SS 的安装流程与 Windows 类似，但需要额外注意：

cd /home/palworld/server/Pal/Binaries/Win64/

wget https://github.com/UE4SS-RE/RE-UE4SS/releases/download/v3.0.1/UE4SS_v3.0.1.zip
unzip UE4SS_v3.0.1.zip
# （请替换为最新版本链接）

nano UE4SS-settings.ini

四、安装你的第一个 Mod

我们以一个最简单的 Mod 为例——增加基地帕鲁数量上限（纯服务器端 Mod，客户端无需安装）。

mkdir -p Pal/Content/Paks/~mods
# 将 .pak 文件放入，并确保文件名以 _P 结尾
cp MyBasePalsMod.pak Pal/Content/Paks/~mods/MyBasePalsMod_P.pak

cd Pal/Binaries/Win64/Mods/
mkdir MyMod
# 将 Mod 的 Lua 文件放入 MyMod/ 目录
# 目录结构通常为：
# Mods/MyMod/
#   ├── main.lua
#   └── Scripts/
#       └── config.lua

MyMod : 1

# Windows
PalServer.exe

# Linux
./PalServer.sh

[UE4SS] Mod 'MyMod' loaded successfully
[UE4SS] Lua script 'main.lua' executed

五、客户端同步（关键！）

这是最多人踩坑的地方。不是所有 Mod 都只需要安装在服务器端。

5.1 哪些 Mod 客户端也需要装？

5.2 客户端安装步骤

客户端的安装流程与服务器完全相同：

1. 在 Steam 库中找到 Palworld → 右键 → 管理 → 浏览本地文件
2. 安装 UE4SS（同第三章）到 Pal/Binaries/Win64/
3. 将 .pak Mod 放入 Pal/Content/Paks/~mods/
4. 将 Lua Mod 放入 Pal/Binaries/Win64/Mods/ 并编辑 mods.txt

5.3 如何让玩家方便同步？

推荐做法：

1. 将你的 Mod 包（包括 UE4SS 配置好的完整 Pal/ 目录结构）打包成 zip
2. 上传到网盘或群文件
3. 玩家下载后解压覆盖到游戏目录即可
4. 或者让每个玩家自行从 Nexus Mods 下载相同的 Mod 列表

六、常见 Mod 类型 & 推荐列表

6.1 Mod 分类

6.2 推荐 Mod（服务器端）

在 Nexus Mods 搜索 Palworld：nexusmods.com/palworld

七、进阶：合并 Mod 与冲突排查

7.1 Mod 加载顺序

在 mods.txt 中，Mod 按从上到下的顺序加载。后面的 Mod 会覆盖前面的同名文件/函数。

# 基础 Mod 先加载
BaseLibrary : 1
# 依赖 Mod 后加载
MyFeatureMod : 1
# 补丁/覆盖最后加载
MyFeatureMod_Patch : 1

7.2 .pak 文件的加载优先级

在 ~mods/ 目录中，文件按字母顺序加载。可以通过命名控制优先级：

Pal/Content/Paks/~mods/
├── 00_BaseLibrary_P.pak      ← 最先加载
├── 01_CoreFeatures_P.pak
├── 02_ExtraContent_P.pak
└── 99_FinalPatch_P.pak       ← 最后加载，最高优先级

7.3 冲突排查方法

1. 二分法排查：关闭一半 Mod，测试是否正常，逐步缩小范围
2. 查看 UE4SS 日志：在 Pal/Binaries/Win64/UE4SS.log 中搜索 ERROR 和 WARN
3. 检查 .pak 文件：两个 .pak 修改了同一个资源就会冲突
4. Lua 脚本冲突：两个 Mod 注册了同名的 Hook 或覆盖了同一个函数

7.4 合并多个 .pak Mod

如果你有多个 .pak Mod 需要合并，可以使用 UnrealPak 工具（UE5 自带）。但这对普通用户门槛较高，建议优先选择「同一个作者出的合集 Mod」来避免冲突。

八、Linux 服务器特殊处理

8.1 Wine/Proton 环境准备

Palworld Linux 服务器实际上通过 Proton 运行 Windows 版本。确保 Proton 已正确安装：

# 通过 SteamCMD 安装的服务器通常自带 Proton
# 检查 Proton 版本
ls ~/Steam/steamapps/common/Proton*/

8.2 UE4SS 在 Linux 下的已知问题

8.3 Linux 启动脚本（含 UE4SS）

#!/bin/bash
# Palworld Linux Server with UE4SS

export WINEDLLOVERRIDES="xinput1_3=n,b"
export WINEARCH=win64
export WINEPREFIX=/home/palworld/.wine

cd /home/palworld/server

# 先更新服务器
steamcmd +force_install_dir /home/palworld/server +login anonymous +app_update 2394010 validate +quit

# 启动（带 UE4SS 日志输出）
./PalServer.sh -useperfthreads -NoAsyncLoadingThread -UseMultithreadForDS 2>&1 | tee server.log

8.4 替代方案：使用 Docker

社区有制作好的 Docker 镜像，内置 UE4SS 和常见 Mod：

# 搜索 Docker Hub
docker search palworld-server

# 推荐镜像（示例）
docker run -d \
  --name palworld \
  -p 8211:8211/udp \
  -v /path/to/saves:/palworld/Pal/Saved \
  -e SERVER_NAME="My Server" \
  thijsvanloef/palworld-server-docker:latest

Docker 方式通常已预配置好 UE4SS，只需将 Mod 文件挂载进去即可。

九、常见问题 FAQ

Q: 服务器启动后闪退 / 没有反应？

检查顺序：
1. UE4SS 版本是否兼容当前 Palworld 版本
2. 查看 UE4SS.log 中的错误信息
3. 尝试临时移除所有 Mod（重命名 mods.txt→mods.txt.bak）看能否启动
4. 检查 UE4SS-settings.ini 中 GuiConsoleEnabled = 0

Q: 玩家连不上服务器？

检查：
• UDP 8211 端口是否放行（防火墙 + 安全组）
• 服务器是否正常启动（查看控制台日志）
• 客户端和服务器的 Mod 是否完全一致
• 如果客户端装了 UE4SS 但服务器没装（或反过来），也可能连不上

Q: Mod 装了但不生效？

检查：
1. mods.txt 中的 Mod 名字是否与文件夹名完全一致（包括大小写）
2. .pak 文件名是否以 _P 结尾
3. .pak 是否放在了正确的 ~mods/ 目录（不是 Paks/ 根目录）
4. UE4SS 日志中搜索 Mod 名称确认是否加载

Q: 游戏更新后 Mod 失效了？

正常现象。每次 Palworld 更新后：
1. 先更新服务器文件（steamcmd +app_update 2394010）
2. 重新安装 UE4SS（因为更新可能覆盖了 DLL）
3. 重新放置 .pak Mod 文件
4. 检查 UE4SS 是否有新版本
5. 部分 Mod 本身也需要更新以兼容新版本

Q: 如何卸载 Mod？

1. Lua Mod：在 mods.txt 中将 : 1 改为 : 0，或者删除/重命名 Mod 文件夹
2. .pak Mod：从 ~mods/ 目录中移除文件
3. 完全卸载：删除 xinput1_3.dll、UE4SS.dll、dwmapi.dll 和整个 Mods/ 文件夹

Q: 服务器一直卡在加载界面？

通常是因为某个 Mod 导致了死循环或无限等待。用二分法逐个关闭 Mod 找出问题源。

十、完整启动脚本参考

10.1 Windows 完整启动脚本 (start.bat)

@echo off
cd /d C:\palworld_server

echo ================================
echo  Palworld Server with Mods
echo ================================
echo.

:: 自动更新服务器
echo [1/3] Updating server...
C:\steamcmd\steamcmd.exe +force_install_dir C:\palworld_server +login anonymous +app_update 2394010 validate +quit

:: 检查 UE4SS 是否完整
echo [2/3] Checking UE4SS...
if not exist "Pal\Binaries\Win64\xinput1_3.dll" (
    echo [WARN] UE4SS not found! Mods will NOT load.
    echo [WARN] Please install UE4SS first.
)

:: 启动服务器
echo [3/3] Starting server...
echo.
PalServer.exe -useperfthreads -NoAsyncLoadingThread -UseMultithreadForDS -publiclobby

pause

10.2 Linux 完整启动脚本 (start.sh)

#!/bin/bash
set -e

SERVER_DIR="/home/palworld/server"
STEAMCMD="/usr/games/steamcmd"

echo "================================"
echo " Palworld Server with Mods"
echo "================================"
echo ""

# 更新服务器
echo "[1/4] Updating server..."
$STEAMCMD +force_install_dir $SERVER_DIR +login anonymous +app_update 2394010 validate +quit

# 备份存档
echo "[2/4] Backing up saves..."
BACKUP_DIR="$SERVER_DIR/backups/$(date +%Y%m%d_%H%M%S)"
mkdir -p "$BACKUP_DIR"
cp -r "$SERVER_DIR/Pal/Saved/SaveGames" "$BACKUP_DIR/" 2>/dev/null || true
echo "  Backup saved to: $BACKUP_DIR"

# 检查 UE4SS
echo "[3/4] Checking UE4SS..."
if [ ! -f "$SERVER_DIR/Pal/Binaries/Win64/xinput1_3.dll" ]; then
    echo "  [WARN] UE4SS not found! Mods will NOT load."
fi

# 启动服务器
echo "[4/4] Starting server..."
echo ""
cd "$SERVER_DIR"

export WINEDLLOVERRIDES="xinput1_3=n,b"
./PalServer.sh -useperfthreads -NoAsyncLoadingThread -UseMultithreadForDS -publiclobby

10.3 设置为系统服务（Linux systemd）

# 创建服务文件 /etc/systemd/system/palworld.service
sudo nano /etc/systemd/system/palworld.service

[Unit]
Description=Palworld Dedicated Server
After=network.target

[Service]
Type=simple
User=palworld
Group=palworld
WorkingDirectory=/home/palworld/server
Environment="WINEDLLOVERRIDES=xinput1_3=n,b"
ExecStartPre=/usr/games/steamcmd +force_install_dir /home/palworld/server +login anonymous +app_update 2394010 validate +quit
ExecStart=/home/palworld/server/PalServer.sh -useperfthreads -NoAsyncLoadingThread -UseMultithreadForDS
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

# 启用服务
sudo systemctl daemon-reload
sudo systemctl enable palworld
sudo systemctl start palworld

# 查看状态
sudo systemctl status palworld

# 查看日志
sudo journalctl -u palworld -f