Installer DarkRP de zéro sur un serveur GMod

Introduction

DarkRP transforme ton serveur GMod en ville roleplay avec un système d'économie, des métiers (police, mafia, médecin), de la propriété immobilière, et un cycle jour/nuit. C'est gratuit, open source, mais sa courbe d'apprentissage est costaude. Ce guide te lance proprement.

Prérequis

• Un serveur Garry's Mod chez VeryCloud
• ULX déjà installé (voir tuto dédié)
• Accès Files et Startup du panel Wisp

Étape 1 : Télécharger DarkRP

DarkRP est distribué via GitHub :

• DarkRP : https://github.com/FPtje/DarkRP/archive/master.zip
• DarkRPModification : https://github.com/FPtje/DarkRPModification/archive/master.zip

💡 Ne jamais modifier DarkRP directement ! Toute customisation passe par DarkRPModification pour rester upgradable.

Étape 2 : Uploader sur le serveur

Dans Wisp → Files → /garrysmod/gamemodes/ :

1. Upload le contenu de DarkRP-master/ → renommer en darkrp/ (le dossier doit s'appeler darkrp)
2. Va dans /garrysmod/addons/
3. Upload le contenu de DarkRPModification-master/ → renommer en darkrpmodification/

Structure attendue :

/garrysmod/
├── gamemodes/
│   └── darkrp/
│       ├── gamemode/
│       └── entities/
└── addons/
    └── darkrpmodification/
        └── lua/darkrp_customthings/

Étape 3 : Configurer le gamemode au boot

Dans Wisp → Startup, modifie :

GAMEMODE = darkrp
MAP      = rp_downtown_v4c_v2   # map RP standard

Pour la map, soit elle est dans ta collection workshop (cf tuto Workshop Collection), soit tu uploades le .bsp manuellement dans /garrysmod/maps/.

Étape 4 : Premier démarrage

Restart le serveur. Au boot tu dois voir :

[DarkRP] Loaded gamemode darkrp v2.x.x
[DarkRP] Loaded 24 jobs
[DarkRP] Loaded 47 entities

Si erreur de chargement de jobs, c'est presque toujours un fichier jobs.lua mal édité — voir étape 5.

Étape 5 : Configurer les métiers (jobs)

Les jobs custom se déclarent dans /garrysmod/addons/darkrpmodification/lua/darkrp_customthings/jobs.lua.

Exemple ajout d'un métier :

TEAM_BAKER = DarkRP.createJob("Boulanger", {
    color = Color(255, 200, 100, 255),
    model = {"models/player/Group01/Female_01.mdl", "models/player/Group01/male_01.mdl"},
    description = [[Vendez du pain frais aux citoyens]],
    weapons = {},
    command = "baker",
    max = 2,
    salary = 80,
    admin = 0,
    vote = false,
    hasLicense = false,
    candemote = true,
    category = "Citoyens",
})

Lance un lua_run ou redémarre pour appliquer. Les jobs apparaissent dans le menu F4 in-game.

Étape 6 : Configurer la map

Différentes maps RP populaires :

• rp_downtown_v4c_v2 : la map historique, gratuite, workshop
• rp_evocity_v33x : EvoCity, très utilisée
• rp_unioncity : moderne, immense
• rp_rockford_v2b : urbaine GTA-like

Ajoute-les à ta collection workshop et change MAP dans Startup.

Étape 7 : Settings DarkRP

Édite /garrysmod/gamemodes/darkrp/gamemode/config/settings.lua pour les paramètres globaux :

GM.Config.AdminProducts = false   -- Admins peuvent vendre
GM.Config.maxprops = 30           -- Max props par joueur
GM.Config.startingmoney = 500     -- Argent de départ
GM.Config.paydelay = 360          -- Délai entre salaires (sec)
GM.Config.killtime = 10           -- Délai respawn

⚠️ Idéalement, tes customs vont dans darkrpmodification pour ne pas casser à la prochaine maj DarkRP. Mais settings.lua reste souvent édité directement faute de mieux.

Étape 8 : Économie + BDD MySQL (optionnel mais recommandé)

Par défaut DarkRP stocke l'économie en SQLite local. Pour un serveur sérieux, passe à MySQL :

1. Crée une BDD MySQL (ex via Plesk Obsidian VeryCloud ou via le panel)
2. Installe mysqloo (voir tuto dédié)
3. Édite /garrysmod/addons/darkrpmodification/lua/darkrp_config/mysql.lua :

MySQLite.config.EnableMySQL = true
MySQLite.config.Host        = "ta.mysql.host"
MySQLite.config.Port        = 3306
MySQLite.config.Username    = "darkrp_user"
MySQLite.config.Password    = "mdp"
MySQLite.config.Database    = "darkrp"

Restart.

Étape 9 : Permissions admin DarkRP

Les commandes DarkRP admin sont gatées par ULX :

ulx groupallow superadmin DarkRP.*
ulx groupallow admin DarkRP.kick
ulx groupallow admin DarkRP.warrant

Liste complète : ulx help filtré sur "DarkRP".

Étape 10 : Test

Connecte-toi en jeu, ouvre F4 (menu DarkRP). Tu dois voir :

• La liste des jobs
• Le shop (armes, props, drogues)
• Ton wallet
• Les commandes RP (/advert, /me, /y)

Dépannage

Le gamemode ne charge pas

• Dossier mal nommé : doit être garrysmod/gamemodes/darkrp/ exactement
• Vérifie la console pour les erreurs Lua

Erreur "attempt to call nil value" au boot

• Conflit entre DarkRP et un addon mal codé
• Test en désactivant les addons un par un (/addons/ → renomme en addons.bak/)

Les jobs ne se chargent pas

• Erreur de syntaxe Lua dans jobs.lua
• Vérifie la console : la ligne exacte est généralement indiquée

Wallet à 0 et ne se met pas à jour

• BDD pas connectée (si MySQL) — check les logs
• En SQLite, vérifie que data/sv.db est writable

Commandes utiles

/buyammo <type>           # Acheter munitions
/setjob <job>             # Changer de job (admin)
/say                      # Chat
/advert <msg>             # Publicite
/me <action>              # Action RP
/y <msg>                  # Crier
darkrp_giveMoney <somme>  # Donner de l'argent (admin)

Conclusion

DarkRP installé en quelques heures avec ULX et une collection workshop = base solide pour un serveur RP. La vraie complexité commence avec la personnalisation : jobs custom, addons CityRP / TTT-like, économie équilibrée. Mais la base technique chez VeryCloud sur Wisp prend une demi-journée max.

Pour aller plus loin : addons RP populaires (LibK Inventory, prop protection), customisation profonde via darkrpmodification, balance économique pour serveur public.

Ressources

• DarkRP — GitHub officiel
• DarkRP Wiki
• DarkRPModification
• DarkRP Forum (Facepunch)