Dépannage

Le menu ne s'ouvre pas

1. 1Vérifiez ensure oxmysql puis ensure zDisplay.
2. 2Vérifiez que web/dist/index.html existe.
3. 3Exécutez zdisplay-doctor.
4. 4Confirmez que CONFIG.command_enabled et CONFIG.open_key.enabled correspondent au mode utilisé.
5. 5Confirmez que CONFIG.can_open(source) retourne true.
6. 6Vérifiez si le joueur a remappé F9 dans ses réglages FiveM.

Le joueur voit le menu mais ne peut pas créer

Ajoutez zdisplay.create, activez la création publique ou ajoutez son métier/sa licence dans Administration > Réglages. Vérifiez également que sa limite de displays n'est pas atteinte.

Le display n'apparaît pas dans le monde

• son statut doit être approved ;
• il doit avoir été placé ;
• le joueur doit se trouver dans la distance d'activation ;
• le display doit faire partie des DUI les plus proches selon max_active_dui ;
• vérifiez les erreurs DUI/CEF dans la console F8.

Une image ou un GIF est refusé

• activez les URL externes ;
• ajoutez le domaine sans https:// ni chemin ;
• utilisez HTTPS ;
• vérifiez l'extension et la longueur de l'URL ;
• vérifiez allow_gifs et la limite de GIF.

Une vidéo est refusée

Vérifiez les URL externes, le domaine, le fournisseur, video.enabled, video.admin_only, les métiers/licences autorisés, le son et la limite de vidéos. YouTube et Twitch nécessitent eux aussi un domaine autorisé.

Les achats échouent

• activez CONFIG.purchases.enabled ;
• utilisez ESX, QBCore, QBox ou un bridge personnalisé ;
• vérifiez le compte configuré et le solde ;
• marquez le display approuvé comme achetable ;
• utilisez un prix entier ;
• adaptez on_display_purchased pour livrer le résultat attendu.

Erreur SQL ou migration

Vérifiez l'ordre de démarrage, les identifiants de connexion oxmysql, les droits CREATE/ALTER/INDEX et les erreurs de la console serveur. Ne marquez jamais manuellement une migration comme appliquée sans avoir vérifié le schéma.

Le thème ou la langue ne change pas

Après le premier lancement, settings.json peut conserver activeTheme et locale malgré une modification de config.lua. Arrêtez la ressource, sauvegardez le fichier, corrigez ces valeurs puis redémarrez.

Si le problème persiste, rejoignez le support : discord.gg/zproject.