Installer darkrpmodification
Ne modifie jamais les fichiers du gamemode DarkRP lui-même : ils sont écrasés à chaque mise à jour. Toute ta configuration va dans l'addon darkrpmodification.
- Télécharge darkrpmodification depuis le dépôt GitHub officiel de DarkRP (FPtje/darkrpmodification).
- Décompresse-le dans
garrysmod/addons/et renomme le dossier endarkrpmodification(sans « -master »). - Le gamemode DarkRP doit être dans
garrysmod/gamemodes/darkrpet ton script de démarrage doit contenir+gamemode darkrp. - Redémarre complètement le serveur après chaque modification (un changement de map ne suffit pas toujours).
Où va chaque fichier
Tous les fichiers ci-dessous sont dans addons/darkrpmodification/lua/darkrp_customthings/. Colle le code généré sous le commentaire d'en-tête de chaque fichier.
| Fichier | Contenu | Générateur |
|---|---|---|
jobs.lua | Crée tes métiers : modèles, armes, salaire, vote, VIP, vie et armure au spawn. | Métiers |
shipments.lua | Caisses d'armes et armes à l'unité pour l'armurier. | Armes & caisses |
entities.lua | Imprimantes, labos, micro-ondes… tout ce qui s'achète dans le F4. | Entités |
ammo.lua | Boîtes de munitions en vente dans le F4. | Munitions |
vehicles.lua | Véhicules Source achetables par métier. | Véhicules |
doorgroups.lua | Portes du commissariat, de la mairie… pour certains métiers. | Groupes de portes |
categories.lua | Range tes métiers et objets par catégories colorées. | Catégories F4 |
food.lua | Aliments du cuisinier avec énergie et prix. | Nourriture |
demotegroups.lua | Un démote dans la police bannit de tous les métiers police. | Groupes de rétrogradation |
agendas.lua | Le tableau d'ordres affiché aux membres d'un groupe. | Agendas |
groupchats.lua | Les canaux /g privés entre métiers ou pour le staff. | Chats de groupe |
Ordre de chargement : categories.lua est lu avant les autres, puis les métiers. Un objet qui référence TEAM_X doit donc venir après la création de ce métier, ce qui est automatique si tes métiers sont dans jobs.lua.
Modifier un métier par défaut
Citoyen, Policier, Gangster, Maire… sont créés par DarkRP. Pour en changer un :
- Ouvre
darkrp_config/disabled_defaults.luaet passe le métier àtruedans la sectionjobs. - Recrée-le avec le générateur de métiers en gardant le même identifiant (par exemple
TEAM_POLICE) pour que le reste du gamemode continue de fonctionner. - Si tu désactives le métier par défaut
TEAM_CITIZEN, mets à jourGAMEMODE.DefaultTeamen bas dejobs.lua.
Métiers VIP
Dans chaque générateur, la section Restriction d'accès crée un customCheck. Exemple pour un métier réservé aux groupes vip et superadmin :
customCheck = function(ply) return table.HasValue({"vip", "superadmin"}, ply:GetUserGroup()) end,
CustomCheckFailMsg = "Réservé aux VIP !",
Le nom du groupe doit être exactement celui de ton admin mod (ULX, SAM, ServerGuard…), en minuscules.
Workshop & FastDL
- Le serveur télécharge les addons de ta collection grâce à
+host_workshop_collection IDdans le script de démarrage. - Les joueurs ne téléchargent que ce que le serveur leur demande : c'est le rôle du fichier généré par l'outil Collection Workshop (
resource.AddWorkshop). - Les addons sans contenu (scripts uniquement) n'ont pas besoin d'être envoyés aux joueurs : décoche-les pour accélérer le chargement.
- Le FastDL (
sv_downloadurl) ne sert que pour du contenu hors Workshop.
Erreurs courantes
| Message | Cause probable |
|---|---|
attempt to index global 'TEAM_X' (a nil value) | Le métier n'existe pas (faute de frappe, ou il est désactivé dans disabled_defaults.lua). |
Corrupt job … element model is corrupt | Le chemin du modèle est vide ou mal écrit, il doit finir par .mdl. |
The command … already exists | Deux métiers ou entités utilisent la même commande. |
| Erreur rouge / « ERROR » à la place d'un modèle | Le contenu n'est pas envoyé aux joueurs : ajoute l'addon à ta collection et au fichier workshop.lua. |
| Le métier n'apparaît pas dans le F4 | La catégorie n'existe pas, ou un customCheck le cache au joueur. |
unexpected symbol near … | Une virgule ou une accolade manque, souvent après un copier-coller partiel. Recopie le bloc entier depuis le générateur. |