本指南介绍如何在 Legion Hosting 托管的 Garry's Mod 服务器上安装和配置 ULX 管理员 mod，包括安装、授予管理员权限、常用命令和管理权限组。
前提条件： 本指南假设您已拥有一个正常运行的 Garry's Mod 服务器。如果尚未设置，请先参阅 Garry's Mod 服务器设置指南。您需要 SFTP 访问权限来上传文件。如果尚未设置，请参阅 SFTP 文件上传指南。
目录
1. 安装 ULX 和 ULib
ULX 是 Garry's Mod 最广泛使用的管理员 mod。它需要同时安装两个插件：
| 插件 | Workshop ID | 说明 |
|---|---|---|
| ULib | 557962280 | ULX 所需的依赖库。必须先安装。 |
| ULX | 557962238 | 管理员 mod 本体。依赖 ULib。 |
方式 A — Workshop 合集（推荐）
将两个 Workshop ID 添加到服务器的 Workshop 合集中。如果您已在 GPanel 中通过 +host_workshop_collection 配置了合集，只需在 Steam 上将 ULib 和 ULX 添加到该现有合集中。服务器将在下次重启时自动下载它们。
方式 B — 手动 SFTP 上传
- 从 Workshop 或 Team Ulysses GitHub 下载两个插件。
- 通过 SFTP 上传到服务器，使文件夹结构如下：
garrysmod/addons/ulib/
garrysmod/addons/ulx/每个文件夹内必须直接包含插件的 lua/ 目录。
重要： 没有 ULib，ULX 将无法运行。请务必同时安装两者。安装完成后，从 GPanel 重启服务器。
2. 授予自己超级管理员权限
ULX 安装并重启服务器后，您需要授予自己 superadmin 权限。在 GPanel 中打开服务器控制台并运行：
ulx adduser "YourSteamName" superadmin如果您的 Steam 名称包含特殊字符或空格，请使用 64 位 Steam ID 以确保准确：
ulx adduserid "STEAM_0:1:12345678" superadmin
查找您的 Steam ID： 您可以在 steamid.io 上搜索您的个人资料来查找 Steam ID。使用
STEAM_0:X:XXXXXXXX 格式或 64 位 7656119XXXXXXXXXX 格式。
授权后，重新连接服务器。您可以在聊天中输入 !menu 打开 ULX 管理面板来验证您的权限。
3. 常用 ULX 命令
ULX 命令可以在 GPanel 的服务器控制台、游戏内控制台或聊天命令中运行（前缀为 !）。以下是最常用的命令。
玩家管理
| 命令 | 聊天快捷方式 | 描述 |
|---|---|---|
ulx kick "Player" reason | !kick Player reason | 将玩家踢出服务器 |
ulx ban "Player" minutes reason | !ban Player 60 reason | 封禁玩家（0 = 永久） |
ulx unban STEAMID | !unban STEAMID | 通过 Steam ID 解除封禁 |
ulx slay "Player" | !slay Player | 立即击杀玩家 |
ulx slap "Player" damage | !slap Player 10 | 对玩家造成指定伤害 |
通讯控制
| 命令 | 聊天快捷方式 | 描述 |
|---|---|---|
ulx gag "Player" | !gag Player | 禁止玩家使用语音聊天 |
ulx ungag "Player" | !ungag Player | 恢复玩家的语音聊天 |
ulx mute "Player" | !mute Player | 禁止玩家使用文字聊天 |
ulx unmute "Player" | !unmute Player | 恢复玩家的文字聊天 |
实用命令
| 命令 | 聊天快捷方式 | 描述 |
|---|---|---|
ulx noclip "Player" | !noclip Player | 切换穿墙飞行模式 |
ulx god "Player" | !god Player | 切换上帝模式（无敌） |
ulx teleport "Player" | !tp Player | 将玩家传送到准星位置 |
ulx bring "Player" | !bring Player | 将玩家传送到你身边 |
ulx goto "Player" | !goto Player | 将自己传送到玩家身边 |
ulx return "Player" | !return Player | 将玩家送回之前的位置 |
ulx cloak "Player" | !cloak Player | 使玩家隐身 |
4. 权限组
ULX 使用基于组的权限系统。默认情况下，ULX 包含以下权限组，按权限从高到低排列：
| 组 | 继承自 | 典型用途 |
|---|---|---|
superadmin | admin | 服务器拥有者。拥有所有命令的完全访问权限。 |
admin | operator | 可信赖的管理人员。可以封禁、踢出和管理玩家。 |
operator | user | 初级管理员。拥有有限的管理命令。 |
user | 无 | 所有玩家的默认组。 |
管理用户和组
// Add a user to a group
ulx adduser "Player" admin
// Remove a user from their group (reverts to "user")
ulx removeuser "Player"
// Create a custom group that inherits from "operator"
ulx groupallow "moderator" "ulx kick"
ulx addgroup "moderator" "operator"
// Grant a specific command to a group
ulx groupallow "admin" "ulx ban"
// Deny a specific command from a group
ulx groupdeny "operator" "ulx ban"使用图形界面
作为超级管理员，在聊天中输入 !menu 打开 ULX 管理面板。Groups 选项卡提供了可视化界面，用于创建组、分配权限和管理用户，无需使用控制台命令。
提示： 组数据存储在
garrysmod/data/ulib/groups.txt 中，用户数据存储在 garrysmod/data/ulib/users.txt 中。这些文件由 ULX 自动管理，但您可以通过 SFTP 备份它们。
5. 聊天命令
ULX 支持基于聊天的命令快捷方式，方便在游戏内快速进行管理操作。所有命令默认使用 ! 前缀。一些常用格式：
| 聊天命令 | 效果 |
|---|---|
!menu | 打开 ULX 管理图形界面 |
!motd | 显示每日公告 |
!kick Player reason | 踢出指定玩家 |
!ban Player 60 reason | 封禁 60 分钟 |
!hp Player 100 | 设置玩家的生命值 |
!armor Player 100 | 设置玩家的护甲值 |
提示： 使用
@ 作为目标可将命令应用于自己。例如，!god @ 可切换自己的上帝模式。
6. 配置文件
ULX 将其配置和数据存储在 garrysmod/data/ulib/ 中。需要了解的关键文件：
| 文件 | 用途 |
|---|---|
data/ulib/users.txt | 所有用户到组的分配和 Steam ID |
data/ulib/groups.txt | 组定义、继承关系和权限 |
data/ulib/bans.txt | 活跃封禁列表及到期时间 |
data/ulx/config.txt | ULX 设置（每日公告、欢迎消息、日志等） |
备份提醒： 在对管理员设置进行重大更改之前，请通过 SFTP 下载
data/ulib/ 和 data/ulx/ 作为备份。配置错误的组文件可能会导致所有管理员被锁定。
相关文章
- Garry's Mod 服务器设置指南 — Server.cfg、Workshop、游戏模式、DarkRP、FastDL
- Garry's Mod 故障排除 — 缺失贴图、Workshop 错误等
- 如何通过 SFTP 上传文件
需要帮助？ 如果您在 ULX 或管理员权限方面遇到问题，请 提交工单，并附上您的服务器 IP 和问题描述。
