中文

游戏服务器

在 Garry's Mod 上安装 ULX 和 ULib

在您的 Linux Garry's Mod 服务器上安装 ULX 和 ULib:首位超级管理员、组、权限、处罚、管理员备份、更新和故障排除。

阅读约 8 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何安装 Garry's Mod 的管理模组 ULX 及其库 ULib,然后指定管理员、创建组并为其分配精确的权限。

HostMyServers 不提供托管式游戏主机服务:您需要在自己的 VPS 或专用服务器上自行管理该服务器。

前提条件

  • 已按照创建 Garry's Mod 服务器指南安装好的服务器。本指南沿用该指南中的 gmod 用户、/home/gmod/gmod-server 目录和 gmod.service 服务
  • /home/gmod/backup.sh 脚本,参见该指南中的自动备份一节
  • 具有 sudo 权限的 SSH 访问
  • 已配置 RCON,并且已允许您的 IP 地址访问 TCP 端口 27015;或者已有账户在 settings/users.txt 中被声明为 superadmin
  • 您的 SteamID,格式为 STEAM_0:X:XXXXXXXX,连接后可通过 status 命令查看

文件组织

下面所有路径均以 /home/gmod/gmod-server/garrysmod 为起点。

项目 位置 作用
ULib addons/ulib ULX 所需的库
ULX addons/ulx 管理命令和菜单
用户和封禁 sv.db SQLite 表 ulib_users 和 ulib_bans
组 data/ulib/groups.txt 组及其关联的权限
用户副本 data/ulib_backups ULib 在启动时创建的副本
ULX 配置 data/ulx/config.txt 欢迎消息、日志、投票
ULX 日志 data/ulx_logs 操作记录

data/ulx 和 data/ulib 中的文件会在插件首次启动时创建。

步骤 1:备份服务器

终端
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -u gmod ls -lh /home/gmod/backups

最新的归档文件应带有当天的日期。其中包含 sv.db、data、settings 和 addons 等内容。

步骤 2:安装 ULib 和 ULX

以 gmod 用户身份登录,然后在插件文件夹中获取官方仓库:

终端
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons
git clone https://github.com/TeamUlysses/ulib.git ulib
git clone https://github.com/TeamUlysses/ulx.git ulx

检查得到的目录结构:

终端
ls ulib/lua/autorun/ulib_init.lua ulib/lua/ulib/init.lua ulx/lua/ulib/modules/ulx_init.lua ulx/lua/ulx/init.lua
exit

这四个文件都应正常显示,没有错误。ulib 和 ulx 文件夹必须保持小写。

步骤 3:启动服务器并检查加载情况

必须完整重启:仅更换地图是不够的。

终端
sudo systemctl start gmod.service

等待加载完成,然后查找这两个插件的消息:

终端
sudo journalctl -u gmod.service -n 500 --no-pager | grep -E 'Ulysses Library|ULX Admin Mod'

出现 Ulysses Library 和 ULX Admin Mod 这两行,即表示它们已加载。然后检查数据文件是否已创建:

终端
sudo -u gmod ls /home/gmod/gmod-server/garrysmod/data/ulib /home/gmod/gmod-server/garrysmod/data/ulx

步骤 4:指定首位超级管理员

superadmin 组可以使用所有命令。请选择适合您情况的方法。

通过 RCON

在游戏控制台中执行,并替换其中的示例值:

文本
rcon_address 服务器IP:27015
rcon_password YourPassword
rcon ulx adduserid "STEAM_0:X:XXXXXXXX" superadmin

如果您已在 users.txt 中是超级管理员

如果您的账户已列在 settings/users.txt 中,请连接服务器,并在游戏控制台中将其登记到 ULX:

文本
ulx adduser "YourName" superadmin

检查结果

重新连接服务器,然后在游戏控制台中输入:

文本
ulx who

