Configurator Toolby Bagz Network

Guides DarkRP

L'essentiel pour installer et configurer DarkRP proprement.

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.

  1. Télécharge darkrpmodification depuis le dépôt GitHub officiel de DarkRP (FPtje/darkrpmodification).
  2. Décompresse-le dans garrysmod/addons/ et renomme le dossier en darkrpmodification (sans « -master »).
  3. Le gamemode DarkRP doit être dans garrysmod/gamemodes/darkrp et ton script de démarrage doit contenir +gamemode darkrp.
  4. 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.

FichierContenuGénérateur
jobs.luaCrée tes métiers : modèles, armes, salaire, vote, VIP, vie et armure au spawn.Métiers
shipments.luaCaisses d'armes et armes à l'unité pour l'armurier.Armes & caisses
entities.luaImprimantes, labos, micro-ondes… tout ce qui s'achète dans le F4.Entités
ammo.luaBoîtes de munitions en vente dans le F4.Munitions
vehicles.luaVéhicules Source achetables par métier.Véhicules
doorgroups.luaPortes du commissariat, de la mairie… pour certains métiers.Groupes de portes
categories.luaRange tes métiers et objets par catégories colorées.Catégories F4
food.luaAliments du cuisinier avec énergie et prix.Nourriture
demotegroups.luaUn démote dans la police bannit de tous les métiers police.Groupes de rétrogradation
agendas.luaLe tableau d'ordres affiché aux membres d'un groupe.Agendas
groupchats.luaLes 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 :

  1. Ouvre darkrp_config/disabled_defaults.lua et passe le métier à true dans la section jobs.
  2. 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.
  3. Si tu désactives le métier par défaut TEAM_CITIZEN, mets à jour GAMEMODE.DefaultTeam en bas de jobs.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 ID dans 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

MessageCause 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 corruptLe chemin du modèle est vide ou mal écrit, il doit finir par .mdl.
The command … already existsDeux métiers ou entités utilisent la même commande.
Erreur rouge / « ERROR » à la place d'un modèleLe 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 F4La 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.