📂Dossiers importants

Cette page sert à te montrer où se trouvent les éléments vitaux de la base GuerreRP, et dans quels dossiers tu dois (ou ne dois pas) mettre les mains.

On va faire simple :

1. D’abord les fichiers/dossiers importants à la racine

2. Puis les gros blocs importants dans resources/

3. Ensuite les dossiers “à manipuler avec précaution” ou “optionnels”

---

1. RACINE DU SERVEUR GUERRERP

---

À la racine de ta base, tu as notamment :

• server.cfg → Fichier de configuration principal du serveur FiveM. → C’est là que tu déclares : nom du serveur, ports, key FiveM, ensure des ressources, etc. → À modifier avec soin : une virgule ou un ensure de travers, et le serveur ne démarre plus.

• ressources.cfg → Fichier où tu listes / organises tes ensure de ressources (par catégories). → Pratique pour garder une vue claire de ce qui se lance, dans quel ordre. → Tu y verras les sections qui correspondent à la structure de resources/ ( [0_fivem], [1_esential], [dev], etc.).

• guerrerp.sql → Fichier SQL principal de la base de données GuerreRP. → C’est ce fichier que tu importes dans ta DB (vu dans la page “Import SQL”). → À ne jamais modifier “à l’aveugle”. Si tu touches, fais toujours un backup.

• easy_admin.cfg → Configuration liée à EasyAdmin (si utilisé). → Tu peux y régler certains comportements de l’admin menu, permissions, etc.

• logo.png → Logo de la base / du serveur (utilisable pour le loadscreen, la com, etc.). → Détail visuel, pas critique, mais sympa pour le branding.

Ensuite, tu as le dossier clé :

• resources/ → Cœur de la base GuerreRP : framework, scripts, mappings, véhicules, systèmes custom. → C’est ce dossier que tu dois vraiment comprendre, d’où la suite de cette page.

---

1. STRUCTURE GLOBALE DU DOSSIER resources/

---

Dans ton arborescence guerrerp, le dossier resources contient notamment ces gros blocs :

• [0_fivem]

• [1_esential]

• [2_test]

• [dev]

• [gamemodes]

• [gameplay]

• [local]

• [managers]

• [start_manuel]

• [system]

• [test]

Tous ne sont pas aussi importants. Certains sont le cœur du serveur, d’autres sont des tests ou des scripts optionnels.

On va se concentrer sur ceux qui comptent vraiment au quotidien.

---

1. [0_fivem] – CORE FIVEM, FRAMEWORK & LOADSCREEN

---

Chemin : resources/[0_fivem]

Ce dossier regroupe les éléments de base indispensables pour que ta base tourne :

• oxmysql/ → Bridge entre FiveM et ta base MySQL/MariaDB. → Si ça casse ici, plus aucun script ne parle à la DB. → À garder à jour, mais à manipuler avec prudence.

• [extended]/es_extended/ → Cœur du framework ESX Legacy. → Tu y trouveras :

  • client/ : logique client (incl. imports, modules, etc.)

  • server/ : logique serveur (bridge inventaire, classes, modules…)

  • html/, locales/, shared/ : UI, langues, config partagée. → On évite de modifier le cœur d’ESX sauf si tu sais exactement ce que tu fais. La plupart de tes modifications devraient se faire dans les scripts addon, pas ici.

• [system]/origen_loadscreen/ → Ton écran de chargement (loadscreen). → Contient ui/css, ui/img, ui/js. → Tu peux personnaliser le visuel ici (logo, couleurs, fond…), c’est safe tant que tu touches à l’HTML/CSS/JS, pas au reste du core.

---

1. [1_esential] – LIBS, FRAMEWORKS ADDITIONNELS & COEUR GUERRERP

---

Chemin : resources/[1_esential]

C’est l’un des dossiers les plus importants de toute la base. Il contient à la fois :

• tes scripts custom GuerreRP,

• des librairies partagées,

• des ressources essentielles comme ox_inventory / ox_lib.

Les sous-dossiers clés :

---

4.1 [10_ducratif] – Scripts cœur GuerreRP

Chemin : resources/[1_esential]/[10_ducratif]

C’est ton noyau custom. Dedans, on retrouve :

• ducratif_territoire/ → Gestion des territoires, logique GuerreRP autour des zones/guerres.

