1. Préparer le serveur
Installer oxmysql, ox_lib et un seul framework : Qbox (qbx_core) ou ESX (es_extended). Configurer la connexion SQL et activer OneSync sur le serveur.
Créer un dossier cdt_admin dans vos ressources, puis y extraire le ZIP. Le fichier fxmanifest.lua doit se trouver directement dans ce dossier :
resources/
└── cdt_admin/
├── fxmanifest.lua
├── client/
├── server/
├── shared/
├── config/
├── locales/
└── nui/
2. Ajouter les permissions et le démarrage dans server.cfg
Copier ces lignes dans server.cfg. Remplacer VOTRE_IDENTIFIANT_FIVEM par la partie numérique de votre identifiant fivem: réel.
# Le groupe owner hérite des autorisations du groupe admin.
add_principal group.owner group.admin
# Permissions CDT Admin : le groupe CDT owner possède tous les droits.
add_ace group.cdt_owner cdt_admin.owner allow
# Attribuer le groupe owner à votre compte FiveM.
add_principal identifier.fivem:VOTRE_IDENTIFIANT_FIVEM group.cdt_owner
# Dépendances : ne pas dupliquer les ensure déjà présents dans votre configuration.
ensure oxmysql
ensure ox_lib
# Framework : choisir UNE des deux lignes.
ensure qbx_core
# ensure es_extended
# Démarrer ici les ressources d'inventaire, ambulance et garages utilisées.
# ox_target est facultatif ; le démarrer ici si vous l'utilisez.
# Démarrer CDT Admin après ses dépendances et ses permissions.
ensure cdt_admin
Sous ESX, commenter ensure qbx_core et décommenter ensure es_extended.
La ligne add_principal group.owner group.admin donne au groupe group.owner les autorisations ACE de group.admin. Le compte doit appartenir à group.owner pour bénéficier de cet héritage. Si cette attribution n'existe pas déjà dans votre configuration, ajouter aussi :
add_principal identifier.fivem:VOTRE_IDENTIFIANT_FIVEM group.owner
Cet héritage complète les permissions CDT : conserver également l'attribution à group.cdt_owner et le droit cdt_admin.owner indiqués ci-dessus.
Si vous utilisez votre identifiant Rockstar license: plutôt que fivem:, remplacer la ligne d'attribution par :
add_principal identifier.license:VOTRE_LICENSE_ROCKSTAR group.cdt_owner
add_principal identifier.license:VOTRE_LICENSE_ROCKSTAR group.owner
Remplacer VOTRE_LICENSE_ROCKSTAR par la valeur située après license: dans vos identifiants serveur. Ces deux lignes remplacent les attributions identifier.fivem: aux groupes correspondants. Utiliser une seule des deux méthodes pour le même compte.
Pour plusieurs owners, ajouter une ligne add_principal par compte. Le nom group.cdt_owner est un groupe ACE dédié à CDT ; il n'est pas nécessaire de modifier les permissions de votre framework.
3. Configurer les intégrations
Adapter les fichiers de config/ aux ressources installées :
inventory.lua: inventaire et images.medical.lua: soins et réanimation.garages.lua: garages et véhicules possédés.notifications.lua: notifications.server.lua,client.lua,shared.lua: valeurs initiales générales.
Conserver debug = false dans config/server.lua pour une utilisation normale. Les ressources tierces ne sont pas incluses. Les guides *_CONFIGURATION.md détaillent les fournisseurs et les adaptations.
4. Premier démarrage et accès
Redémarrer le serveur après modification de server.cfg, puis charger votre personnage. Le droit ACE cdt_admin.owner attribue automatiquement le grade owner à ce personnage.
Les tables cdt_admin_* sont créées au démarrage : aucun import SQL manuel n'est requis. Le compte SQL doit pouvoir créer et mettre à jour les tables.
/admincdt_config: configuration et gestion des membres du staff, réservées au owner.- F9 : prendre ou quitter le service staff.
/admincdtou F10 : ouvrir le panneau d'administration./cdt_report: interface de signalement des joueurs.
Les raccourcis peuvent être modifiés dans les paramètres FiveM. Les réglages généraux enregistrés en SQL sont prioritaires sur les valeurs initiales des fichiers. Les changements de fournisseurs nécessitent un redémarrage de cdt_admin.
5. Attribuer les autres grades
Depuis /admincdt_config, utiliser la gestion Staff pour attribuer les grades aux personnages. Les groupes administratifs Qbox/ESX et les groupes ACE habituels n'accordent pas automatiquement de droits CDT. Seul le droit ACE spécial cdt_admin.owner attribue automatiquement le grade owner.
| Grade CDT | Niveau |
|---|---|
| owner | 100 |
| superadmin | 90 |
| admin | 70 |
| moderator | 50 |
| support | 30 |
| trial | 10 |
| none | 0 |
Autre méthode, dans la console serveur :
cdt_admin_setgrade 12 owner
cdt_admin_setgrade 24 admin
cdt_admin_setgrade 36 moderator
Remplacer les nombres par les IDs serveur des personnages connectés. Ces commandes sont réservées à la console ; les grades restent sauvegardés sur les personnages.
6. Retirer les droits d'un owner
Retirer sa ligne add_principal de server.cfg, puis redémarrer le serveur pour appliquer la nouvelle configuration ACE. Retirer le droit ACE ne supprime pas le grade déjà sauvegardé : attribuer ensuite none dans la console serveur :
cdt_admin_setgrade 12 none
Remplacer 12 par l'ID serveur du personnage connecté. Pour un personnage hors ligne, utiliser son identifiant de personnage exact à la place de l'ID serveur. Tant que le compte conserve le droit ACE cdt_admin.owner, le grade owner sera réattribué automatiquement.
7. Vérifier l'installation
Après installation, suivez PRISE_EN_MAIN.md pour découvrir le menu. Si un accès ou une intégration ne fonctionne pas, consultez DEPANNAGE.md.
Vérifier l'absence d'erreurs dans la console, l'accès du owner, le refus d'accès d'un joueur sans grade, la prise de service et les intégrations installées. Tester les deux langues si elles sont proposées aux utilisateurs.
La tornade est indiquée Bêta dans l'interface météo. Le tsunami n'est pas proposé dans les choix de cette interface. Tous les fichiers de cette distribution restent accessibles et modifiables grâce à escrow_ignore { '**/*' }.