ZPROJECT

Dépannage

Par
Sören
v1.0.0Voir la ressource →

La ressource ne démarre pas

Vérifiez les points suivants :

  1. 1Le dossier porte bien le nom zBot.
  2. 2La ressource système yarn est disponible et démarre avant zBot.
  3. 3node_version '22' est présent dans fxmanifest.lua.
  4. 4oxmysql et zScreenshot sont installés.
  5. 5Les dépendances démarrent avant zBot.
  6. 6Le build fourni contient bien web/build/index.html.

Aucune commande npm install ou compilation manuelle n’est nécessaire.

Le bot Discord reste hors ligne

  • Vérifiez config.json > TOKEN.
  • Confirmez que l’application Discord possède bien un bot.
  • Vérifiez que le bot a été ajouté à votre serveur Discord.
  • Consultez la console FiveM au démarrage.
  • Validez la syntaxe JSON de config.json après chaque modification.

Les commandes Discord n’apparaissent pas

  • Vérifiez que isAvailable vaut true dans le fichier de la commande.
  • Redémarrez zBot afin de republier les commandes.
  • Confirmez que le bot dispose de l’accès aux commandes d’application.
  • Laissez à Discord le temps de synchroniser les commandes globales.

Un joueur n’est pas trouvé

Le joueur doit être connecté au serveur FiveM et son identifiant discord: doit correspondre au compte sélectionné sur Discord.

Demandez-lui de vérifier son compte Discord puis de se reconnecter à FiveM.

Les bannissements ne sont pas enregistrés

La table est créée automatiquement. Vérifiez uniquement :

  1. 1la connexion MySQL utilisée par oxmysql ;
  2. 2le démarrage d’oxmysql avant zBot ;
  3. 3la présence de zbot_bans après le démarrage.

Après correction, redémarrez zBot. Aucun import SQL manuel n’est nécessaire.

/screen ou /clip ne renvoie pas de média

  • Vérifiez que zScreenshot est démarré sous ce nom.
  • Remplacez WEBHOOKS.screenshots et WEBHOOKS.videos par vos URL.
  • Vérifiez que CLIP_DURATION contient un nombre supérieur à 0.

Les messages ou annonces ne s’affichent pas

  • Vérifiez que le build contient web/build/index.html.
  • Vérifiez que les fichiers de web/build/ sont présents avec la ressource.
  • Redémarrez zBot.

L’interface est déjà compilée ; ne lancez aucune commande npm ou Vite.

/clear ou /clearall ne nettoie pas le chat

Vérifiez que la ressource FiveM chat, ou une ressource compatible, est démarrée.

Un membre ne peut pas utiliser une commande

  • Vérifiez les identifiants présents dans requiredRoles.
  • Confirmez que le membre possède au moins un rôle configuré.
  • Redémarrez zBot après une modification des permissions.

Pour une assistance complémentaire, rejoignez discord.gg/zproject.

← PrécédentMise à jour