常见问题

我不小心封禁了自己/其他人。如何解除封禁？

账号封禁请使用 /unban <UserId>，IP 封禁请使用 /unbanip <IP>。PalDefender 的封禁记录保存在 ../Pal/Binaries/Win64/PalDefender/Banlist.json。如果要手动编辑该文件，请先停止服务器，或在编辑后重新加载配置。

已废弃旧版通过 Config.json 清理 IP 封禁

旧版 Wiki 曾提示管理员从 ../Pal/Binaries/Win64/PalDefender/Config.json 删除 IP 封禁。该位置已不再用于封禁记录。请改用 /unbanip <IP>，或编辑 ../Pal/Binaries/Win64/PalDefender/Banlist.json。

我添加或修改了 PalTemplate/PalSummon 文件，但命令失败。

确认文件是有效 JSON。请移除注释和末尾多余逗号。
模板应放在 ../Pal/Binaries/Win64/PalDefender/Pals/Templates/.
召唤文件应放在 ../Pal/Binaries/Win64/PalDefender/Pals/Summons/.
使用不带路径的文件名，例如 /summon ArenaBoss。
对于召唤文件，请确认包含 PalTemplate、X、Y 和 Z。
对于模板文件，请确认包含 PalID，并且使用有效的 Pal ID。

命令应该使用哪种 ID：UserId、PlayerUId、名称还是 SteamID？

大多数管理员命令需要玩家的 UserId，例如 steam_... 或 gdk_...。在游戏内使用 /iwantplayerlist 可在玩家列表中显示 ID；如果已启用，也可以使用 REST/API 工具。

为什么在聊天中不需要参数的命令，通过 RCON 执行时需要坐标或 UserId？

RCON 没有游戏内玩家角色，因此 PalDefender 无法推断你的位置或目标。对于 /getpos、/tp、/spawnpal 以及基地位置相关命令，请明确提供目标玩家或坐标。

REST API 返回 401 或 403，我应该检查什么？

401: 检查 Authorization: Bearer <token> 请求头，并确认令牌文件没有命名为 TokenExample.json。
403: 检查令牌权限，并确认服务器已经完成启动。
修改令牌后，请根据你的主机流程重启服务器，或重新加载 API/令牌配置。

我无法以管理员身份登录，提示管理员命令受白名单保护。

请确认你已像这样把自己的 IP 添加到 ../Pal/Binaries/Win64/PalDefender/Config.json：

"useAdminWhitelist": true,
"adminIPs": [
    "127.0.0.1",
    "196.128.2.*",
    "123.222.111.122",
    "111.111.111.111",
],

也可以将 useAdminWhitelist 设为 false，但不推荐这样做，因为已知作弊者可能通过漏洞获取管理员密码。

我的服务器启动时崩溃。

确认 PalDefender 是唯一运行的 Mod。删除其他 Mod 后检查问题是否仍然存在。
检查 PalDefender 是否为最新版本。
查看我们的 Discord 了解公告。
重命名 ../Pal/Binaries/Win64/ 中的 `PalDefender` 目录，然后重启服务器。
在某些情况下，安装 VC++ Redistributable 会有帮助。

我的服务器控制台无法正确显示某些符号。

请使用 Windows Terminal，或其他正确支持 Unicode 的终端，而不是默认 Windows 控制台。

如何报告崩溃？

请在 Issue 区发送以下文件：

.../Pal/Saved/Crashes/<random numbers>/CrashContext.runtime-xml
.../Pal/Binaries/Win64/PalDefender/Logs/<recent logs>

请附上你看到的、或认为可能相关的任何信息。不要忘记 PalDefender 版本！任何信息都可能有价值。