• go_fast/ → Système de “Go-Fast” (livraisons risquées, missions illégales, etc.).

• job_transport_pl/ → Job de transport (camions / livraisons / remorques…), avec client/ et server/.

• menu_facturation/ → Menu de facturation pour la gestion RP des paiements entre joueurs / métiers.

• PowerEvent/ → Ton système de groupes PNJ / events hostiles (PowerEvent, GroupPNJ). → Contient client/, server/ et un dossier logs/ pour les logs événements.

• stimulant_guerrerp/ → Script lié à des consommables / buff / stimulants (côté gameplay GuerreRP).

• [mapping_ducratif]/ → Regroupe certains mappings custom liés à tes systèmes (HQ, zones spéciales, etc.).

👉 En résumé : Si tu cherches un “script maison” marqué Ducratif/GuerreRP qui impacte le gameplay, il est très probablement ici.

---

4.2 [2_libs] – Librairies communes

Chemin : resources/[1_esential]/[2_libs]

On y trouve notamment :

• async/

• cron/

• memorygame/ (mini-jeu mémoire)

• rprogress/ (barre de progression)

• sd_lib/ (lib propre avec plein de modules utilitaires)

Ce sont des ressources support utilisées par d’autres scripts :

• Elles gèrent des tâches communes (asynchrone, cron, progress bar, mini-jeux, utilitaires, etc.).

• Tu ne vas presque jamais “jouer” directement dedans côté gameplay.

• Tu dois surtout les laiss­er actives pour que les scripts qui en dépendent fonctionnent.

---

4.3 [ox] – ox_inventory & ox_lib

Chemin : resources/[1_esential]/[ox]

Deux ressources majeures :

• ox_inventory/ → Le système d’inventaire avancé. → Contient data/, locales/, modules/, interface/, etc. → Beaucoup de scripts peuvent s’intégrer à ox_inventory.

• ox_lib/ → Librairie utilitaire : UI, callbacks, notifications, menus, etc. → C’est une colonne vertébrale technique pour beaucoup de scripts modernes.

👉 Important : Si tu mets à jour ces ressources, fais-le proprement, et teste bien ensuite : une mauvaise version d’ox_inventory ou ox_lib peut casser beaucoup de choses d’un coup.

---

4.4 Autres ressources importantes dans [1_esential]

On y retrouve aussi des scripts comme :

• vSync/ → Gestion du temps & météo (synchronisation pour tous les joueurs).

• D’autres petits scripts utilitaires / gameplay de base, intégrés au cœur de la base.

Globalement : [1_esential] est un dossier à ne jamais supprimer ni renommer au hasard. Tu peux rajouter des choses, mais évite de tout chambouler dedans.

---

1. [dev] – SCRIPTS AVANCÉS & PROJETS CUSTOM

---

Chemin : resources/[dev]

C’est ton “bac à sable sérieux” : des scripts puissants, souvent très custom GuerreRP, parfois encore en évolution, mais qui peuvent faire partie de la prod.

Dedans, on a par exemple :

• caisse_shop/ → Boutique de caisses (lootbox) avec interface HTML (html/img).

• DucraChat/ → Système de messagerie / chat type app (avec html/).

• esx_multicharacter/ → Multi-personnages (sélection de personnage, interface HTML, etc.).

• gps_portable/ → Script de GPS portable (tracker, gestion des positions, etc.).

• GuerreAdmin/ → Outils staff/admin custom (menus, jail, staffgun, etc. d’après la structure).

• market/ → Système de marché / annonces (type LBC / market in-game).

• paintball_teams/

→ Paintball avec équipe, point personnel et groupe + Compétences, dashboard, ect.

• [mapping_paintball_teams]/ → Système de paintball par équipes + mapping dédié.

• zone_infecter/ et zone_infectee_fx/ → Zone infectée / zombies + effets associés (stream, web, composants React/JS, etc.).

• [newprison]/ → Nouveau mapping prison (int_prisonfull, prisonprops, etc.).

• Et d’autres petits scripts :

  • discord_id/

  • change_place_voiture/

  • interact-sound/

  • kurlie_clothing_item/

  • raduis_cercle/

  • velo_poche/ etc.

👉 Ce qu’il faut retenir :

