Установка и настройка DarkRP на Garry's Mod
Установите DarkRP на ваш Linux-сервер Garry's Mod: игровой режим, аддон darkrpmodification, настройки, собственные профессии, обновления, откат и устранение неполадок.
На этой странице
Это руководство объясняет, как превратить ваш сервер Garry's Mod в ролевой сервер с DarkRP: установка игрового режима, настройка без изменения его кода, добавление профессии, обновления и откат.
HostMyServers не предлагает управляемый игровой хостинг: вы самостоятельно администрируете этот сервер на вашем VPS или выделенном сервере.
Предварительные требования
- Сервер, установленный по руководству Создание сервера Garry's Mod. Это руководство продолжает его: пользователь
gmod, папка/home/gmod/gmod-server, скриптstart.shи сервисgmod.service - Скрипт
/home/gmod/backup.sh, описанный в разделе Автоматическое резервное копирование того же руководства - SSH-доступ с
sudo - Garry's Mod на вашем компьютере, чтобы проверить результат в игре
Организация файлов
DarkRP отделяет свой код от ваших настроек. Все пути ниже начинаются с /home/gmod/gmod-server/garrysmod.
| Элемент | Расположение | Назначение |
|---|---|---|
| Игровой режим | gamemodes/darkrp |
Код DarkRP, его никогда не нужно изменять |
| Аддон для настройки | addons/darkrpmodification |
Ваши настройки, профессии и сущности |
| База данных | sv.db |
База SQLite сервера, в том числе данные игроков |
| Журналы DarkRP | data/darkrp_logs |
История действий на сервере |
Шаг 1: резервное копирование сервера
Остановите сервер, запустите резервное копирование и сохраните копию скрипта запуска:
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -u gmod cp -p /home/gmod/gmod-server/start.sh /home/gmod/start.sh.before-darkrpУбедитесь, что архив и копия существуют:
sudo -u gmod ls -lh /home/gmod/backups /home/gmod/start.sh.before-darkrpШаг 2: установка DarkRP и его аддона
Войдите как пользователь gmod, затем получите два официальных репозитория. Если вы уже клонировали DarkRP при установке сервера, повторно он не загружается.
sudo -iu gmod
cd ~/gmod-server/garrysmod
[ -d gamemodes/darkrp ] || git clone https://github.com/FPtje/DarkRP.git gamemodes/darkrp
git clone https://github.com/FPtje/darkrpmodification.git addons/darkrpmodificationПроверьте наличие нужных файлов:
ls gamemodes/darkrp/darkrp.txt addons/darkrpmodification/lua/darkrp_config/settings.luaОба пути должны отобразиться без ошибок. Оставляйте имена папок строчными буквами: Linux различает регистр.
Шаг 3: включение игрового режима
По-прежнему от имени пользователя gmod замените игровой режим в скрипте запуска и проверьте результат:
sed -i 's/+gamemode sandbox/+gamemode darkrp/' ~/gmod-server/start.sh
grep -n '+gamemode' ~/gmod-server/start.shВыведенная строка должна содержать +gamemode darkrp. Если там указан другой игровой режим, исправьте строку командой nano ~/gmod-server/start.sh.
Выйдите из сессии и запустите сервер:
exit
sudo systemctl start gmod.serviceДля первой проверки оставьте карту gm_construct. Ролевую карту можно будет установить после того, как игровой режим заработает.
Шаг 4: проверка работы
Проверьте сервис, затем поищите возможные ошибки в его журналах:
sudo systemctl is-active gmod.service
sudo journalctl -u gmod.service -n 300 --no-pager | grep -iE 'corrupt team|does not exist|lua error|\[error\]'Первая команда должна ответить active. Вторая не должна ничего выводить.
Затем подключитесь к серверу из игры:
- Нажмите F4: откроется меню DarkRP со списком профессий
- В чате введите
/rpname Иван Петров: имя вашего персонажа изменится - Выберите профессию в меню F4: ваш персонаж примет её внешний вид
Контент DarkRP опубликован в Workshop, и игровой режим связан с ним по идентификатору: игра предлагает его игрокам при подключении.
Шаг 5: изменение настроек
Откройте файл конфигурации:
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_config/settings.luaВот несколько распространённых настроек с их исходными значениями:
| Настройка | Исходное значение | Эффект |
|---|---|---|
GM.Config.startingmoney |
500 |
Деньги, получаемые при первом подключении |
GM.Config.normalsalary |
45 |
Начальная зарплата новых игроков |
GM.Config.paydelay |
160 |
Интервал между выплатами зарплаты, в секундах |
GM.Config.currency |
"$" |
Символ валюты |
GM.Config.currencyLeft |
true |
Символ слева (true) или справа (false) от суммы |
GM.Config.allowrpnames |
true |
Разрешает команду /rpname |
GM.Config.respawntime |
1 |
Минимальное ожидание перед возрождением, в секундах |
GM.Config.maxdoors |
20 |
Максимальное количество дверей на игрока |
GM.Config.logging |
true |
Включает журналы DarkRP |
Например, чтобы показывать суммы в евро:
GM.Config.currency = "€"
GM.Config.currencyLeft = falseИзменяйте существующие строки, а не дублируйте их, затем перезапустите сервер:
sudo systemctl restart gmod.serviceПроверьте изменение в игре: сумма на экране должна отображаться с новым символом. startingmoney применяется только к игрокам, которые подключаются впервые.
Шаг 6: добавление профессии
Откройте файл профессий:
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_customthings/jobs.luaДобавьте этот блок сразу после комментария в начале файла, перед строкой GAMEMODE.DefaultTeam:
TEAM_GUARD = DarkRP.createJob("Охранник", {
color = Color(45, 110, 170, 255),
model = {"models/player/police.mdl", "models/player/police_fem.mdl"},
description = [[Вы охраняете магазины города.]],
weapons = {"stunstick"},
command = "guard",
max = 3,
salary = 60,
admin = 0,
vote = false,
hasLicense = false,
category = "Citizens",
})| Поле | Описание |
|---|---|
color |
Цвет профессии в таблице очков и в меню |
model |
Модель персонажа или список моделей |
description |
Текст, отображаемый в меню F4 |
weapons |
Оружие, получаемое в дополнение к снаряжению по умолчанию |
command |
Команда чата для профессии, без /, уникальная на сервере |
max |
Максимальное количество игроков или доля игроков, если значение лежит между 0 и 1 |
salary |
Зарплата, выплачиваемая игроку |
admin |
0 для всех, 1 для админов, 2 для суперадминов |
vote |
Требует голосования для получения профессии |
hasLicense |
Выдаёт лицензию на ношение оружия |
category |
Категория меню F4, которая уже должна существовать. Citizens предоставляется DarkRP |
Перезапустите сервер, затем проверьте в игре, что Охранник появился в меню F4 и что команда /guard работает:
sudo systemctl restart gmod.serviceGit-репозиторий аддона сохраняет историю ваших изменений. Чтобы просмотреть их или отменить изменения в файле:
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons/darkrpmodification
git diff
git checkout -- lua/darkrp_customthings/jobs.lua
exitКоманда git checkout стирает ваши изменения в этом файле: запускайте её только для возврата к исходной версии.
Отключение или изменение исходной профессии
Поставляемые профессии отключаются в addons/darkrpmodification/lua/darkrp_config/disabled_defaults.lua. Например, ["gangster"] = true, в списке DarkRP.disabledDefaults["jobs"] убирает профессию Gangster.
Чтобы изменить исходную профессию, отключите её, затем скопируйте её определение из gamemodes/darkrp/gamemode/config/jobrelated.lua в jobs.lua. Не отключайте citizen, не изменив GAMEMODE.DefaultTeam: эта профессия назначается игрокам при входе.
Полезные команды в игре
| Команда | Эффект | Доступ |
|---|---|---|
/rpname <имя> |
Меняет имя персонажа | Все |
/job <название> |
Меняет отображаемое название профессии | Все |
/setspawn <команда профессии> |
Заменяет точку возрождения профессии вашей позицией | Администраторы |
/addspawn <команда профессии> |
Добавляет профессии точку возрождения | Администраторы |
/setmoney <игрок> <сумма> |
Устанавливает деньги игрока | В зависимости от права DarkRP_SetMoney |
DarkRP включает административный инструмент FAdmin и защиту объектов FPP. Чтобы управлять командой с помощью подробных групп, см. Установка ULX и ULib на Garry's Mod.
Переход на ролевую карту
Добавьте карту в вашу коллекцию Workshop, как описано в руководстве по установке сервера, затем измените стартовую карту в start.sh:
sudo -u gmod nano /home/gmod/gmod-server/start.sh +map rp_map_name \Имя совпадает с именем файла .bsp без расширения. Затем перезапустите сервис. Если сервер перестал запускаться с этой картой, верните gm_construct.
Для контента, которого нет в Workshop, см. Раздача контента Garry's Mod через FastDL и Nginx.
База данных
По умолчанию DarkRP использует базу SQLite sv.db, которая уже входит в backup.sh, и никакой настройки не требуется. Внешняя база MySQL настраивается в addons/darkrpmodification/lua/darkrp_config/mysql.lua и требует модуль MySQLOO. Перед любыми изменениями сделайте резервную копию данных.
Обновление DarkRP
Остановите сервер, сделайте резервную копию, запишите текущую версию, затем обновите:
sudo systemctl stop gmod.service
sudo -u gmod /home/gmod/backup.sh
sudo -iu gmod
git -C ~/gmod-server/garrysmod/gamemodes/darkrp rev-parse HEAD > ~/darkrp-before-update.txt
git -C ~/gmod-server/garrysmod/gamemodes/darkrp pull --ff-only
exit
sudo systemctl start gmod.serviceЗатем повторите проверки из шага 4. Обновлять darkrpmodification каждый раз не нужно: если в settings.lua какой-то настройки нет, DarkRP использует значение по умолчанию.
Откат
Возврат к предыдущей версии DarkRP
sudo systemctl stop gmod.service
sudo -iu gmod
git -C ~/gmod-server/garrysmod/gamemodes/darkrp reset --hard "$(cat ~/darkrp-before-update.txt)"
exit
sudo systemctl start gmod.serviceВозврат в режим Sandbox
sudo systemctl stop gmod.service
sudo -u gmod cp -p /home/gmod/start.sh.before-darkrp /home/gmod/gmod-server/start.sh
sudo systemctl start gmod.serviceПапки DarkRP остаются на месте и больше не используются.
Восстановление данных
Выведите список резервных копий, затем восстановите нужную. Всё, что изменилось после этой копии, например деньги игроков, будет потеряно.
sudo systemctl stop gmod.service
sudo -iu gmod
ls -1t ~/backups | head -n 5
tar -xzf ~/backups/gmod_YYYY-MM-DD_HH-MM-SS.tar.gz -C ~/gmod-server/garrysmod
exit
sudo systemctl start gmod.serviceПри возникновении проблем
Меню F4 не открывается, и сервер остаётся в режиме Sandbox
- Проверьте строку
+gamemode darkrpвstart.sh - Проверьте, что файл
gamemodes/darkrp/darkrp.txtсуществует, именно с таким именем строчными буквами - Посмотрите журналы:
sudo journalctl -u gmod.service -n 300 --no-pager
fatal: destination path ... already exists and is not an empty directory
Папка уже существует. Для darkrpmodification проверьте её содержимое: если там ваши настройки, не удаляйте её.
fatal: detected dubious ownership in repository
Команда Git была запущена от имени другого пользователя, не gmod. Войдите командой sudo -iu gmod и запустите её снова.
Corrupt team: Охранник!
Одно из полей профессии недопустимо. Следующее сообщение уточняет, какое именно, например The salary must be a number and it must be greater than zero.. Если вы видите This job does not have a unique command., выберите другое значение для command.
The category of "Охранник" ("...") does not exist!
Указанной категории не существует. Её название чувствительно к регистру. Используйте существующую категорию или создайте её в addons/darkrpmodification/lua/darkrp_customthings/categories.lua.
Ошибка Lua со ссылкой на darkrp_customthings/jobs.lua
Возле указанной строки пропущена фигурная скобка, запятая или кавычка. Исправьте файл или верните его исходную версию командой git checkout, затем перезапустите сервер.
Addon detected in the darkrp_modules folder.
Полный аддон был помещён в lua/darkrp_modules. Переместите его в garrysmod/addons/.
There is a player with an invalid team!
Эта ошибка обычно является следствием предыдущей. Найдите первую ошибку в журналах сервера, часто она в jobs.lua.
error: Your local changes to the following files would be overwritten by merge
Это сообщение появляется, если вы запускаете git pull в darkrpmodification после изменения его файлов. Такое обновление не нужно: оставьте аддон как есть. Если сообщение относится к gamemodes/darkrp, значит, был изменён файл игрового режима: git -C ~/gmod-server/garrysmod/gamemodes/darkrp status покажет, какой именно.
Фиолетовые текстуры или модели ERROR
Игрок не получил контент. Проверьте, что в игре у него не отключена загрузка контента, затем проверьте аддоны вашей коллекции Workshop.
FAQ
Можно ли установить DarkRP из Workshop?
Да, проект публикует его под идентификатором 248302805. Используйте только один способ: в этом руководстве применяется Git, который позволяет легко вернуться к конкретной версии.
Доступен ли DarkRP на русском языке?
Игровой режим поставляется на английском. Переводы можно добавить в lua/darkrp_language внутри darkrpmodification.
Где найти больше примеров?
См. вики DarkRP, в частности страницу Custom job fields.