中文

游戏服务器

在 Garry's Mod 上安装和配置 DarkRP

在您的 Linux Garry's Mod 服务器上安装 DarkRP:游戏模式、darkrpmodification 插件、设置、自定义职业、更新、回滚和故障排除。

阅读约 8 分钟, 更新于 2026年11月18日

本页内容

本指南介绍如何用 DarkRP 把您的 Garry's Mod 服务器变成角色扮演服务器:安装游戏模式、在不修改其代码的前提下进行自定义、添加职业、更新以及回滚。

HostMyServers 不提供托管式游戏主机服务:您需要在自己的 VPS 或专用服务器上自行管理该服务器。

前提条件

  • 已按照创建 Garry's Mod 服务器指南安装好的服务器。本指南沿用该指南中的 gmod 用户、/home/gmod/gmod-server 目录、start.sh 脚本和 gmod.service 服务
  • /home/gmod/backup.sh 脚本,参见该指南中的自动备份一节
  • 具有 sudo 权限的 SSH 访问
  • 您电脑上的 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 Zhang Wei:您的角色名称随之改变
  3. 在 F4 菜单中选择一个职业:您的角色会换上该职业的外观

DarkRP 的内容发布在 Workshop 上,游戏模式通过其 ID 与之关联:玩家连接时,游戏会提示下载。

步骤 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 中停用。例如,在 DarkRP.disabledDefaults["jobs"] 列表中加入 ["gangster"] = true, 即可移除 Gangster 职业。

要修改某个原有职业,请先将其停用,然后把它的定义从 gamemodes/darkrp/gamemode/config/jobrelated.lua 复制到 jobs.lua。如果不相应调整 GAMEMODE.DefaultTeam,请不要停用 citizen,因为它是玩家刚进入服务器时被分配的职业。

游戏内常用命令

命令 作用 权限
/rpname <名称> 更改角色名称 所有人
/job <头衔> 更改显示的职业头衔 所有人
/setspawn <职业命令> 将该职业的出生点替换为您当前的位置 管理员
/addspawn <职业命令> 为该职业添加一个出生点 管理员
/setmoney <玩家> <金额> 设置玩家的金钱 取决于 DarkRP_SetMoney 权限

DarkRP 内置管理工具 FAdmin 和物件保护 FPP。如需通过详细的组来管理您的团队,请参阅安装 ULX 和 ULib。

切换到角色扮演地图

按照服务器安装指南中的说明,将地图添加到您的 Workshop 合集,然后在 start.sh 中更改启动地图:

终端
sudo -u gmod nano /home/gmod/gmod-server/start.sh
文本
    +map rp_map_name \

名称就是 .bsp 文件的名称,不含扩展名。然后重启服务。如果服务器无法在该地图上启动,请改回 gm_construct。

对于 Workshop 上没有的内容,请参阅使用 FastDL 和 Nginx 分发 Garry's Mod 内容。

数据库

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 模式

  • 检查 start.sh 中的 +gamemode darkrp 这一行
  • 检查文件 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 中创建它。

引用 darkrp_customthings/jobs.lua 的 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

如果您在修改了 darkrpmodification 的文件之后,在其中运行 git pull,就会出现此消息。该更新并非必需:请保持插件原样。如果消息涉及 gamemodes/darkrp,则说明游戏模式的某个文件被修改过:git -C ~/gmod-server/garrysmod/gamemodes/darkrp status 会告诉您是哪一个。

紫色纹理或 ERROR 模型

玩家没有收到内容。请检查其游戏内的内容下载选项是否未被禁用,然后检查您 Workshop 合集中的插件。

FAQ

可以从 Workshop 安装 DarkRP 吗?

可以,该项目以 ID 248302805 发布。请只使用一种方法:本指南使用 Git,它便于轻松回到某个特定版本。

DarkRP 提供中文吗?

游戏模式自带英文。可以在 darkrpmodification 的 lua/darkrp_language 中添加翻译。

在哪里可以找到更多示例?

请参阅 DarkRP 维基,尤其是 Custom job fields 页面。