PermisJeu

Avec Permis des personnages, la fiche citoyen d’un personnage du jeu gagne un onglet Permis : les permis lus en jeu (permis de conduire, port d’arme…), valides ou retirés. Un agent habilité peut retirer ou rendre un permis depuis le MDT : le changement part en jeu.

L’activer

Dans Configuration › Jeu › Intégrations, active Permis des personnages (administrateurs, ou un grade qui a Administration déléguée › Régler le jeu). Sous l’interrupteur, SuperMDT indique le script utilisé et si un permis s’écrit aussi quand le personnage est hors ligne.

L’onglet Permis

Sur la fiche d’un citoyen venu du jeu, l’onglet Permis montre :

• chaque permis, Valide ou Retiré, et quand ils ont été lus en jeu ;
• le changement en cours d’un permis, s’il y en a un (« Retrait en attente de la connexion du personnage »…) ;
• les Derniers changements : les 10 plus récents, avec l’auteur, le motif et le résultat en jeu.

Les permis arrivent à chaque connexion, reconnexion ou changement de personnage (sauf s’ils ont été lus il y a moins d’une minute), puis sont relus toutes les 10 minutes pour les personnages connectés : un permis donné ou retiré en jeu (auto-école, armurerie) apparaît donc dans le MDT. Une liste inchangée n’est pas renvoyée.

Avec esx_license, seuls les permis que le personnage possède et ceux retirés par le MDT (qu’on peut rendre) sont affichés : un permis du catalogue qu’il n’a jamais obtenu n’apparaît pas.

Les types connus sont traduits (Permis de conduire, Port d’arme, Permis moto, Code de la route…) ; un type inconnu s’affiche avec le nom du jeu, ou le libellé du catalogue d’ESX.

Retirer ou rendre un permis

1. Ouvre l’onglet Permis de la fiche.
2. Sur la ligne du permis, clique sur Retirer (ou Rendre pour un permis retiré).
3. Saisis le Motif : obligatoire, de 3 à 200 caractères.
4. Pour retirer, maintiens le bouton Retirer qui apparaît (relâcher annule). Pour rendre, clique sur Rendre le permis. Annuler referme sans rien changer.
5. Le changement part en jeu. Son état s’affiche sur la ligne : en cours, en attente de connexion, appliqué en jeu, ou échec avec la raison.

Chaque changement est inscrit au journal d’audit : qui, quel permis, le motif, avant et après, puis le résultat en jeu.

Qui peut le faire

Permission	Ce qu’elle permet	Par défaut
Permis › Voir les permis	l’onglet Permis	tous les grades
Permis › Révoquer	Retirer un permis en jeu, avec un motif	encadrement et plus
Permis › Rendre	Rendre en jeu un permis retiré, avec un motif	encadrement et plus

Ces permissions se règlent sous le module Citoyens de la matrice, dans Grades et permissions, et n’y apparaissent que si l’intégration au jeu est activée. Les administrateurs les ont toujours. Le catalogue complet est dans Les permissions.

Ce que ça change vraiment en jeu

Permis	Effet réel
Port d’arme (weapon)	Les armureries qui lisent le permis natif (ox_inventory avec license = 'weapon' sur l’article, qb-shops, esx_weaponshop) refusent la vente.
Permis de conduire	Aucun script natif n’empêche de conduire sans permis : le retrait est un effet RP (contrôles, fiche).
Carte physique (objet d’inventaire)	N’est pas retirée de l’inventaire.

Un guichet qui revend le permis

Si ton serveur vend le permis (le guichet data/licenses.lua d’ox_inventory, esx_weaponshop…), le joueur peut le racheter après un retrait. Retire ce point de vente si le retrait doit tenir.

Compatibilité

Testé en jeu essayé en jeu sur un vrai serveur. Vérifié sur le code écrit d’après le code source ou l’API native du script, couvert par les tests de la passerelle, pas encore essayé en jeu. Expérimental d’après la documentation publique de l’éditeur, jamais essayé : vérifie-le sur ton serveur avant de t’y fier.

Framework	Script	État	Lecture	Retrait et restitution
Qbox	natif (metadata.licences)	Vérifié sur le code	Oui	En ligne et hors ligne (hors ligne, qbx_core enregistre un peu plus tard : la passerelle relit jusqu’à 5 fois avant de conclure).
QBCore	natif (metadata.licences)	Testé en jeu	Oui	Personnage connecté seulement : sinon, le changement attend sa connexion.
ESX	esx_license (avec oxmysql)	Vérifié sur le code	Permis possédés, et ceux retirés par le MDT ; libellés du catalogue	En ligne et hors ligne.
ESX, QBCore, Qbox	BCS License Manager	Expérimental	Oui	Retrait en ligne ou non ; restitution personnage connecté. Prioritaire s’il est démarré.
ESX, QBCore, Qbox	qs-licenses (Quasar)	Expérimental	Permis actifs seulement	Retrait en ligne ou non ; restitution personnage connecté. Prioritaire s’il est démarré.

Sur QBCore, la passerelle n’écrit jamais directement en base pour un personnage hors ligne : la sauvegarde du framework écraserait le changement s’il se connectait entre-temps.

Ton script est personnalisé ?

Ton script de permis…	Résultat
écrit dans metadata.licences (QBCore, Qbox) ou dans user_licenses (ESX)	Lu et modifiable depuis le MDT.
garde ses permis dans ses propres tables ou exports	Ni lu, ni modifié.

Réglages de la passerelle

Dans config.lua, Config.Integrations.licenses : resyncMinutes (relecture des personnages connectés, 10 minutes) et readIntervalMs (un personnage lu au plus toutes les secondes).

Dépannage

Ce que tu vois	Cause	Que faire
Pas d’onglet Permis	Intégration non activée, intégration au jeu coupée, ou permission manquante	Configuration › Jeu › Intégrations ; Permis › Voir les permis.
« Ce citoyen n’est pas un personnage du jeu »	Fiche saisie dans le MDT	Rien à lire.
« Pas encore lus en jeu »	Le personnage ne s’est pas connecté depuis l’activation	Ils arrivent à sa prochaine connexion.
« … en attente de la connexion du personnage »	QBCore, ou restitution avec BCS ou qs-licenses	Le changement s’applique à la prochaine connexion.
Permis retiré, le joueur achète encore une arme	Un guichet revend le permis, ou l’armurerie ne lit pas le permis natif	Retirer ce point de vente, vérifier la boutique.