您的账户应出现在 superadmin 组中。接着在聊天中输入 !menu:XGUI 管理菜单随之打开。在控制台中,ulx menu 命令的效果相同。

步骤 5:创建组

ULX 提供以下组:

组 继承自 可作用的对象
user 无 所有人
operator user 级别低于 admin 的玩家
admin operator 级别低于 superadmin 的玩家
superadmin admin 所有人

要创建一个只能踢出玩家的版主组,请使用您的超级管理员账户在游戏控制台中输入以下命令:

文本
ulx addgroup moderator operator
ulx groupallow moderator "ulx kick"
ulx setgroupcantarget moderator "!%admin"
ulx adduser "ModeratorName" moderator

目标 !%admin 可防止该组以管理员及更高级别的组为目标。

要进行验证,请使用版主账户连接,并在控制台中运行 ulx help:列表只会显示该账户有权使用的命令。尝试执行未授权的命令会返回 You don't have access to this command。

管理权限和成员

命令 作用
ulx adduser "Name" group 将在线玩家加入某个组
ulx adduserid "STEAM_0:X:XXXXXXXX" group 通过 SteamID 将玩家加入某个组,即使其不在线
ulx removeuser "Name" 移除在线玩家的所有权限
ulx removeuserid "STEAM_0:X:XXXXXXXX" 通过 SteamID 移除所有权限
ulx groupallow group "ulx command" 授予某个组一项权限
ulx groupdeny group "ulx command" 撤销某个组的一项权限
ulx userallow "Name" "ulx command" 授予某个玩家一项权限
ulx userdeny "Name" "ulx command" 撤销某个玩家的一项权限
ulx removegroup group 删除某个组
ulx usermanagementhelp 显示权限的详细帮助

日常使用 ULX

命令可在控制台(ulx kick)或聊天(!kick)中使用。

控制台 聊天 作用 默认权限
ulx kick "Name" reason !kick 踢出玩家 admin
ulx ban "Name" 60 reason !ban 封禁 60 分钟,0 表示永久封禁 admin
ulx banid "STEAM_0:X:XXXXXXXX" 60 reason !banid 通过 SteamID 封禁 superadmin
ulx unban "STEAM_0:X:XXXXXXXX" !unban 解除封禁 admin
ulx map map_name !map 更换地图 admin
ulx noclip !noclip 开启或关闭自由飞行 admin
ulx spectate "Name" !spectate 观察某个玩家 admin

您可以使用以下关键字指定多名玩家:^ 表示您自己,@ 表示您正在看的玩家,* 表示所有人,#group 表示某个组的成员,%group 表示该组及继承自它的组。在前面加上 ! 则反选。

配置 ULX

打开配置文件:

终端
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/data/ulx/config.txt

以下是一些有用的设置。以 ; 开头的行是注释。

文本
ulx showMotd 0
ulx welcomemessage "欢迎来到 %host%, 当前地图 %curmap%."
ulx logFile 1
ulx logDir "ulx_logs"
设置 作用
ulx showMotd 连接时的消息:0 为禁用,1 为文件,2 为内置生成器,3 为网址
ulx welcomemessage 欢迎消息,留空则禁用
ulx logFile 将日志保存到文件
ulx logDir 日志文件夹,位于 garrysmod/data 下

重启服务器以应用更改:

终端
sudo systemctl restart gmod.service

如需针对某个游戏模式的设置,请创建 data/ulx/gamemodes/darkrp/config.txt,并根据实际情况调整游戏模式的名称。如果您使用 DarkRP,另请参阅在 Garry's Mod 上安装和配置 DarkRP。

备份管理员

ULib 每次启动时都会把用户列表复制到 data/ulib_backups。您也可以通过 RCON 运行以下命令:

文本
rcon ucl_backup_users force
rcon ucl_restore_users latest

第一条命令会立即创建一份副本。第二条命令会用最新的副本替换当前列表:仅在出现问题时使用。这些副本只是对 backup.sh 的补充,backup.sh 才是您真正的备份。

