FR

Serveurs de jeux

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.

9 min de lecture, mis à jour le 18 novembre 2026

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 script start.sh et du service gmod.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 :

Terminal
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-darkrp

Vérifiez que l'archive et la copie existent :

Terminal
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.

Terminal
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

Contrôlez la présence des fichiers attendus :

Terminal
ls gamemodes/darkrp/darkrp.txt addons/darkrpmodification/lua/darkrp_config/settings.lua

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

Terminal
sed -i 's/+gamemode sandbox/+gamemode darkrp/' ~/gmod-server/start.sh
grep -n '+gamemode' ~/gmod-server/start.sh

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

Terminal
exit
sudo systemctl start gmod.service

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

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

  1. Appuyez sur F4 : le menu DarkRP s'ouvre avec la liste des métiers
  2. Dans le chat, saisissez /rpname Jean Martin : votre nom de personnage change
  3. 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 :

Terminal
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_config/settings.lua

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

lua
GM.Config.currency                      = "€"
GM.Config.currencyLeft                  = false

Modifiez les lignes existantes au lieu de les dupliquer, puis redémarrez le serveur :

Terminal
sudo systemctl restart gmod.service

Vé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 :

Terminal
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/addons/darkrpmodification/lua/darkrp_customthings/jobs.lua

Ajoutez ce bloc juste après le commentaire d'en-tête, avant la ligne GAMEMODE.DefaultTeam :

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

Terminal
sudo systemctl restart gmod.service

Le dépôt Git de l'addon garde la trace de vos changements. Pour les relire, ou pour annuler ceux d'un fichier :

Terminal
sudo -iu gmod
cd ~/gmod-server/garrysmod/addons/darkrpmodification
git diff
git checkout -- lua/darkrp_customthings/jobs.lua
exit

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

Terminal
sudo -u gmod nano /home/gmod/gmod-server/start.sh
Texte
    +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 :

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

Refaites 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

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

Revenir au mode Sandbox

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

Les 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.

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

En cas de problème

Le menu F4 ne s'ouvre pas et le serveur reste en Sandbox

  • Vérifiez la ligne +gamemode darkrp dans start.sh
  • Vérifiez que le fichier gamemodes/darkrp/darkrp.txt existe, 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.