RU

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

Установка и настройка DarkRP на Garry's Mod

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

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

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

Это руководство объясняет, как превратить ваш сервер 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. Вторая не должна ничего выводить.

Затем подключитесь к серверу из игры:

  1. Нажмите F4: откроется меню DarkRP со списком профессий
  2. В чате введите /rpname Иван Петров: имя вашего персонажа изменится
  3. Выберите профессию в меню 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

Например, чтобы показывать суммы в евро:

lua
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:

lua
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.service

Git-репозиторий аддона сохраняет историю ваших изменений. Чтобы просмотреть их или отменить изменения в файле:

Терминал
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.