Licence : fonctionnement et erreurs
La licence n’est pas qu’un contrôle d’accès : c’est le canal permanent entre le serveur et le panel. Elle décide des modules actifs, pousse la configuration et remonte l’état en direct.
La convar
La licence se pose avec set loop_license "xxxx" dans server.cfg (LOOP Guard, système intégré). L’ancien module de protection ROOT (loop-root, convars root_*) est désactivé depuis le 14/09/2026 sur loop_dev.
Fonctionnement
- Au démarrage, le serveur se présente : clé, identifiant Cfx, nom, liste des modules. Il reçoit un jeton de session, la liste des modules autorisés, la configuration (identité, écran de chargement, boutique) et les commandes en attente.
- En continu, une boucle échange toutes les quelques secondes : le serveur envoie joueurs, console, journaux et état ; le panel renvoie droits, configuration, commandes staff et bannis.
- Modules : les modules de cœur (core, runtime, cache, interface) ne sont jamais arrêtés ; les modules gérés (menu F1, menu pause, menu contextuel, créateur, permissions, boutique...) ne démarrent que si la licence les autorise, et s’activent ou se coupent depuis l’espace client sans redémarrage.
- Si le panel devient injoignable, le serveur continue normalement et retente ; une licence explicitement révoquée arrête les modules gérés à la réponse suivante.
Depuis le panel, sans être en jeu : expulser, message privé, annonce, argent, métier, objets, soin et réanimation, ressources, commande console, redémarrage programmé avec compte à rebours, capture d’écran d’un joueur.
Relier un serveur
| Signe | Signification |
|---|---|
| Le serveur apparaît en ligne dans le panel | La présentation a réussi |
| La liste des joueurs se met à jour | La boucle tourne |
| Le menu F1 s’ouvre en jeu | Les modules gérés sont autorisés |
| Un changement de nom depuis le panel se voit en jeu | La configuration descend |
Une licence autorise un nombre de serveurs simultanés, comptés par identifiant Cfx ; une place se libère seule après quelques minutes sans signal. Un serveur marqué « environnement de développement » échappe à l’arrêt automatique des modules.
Erreurs courantes
| Message ou symptôme | Cause | Correction |
|---|---|---|
| Aucune licence | Convar non posée | Ajouter loop_license dans server.cfg |
| Licence invalide, code 401 ou 403 | Clé inconnue, expirée ou révoquée | Vérifier la licence dans l’espace client |
| Nombre de serveurs atteint | Place occupée | Attendre la libération ou libérer la place |
| Identifiant Cfx différent | Clé Cfx ne correspond pas | Corriger sv_licenseKey ou relier la licence au bon identifiant |
| Le menu F1 ne s’ouvre pas | Module arrêté par la licence, ou aucune permission | Vérifier les modules, puis /myrank |
| Des ressources s’arrêtent seules au démarrage | Hors des modules autorisés | Activer le module dans l’espace client |
| Le nom du serveur ne change pas | Réglé dans le fichier alors qu’il descend du panel | Le changer dans l’espace client |
| « Illegal mix of collations » | Tables importées avec une autre collation | Homogénéiser la collation |
| OneSync requis | OneSync désactivé | L’activer dans txAdmin |
LOOP Docs