Comment installer et configurer un serveur GMod DarkRP ?
Dans ce guide, vous apprendrez à faire passer un serveur Garry's Mod fonctionnel au mode de jeu DarkRP et à configurer DarkRP de la manière recommandée par son développeur, c'est-à-dire sans toucher aux fichiers du cœur. Vous verrez pas à pas comment installer DarkRP avec Git ou le Steam Workshop (Atelier), modifier l'argent de départ, les salaires, les métiers et les lois avec l'addon darkrpmodification, vous attribuer les droits d'administrateur et corriger les erreurs les plus fréquentes.
Avant de commencer
DarkRP est un mode de jeu de roleplay dans lequel les joueurs choisissent un métier, comme policier, médecin, vendeur d'armes ou simple citoyen, et gagnent de l'argent. Il est open source (licence MIT) et développé dans son dépôt officiel sur GitHub ; la version indiquée dans le fichier darkrp.txt du dépôt est la 2.7.0. Avant de commencer, préparez les éléments suivants :
- Un serveur GMod fonctionnel : il vous faut un serveur installé avec SteamCMD, avec un GSLT (jeton de connexion du serveur) défini et le port 27015 TCP/UDP ouvert. Toutes ces étapes sont expliquées dans le guide d'installation d'un serveur Garry's Mod. Ce guide utilise les mêmes dossiers :
C:\GModServersous Windows,/home/steam/gmodsous Linux. - Contenu de Counter-Strike : Source (CSS) : d'après la FAQ de DarkRP, les armes et l'argent qui flottent dans les airs viennent du fait que le contenu CSS n'est pas installé ou n'est pas monté via
mount.cfg. La map utilisée dans ce guide nécessite aussi CSS. Le montage est décrit à l'étape 7 du guide d'installation. - Des ressources suffisantes : les serveurs DarkRP demandent davantage de processeur et de mémoire à mesure que l'on ajoute des addons et des maps. Les offres se trouvent sur la page Location de serveur Garry's Mod ; suivez l'utilisation grâce aux graphiques d'utilisation en direct de l'Espace client.
- Git (outil de gestion de versions) : le fichier README (lisez-moi) de DarkRP demande d'utiliser Git ou le Workshop pour l'installation ; il indique que le téléchargement manuel (ZIP) est possible, mais déconseillé.
- Sauvegarde : les VDS n'incluent pas de sauvegarde automatique. Avant de commencer, copiez hors du serveur les dossiers
garrysmod/cfgetgarrysmod/addonsainsi que le fichiergarrysmod/sv.db.
Comparaison des méthodes d'installation :
| Méthode | Emplacement de DarkRP | Mise à jour | Remarque |
|---|---|---|---|
| Git | garrysmod/gamemodes/darkrp | Avec git pull, quand vous le décidez | Vous choisissez le moment de la mise à jour |
| Steam Workshop | Téléchargé au démarrage via la collection | Automatique à chaque démarrage | La page Workshop présente cette version comme expérimentale, mais officielle |
| ZIP | garrysmod/gamemodes/darkrp | En supprimant l'ancien dossier et en mettant le nouveau | Déconseillé par le README ; à utiliser si vous ne pouvez pas installer Git |
1. Téléchargez le mode de jeu DarkRP
N'utilisez qu'une seule des trois méthodes. Avec Git et le ZIP, DarkRP va dans le dossier garrysmod/gamemodes, à côté des dossiers sandbox et base. La note d'installation du dépôt DarkRP est claire : si vous placez DarkRP dans le dossier addons, il ne fonctionne pas.
Linux (Git) : installez Git avec votre compte disposant des droits sudo, puis passez à l'utilisateur steam et clonez le dépôt :
sudo apt-get install git
sudo -iu steam
cd /home/steam/gmod/garrysmod/gamemodes
git clone https://github.com/FPtje/DarkRP.git darkrp
Windows (Git) : installez Git for Windows depuis le site git-scm.com, puis exécutez ceci dans l'invite de commandes :
cd C:\GModServer\garrysmod\gamemodes
git clone https://github.com/FPtje/DarkRP.git darkrp
Le darkrp à la fin de la commande détermine le nom du dossier. Ce nom est important : la valeur +gamemode darkrp de la commande de lancement cherche ce dossier, et la FAQ de DarkRP exige que le dossier s'appelle darkrp en minuscules. Une installation correcte contient le fichier gamemodes/darkrp/darkrp.txt.
ZIP : l'archive téléchargée via Code → Download ZIP sur la page GitHub contient un dossier DarkRP-master. Renommez ce dossier en darkrp et déplacez-le dans gamemodes.
Steam Workshop : la version Workshop officielle de DarkRP est publiée sous l'identifiant 248302805. Avec cette méthode, vous ne mettez rien dans le dossier gamemodes ; il suffit d'ajouter DarkRP à la collection que vous créerez à l'étape 3.
2. Installez l'addon darkrpmodification
Les réglages, les métiers et les fichiers de langue de DarkRP ne se modifient pas dans le mode de jeu lui-même, mais dans un addon séparé. Le README de DarkRP et le wiki de DarkRP demandent de ne pas toucher aux fichiers du cœur, y compris le dossier config situé dans gamemodes/darkrp. Selon le wiki, les fichiers du cœur modifiés ne peuvent plus être mis à jour et les développeurs n'assurent pas d'aide pour les problèmes causés par ces modifications. Installez plutôt l'addon officiel darkrpmodification dans le dossier addons.
Linux (avec l'utilisateur steam) :
cd /home/steam/gmod/garrysmod/addons
git clone https://github.com/FPtje/darkrpmodification.git darkrpmodification
Windows :
cd C:\GModServer\garrysmod\addons
git clone https://github.com/FPtje/darkrpmodification.git darkrpmodification
Si vous téléchargez le ZIP, vérifiez l'arborescence : le chemin du fichier de réglages principal doit être addons/darkrpmodification/lua/darkrp_config/settings.lua. Le dossier extrait de l'archive ne doit pas se retrouver imbriqué sur deux niveaux. Donnez au dossier un nom en minuscules et sans espace ; sous Linux, les chemins de fichiers sont sensibles à la casse. Principaux fichiers de l'addon :
| Dossier / fichier | Utilité |
|---|---|
lua/darkrp_config/settings.lua | Réglages principaux de DarkRP : argent, salaire, permis, chat, portes |
lua/darkrp_config/disabled_defaults.lua | Désactivation des modules, métiers et objets par défaut |
lua/darkrp_config/mysql.lua | Connexion à une base de données MySQL externe |
lua/darkrp_config/licenseweapons.lua | Armes qui ne nécessitent pas de permis lorsque le réglage du permis est activé (toute arme absente de la liste exige un permis) |
lua/darkrp_customthings/ | Métiers (jobs.lua), cargaisons (shipments), objets achetables (entities), véhicules, groupes de portes |
lua/darkrp_language/ | Fichiers de traduction |
lua/darkrp_modules/ | Vos propres modules DarkRP |
3. Préparez la map et la collection Workshop
La map rp_downtown_v4c_v2 utilisée dans les exemples de ce guide se trouve sur le Workshop sous l'identifiant 110286060 ; la page de la map indique que de nombreuses textures apparaîtront manquantes sans Counter-Strike : Source. La liste des maps du wiki DarkRP propose d'autres options comme rp_downtown_v4c_v4 (452404339) et rp_eastcoast (354565921).
- Sur Steam, créez une collection dans le Workshop de Garry's Mod et ajoutez-y la map. Si vous avez choisi la méthode Workshop, ajoutez aussi DarkRP (
248302805). - Réglez la visibilité de la collection sur publique ou non répertoriée (unlisted) ; selon Facepunch, le serveur ne peut pas accéder aux collections privées.
- Récupérez l'identifiant de la collection à partir de la valeur
?id=de l'adresse de la page ; vous l'indiquerez au paramètre+host_workshop_collectionà l'étape 4.
Si la map lancée par le serveur figure dans la collection (correspondance par le nom du .bsp), elle est téléchargée automatiquement par les joueurs. L'identifiant Workshop étant défini dans le fichier darkrp.txt de DarkRP, le mode de jeu est lui aussi téléchargé par les joueurs à la connexion, quelle que soit la méthode d'installation. Pour les autres addons de modèles et de textures, il faut des lignes resource.AddWorkshop ; les détails se trouvent dans le guide addons Workshop pour GMod.
4. Démarrez le serveur avec DarkRP
Dans le fichier de lancement créé dans le guide d'installation, remplacez +gamemode sandbox par +gamemode darkrp et +map gm_construct par la map RP, puis ajoutez la collection.
Windows (C:\GModServer\start.bat) :
@echo off
srcds.exe -console -game garrysmod -port 27015 -tickrate 66 +maxplayers 32 +gamemode darkrp +map rp_downtown_v4c_v2 +host_workshop_collection COLLECTION_ID +sv_setsteamaccount YOUR_GSLT_TOKEN
Linux (/home/steam/gmod/start.sh) :
#!/bin/bash
cd /home/steam/gmod
./srcds_run -game garrysmod -port 27015 -tickrate 66 +maxplayers 32 +gamemode darkrp +map rp_downtown_v4c_v2 +host_workshop_collection COLLECTION_ID +sv_setsteamaccount YOUR_GSLT_TOKEN
La ligne Making workshop gamemode available for client download dans la console indique que le mode de jeu sera téléchargé par les joueurs. Une fois que vous êtes connecté au serveur, la touche F4 doit ouvrir le menu des métiers et des achats, et la touche F1 le menu d'aide qui liste les commandes de chat. Les commandes de chat commencent par / ; par exemple, /rpname permet de changer votre nom de roleplay.
5. Attribuez-vous les droits d'administrateur
DarkRP est livré avec un module d'administration intégré appelé FAdmin, activé par défaut. FAdmin considère que la console du serveur dispose de tous les droits ; vous pouvez donc vous nommer super-administrateur (superadmin) depuis celle-ci. Pendant que vous êtes connecté au jeu, tapez ceci dans la console du serveur (la fenêtre srcds sous Windows, screen -r gmod sous Linux) :
fadmin setroot julien
FAdmin trouve le joueur à partir d'une partie de son nom, découpe la valeur saisie au niveau des espaces et ne tient compte que des segments composés de lettres de l'alphabet anglais, de chiffres et des caractères : _ .. Saisissez donc une partie de votre nom qui vous est propre, sans espace et sans accents ni caractères spéciaux (é, è, à, ç) ; si possible, exécutez la commande lorsque vous êtes seul sur le serveur. Les droits attribués sont enregistrés dans la base de données. Vous pouvez aussi ajouter votre SteamID avec la valeur "superadmin" à la liste GM.Config.DefaultPlayerGroups de settings.lua. Pour gérer les droits avec ULX, consultez le guide installer ULX et ULib sur GMod.
Deux des commandes console du wiki DarkRP vous seront utiles : darkrp setmoney julien 5000 fixe le portefeuille d'un joueur au montant indiqué (droits d'administrateur requis) ; rp_resetallmoney remet à zéro le portefeuille de tout le monde (super-administrateur uniquement). Avant d'exécuter la seconde, faites une sauvegarde de sv.db.
6. Effectuez les réglages de base (settings.lua)
Le fichier addons/darkrpmodification/lua/darkrp_config/settings.lua liste tous les réglages de DarkRP, chacun précédé d'une courte explication en anglais. Les réglages ont la forme GM.Config.nom_du_reglage = valeur : les réglages d'activation/désactivation prennent true ou false, les réglages numériques un nombre. Si un réglage manque dans le fichier, DarkRP utilise la valeur par défaut. Exemple de point de départ pour une communauté francophone (repérez les lignes dans le fichier et modifiez leur valeur ; n'ajoutez pas une seconde fois le même réglage) :
GM.Config.startingmoney = 1000
GM.Config.normalsalary = 60
GM.Config.paydelay = 300
GM.Config.currency = "€"
GM.Config.currencyLeft = false
GM.Config.license = false
GM.Config.alltalk = false
GM.Config.DefaultLaws = {
"N'attaquez pas les autres citoyens, sauf en cas de légitime défense.",
"N'entrez pas chez les autres et ne volez pas.",
"Les imprimantes à billets et la drogue sont illégales.",
}
Dans cet exemple, les nouveaux joueurs commencent avec 1000 unités, touchent un salaire toutes les 300 secondes, et la devise s'affiche à droite du montant sous la forme « € ». DefaultLaws correspond aux lois par défaut, qui ne peuvent pas être modifiées depuis le jeu. Pour que les caractères accentués (é, è, à, ç) s'affichent correctement, enregistrez le fichier en encodage UTF-8, puis redémarrez le serveur pour charger les modifications.
7. Modifiez les modules et les métiers
Le fichier disabled_defaults.lua liste les modules, métiers et objets fournis avec DarkRP : true désactive l'élément, false le laisse actif. Par exemple, le système de faim (hungermod) et le module AFK (loin du clavier) sont désactivés par défaut. Pour activer la faim et supprimer le métier « Hobo » (sans-abri), modifiez ainsi les lignes concernées :
DarkRP.disabledDefaults["modules"] = {
...
["hungermod"] = false,
...
}
DarkRP.disabledDefaults["jobs"] = {
...
["hobo"] = true,
...
}
Lorsque le module de faim est activé, le métier de cuisinier (Cook), qui ne fonctionne qu'avec ce module, entre aussi en jeu ; la vitesse de la faim est définie par GM.Config.hungerspeed dans settings.lua (2 par défaut).
Les nouveaux métiers s'ajoutent dans le fichier darkrp_customthings/jobs.lua, sous la ligne « Add your custom jobs under the following line ». Un exemple simple :
TEAM_TAXI = DarkRP.createJob("Chauffeur de taxi", {
color = Color(230, 180, 20, 255),
model = {"models/player/Group01/male_03.mdl"},
description = [[Transporte des passagers en ville et négocie le prix de la course.]],
weapons = {},
command = "taxi",
max = 3,
salary = GAMEMODE.Config.normalsalary,
admin = 0,
vote = false,
hasLicense = false,
category = "Citizens",
})
command est la commande que le joueur tape dans le chat pour prendre ce métier (ici /taxi). max fixe le nombre de personnes pouvant exercer ce métier en même temps ; les valeurs comprises entre 0 et 1 sont lues comme une proportion du nombre de joueurs (0.3 = 30 %). Si vous voulez modifier un métier par défaut (par ex. Medic), suivez la note de jobs.lua : désactivez d'abord le métier dans disabled_defaults.lua, puis copiez sa définition depuis le fichier gamemode/config/jobrelated.lua du cœur vers jobs.lua et modifiez-la là. Pour l'équilibre des salaires, les champs de métier personnalisés et l'économie, passez au guide métiers personnalisés et économie DarkRP.
8. Traduisez DarkRP en français
Le cœur de DarkRP ne contient que le fichier de langue anglais ; les traductions se font dans le dossier darkrp_language de l'addon. D'après les instructions du fichier d'exemple english.lua :
- Copiez le fichier
lua/darkrp_language/english.luadans le même dossier sous le nomfrancais.lua. - Traduisez les textes entre guillemets sans toucher aux clés situées à gauche du signe égal. Ne supprimez pas les espaces réservés comme
%set%d; DarkRP les remplace par des noms et des montants. - Dans l'expression
DarkRP.addLanguage("en", my_language)de la dernière ligne du fichier, remplacez"en"par le code de langue français de Garry's Mod. Pour connaître ce code, choisissez le français dans le menu en bas à droite du jeu, puis tapezgmod_languagedans la console. - Indiquez le même code à la variable
gmod_languagedans le fichierserver.cfgdu serveur.
Lorsque DarkRP est mis à jour, de nouvelles expressions peuvent apparaître ; celles qui ne sont pas traduites s'affichent en anglais. Pour voir celles qui manquent, tapez darkrp_getphrases "code_langue" dans la console du jeu, ajoutez les lignes obtenues à votre fichier et traduisez-les. Le fichier chatcommands.lua du même dossier contient les descriptions des commandes de chat ; vous pouvez le traduire de la même manière.
9. Sauvegardez les données et mettez DarkRP à jour
Par défaut, DarkRP conserve ses données dans la base SQLite intégrée de Garry's Mod, dans le fichier garrysmod/sv.db ; les portefeuilles des joueurs et les droits FAdmin s'y trouvent. Si vous voulez utiliser une base de données MySQL externe, vous devez passer le réglage RP_MySQLConfig.EnableMySQL de mysql.lua à true et installer le module MySQLOO. N'oubliez pas que le mot de passe de ce fichier peut être lu par toute personne ayant accès aux fichiers du serveur.
Avant une mise à jour et à intervalles réguliers, arrêtez le serveur et copiez hors du serveur le fichier garrysmod/sv.db ainsi que les dossiers garrysmod/cfg et garrysmod/addons/darkrpmodification. L'espace de sauvegarde cloud, accessible en SFTP, est une destination adaptée pour ces copies. La méthode de mise à jour dépend de votre méthode d'installation :
- Git : arrêtez le serveur, allez dans le dossier
gamemodes/darkrpet exécutezgit pull, puis démarrez le serveur. - ZIP : d'après la note d'installation de DarkRP, supprimez l'ancien dossier
darkrpavant de mettre le nouveau. - Workshop : le serveur met la collection à jour à chaque démarrage. Si vous ne le souhaitez pas, ajoutez
+host_workshop_autoupdate 0à la commande de lancement ; selon Facepunch, les joueurs risquent alors de ne pas pouvoir rejoindre le serveur à cause de l'ancienne version d'une map mise à jour.
N'exécutez pas git pull dans le dossier darkrpmodification : cela peut entrer en conflit avec les fichiers que vous avez modifiés. D'après la note en tête de settings.lua, il n'est pas nécessaire de tenir ce fichier à jour : lorsqu'un nouveau réglage est ajouté, DarkRP utilise sa valeur par défaut, et vous pouvez ajouter la ligne vous-même si vous le souhaitez.
Exemple de configuration : réglages souvent modifiés
| Réglage | Fichier | Par défaut | Effet |
|---|---|---|---|
GM.Config.startingmoney | settings.lua | 500 | Argent présent dans le portefeuille du joueur à sa première connexion au serveur |
GM.Config.normalsalary | settings.lua | 45 | Salaire de départ des nouveaux joueurs |
GM.Config.paydelay | settings.lua | 160 | Intervalle entre deux versements de salaire (secondes) |
GM.Config.license | settings.lua | false | Si true, un permis est nécessaire pour ramasser des armes au sol |
GM.Config.alltalk | settings.lua | false | true : chat global, false : chat de proximité |
GM.Config.babygod | settings.lua | true | Le joueur qui apparaît (spawn) ne subit aucun dégât pendant babygodtime (5 s) |
GM.Config.maxdoors | settings.lua | 20 | Nombre maximal de portes qu'un joueur peut posséder |
GM.Config.currency | settings.lua | "$" | Symbole de la devise |
["hungermod"] | disabled_defaults.lua | true (désactivé) | Système de faim |
RP_MySQLConfig.EnableMySQL | mysql.lua | false | Avec false, la base SQLite intégrée (sv.db) est utilisée |
gmod_language | server.cfg | — | Code de langue utilisé par DarkRP |
Erreurs fréquentes
- Le serveur démarre en Sandbox, ou erreur
couldn't include file darkrp\gamemode\cl_init.lua (File not found): d'après la FAQ de DarkRP, la commande de lancement doit contenir+gamemode darkrpet le dossier doit s'appelerdarkrpen minuscules. Vérifiez que vous n'avez pas laissé le nom de dossierDarkRP-masteret que vous avez placé le dossier dansgamemodeset non dansaddons. - Les armes et l'argent flottent dans les airs, la map affiche des textures violettes et noires : le contenu CSS n'est pas installé ou le chemin dans
mount.cfgest erroné ; sous Linux, faites attention à la casse du chemin. Pour que le contenu s'affiche aussi correctement à l'écran des joueurs, il doit également être présent côté joueur. - Impossible de ramasser une arme au sol : si
GM.Config.licensevauttrue, le joueur sans permis ne peut pas ramasser d'arme. Passez le réglage àfalse, ou obtenez le permis auprès du chef de la police ou du maire. - Les modifications de
settings.luasont sans effet : le fichier modifié est peut-être le fichier du cœur situé dansgamemodes/darkrp, et non celui de l'addon, ou l'addon se trouve dans le mauvais dossier. Vérifiez le chemin complet du fichier, redémarrez le serveur et cherchez une erreur Lua dans la console ; une virgule manquante ou un guillemet non fermé empêche le chargement de tout le fichier. - Impossible de trouver l'origine des erreurs Lua : d'après la note de dépannage de DarkRP, tapez
lua_log_sv 1dans la console du serveur et reproduisez l'erreur ; les erreurs sont écrites dans le fichiergarrysmod/lua_errors_server.txt. Les journaux d'événements propres à DarkRP sont écrits dans le dossiergarrysmod/data/darkrp_logs/lorsqueGM.Config.loggingest activé (truepar défaut). Pour les saccades et le lag, consultez le guide performances d'un serveur GMod et erreurs Lua. - Le maire ne peut pas édicter de lois, lancer un confinement ou une loterie : le champ
mayor = true,manque dans le métier de maire que vous avez écrit. D'après la FAQ, à partir de DarkRP 2.5.0, ce champ ne s'ajoute à la main que dans les métiers de maire personnalisés.
Questions fréquentes
Faut-il utiliser Git ou le Workshop ?
Les deux sont des méthodes recommandées par le développeur de DarkRP. Avec Git, c'est vous qui lancez la mise à jour, ce qui vous permet de faire une sauvegarde au préalable. Le Workshop facilite l'installation, mais le serveur se met à jour à chaque démarrage et la page Workshop présente cette version comme expérimentale. Si vous voulez maîtriser le moment des mises à jour, choisissez Git.
Puis-je configurer DarkRP sans connaître le Lua ?
En grande partie, oui. Le README de darkrpmodification indique que l'addon est aussi conçu pour ceux qui ne connaissent pas le Lua ; settings.lua et disabled_defaults.lua demandent seulement de modifier des valeurs. Pour les définitions de métiers, vous pouvez commencer en copiant les exemples des fichiers.
Où l'argent des joueurs est-il stocké et comment le remettre à zéro ?
Dans une installation par défaut, il est stocké dans la base de données garrysmod/sv.db. Vous modifiez l'argent d'un joueur avec darkrp setmoney et celui de tout le monde avec rp_resetallmoney (étape 5) ; faites au préalable une sauvegarde de sv.db.
Puis-je utiliser une autre map RP ?
Oui. Ajoutez la map à votre collection Workshop et remplacez la valeur +map par le nom du .bsp de la map. Vérifiez sur la page Workshop de la map si elle nécessite un contenu supplémentaire comme CSS. Pour le chargement des maps et les autres sujets, consultez la page Guides Garry's Mod.
Guides associés
- Comment installer un serveur Garry's Mod ? Guide SteamCMD et srcds
- Ajouter des métiers personnalisés et un système d'économie sur GMod DarkRP
- Installer ULX et ULib sur GMod : comment donner les droits d'admin
- Comment ajouter des addons Workshop (Atelier) à un serveur GMod ?
- Performances d'un serveur GMod : corriger les erreurs Lua et le lag
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.