Pterohost docs

Установка ULX и права администратора в Garry's Mod

Как установить ULib и ULX на сервер Garry's Mod, выдать права администратора и суперадмина, использовать команды через консоль и меню.

ULX - стандарт де-факто для администрирования серверов Garry’s Mod. Этот аддон даёт гибкую систему групп и прав, десятки команд для управления игроками и удобное графическое меню. Без ULX управлять активным сервером крайне неудобно. В этой статье вы узнаете, как правильно установить ULib и ULX, выдать себе права суперадмина и использовать ключевые команды администрирования.

Что понадобится

  • Работающий сервер Garry’s Mod.
  • Доступ к файлам сервера по FTP/SFTP или через панель управления.
  • Steam-аккаунт для скачивания аддонов из Workshop (опционально).

Хотите получить готовый Garry’s Mod сервер с уже настроенной панелью управления? Pterohost предоставляет сервер Garry’s Mod с автоустановкой аддонов, NVMe SSD и AMD Ryzen 9 7950X3D - без долгой настройки с нуля. По промокоду 4START скидка 20% на первый заказ.

Что такое ULib и почему нужны оба аддона

ULX и ULib - два разных, но взаимосвязанных аддона от команды Team Ulysses:

  • ULib - библиотека низкого уровня. Предоставляет API для управления игроками, группами, правами и командами. Сам по себе не добавляет команд в игру.
  • ULX - пользовательский интерфейс поверх ULib. Добавляет сотни команд, графическое меню и систему групп.

Без ULib аддон ULX не запустится. Устанавливать нужно оба - в строго правильном порядке загрузки (Garry’s Mod сам разберётся с порядком по наличию обоих файлов в addons/).

Скачивание аддонов

Вариант 1: GitHub (рекомендуется)

# Клонировать ULib
git clone https://github.com/TeamUlysses/ulib.git ulib

# Клонировать ULX
git clone https://github.com/TeamUlysses/ulx.git ulx

GitHub-версии всегда актуальны и легко обновляются командой git pull.

Вариант 2: Steam Workshop

Подпишитесь на аддоны в мастерской Steam:

  • ULib: ID 557962280
  • ULX: ID 557962280

Для выделенного сервера Workshop-аддоны нужно подключать через файл garrysmod/cfg/mount.cfg или через параметр запуска +host_workshop_collection.

Установка файлов на сервер

Распакуйте или скопируйте оба аддона в правильную директорию:

garrysmod/
  addons/
    ulib/     <- папка библиотеки ULib
    ulx/      <- папка аддона ULX

Подключение по FTP описано в статье Подключение по FTP/SFTP. После загрузки файлов перезапустите сервер.

Признаки успешной загрузки в консоли сервера:

[ULib] Загружено.
[ULX] Версия X.X загружена.

Выдача прав администратора

Через консоль сервера (основной способ)

Зайдите на сервер и откройте консоль сервера (не игровую консоль клиента). Выполните команду с точным ником игрока:

# Выдать права суперадмина
ulx addsuperadmin "ВашНик"

# Выдать права администратора
ulx adduser "НикИгрока" admin

# Выдать права оператора
ulx adduser "НикИгрока" operator

Через игровую консоль (если у вас уже есть права)

# Повысить другого игрока до суперадмина
ulx addsuperadmin НикБезПробелов

# Добавить игрока в группу по Steam ID
ulx adduser "#STEAM_0:0:12345678" admin

Через файл users.txt

Если доступ к консоли сервера недоступен, отредактируйте файл garrysmod/addons/ulib/cfg/users.txt:

"ULib"
{
  "Users"
  {
    "STEAM_0:0:12345678"
    {
      "group" "superadmin"
    }
  }
}

Группы пользователей ULX

ГруппаУровеньЧто можно делать
user0 - базовыйТолько стандартные игровые действия
operator1 - модераторKick, mute, freeze, базовые команды
admin2 - администраторВсе команды оператора + ban, teleport, god
superadmin3 - суперадминПолный доступ ко всем командам и настройкам

Группы можно создавать и настраивать через меню ULX - раздел Groups.

