Dépannage et FAQ
Premier réflexe : la fenêtre du serveur (FXServer ou console web, écran Console) et la commande console tlr_diag, qui affiche l'état du cœur, de chaque service et de la configuration.
Messages de licence
Ils s'affichent au démarrage dans un bloc [tlr_core:licence], et aux joueurs refusés à la connexion. tlr_licence (fenêtre du serveur) réaffiche l'état ; tlr_licence verifier relance une vérification.
| Message | Cause | Que faire |
|---|---|---|
| aucune clé | tlr_licence_key absente de server.cfg, ou placée après ensure tlr_core. | Ajoutez set tlr_licence_key "VOTRE_CLE" avant les ensure. |
| clé inconnue ou invalide | Faute de frappe, clé incomplète. | Recopiez la clé depuis /malicence (15 caractères, commence par TLR ; espaces et points ignorés). |
| licence révoquée | La licence a été annulée par le vendeur. | Contactez le vendeur. |
| licence expirée | Abonnement non renouvelé. | Renouvelez sur le Discord du vendeur, puis tlr_licence verifier ou redémarrez. |
| licence liée à un autre serveur | L'adresse IP de la machine n'est pas celle enregistrée. | /changerip sur le Discord du vendeur, puis redémarrez. |
| serveur de licences injoignable et aucune vérification récente en cache | Pas d'accès à Internet sortant, pare feu, DNS, ou tout premier démarrage hors ligne. | Autorisez les connexions HTTPS sortantes vers licence.jurinova.be. |
| serveur de licences injoignable depuis plus de 72 heures | Le délai de grâce hors ligne est épuisé. | Rétablissez l'accès sortant, puis redémarrez. |
| horloge de la machine incohérente | L'heure du système a reculé. | Corrigez l'heure de la machine (synchronisation NTP). |
| signature de la réponse invalide, réponse rejouée ou altérée | Un proxy ou un antivirus modifie le trafic, ou une tentative de contournement. | Retirez l'intermédiaire. Si cela persiste, contactez le support. |
Bon à savoir :
- La licence est revérifiée toutes les 6 heures. Si elle cesse d'être valide pendant que le serveur tourne, les joueurs connectés ne sont pas éjectés ; seul le prochain démarrage est bloqué.
- Si le serveur de licences est injoignable, la dernière réponse valide reste acceptée 72 heures (mode grâce, affiché au démarrage).
Erreurs de l'escrow Cfx
| Message | Cause | Que faire |
|---|---|---|
You lack the required entitlement to use tlr_core | La clé sv_licenseKey n'appartient pas au compte Cfx.re qui a acheté tlr_core. | Créez la clé du serveur sur ce compte (portal.cfx.re), ou demandez le transfert de l'achat. |
Failed to verify protected resource | Fichier modifié, archive incomplète, ou ressource renommée. | Retéléchargez depuis le portail, ne renommez pas le dossier, ne modifiez aucun fichier chiffré. |
Mode développement
Pour tester sur votre propre machine sans consommer la licence :
set tlr_licence_dev 1tlr_core démarre alors sans clé, mais refuse toute connexion depuis une adresse IP publique : seuls les joueurs du réseau local (127.0.0.1, 192.168.x.x, 10.x.x.x, 172.16 à 31.x.x) peuvent entrer. Retirez cette ligne avant d'ouvrir le serveur. L'escrow Cfx exige de toute façon une clé sv_licenseKey du compte acheteur, même en local.
Erreurs courantes
| Symptôme | Cause probable | Solution |
|---|---|---|
Couldn't find resource oxmysql ou erreurs MySQL au démarrage | oxmysql absent, démarré après tlr_core, ou chaîne de connexion fausse. | ensure oxmysql avant ensure tlr_core ; vérifiez utilisateur, mot de passe, hôte, port et base dans mysql_connection_string. |
| Le cœur reste « non prêt », joueurs refusés | Une étape indispensable a échoué (base, paramètres, permissions, métiers, objets). | tlr_diag indique l'étape ; corrigez puis restart tlr_core. |
migration N, requête M en échec | Droits SQL insuffisants, ou base modifiée à la main. | Donnez tous les droits sur la base à l'utilisateur (CREATE, ALTER, INDEX...). Restaurez la sauvegarde si la base a été modifiée. |
| Le joueur apparaît avant l'écran des personnages | spawnmanager tourne. | Retirez ensure spawnmanager. |
| Deux écrans de chargement, ou écran noir à la connexion | Une autre ressource déclare loadscreen. | Ne gardez que celui de tlr_core. |
/tlr ne s'ouvre pas | Pas de droit tlr.panel.open. | Vérifiez la ligne add_ace identifier.license:... tlr.founder allow (licence exacte, sans espace) ou donnez un groupe avec tlr_setgroup. |
| La console web refuse la licence du fondateur | La licence saisie n'est pas celle de tlr.founder / tlr_founder. | Ajoutez set tlr_founder "license:..." dans server.cfg et redémarrez. |
| Console web injoignable | Mauvais port, pare feu, ou hébergeur qui expose un autre port. | Le port est celui des joueurs (30120 par défaut). Réglez tlr_console_url avec l'adresse réellement accessible. |
| Plus de code d'installation | Un compte web existe déjà. | Connectez vous, ou tlr_console_invite <licence> pour un nouveau compte. |
| Le serveur ne redémarre pas après un redémarrage programmé | Rien ne relance FXServer. | Voir « Redémarrer sans txAdmin » dans Installation. |
Une valeur de config/ est ignorée | Valeur invalide, ou valeur de départ déjà semée en base. | Lisez l'avertissement de tlr_diag ; pour les éléments semés, modifiez dans le panel (Configuration). |
| Image d'objet absente | Fichier absent de web/img/items/ ou nom différent de l'objet. | Envoyez l'image depuis le panel, section Objets, ou redémarrez après l'avoir déposée. |
FAQ
Puis je modifier le code de tlr_core ? Le code serveur et client est chiffré par l'escrow Cfx. Tout ce qui se règle est lisible : config/, locales/, l'interface web/, les données de shared/ et la lib lib/. Pour ajouter des fonctions, écrivez un module à part qui utilise l'API.
Puis je installer tlr_core sur plusieurs serveurs ? Une clé TLR correspond à un serveur (une adresse IP). Un serveur de test local peut utiliser le mode développement.
Faut il importer un fichier SQL ? Non, les tables se créent toutes seules. Voir install/LISEZMOI.md pour le cas d'un hébergeur restrictif.
Mes ressources RSG ou VORP fonctionnent elles avec tlr_core ? tlr_core est un framework complet, pas une couche de compatibilité. La plupart des systèmes de RSG ont été intégrés au cœur ; une ressource écrite pour un autre framework doit être adaptée à l'API de tlr_core.
Faut il txAdmin ? Non. La console web de tlr_core couvre l'administration courante. txAdmin reste utilisable si vous le préférez.
Où sont les journaux ? Panel en jeu, section Journaux, et console web, écran Console et Journal web. Ils sont en base (table tlr_logs).
Comment changer de langue ? Voir locales/ dans Configuration.
Une mise à jour efface t elle mes réglages ? Non : les réglages en jeu sont en base, et vous remettez votre dossier config/. Voir Mise à jour.
À qui demander de l'aide ? Sur le Discord du vendeur, avec : la version de tlr_core, le résultat de tlr_diag, et le message exact de la fenêtre du serveur. N'envoyez jamais vos clés ni votre mot de passe de base.
Source : tlr_core/docs/DEPANNAGE.md