更新 ULib 和 ULX

请始终同时更新这两个插件,并先记下它们的版本:

终端
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons
git -C ulib rev-parse HEAD > ~/ulib-before-update.txt
git -C ulx rev-parse HEAD > ~/ulx-before-update.txt
git -C ulib pull --ff-only
git -C ulx pull --ff-only
exit
sudo systemctl start gmod.service

然后重新执行步骤 3 中的检查,并在游戏中运行 ulx who。

回滚

回到上一个版本

更新可能会改变数据格式。因此还要恢复刚才创建的归档文件,请替换其名称:

终端
sudo systemctl stop gmod.service
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons
git -C ulib reset --hard "$(cat ~/ulib-before-update.txt)"
git -C ulx reset --hard "$(cat ~/ulx-before-update.txt)"
tar -xzf ~/backups/gmod_YYYY-MM-DD_HH-MM-SS.tar.gz -C ~/gmod-server/garrysmod sv.db data
exit
sudo systemctl start gmod.service

自该归档以来所做的更改(例如新的封禁)会丢失。

停用 ULX

终端
sudo systemctl stop gmod.service
sudo -iu gmod
mkdir -p ~/disabled-addons
mv ~/gmod-server/garrysmod/addons/ulx ~/gmod-server/garrysmod/addons/ulib ~/disabled-addons/
exit
sudo systemctl start gmod.service

服务器随后会回到 Garry's Mod 的 settings/users.txt 列表。

故障排除

未知命令 ulx

  • 检查安装后是否已重启服务器
  • 检查步骤 2 中的文件:文件夹名称错误或嵌套(例如 addons/ulx/ulx)会导致无法加载
  • 检查 ULib 是否存在:没有它,ULX 无法工作
  • 查找错误:sudo journalctl -u gmod.service -n 500 --no-pager | grep -iE 'ulib|ulx|\[error\]'

Bad RCON password

输入的密码与 server.cfg 中的 rcon_password 不一致。如果完全无法连接,请检查您的 IP 地址是否已被允许访问 TCP 端口 27015。

Invalid steamid.

SteamID 格式不正确。请从 status 命令的输出中复制,并保留引号。

invalid group "..." specified

该组不存在。请检查拼写,或使用 ulx addgroup 创建它。

You don't have access to this command

您的账户没有该权限。请使用 ulx who 检查您所在的组;如果刚更改过组,请重新连接。

No player with id "..." exists in the ULib user list

该 SteamID 没有任何已登记的权限,因此没有可移除的内容。

管理员失去组后又重新获得

他仍然列在 settings/users.txt 中;如果您使用 DarkRP,也可能在 GM.Config.DefaultPlayerGroups 中。请将其从这些列表中移除,然后重启服务器。

The users database failed to load.

ULib 无法读取其在 sv.db 中的表。随后的消息 Error while querying database was: 会给出原因。请使用 df -h 检查磁盘空间,然后在服务器停止的状态下,从您最近的归档中恢复 sv.db。

ULib 的 users.txt 文件不再变化

这是正常的:新版本的 ULib 将用户存储在 sv.db 中。一些文档仍然提到旧文件。请使用 ulx adduser 和 ulx adduserid 命令。

FAQ

可以从 Workshop 安装 ULX 吗?

可以,ULib 的 ID 为 557962238,ULX 的 ID 为 557962280,请将它们添加到您的合集中。此时请删除 addons/ulib 和 addons/ulx 文件夹,以免出现两份副本。

ULX 会取代 DarkRP 上的 FAdmin 吗?

这两个工具相互独立。FAdmin 随 DarkRP 一同提供。如果您只想使用 ULX,可以在 disabled_defaults.lua 中通过 ["fadmin"] = true, 将其停用。

在哪里可以找到完整的命令列表?

请在控制台中运行 ulx help,或查看 Ulysses 项目网站。