Erreurs fréquentes

Le serveur s'arrête au démarrage

Le téléphone coupe le processus quand sa licence est invalide. Vérifiez dans l'ordre :

Vérification	Comment
La clé est déclarée	`setr zsphone_license_key "..."` dans `config.cfg`
La clé n'est pas expirée	Bannière en console au démarrage
C'est bien une clé Téléphone	Une clé de base seule ne valide plus le téléphone
L'IP correspond	Voir ci-dessous

`invalid server ip`

Chaque clé se verrouille sur l'IP du premier serveur qui l'utilise. Après un changement d'hébergeur, demandez une réinitialisation d'IP dans un ticket.

Le téléphone ne s'ouvre pas, sans erreur en console

Cause	Vérification
Pas d'item	`Config.Phone.Item.Require = true` et l'item `phone` est-il dans l'inventaire ?
Item mal déclaré	L'item existe-t-il dans votre inventaire, et est-il utilisable ?
Joueur mort ou menotté	Comportement voulu
Autre interface ouverte	Le téléphone refuse de s'ouvrir par-dessus une autre NUI

Le numéro change à chaque connexion

En mode téléphone unique, l'item doit être non empilable. Sur ox_inventory : stack = false. Sur qb-inventory : unique = true. Sans cela, deux téléphones fusionnent et perdent leurs métadonnées.

Les applications Portefeuille / Factures / Services sont vides

Le provider correspondant n'a pas été détecté. Regardez la ligne affichée au démarrage :

[zs-phone] framework=... banking=... billing=... society=...

Une valeur internal signifie qu'aucun script externe n'a été trouvé et que le téléphone gère lui-même les données. Une application vide malgré un provider correct vient généralement d'un nom de métier absent de votre base.

L'application Maison ne liste rien

Vérifiez que Config.Phone.Housing correspond bien à votre script, et que le joueur est réellement propriétaire ou détenteur de clé côté script de housing.

Les joueurs ne s'entendent pas en appel

Aucun système de voix détecté, ou le mauvais forcé. Voir Système de voix.

L'envoi de photos échoue

Le CDN KLMSTUDIO est réservé aux clients de la base. Avec le téléphone seul, Config.Phone.Camera.UploadProvider = 'cdn' ne fonctionnera pas : basculez sur fivemanage ou discord, voir Envoi de médias.

Message console	Cause
`Upload CDN indisponible : convar "zsphone_license_key" non definie`	Clé absente
`Echec token CDN (HTTP 401/403)`	Clé refusée — vous n'avez pas la base
`Echec token CDN (HTTP ...)`	Backend injoignable

Les vidéos et mémos vocaux passent toujours par Fivemanage : sans clé Fivemanage renseignée, ils échouent même si les photos fonctionnent.

Le téléphone ne se met pas à jour

Il manque la permission child process :

add_unsafe_child_process_permission zs-phone

Avec la base KLMSTUDIO, vérifiez que server.cfg exécute bien :

exec @core/configs/panel_server.cfg

Le core ajoute ensuite la permission automatiquement dans ce fichier.

`bcrypt worker unavailable`

Le téléphone continue de fonctionner avec le fallback natif FiveM. Pour réactiver le worker, vérifiez :

add_unsafe_worker_permission zs-phone

Puis effectuez un redémarrage complet du serveur. Avec la base KLMSTUDIO, la ligne doit être présente dans core/configs/panel_server.cfg ; ne la dupliquez pas ailleurs.

Erreurs SQL au démarrage

Les migrations s'exécutent à chaque démarrage. Un message SQL FAILED (<table>) indique une table en échec. Cause la plus fréquente : conflit de collations entre bases.