安装指南
先选你在哪儿玩，再跟着对应步骤安装。自己的电脑和远端服务器，需要分别处理。
Windows 游戏客户端；Linux x86_64 专服使用对应安装包。Windows 专用服务器不在这些模组的支持范围，本地主机真实访客场景尚不能保证。
本文核对的包版本：0.18.4；游戏资料基线：Palworld v1.0.5.102999。下载到的版本不同时，先核对随包说明。
01 · 客户端、单人游戏和自己当房主
- 退出游戏，备份要使用的存档。打开本模组的工坊条目，订阅并等 Steam 下载完成。
- 同时订阅依赖 UE4SS Experimental (Palworld)。这些模组各自独立，无需 PalSchema，也不用把本站所有模组都装上。
- 在游戏模组管理器里启用本模组和依赖，完整退出，再重新启动。只回到标题画面不算重启。
- 先进入备份过的世界，按下方“确认生效”检查。旧手动版和工坊版不要同时加载；以前手动安装过的，先按旧包说明停用重复副本。
加入别人服务器的玩家，完成客户端步骤后，把这份指南发给管理员。范围、容量、掉落与服务组件，需要在服务器安装；你的订阅不会替远端安装。自己当房主则在本机加载，但不能据此保证所有访客场景都可用。
02 · Linux 专服安装
先拿对安装包
在已订阅并完成下载的电脑上，打开 Steam 库目录下的这个位置。库可能在别的磁盘；条目 ID 就是工坊链接中 id= 后面的数字。
steamapps/workshop/content/1623730/3811768120/把本模组的完整目录上传到服务器，放在游戏目录之外。需要 Server、Linux/runtime 和安装器；只上传客户端 Scripts 或单个安装脚本都不完整。
进入安装包目录，至少应看到以下内容。版本或文件不对应时先停在这里：查看工坊更新说明，或在对应项目留言附上版本号，确认完整 Linux 包。不要拿 Windows DLL、Info.json 或客户端 Scripts 代替。
install-linux.sh
install-linux.py
package.json
SHA256SUMS.txt
Server/Scripts/
Linux/runtime/停服、备份和检查环境
- 通知玩家退出，用原来的方式完整停服，暂停面板、systemd 或其他监督器的自动拉起。
- 停服后备份 Pal/Saved，记录原启动命令、参数、运行账号和工作目录。安装器的文件备份不包含完整游戏存档。
- 确认 Linux x86_64、Python 3.9+ 和 fuser（通常由 psmisc 提供）。使用有游戏目录写权限的原游戏账号。
- 游戏根目录应直接包含 Pal/Binaries/Linux/PalServer-Linux-Shipping。使用不经符号链接的真实绝对路径；下方示例路径需要替换。
uname -m
python3 --version
command -v fuser预览改动，再安装
cd /path/to/package
sh install-linux.sh --game-root /path/to/game --dry-run先看检查结果，确认路径和改动正确，再执行下一条。遇到仍在运行、校验失败或运行库冲突，先处理原因，不跳过检查。
sh install-linux.sh --game-root /path/to/game记下输出的备份位置。安装器保留其他模组条目，不修改端口、防火墙或服务配置，也不自动重启。安装过程不需要 Steam 密码。
安装后的本模组脚本目录：
Pal/Binaries/Linux/Mods/AxPalboxQuickFavoriteServer/Scripts/接回原来的启动方式
已有正常的 UE4SS 启动入口，就继续用原入口。首次安装时，安装器生成下面这个脚本；从游戏根目录运行它，并带上原来的启动参数。
AxPalboxQuickFavoriteServer.sh面板或 systemd 只调整必要的启动入口，保留原账号、工作目录、端口和绑定地址。多个模组共用一个正常的 UE4SS 入口，不是每个模组各开一次服务器。安装器不会代替你修改面板或服务单元。
容器与托管面板由管理员按实际挂载路径操作。如果没有停服、文件或启动入口的权限，交给服务商处理。安装模组不需要额外开放公网端口。
03 · 确认加载，再确认游戏效果
安装成功只说明文件已放好。启动后，在 Pal/Binaries/Linux/UE4SS.log 中查找本模组的加载记录和错误，再让匹配版本的客户端进入世界核对。
[AxPalboxQuickFavoriteServer] LOADED v0.18.0这是这份包的服务组件标识，可能与客户端版本不同；不要仅因数字不同就认定装错。
这个模组具体检查什么
Linux 使用 AxPalboxQuickFavoriteServer，客户端与服务端都需要。星级筛选要求 0.18.0 或更新的兼容服务；旧服务拒绝不支持的条件，不会悄悄忽略它。当前日志的服务标识仍为 0.18.0，不等于客户端必须退到旧版。
打开自己的终端，进入快速收藏，用很窄的条件预览，核对待改、无需改、锁定数量，再确认目标收藏等级。只读取个人终端存储，不包含队伍和基地工人。第一次可选一只熟悉的帕鲁验证，但这不是每次使用的解锁门槛。
What to check for this mod
Linux uses AxPalboxQuickFavoriteServer and needs both the client and service. Star filtering requires a compatible service at 0.18.0 or later; an older service rejects unsupported conditions rather than ignoring them. The current log identifier remains 0.18.0; this does not require downgrading the client.
Open your own Palbox, choose Quick Favorite, preview a narrow filter and review pending, unchanged and locked counts before confirming the target favorite level. It scans personal storage, not your party or base workers. Testing with one familiar Pal first is sensible, but is not a mandatory unlock step.
04 · 更新、停用与恢复
客户端更新：完整退出，等 Steam 更新完成，再启动。Linux 更新：通知玩家 → 停服并暂停自动拉起 → 备份存档和旧包 → 游戏目录外解压新包 → dry-run → 安装 → 沿用 UE4SS 入口启动 → 核对日志与效果。客户端也要使用兼容版本；订阅不会自动更新远端 Linux 安装。
停用前先按上方本模组说明处理额外格位、设施或队列。客户端禁用并完整重启。Linux 停服后，在对应安装包目录执行：
sh install-linux.sh --game-root /path/to/game --disable只停用这一项，不删除其他模组共用的 UE4SS。再次启用时停服后按正常安装步骤操作。文件回退或停用不会撤销已写进存档的收藏、投入、建筑或加工结果。
回退安装文件
这份安装器支持 --restore。填入安装时输出的实际备份路径，停服后先预览，确认后再去掉 --dry-run。若共用文件已有其他修改，先核对差异，不强行覆盖。
sh install-linux.sh --game-root /path/to/game --restore /path/to/backup --dry-run恢复整个 Pal/Saved 会一起回退游戏进度，和普通停用不同。先保存当前状态，再决定是否需要恢复存档。
遇到问题，从这里查
- 找不到 install-linux.sh
- 核对是否上传了完整目录，而非客户端副本。
- 服务器仍在运行
- 检查面板或监督器是否重新拉起了进程，确认停服后重试。
- SHA-256 或运行库检查失败
- 重新获取完整包，核对已有运行库与其他模组依赖。不要修改校验清单或删除未知库来绕过。
- 安装完成，但没效果
- 检查 UE4SS 启动入口、Mods/mods.txt、本模块目录和双方版本，再按本模组验证步骤检查对象。一次随机掉落或一个旧箱子不能代表全部安装结果。
仍有问题，可以在下方留言：附游戏与模组版本、单机还是哪种服务器、操作步骤、完整报错与同时段日志。发送前去掉账号、私人路径和地址，不需要提供密码。
工坊目录与服务器机制参考官方资料；本页 Linux 步骤以随包安装器为准。 Palworld 服务器文档 ↗