Dépannage

La ressource ne démarre pas

Contrôlez les éléments suivants :

1. 1oxmysql est installé et connecté à MySQL ou MariaDB.
2. 2es_extended est démarré.
3. 3zSleep-v2 démarre après ces deux ressources.
4. 4Les valeurs de config.lua utilisent une syntaxe Lua valide.

Ordre de démarrage conseillé :

ensure oxmysql
ensure es_extended
ensure zSleep-v2

La table sleepers n'existe pas

Aucun fichier SQL ne doit être importé. Vérifiez la connexion de oxmysql, puis redémarrez zSleep V2 afin que la table soit créée automatiquement.

Aucun dormeur n'apparaît après une déconnexion

Vérifiez successivement que :

• CONFIG.getPlayerIdentifier(source) retourne bien un identifiant.
• zSleep V2 est démarré avant le test.
• La connexion à la base de données fonctionne.
• La configuration ESX fournie fonctionne avant toute adaptation du framework.

Le joueur n'est pas restauré à sa reconnexion

Assurez-vous que CONFIG.spawnedEvent correspond à l'événement de spawn réellement utilisé par votre serveur.

Avec la configuration fournie :

spawnedEvent = "esx:onPlayerSpawn"

La commande /carry n'existe pas

Vérifiez la configuration suivante :

carry = {
    enabled = true,
    command = "carry",
    event = "zSleep:toServer:carry",
    radius = 2.0
}

Redémarrez ensuite la ressource. Si CONFIG.carry.command a été modifié, utilisez le nouveau nom de commande.

La commande /handleped n'existe pas ou refuse l'accès

Contrôlez CONFIG.handlePed.enabled, CONFIG.handlePed.command et la valeur retournée par CONFIG.handlePed.hasPermission(source).

Aucun dormeur n'est sélectionné avec /handleped

Approchez-vous de la cible ou adaptez CONFIG.handlePed.radius. Le rayon par défaut est 10.0.

L'interface ne s'affiche pas

Vérifiez la présence de web/dist/index.html et du dossier web/dist/assets dans la ressource. L'interface compilée est incluse dans le package.

Les textes ne sont pas dans la bonne langue

Sélectionnez l'une des langues incluses, puis redémarrez la ressource :

locale = "fr" -- ou "en"

Les journaux Discord ne sont pas reçus

Vérifiez la catégorie concernée dans server/config.lua. Chaque journal activé doit utiliser une URL de webhook Discord valide.

Une intégration utilise un mauvais nom de ressource

Les exemples de cette documentation utilisent zSleep-v2. Si vous renommez le dossier, reportez son nouveau nom dans les appels exports[...].

Pour toute assistance supplémentaire, rejoignez le serveur Discord de zProject.