Открытие меню администратора

ULX предоставляет несколько способов открыть графическое меню:

# В игровом чате (работает для всех с правами)
!menu
!ulx

# В игровой консоли
ulx menu
xgui

Меню содержит вкладки: Players (управление игроками), Bans (список банов), Map (смена карты), Settings (настройки ULX), Groups (управление группами).

Таблица популярных команд ULX

КомандаПримерОписание
ulx kickulx kick "Ник" "Причина"Кик игрока с сервера
ulx banulx ban "Ник" 60 "Причина"Бан на 60 минут
ulx unbanulx unban STEAM_0:0:123Разбанить по Steam ID
ulx slayulx slay "Ник"Убить игрока
ulx godulx god "Ник"Включить бессмертие
ulx noclipulx noclip "Ник"Включить нoclip
ulx teleportulx teleport "Ник"Телепортировать к себе
ulx freezeulx freeze "Ник"Заморозить игрока
ulx jailulx jail "Ник" 60Посадить в тюрьму на 60 сек
ulx gimpulx gimp "Ник"Случайные сообщения вместо текста игрока
ulx muteulx mute "Ник"Заглушить голосовой чат
ulx gagulx gag "Ник"Заблокировать текстовый чат
ulx bringulx bring "Ник"Телепортировать игрока к вам
ulx sendulx send "Ник" "Ник2"Телепортировать к другому игроку
ulx armorulx armor "Ник" 100Выдать броню
ulx hpulx hp "Ник" 100Установить здоровье
ulx spectateulx spectate "Ник"Перейти в режим наблюдателя за игроком
ulx steamidulx steamid "Ник"Показать Steam ID игрока

Все команды также доступны через чат с префиксом ! вместо ulx - например, !kick "Ник" "Причина".

Частые ошибки

ULX загружается, но команды не работают Убедитесь, что ULib установлен и загружен. В консоли должна быть строка [ULib] Загружено. перед строкой ULX. Если ULib отсутствует - скачайте и установите его.

Ошибка “You do not have access to this command” Ваш аккаунт не распознан как суперадмин. Проверьте точность написания ника (регистр важен) или используйте Steam ID. В консоли сервера выполните ulx addsuperadmin "ВашНик".

После перезапуска сервера права сбросились Убедитесь, что файл ulib/cfg/users.txt доступен для записи и не перезаписывается при перезапуске. Если используете Docker или панель управления - проверьте маппинг томов.

Меню ULX не открывается (!menu не работает) ULX должен быть установлен на клиенте тоже (через Workshop или FastDL). Проверьте, что аддон загружается без ошибок в консоли при подключении.

Команда ulx ban не сохраняет бан Проверьте наличие и права на запись файла garrysmod/cfg/bans.cfg. Без этого файла баны не сохраняются между перезапусками.

Тратите время на настройку вместо игры? Pterohost упрощает администрирование - поддержка 24/7, бесплатная миграция сервера с другого хостинга, автоустановка аддонов и мощное железо AMD Ryzen 9 7950X3D с NVMe SSD. По промокоду 4START скидка 20% на первый заказ.

Часто задаваемые вопросы

Как установить ULX на сервер Garry’s Mod? Скачайте ULib и ULX с GitHub или Workshop, распакуйте оба аддона в папку garrysmod/addons/ и перезапустите сервер.

Как добавить администратора в Garry’s Mod? В консоли сервера выполните команду: ulx adduser "НикИгрока" admin. Для суперадмина используйте ulx addsuperadmin.

Как стать суперадмином на своём сервере Garry’s Mod? Зайдите в консоль сервера (не игровую) и выполните ulx addsuperadmin "ВашНик". Или отредактируйте файл ULib/cfg/users.txt.

Что такое ULib? ULib - библиотека-зависимость для ULX. Без неё ULX не работает. ULib предоставляет базовые функции управления игроками, группами и правами.

Как открыть меню администратора в Garry’s Mod? Введите в игровой чат !menu или !ulx. Также можно нажать F4 если включён DarkRP, или вызвать xgui через консоль командой ulx menu.

Читайте также