概述： 本指南涵盖如何在您的 Project Zomboid 服务器上设置管理员权限，以及使用最常用的管理员命令进行玩家管理、世界控制和服务器管理。
前提条件
- 一台由 Legion Hosting 托管的正在运行的 Project Zomboid 服务器
- 能够访问 GPanel
- 已安装游戏并能连接到您的服务器
设置管理员权限
在游戏内使用管理员命令之前，您需要在服务器上配置管理员密码。有两种方法可以实现。
方法 1：服务器设置文件
- 打开 GPanel 并导航到您的服务器。
- 进入文件管理器并打开
/.cache/server/<servername>.ini（将<servername>替换为您服务器的名称）。 - 找到
AdminPassword=行并设置一个安全密码：AdminPassword=YourSecurePassword123 - 保存文件并重启服务器。
方法 2：GPanel Startup 标签页
- 打开 GPanel 并导航到您的服务器。
- 进入 Startup 标签页。
- 找到 Admin Password 字段并输入您想要的密码。
- 重启服务器使更改生效。
授予玩家管理员权限
设置管理员密码后，连接并输入管理员密码的玩家将拥有管理员权限。您还可以直接从服务器控制台设置访问级别。
在 GPanel Console 标签页中，输入：
setaccesslevel <username> admin这是一个仅限控制台的命令——必须从 GPanel 控制台或服务器控制台运行，不能从游戏内聊天中运行。
重要提示： 切勿公开分享您的管理员密码。任何拥有密码的人都可以获得您服务器的完整管理员权限。
常用管理员命令
带有 / 前缀的命令在游戏内聊天中输入——按 T 或 Enter 打开聊天窗口。不带 / 前缀的命令仅限控制台，必须从 GPanel Console 标签页运行。
玩家管理
| 命令 | 描述 |
|---|---|
/players |
列出所有当前连接的玩家 |
/kick <username> |
将玩家踢出服务器 |
/banuser <username> |
封禁玩家 |
/unbanuser <username> |
解除玩家封禁 |
/adduser <username> <password> |
为玩家创建白名单账户 |
/servermsg <message> |
向服务器上所有玩家广播消息 |
传送
| 命令 | 描述 |
|---|---|
/teleport <username> |
将自己传送到玩家所在位置 |
/teleportto <x> <y> <z> |
将自己传送到指定地图坐标 |
玩家作弊 / 调试
| 命令 | 描述 |
|---|---|
/godmod <username> |
为玩家切换上帝模式（无敌） |
/invisible <username> |
为玩家切换隐身模式（僵尸忽略他们） |
/noclip <username> |
为玩家切换穿墙模式（穿过墙壁和地形飞行） |
/addxp <username> <perk> <amount> |
给玩家在特定技能上增加经验值（例如 /addxp Player1 Carpentry 1000） |
世界与事件
| 命令 | 描述 |
|---|---|
/startrain |
开始下雨事件 |
/stoprain |
停止当前降雨 |
/gunshot |
触发附近的枪声事件以吸引僵尸 |
/chopper |
触发直升机飞越事件 |
服务器控制
| 命令 | 描述 |
|---|---|
/save |
立即强制保存世界 |
/quit |
保存世界并优雅地停止服务器 |
访问级别
Project Zomboid 有多个访问级别来控制玩家可以使用的命令。从 GPanel Console 设置玩家的访问级别（这是一个仅限控制台的命令）：
setaccesslevel <username> <level>| 级别 | 描述 |
|---|---|
| admin | 拥有所有命令的完整访问权限。可以管理其他管理员、更改服务器设置和控制服务器。 |
| moderator | 可以踢出和封禁玩家、传送和查看玩家信息。无法更改服务器设置。 |
| overseer | 有限的管理能力。可以查看玩家信息并执行基本管理操作。 |
| gm | 游戏管理员。可以生成物品、传送和管理游戏内事件。适用于角色扮演服务器。 |
| observer | 可以旁观玩家。命令访问权限最小。适用于监控服务器。 |
| none | 没有特殊权限的普通玩家。这是所有玩家的默认级别。 |
提示： 要移除玩家的管理员权限，从 GPanel Console 将其访问级别设置回
none：setaccesslevel PlayerName none
使用 GPanel 控制台
您也可以通过 GPanel 网页控制台运行命令，无需登录游戏：
- 打开 GPanel 并导航到您的服务器。
- 进入 Console 标签页。
- 在底部的输入框中输入命令并按 Enter。
注意： 游戏内命令（带
/ 前缀）也可以在 GPanel 控制台中通过带 / 前缀输入来运行。某些命令如 setaccesslevel 仅限控制台使用，不使用 / 前缀。某些命令（如传送和上帝模式）可能仅在您登录游戏时才有效。
管理封禁列表
当您使用 /banuser 封禁玩家时，封禁记录存储在服务器的数据库中，位于 /.cache/db/。
管理封禁：
- 封禁玩家：
/banuser <username> - 解封玩家：
/unbanuser <username> - 手动编辑： 您也可以使用 GPanel 文件管理器浏览
/.cache/db/目录，在需要时手动编辑封禁列表。
故障排除
管理员命令不起作用
- 确保在
/.cache/server/<servername>.ini中正确设置了管理员密码（AdminPassword=行），并且在更改后重启了服务器。 - 确保您在连接服务器时输入了管理员密码。
- 检查
/.cache/Logs/中的服务器日志是否有任何错误消息。
"You don't have access" 错误
- 您的访问级别可能不够高。请服务器管理员从 GPanel Console 使用
setaccesslevel <username> admin设置您的访问级别。 - 某些命令需要 admin 访问级别。如果您被设置为较低级别（如 moderator 或 gm），某些命令可能对您不可用。
/addxp 不起作用
- 确保技能名称拼写正确并使用确切的 PZ 技能名称（例如
Carpentry、Cooking、Farming、Fitness、Strength）。 - 运行命令时玩家必须在线。
GPanel 控制台命令无响应
- 某些命令只能在游戏内输入，不能通过 GPanel 控制台运行。
- 确保服务器正在运行，而不是处于崩溃或停止状态。
- 尝试从 GPanel 重启服务器并再次执行命令。
相关指南
- Project Zomboid 服务器设置指南 — 配置服务器的游戏设置、难度和沙盒选项。
- Project Zomboid 模组安装指南 — 为您的服务器添加 Workshop 模组。
需要帮助？ 如果您在使用管理员命令或服务器管理方面遇到问题，提交支持工单，我们的团队将为您提供帮助。
