Установка ULX и ULib на Garry's Mod
Установите ULX и ULib на ваш Linux-сервер Garry's Mod: первый суперадмин, группы, права, наказания, резервное копирование администраторов, обновления и устранение неполадок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как установить 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.