• C’est un dossier crucial pour ton “flavour” GuerreRP avancé (paintball, zone infectée, market, etc.).

• Quand tu as un bug sur un de ces systèmes, c’est ici que tu viens fouiller en premier.

• Certains scripts peuvent ne pas être activés par défaut : regarde ton ressources.cfg / server.cfg pour voir ce qui est ensure ou non.

---

1. [start_manuel] – RESSOURCES MANUELLES / OPTIONNELLES

---

Chemin : resources/[start_manuel]

On y trouve par exemple :

• boii_minigames/ → Pack de mini-jeux (anagram, safe_crack, skill_bar, etc.) avec UI HTML.

• phone_rue/ → Script de téléphone / pager (Borne téléphonique dans les rues).

• pv-pager/ → Pager / alerte.

• rprogress/ (version isolée) → Autre implémentation de barre de progression avec UI.

Ce sont des scripts qui peuvent être :

• activés pour des events,

• utilisés comme complément à la base,

• ou simplement gardés de côté pendant le dev.

Ils ne sont généralement pas “core vitaux”, mais ils peuvent ajouter beaucoup au gameplay.

---

1. [system], [managers], [gamemodes], [gameplay]

---

Ces dossiers sont plutôt liés au cœur de FiveM qu’à GuerreRP en tant que tel :

• resources/[system]/

  • baseevents, hardcap, rconlog, sessionmanager, etc.

  • Gèrent la base du fonctionnement du serveur, sessions, événements globaux.

• resources/[managers]/

  • mapmanager/, spawnmanager/.

  • Quelle map charger, comment les joueurs spawnent, etc.

• resources/[gamemodes]/

  • basic-gamemode/, [maps]/fivem-map-hipster, etc.

  • Gamemodes par défaut de FiveM, rarement utilisés tels quels avec ESX.

• resources/[gameplay]/

  • chat/ (système de chat avec UI HTML + node_modules).

  • Si tu utilises un autre chat, tu peux adapter, mais attention à ce qui dépend de cette ressource.

👉 Conseil : Ne touche à ces dossiers que si tu sais ce que tu fais. Ce sont des briques fondamentales de FiveM. En général, tu les laisses tranquilles et tu travailles plutôt dans [1_esential] et [dev].

---

1. [2_test], [test], [local]

---

• resources/[2_test]/ → Contient surtout des ressources de test / framework, ex : screenshot-basic/, etc. → Peut servir pour des essais, des features temporaires, etc.

• resources/[test]/ → example-loadscreen, fivem/, etc. → Plutôt des exemples / ressources de démo.

• resources/[local]/ → Dossier actuellement vide ou réservé à des tests locaux.

👉 Tu peux t’en servir comme terrain d’expérimentation, mais ce n’est pas le cœur de ta base. Si tu supprimes quelque chose ici, tu risques beaucoup moins de casser tout le serveur (tant que ce n’est pas ensure dans ta config).

---

1. EN RÉSUMÉ : OÙ REGARDER EN PRIORITÉ ?

---

• Pour la config serveur : → server.cfg, ressources.cfg

• Pour la base de données : → guerrerp.sql (et la doc “Import SQL”)

• Pour le framework & le lien DB : → resources/[0_fivem]/oxmysql/ → resources/[0_fivem]/[extended]/es_extended/

• Pour les scripts core GuerreRP : → resources/[1_esential]/[10_ducratif]/

• Pour les libs importantes (progress bar, mini-jeux, utils) : → resources/[1_esential]/[2_libs]/ → resources/[1_esential]/[ox]/ (ox_inventory + ox_lib)

• Pour les gros systèmes custom avancés (phone, paintball, zone infectée, market, lootbox shop, etc.) : → resources/[dev]/

• Pour les scripts optionnels / events / minigames : → resources/[start_manuel]/

• Pour le cœur FiveM (à éviter de tripoter sans raison) : → resources/[system]/, [managers]/, [gamemodes]/, [gameplay]/

Avec ça, quelqu’un qui découvre la base GuerreRP peut vite comprendre :

• “Ici c’est le framework”

• “Là c’est les scripts maison Ducratif/GuerreRP”

• “Là c’est les gros systèmes avancés”

• “Là c’est juste FiveM de base, je touche pas”