circle-exclamation
Base en V1.0.1 Possible bug, merci de rejoindre le serveur Discord !
search
DiscordGithub

🗂️ Arborescence des fichiers

Cette page présente l’organisation des fichiers et dossiers de la base GuerreRP. Elle a deux objectifs :

  • Donner une vue d’ensemble de la structure du projet

  • Aider les admins / devs à savoir où chercher quoi (framework, scripts custom, mappings, véhicules, etc.)

L’arborescence exacte peut légèrement varier selon vos ajouts personnels, mais la logique globale reste la même.

hashtag
🔎 Vue d’ensemble de la structure

À la racine de votre serveur, vous trouverez généralement quelque chose de proche de :

  • Le dossier contenant les ressources FiveM (scripts, mappings, véhicules, etc.)

  • Les fichiers de configuration serveur (server.cfg, configs txAdmin, etc.)

  • Les dossiers liés à txAdmin / artifacts

  • Éventuellement des dossiers ou fichiers supplémentaires liés à vos outils (logs, backups, etc.)

Exemples typiques de dossiers/fichiers racine :

  • resources/ → Tous les scripts et assets utilisés par le serveur

  • server.cfg ou guerreRP.cfg → Fichier principal de configuration du serveur

  • txData/ ou équivalent → Données txAdmin / FiveM (config, profils, logs)

  • logs/ → Logs serveur (si vous en avez un dédié)

  • start.sh / run.sh / start.bat → Script de lancement du serveur (Linux / Windows Si vps perso)

L’objectif de GuerreRP est de garder cette arborescence lisible et logique, pour que vous puissiez facilement repérer les blocs importants.

hashtag
📁 Organisation principale du dossier resources

Le dossier resources est le cœur de votre serveur. C’est ici que vivent :

  • Le framework

  • Les scripts système

  • Les scripts custom GuerreRP

  • Les mappings

  • Les véhicules

  • Les éventuels scripts standalone

Dans la base GuerreRP, les ressources sont généralement organisées en catégories, par exemple :

  • [core] ou [system]

    • Framework principal (ESX / ESX Legacy)

    • ox_lib / oxmysql

    • Scripts système indispensables

  • [esx] / [extended]

    • Scripts liés au framework ESX (jobs, addons, gestion, etc.)

  • [ox]

    • Ressources spécifiques utilisant ox_lib / ox_inventory si présents

  • [ducratif] / [guerreRP] / [custom]

    • Scripts personnalisés propres à GuerreRP

    • Systèmes de guerre, territoires, events, lootbox, paintball, etc.

  • [mapping] / [maps]

    • Tous les mappings (YM/ YTD / YMAP / YBN / etc.)

    • Intérieurs, bases militaires, HQ, labs, zones spécifiques GuerreRP

  • [cars] / [vehicles]

    • Véhicules de la base (police, EMS, mécano, armée, staff, VIP…)

  • [standalone]

    • Scripts indépendants qui ne dépendent pas forcément d’ESX ou d’ox_lib

Selon votre version de la base, les noms exacts peuvent varier, mais l’idée est toujours de :

  • Regrouper les ressources par fonction

  • Éviter le “bazar” à la racine de resources

  • Permettre à un nouveau dev/admin de comprendre la logique en un coup d’œil

hashtag
🧭 Où trouver quoi ?

Voici quelques repères pour vous orienter dans l’arborescence :

  • Framework & cœur du serveur

    • Dossiers : [core], [system], es_extended, esx_…, ox_…

    • Contient la logique de base : joueurs, jobs, inventaires, DB, etc.

  • Scripts GuerreRP (systèmes de guerre, events, etc.)

    • Dossiers : [ducratif], [guerreRP], [custom] (selon nommage de votre version)

    • Tout ce qui est spécifique à l’univers GuerreRP se trouve ici

  • Mappings

    • Dossier : [mapping], [maps]

    • Chaque sous-dossier est généralement un mapping ou un pack de mappings

  • Véhicules

    • Dossier : [cars], [vehicles]

    • Souvent découpé par type de service (police, EMS, mécano, armée, civil, etc.)

  • Scripts standalone / outils

    • Dossier : [standalone] ou noms de scripts indépendants

    • Peut contenir des systèmes annexes non liés directement au cœur ESX

hashtag
📌 Comment lire l’arborescence

L’arborescence que vous allez voir plus bas est généralement générée avec la commande :

  • Sous Windows : tree /a

  • Sous Linux : tree -d

Quelques conseils de lecture :

  • Chaque niveau de profondeur représente un dossier à l’intérieur d’un autre

  • Les crochets [ ] autour d’un nom de dossier (ex : [core]) sont souvent utilisés pour distinguer une catégorie

  • Les dossiers à la racine de resources donnent une vision macro de la structure du serveur

  • Vous n’êtes pas obligé de connaître chaque ressource par cœur, mais cette vue vous aide à :

    • Repérer rapidement où modifier/ajouter un script

    • Voir si un script est bien rangé dans la bonne catégorie

    • Comprendre la séparation entre “core”, “custom” et “assets” (mappings, véhicules)

hashtag
🧾 Arborescence complète de votre installation

(Cette section sert d’exemple réel de structure, utile pour comparer votre installation, repérer un oubli, ou voir rapidement si un dossier manque par rapport à l’exemple.)

hashtag
✅ Bonnes pratiques liées à l’arborescence

Quelques recommandations pour garder une base propre et exploitable sur le long terme :

  • Ne pas renommer les dossiers critiques (framework, scripts cœur) sans savoir exactement ce que vous faites

  • Éviter de mettre vos ressources perso “en vrac” :

    • Créez vos propres catégories : [custom], [staff], [test], etc.

  • En cas de suppression d’une ressource :

    • Supprimer le dossier

    • Et retirer son ensure dans le fichier de configuration (server.cfg, resources.cfg, etc.)

  • Avant d’ajouter un gros pack (nouveaux mappings, nouveaux véhicules…) :

    • Faire une sauvegarde du serveur / de resources

    • Tester d’abord en local ou sur un serveur de pré-prod si possible

hashtag
🧩 Lien avec les autres pages de la documentation

Cette page “Arborescence des fichiers” fonctionne en duo avec :

  • Prérequis → pour vérifier que votre environnement est prêt

  • Comment obtenir la base GuerreRP → pour télécharger les bons fichiers

  • Installation de la base → pour savoir comment tout placer et configurer

  • Configuration & Personnalisation → pour adapter la base à votre projet

  • Systèmes GuerreRP → pour comprendre le rôle de certains dossiers spécifiques (guerres, events, etc.)

Précédent🧩 Structure du projetSuivant📂Dossiers importants

Mis à jour

Ce contenu vous a-t-il été utile ?