Ce guide aide à identifier les problèmes courants après installation. Commencez par INSTALLATION.md pour vérifier les dépendances, les permissions et l’ordre de démarrage. Pour découvrir le menu, consultez PRISE_EN_MAIN.md.
Le script ne démarre pas
Vérifiez les points suivants dans cet ordre :
- Le dossier de ressource s’appelle
cdt_adminet contient directementfxmanifest.lua. Le ZIP doit être extrait dans ce dossier, sans créer un second dossiercdt_adminà l’intérieur. oxmysqletox_libsont démarrés avant CDT.- Un seul framework est démarré :
qbx_coreoues_extended. - La connexion SQL fonctionne et le compte peut créer et mettre à jour les tables.
- Consultez la première erreur dans la console serveur, ainsi que les lignes qui la précèdent.
| Message ou situation | Vérification |
|---|---|
| « Deux frameworks actifs » | Arrêter l’un des deux cores ; CDT ne choisit pas entre Qbox et ESX actifs simultanément. |
| « Démarrez qbx_core ou es_extended » | Démarrer le framework choisi avant cdt_admin. |
ox_lib must be started before this resource | Vérifier l’installation et l’ordre de démarrage de ox_lib. |
| Erreur SQL ou table absente | Vérifier la connexion, les droits SQL et les erreurs de création de tables au démarrage. |
| Export ou ressource indisponible | Vérifier le nom exact, le démarrage et la version du fournisseur utilisé. |
Les tables CDT sont créées au démarrage. Ne supprimez pas les tables ou les métadonnées des personnages pour résoudre un problème d’accès.
Le menu ne s’ouvre pas ou l’accès est refusé
Chargez votre personnage, puis vérifiez son grade CDT. Être administrateur Qbox/ESX ou appartenir à group.admin ne donne pas automatiquement accès à CDT.
Pour le premier owner, appliquez les lignes ACE de INSTALLATION.md, remplacez les identifiants d’exemple et redémarrez le serveur. Le droit nécessaire est cdt_admin.owner. La ligne add_principal group.owner group.admin fournit l’héritage des droits admin ; les lignes d’attribution du compte et du droit CDT restent nécessaires.
Vous pouvez aussi attribuer le grade depuis la console serveur, avec votre personnage connecté :
cdt_admin_setgrade 12 owner
Remplacez 12 par votre ID serveur actuel. Appuyez ensuite sur F9 pour prendre le service, puis essayez /admincdt. /admincdt_config est réservé au owner et ne demande pas de prise de service.
Une catégorie ou un bouton manque
Le script masque les fonctions non autorisées. Demandez au owner de vérifier votre grade et les seuils d’accès dans la configuration. Les permissions d’une catégorie et celles des actions qu’elle contient peuvent être différentes.
Certains outils dépendent aussi d’une ressource externe correctement configurée. N’activez pas le debug pour contourner un refus de permission : ce mode lève des protections entre staffs.
« Service staff requis »
Appuyez sur F9, puis vérifiez l’état de service affiché dans le panneau. Si vous avez changé de personnage, reconnecté ou subi une baisse de grade, reprenez le service avec un personnage autorisé.
Si F9 ne répond pas, essayez les paramètres de raccourcis FiveM : une affectation locale ou une autre ressource peut utiliser la même touche.
Une action sur un joueur est refusée
Vérifiez votre service, le droit de l’action, le grade de la cible et les paramètres demandés. En mode normal, certaines actions sur soi-même et celles visant un staff de grade égal ou supérieur sont interdites.
Si le joueur s’est déconnecté, actualisez sa fiche. Les modifications d’argent et de métier ESX nécessitent un personnage connecté. Pour une sanction, vérifiez le motif et les limites de durée configurées.
L’inventaire, les soins ou les garages ne fonctionnent pas
- Démarrez la ressource tierce avant
cdt_admin. - Vérifiez son nom exact et le fournisseur choisi dans
config/inventory.lua,config/medical.luaouconfig/garages.lua. - Si plusieurs fournisseurs sont actifs, choisissez explicitement celui utilisé au lieu de
auto. - Vérifiez les anciennes convars
cdt_admin:inventory,cdt_admin:medical,cdt_admin:garagesetcdt_admin:vehicles: elles sont prioritaires sur le choix du fichier. - Redémarrez CDT après modification des fichiers. Les choix partagés avec les clients doivent rester cohérents ; les convars d’inventaire et de médical doivent être répliquées avec
setrlorsqu’elles sont utilisées.
Les API peuvent varier selon la version du produit installé. Un export manquant demande une adaptation à cette version. Les fichiers *_CONFIGURATION.md expliquent les réglages simples ; les fichiers *_BRIDGE.md détaillent les adaptations avancées.
Les images d’objets manquent
Vérifiez le chemin d’images configuré pour votre inventaire et la présence des fichiers dans sa ressource. cdt_admin:inventoryImages, si défini, remplace le réglage du fichier. Le nom de ressource et le chemin doivent correspondre à votre installation.
Un don ou un retrait est refusé
Vérifiez la quantité, le poids disponible, l’emplacement et les métadonnées de l’objet. Le fournisseur doit confirmer la modification. Pour les inventaires ne disposant pas d’un contrôle fiable des transferts, l’inspection utilise le panneau CDT plutôt que l’interface native du fournisseur.
Un véhicule ne peut pas être rangé ou transféré
Vérifiez le propriétaire, la destination et les occupants. L’intégration doit confirmer la sauvegarde, le changement d’état et la suppression du véhicule sorti lorsque nécessaire.
Les écritures du garage ESX officiel et des stockages SQL facultatifs sont désactivées par défaut. Consultez GARAGE_CONFIGURATION.md et GARAGE_BRIDGE.md avant de les activer ; les autres garages peuvent nécessiter leurs propres adaptations.
La météo CDT ne s’applique pas
Arrêtez les autres ressources qui contrôlent météo et heure et retirez leur démarrage automatique de server.cfg. CDT suspend son moteur lorsqu’il détecte un système connu concurrent. Un script personnalisé peut aussi créer un conflit s’il utilise les mêmes fonctions du jeu.
Vérifiez ensuite que le moteur CDT est activé et que vous avez cliqué sur Appliquer à la dernière étape. Naviguer dans le formulaire ne sauvegarde rien. Un événement contrôlant déjà la météo peut bloquer une modification ou le lancement d’une tornade.
Pour un réglage local, vérifiez le secteur choisi et ses limites. La météo peut être régionale, mais l’horloge et le blackout restent globaux. Voir WEATHER_BRIDGE.md.
La tornade ou le tsunami n’apparaît pas
La tornade est une fonctionnalité Bêta. Son lancement exige le moteur météo CDT actif, le service et la permission Monde. Les effets sont limités au monde principal : vérifiez que les joueurs sont dans l’instance 0.
Pendant la préalerte, seul le repère de carte est présent ; l’entonnoir apparaît au début de la phase active. La distance, le relief et les bâtiments peuvent masquer le rendu. Testez sans projections ni dégâts supplémentaires pour commencer.
Le tsunami a été retiré des choix de l’interface météo admin. Son absence est prévue. Voir EVENEMENTS_METEO.md.
Mes modifications de configuration ne sont pas prises en compte
Les réglages généraux déjà enregistrés en SQL sont prioritaires sur les valeurs initiales des fichiers. Modifiez-les depuis /admincdt_config et enregistrez. Un conflit de révision signifie qu’un autre enregistrement a eu lieu : actualisez, puis réappliquez vos changements.
Les fournisseurs sont configurés dans les fichiers et demandent un redémarrage de la ressource. Les réglages de notifications peuvent aussi être remplacés par config/notifications.lua lorsque son mode n’est pas inherit.
Certaines traductions restent en français
Choisissez la langue dans /admincdt_config, puis enregistrez. Les textes saisis par les joueurs ne sont pas traduits et une clé manquante utilise le français de secours.
Après modification des JSON, redémarrez CDT. Les outils cités pour régénérer les textes de secours appartiennent au dépôt de développement et ne sont pas inclus dans le ZIP. Voir TRANSLATIONS.md.
Le grade owner revient après son retrait
Le compte possède encore le droit ACE cdt_admin.owner. Retirez l’attribution correspondante de server.cfg, redémarrez le serveur, puis attribuez none au personnage depuis la console. Retirer le droit ACE ne supprime pas le grade déjà sauvegardé. Voir README_GRADE_SYSTEM.md.
Préparer une demande de support
Rejoignez le Discord de support CDT pour demander de l’aide.
Fournissez :
- La version CDT indiquée dans
fxmanifest.lua. - Votre framework, sa version, les fournisseurs concernés et leurs versions.
- L’action effectuée, votre grade CDT et votre état de service.
- Le message d’erreur exact et les étapes permettant de reproduire le problème.
- Les lignes de console utiles et la partie de configuration concernée, après retrait des secrets.
Ne transmettez pas votre clé serveur, votre mot de passe SQL ou vos URL privées de webhooks. Les ressources tierces ne sont pas fournies avec CDT et leur compatibilité doit être vérifiée sur les versions réellement installées.