RU

Игровые серверы

Установка ULX и ULib на Garry's Mod

Установите ULX и ULib на ваш Linux-сервер Garry's Mod: первый суперадмин, группы, права, наказания, резервное копирование администраторов, обновления и устранение неполадок.

7 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как установить ULX, мод администрирования для Garry's Mod, вместе с его библиотекой ULib, а затем как назначать администраторов, создавать группы и выдавать им точные права.

HostMyServers не предлагает управляемый игровой хостинг: вы самостоятельно администрируете этот сервер на вашем VPS или выделенном сервере.

Предварительные требования

  • Сервер, установленный по руководству Создание сервера Garry's Mod. Это руководство продолжает его: пользователь gmod, папка /home/gmod/gmod-server и сервис gmod.service
  • Скрипт /home/gmod/backup.sh, описанный в разделе Автоматическое резервное копирование того же руководства
  • SSH-доступ с sudo
  • Настроенный RCON и TCP-порт 27015, разрешённый для вашего IP-адреса, либо учётная запись, уже объявленная superadmin в settings/users.txt
  • Ваш 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, см. также Установка и настройка DarkRP на Garry's Mod.

Резервное копирование администраторов

ULib копирует список пользователей в data/ulib_backups при каждом запуске. Вы также можете выполнить эти команды через RCON:

Текст
rcon ucl_backup_users force
rcon ucl_restore_users latest

Первая сразу создаёт копию. Вторая заменяет текущий список самой свежей копией: используйте её только в случае проблемы. Эти копии дополняют 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

После этого сервер возвращается к списку settings/users.txt Garry's Mod.

При возникновении проблем

Команда ulx неизвестна

  • Проверьте, что сервер был перезапущен после установки
  • Проверьте файлы из шага 2: неправильно названная или вложенная папка, например addons/ulx/ulx, мешает загрузке
  • Проверьте, что ULib установлен: ULX не работает без него
  • Найдите ошибки: sudo journalctl -u gmod.service -n 500 --no-pager | grep -iE 'ulib|ulx|\[error\]'

Bad RCON password

Введённый пароль не совпадает с rcon_password в server.cfg. Если подключиться не удаётся совсем, проверьте, что ваш 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 или в GM.Config.DefaultPlayerGroups, если вы используете DarkRP. Удалите его из этих списков, затем перезапустите сервер.

The users database failed to load.

ULib не может прочитать свою таблицу в sv.db. Следующее сообщение, Error while querying database was:, указывает причину. Проверьте место на диске командой df -h, затем восстановите sv.db из последнего архива при остановленном сервере.

Файл users.txt в ULib больше не меняется

Это нормально: последние версии ULib хранят пользователей в sv.db. Некоторая документация всё ещё ссылается на старый файл. Используйте команды ulx adduser и ulx adduserid.

FAQ

Можно ли установить ULX из Workshop?

Да, с идентификаторами 557962238 для ULib и 557962280 для ULX, которые нужно добавить в вашу коллекцию. В этом случае удалите папки addons/ulib и addons/ulx, чтобы не иметь двух копий.

Заменяет ли ULX FAdmin в DarkRP?

Это два независимых инструмента. FAdmin поставляется с DarkRP. Если вы предпочитаете использовать только ULX, FAdmin можно отключить строкой ["fadmin"] = true, в disabled_defaults.lua.

Где найти полный список команд?

Выполните ulx help в консоли или см. сайт проекта Ulysses.