在 Garry's Mod 上安装和配置 DarkRP
在您的 Linux Garry's Mod 服务器上安装 DarkRP:游戏模式、darkrpmodification 插件、设置、自定义职业、更新、回滚和故障排除。
本页内容
本指南介绍如何用 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,第二条命令不应显示任何内容。
然后在游戏中连接到服务器:
- 按 F4:DarkRP 菜单打开,并显示职业列表
- 在聊天中输入
/rpname Zhang Wei:您的角色名称随之改变 - 在 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 日志 |
例如,要以欧元显示金额:
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.service插件的 Git 仓库会记录您的更改。要查看这些更改,或撤销某个文件的更改:
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons/darkrpmodification
git diff
git checkout -- lua/darkrp_customthings/jobs.lua
exitgit 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.serviceDarkRP 的文件夹仍保留在原处,只是不再使用。
恢复数据
列出备份,然后恢复您选定的那一份。自该备份以来发生的所有更改(例如玩家的金钱)都会丢失。
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 页面。