Installer et configurer DarkRP sur Garry's Mod
Installez DarkRP sur votre serveur Garry's Mod Linux : gamemode, addon darkrpmodification, réglages, métiers personnalisés, mises à jour, retour arrière et dépannage.
Sur cette page
Ce guide vous explique comment transformer votre serveur Garry's Mod en serveur de roleplay avec DarkRP : installation du gamemode, personnalisation sans toucher à son code, ajout d'un métier, mises à jour et retour arrière.
HostMyServers ne propose pas d'hébergement de jeux géré : vous administrez vous-même ce serveur sur votre VPS ou votre serveur dédié.
Prérequis
- Un serveur installé avec le guide Créer un serveur Garry's Mod. Ce guide repart de son utilisateur
gmod, du dossier/home/gmod/gmod-server, du scriptstart.shet du servicegmod.service - Le script
/home/gmod/backup.sh, décrit dans la section Sauvegarde automatique de ce même guide - Un accès SSH avec
sudo - Garry's Mod sur votre poste, pour vérifier le résultat en jeu
Organisation des fichiers
DarkRP sépare son code de vos réglages. Tous les chemins ci-dessous partent de /home/gmod/gmod-server/garrysmod.
| Élément | Emplacement | Rôle |
|---|---|---|
| Gamemode | gamemodes/darkrp |
Code de DarkRP, à ne jamais modifier |
| Addon de personnalisation | addons/darkrpmodification |
Vos réglages, métiers et entités |
| Base de données | sv.db |
Base SQLite du serveur, dont les données des joueurs |
| Journaux DarkRP | data/darkrp_logs |
Historique des actions sur le serveur |
Étape 1 : sauvegarder le serveur
Arrêtez le serveur, lancez la sauvegarde et gardez une copie du script de lancement :
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.avant-darkrpVérifiez que l'archive et la copie existent :
sudo -u gmod ls -lh /home/gmod/backups /home/gmod/start.sh.avant-darkrpÉtape 2 : installer DarkRP et son addon
Ouvrez une session avec l'utilisateur gmod, puis récupérez les deux dépôts officiels. Si vous avez déjà cloné DarkRP avec le guide d'installation, il n'est pas téléchargé une seconde fois.
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/darkrpmodificationContrôlez la présence des fichiers attendus :
ls gamemodes/darkrp/darkrp.txt addons/darkrpmodification/lua/darkrp_config/settings.luaLes deux chemins doivent s'afficher sans erreur. Gardez ces noms de dossiers en minuscules : Linux distingue les majuscules.
Étape 3 : activer le gamemode
Toujours avec l'utilisateur gmod, remplacez le gamemode dans le script de lancement et contrôlez le résultat :
sed -i 's/+gamemode sandbox/+gamemode darkrp/' ~/gmod-server/start.sh
grep -n '+gamemode' ~/gmod-server/start.shLa ligne affichée doit contenir +gamemode darkrp. Si un autre gamemode y figure, corrigez-la avec nano ~/gmod-server/start.sh.
Quittez la session et démarrez le serveur :
exit
sudo systemctl start gmod.serviceGardez la carte gm_construct pour ce premier essai. Vous pourrez installer une carte de roleplay une fois le gamemode validé.
Étape 4 : vérifier le fonctionnement
Contrôlez le service, puis cherchez d'éventuelles erreurs dans ses journaux :
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\]'La première commande doit répondre active. La seconde ne doit rien afficher.
Connectez-vous ensuite au serveur depuis le jeu :
- Appuyez sur F4 : le menu DarkRP s'ouvre avec la liste des métiers
- Dans le chat, saisissez
/rpname Jean Martin: votre nom de personnage change - Choisissez un métier dans le menu F4 : votre personnage en prend l'apparence
Le contenu de DarkRP est publié sur le Workshop, et le gamemode y est lié par son identifiant : le jeu le propose aux joueurs à la connexion.
Étape 5 : modifier les réglages
Ouvrez le fichier de configuration :
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_config/settings.luaVoici quelques réglages courants, avec leur valeur d'origine :
| Réglage | Valeur d'origine | Effet |
|---|---|---|
GM.Config.startingmoney |
500 |
Argent reçu à la première connexion |
GM.Config.normalsalary |
45 |
Salaire de départ des nouveaux joueurs |
GM.Config.paydelay |
160 |
Délai entre deux salaires, en secondes |
GM.Config.currency |
"$" |
Symbole monétaire |
GM.Config.currencyLeft |
true |
Symbole à gauche (true) ou à droite (false) du montant |
GM.Config.allowrpnames |
true |
Autorise la commande /rpname |
GM.Config.respawntime |
1 |
Attente minimale avant de réapparaître, en secondes |
GM.Config.maxdoors |
20 |
Nombre maximal de portes par joueur |
GM.Config.logging |
true |
Active les journaux DarkRP |
Par exemple, pour afficher les montants en euros :
GM.Config.currency = "€"
GM.Config.currencyLeft = falseModifiez les lignes existantes au lieu de les dupliquer, puis redémarrez le serveur :
sudo systemctl restart gmod.serviceVérifiez le changement en jeu : le montant affiché à l'écran doit utiliser le nouveau symbole. startingmoney ne s'applique qu'aux joueurs qui se connectent pour la première fois.
Étape 6 : ajouter un métier
Ouvrez le fichier des métiers :
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_customthings/jobs.luaAjoutez ce bloc juste après le commentaire d'en-tête, avant la ligne GAMEMODE.DefaultTeam :
TEAM_VIGILE = DarkRP.createJob("Vigile", {
color = Color(45, 110, 170, 255),
model = {"models/player/police.mdl", "models/player/police_fem.mdl"},
description = [[Vous protégez les commerces de la ville.]],
weapons = {"stunstick"},
command = "vigile",
max = 3,
salary = 60,
admin = 0,
vote = false,
hasLicense = false,
category = "Citizens",
})| Champ | Description |
|---|---|
color |
Couleur du métier dans le tableau des scores et les menus |
model |
Modèle du personnage, ou liste de modèles |
description |
Texte affiché dans le menu F4 |
weapons |
Armes reçues en plus de l'équipement par défaut |
command |
Commande de chat du métier, sans /, unique sur le serveur |
max |
Nombre maximal de joueurs, ou part des joueurs si la valeur est comprise entre 0 et 1 |
salary |
Salaire versé au joueur |
admin |
0 pour tous, 1 pour les admins, 2 pour les superadmins |
vote |
Exige un vote pour obtenir le métier |
hasLicense |
Donne un permis de port d'arme |
category |
Catégorie du menu F4, qui doit déjà exister. Citizens est fournie par DarkRP |
Redémarrez le serveur, puis vérifiez en jeu que Vigile apparaît dans le menu F4 et que la commande /vigile fonctionne :
sudo systemctl restart gmod.serviceLe dépôt Git de l'addon garde la trace de vos changements. Pour les relire, ou pour annuler ceux d'un fichier :
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons/darkrpmodification
git diff
git checkout -- lua/darkrp_customthings/jobs.lua
exitLa commande git checkout efface vos modifications de ce fichier : ne la lancez que pour revenir à sa version d'origine.
Désactiver ou modifier un métier d'origine
Les métiers fournis se désactivent dans addons/darkrpmodification/lua/darkrp_config/disabled_defaults.lua. Par exemple, ["gangster"] = true, dans la liste DarkRP.disabledDefaults["jobs"] retire le métier Gangster.
Pour modifier un métier d'origine, désactivez-le, puis copiez sa définition depuis gamemodes/darkrp/gamemode/config/jobrelated.lua vers jobs.lua. Ne désactivez pas citizen sans adapter GAMEMODE.DefaultTeam, car c'est le métier attribué aux joueurs à leur arrivée.
Commandes utiles en jeu
| Commande | Effet | Accès |
|---|---|---|
/rpname <nom> |
Change le nom du personnage | Tous |
/job <intitulé> |
Change l'intitulé du métier affiché | Tous |
/setspawn <commande du métier> |
Remplace le point d'apparition du métier par votre position | Administrateurs |
/addspawn <commande du métier> |
Ajoute un point d'apparition au métier | Administrateurs |
/setmoney <joueur> <montant> |
Fixe l'argent d'un joueur | Selon le droit DarkRP_SetMoney |
DarkRP inclut l'outil d'administration FAdmin et la protection d'objets FPP. Pour gérer vos équipes avec des groupes détaillés, consultez Installer ULX et ULib.
Passer à une carte de roleplay
Ajoutez la carte à votre collection Workshop, comme indiqué dans le guide d'installation du serveur, puis changez la carte de démarrage dans start.sh :
sudo -u gmod nano /home/gmod/gmod-server/start.sh +map rp_nom_de_la_carte \Le nom est celui du fichier .bsp, sans l'extension. Redémarrez ensuite le service. Si le serveur ne se lance plus sur cette carte, remettez gm_construct.
Pour des contenus absents du Workshop, consultez Servir les contenus avec FastDL et Nginx.
Base de données
DarkRP utilise par défaut la base SQLite sv.db, déjà couverte par backup.sh, et aucune configuration n'est nécessaire. Une base MySQL externe se configure dans addons/darkrpmodification/lua/darkrp_config/mysql.lua et requiert le module MySQLOO. Sauvegardez vos données avant tout changement.
Mettre à jour DarkRP
Arrêtez le serveur, sauvegardez, notez la version actuelle, puis mettez à jour :
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-avant-maj.txt
git -C ~/gmod-server/garrysmod/gamemodes/darkrp pull --ff-only
exit
sudo systemctl start gmod.serviceRefaites ensuite les vérifications de l'étape 4. Il n'est pas nécessaire de mettre à jour darkrpmodification à chaque fois : si un réglage manque dans settings.lua, DarkRP utilise sa valeur par défaut.
Revenir en arrière
Revenir à la version précédente de DarkRP
sudo systemctl stop gmod.service
sudo -iu gmod
git -C ~/gmod-server/garrysmod/gamemodes/darkrp reset --hard "$(cat ~/darkrp-avant-maj.txt)"
exit
sudo systemctl start gmod.serviceRevenir au mode Sandbox
sudo systemctl stop gmod.service
sudo -u gmod cp -p /home/gmod/start.sh.avant-darkrp /home/gmod/gmod-server/start.sh
sudo systemctl start gmod.serviceLes dossiers de DarkRP restent en place et ne sont plus utilisés.
Restaurer les données
Listez les sauvegardes, puis restaurez celle de votre choix. Tout ce qui a changé depuis cette sauvegarde, comme l'argent des joueurs, est perdu.
sudo systemctl stop gmod.service
sudo -iu gmod
ls -1t ~/backups | head -n 5
tar -xzf ~/backups/gmod_AAAA-MM-JJ_HH-MM-SS.tar.gz -C ~/gmod-server/garrysmod
exit
sudo systemctl start gmod.serviceEn cas de problème
Le menu F4 ne s'ouvre pas et le serveur reste en Sandbox
- Vérifiez la ligne
+gamemode darkrpdansstart.sh - Vérifiez que le fichier
gamemodes/darkrp/darkrp.txtexiste, avec ce nom exact en minuscules - Consultez les journaux :
sudo journalctl -u gmod.service -n 300 --no-pager
fatal: destination path ... already exists and is not an empty directory
Le dossier existe déjà. Pour darkrpmodification, contrôlez son contenu : s'il contient vos réglages, ne le supprimez pas.
fatal: detected dubious ownership in repository
La commande Git a été lancée avec un autre utilisateur que gmod. Ouvrez une session avec sudo -iu gmod et relancez-la.
Corrupt team: Vigile!
Un champ du métier est invalide. Le message qui suit précise lequel, par exemple The salary must be a number and it must be greater than zero.. Si vous lisez This job does not have a unique command., choisissez une autre valeur pour command.
The category of "Vigile" ("...") does not exist!
La catégorie indiquée n'existe pas. Son nom respecte la casse. Utilisez une catégorie existante ou créez-la dans addons/darkrpmodification/lua/darkrp_customthings/categories.lua.
Erreur Lua citant darkrp_customthings/jobs.lua
Une accolade, une virgule ou un guillemet manque près de la ligne indiquée. Corrigez le fichier, ou revenez à sa version d'origine avec git checkout, puis redémarrez le serveur.
Addon detected in the darkrp_modules folder.
Un addon complet a été placé dans lua/darkrp_modules. Déplacez-le dans garrysmod/addons/.
There is a player with an invalid team!
Cette erreur découle généralement d'une erreur précédente. Cherchez la première erreur dans les journaux du serveur, souvent dans jobs.lua.
error: Your local changes to the following files would be overwritten by merge
Ce message apparaît si vous lancez git pull dans darkrpmodification après avoir modifié ses fichiers. Cette mise à jour n'est pas nécessaire : laissez l'addon tel quel. Si le message concerne gamemodes/darkrp, un fichier du gamemode a été modifié : git -C ~/gmod-server/garrysmod/gamemodes/darkrp status vous indique lequel.
Textures violettes ou modèles ERROR
Le joueur n'a pas reçu le contenu. Vérifiez que son option de téléchargement des contenus dans le jeu n'est pas désactivée, puis contrôlez les addons de votre collection Workshop.
FAQ
Peut-on installer DarkRP depuis le Workshop ?
Oui, le projet le publie sous l'identifiant 248302805. N'utilisez qu'une seule méthode : ce guide emploie Git, qui permet de revenir facilement à une version précise.
DarkRP est-il disponible en français ?
Le gamemode fournit l'anglais. Des traductions peuvent être ajoutées dans lua/darkrp_language au sein de darkrpmodification.
Où trouver plus d'exemples ?
Consultez le wiki de DarkRP, notamment la page Custom job fields.