Intégration au jeuJeu

SuperMDT fonctionne très bien seul, comme un intranet sur le web. L’intégration au jeu le relie en plus à ton serveur FiveM : les personnages deviennent des fiches citoyen, la prise de service en jeu s’affiche dans le MDT, les agents ouvrent le MDT sur une tablette en jeu, et la carte en direct montre qui patrouille où.

Le lien passe par une ressource FiveM, supermdt-bridge (« la passerelle »), que tu installes sur ton serveur. Elle lit l’état du jeu dans ton framework et l’envoie à SuperMDT. SuperMDT ne se connecte jamais à la base de données de ton serveur de jeu.

Capture à venirgame-settings

Configuration › Jeu : l’interrupteur, l’état de la passerelle, la clé, les jobs et les intégrations

L’interrupteur

Tout part de l’interrupteur Activer l’intégration au jeu, en haut de Configuration › Jeu. Il est réservé aux administrateurs de l’organisation.

• Désactivée (le réglage d’une nouvelle organisation) : SuperMDT se comporte comme un intranet web. La passerelle est refusée si elle tente de se connecter, et les joueurs, la tablette, la carte en direct, le service venant du jeu, la liaison par code et le choix du personnage sont masqués.
• Activée : ton serveur de jeu peut se connecter avec la clé de passerelle, et tes membres relient leur compte de jeu puis se connectent avec leurs personnages.

Couper l’intégration ne supprime rien : joueurs, personnages, réglages et clé restent en place, et tout revient quand tu la réactives. Le changement est inscrit au journal d’audit.

Les changements de réglages arrivent en jeu en quelques secondes : jobs reliés, services, lecteur de plaques, alertes, panique, dispatch rapide, facturations… Les joueurs déjà connectés les voient sans se reconnecter. Seule la réactivation de l’intégration peut prendre jusqu’à 30 secondes.

Ce qui en dépend

Fonction	Sans l’intégration	Avec l’intégration
Fiches citoyen	saisies à la main	chaque personnage du jeu devient une fiche, badge Jeu ; identité en lecture seule
Prise de service	depuis le MDT	synchronisée avec le jeu, dans les deux sens (Service et positions)
Nom affiché	le nom du compte	le nom RP du personnage choisi (Comptes et personnages)
Tablette en jeu	—	le MDT dans le jeu, touche F6 (F4 sur ESX) (Tablette en jeu)
Carte en direct	—	positions des agents en service
Photos prises en jeu, dispatch rapide	—	options de la tablette
Bouton panique	depuis le MDT	aussi par la tablette, la commande /panique ou une touche, avec la position du personnage
Alertes du jeu	—	coups de feu, braquages, vols de véhicule, appels au 911 : un appel au dispatch, fusionné et plafonné
Bracelets électroniques	—	une personne sous bracelet suivie sur la carte en direct, alertes de zone et de déconnexion
Armes, véhicules, virements, permis, amendes, lecteur de plaques, propriétés, numéro de téléphone	—	intégrations facultatives, une par une (voir plus bas)

Les frameworks pris en charge

La passerelle fonctionne avec trois frameworks, et seulement ceux-là :

• ESX Legacy ;
• QBCore ;
• Qbox (qbx_core).

Elle les détecte seule au démarrage. Sur tout autre framework (ox_core, vRP, ND…), elle écrit la raison dans la console du serveur et reste inactive : rien n’est envoyé.

Un framework très modifié

La passerelle lit les données là où le framework les range d’origine (métier, grade, état de service, identité du personnage). Si ton serveur a réécrit ces parties, la lecture peut être incomplète. supermdt status, dans la console du serveur, dit ce que la passerelle a trouvé (voir Installer la passerelle).

Comptes, joueurs et personnages

Trois niveaux, à ne pas confondre :

• le membre du MDT : la personne qui se connecte au site avec Discord, membre de ton organisation ;
• le joueur : la même personne vue par le jeu, reconnue par sa licence Rockstar (avec son Discord et son identifiant FiveM) ;
• les personnages : ceux que ce joueur incarne sur ton serveur. Chacun est une fiche citoyen.

Membre du MDT (compte Discord)
   │  lié par Discord (automatique), par code /mdtlink, ou par un administrateur
   ▼  1 membre → 5 joueurs au plus
Joueur (licence Rockstar, Discord, FiveM)
   │
   ▼  1 joueur → plusieurs personnages
Personnages = fiches citoyen (badge « Jeu »)
   │  le métier en jeu du personnage (police, ambulance…)
   ▼
Service de ton organisation (Configuration › Jeu › Jobs et services)

Un membre est lié à des joueurs, jamais directement à des personnages : ses personnages sont ceux de ses joueurs. Un personnage compte pour un membre quand son métier en jeu est relié à un service où ce membre est affecté (un administrateur les voit tous).

Le nom RP

Quand tu te connectes au MDT, tu choisis avec quel personnage (tu n’as rien à choisir si tu n’en as qu’un). Ce personnage actif donne :

• le nom affiché partout dans le MDT : rapports, journal, dispatch, carte ;
• le service courant : celui du métier du personnage ;
• le matricule : celui de ton affectation dans ce service.

Sans personnage (intégration coupée, aucun joueur lié), c’est le nom de ton compte, comme sans le jeu. Tout le détail : Comptes et personnages.

Les intégrations facultatives

En plus du socle (joueurs, personnages, service, positions, tablette), neuf intégrations s’activent une par une dans Configuration › Jeu › Intégrations. Toutes sont désactivées par défaut, et chacune dépend des scripts installés sur ton serveur :

Intégration	Ce qu’elle fait	Page
Registre des armes automatique	une fiche par arme achetée ou donnée en jeu, avec son numéro de série	Armes
Véhicules possédés	les véhicules des personnages arrivent dans le fichier des véhicules	Véhicules
Virements des salaires	les fiches de paie validées sont versées en jeu	Virements des salaires
Permis des personnages	lecture, retrait et restitution des permis depuis la fiche citoyen	Permis
Encaissement des amendes	l’amende d’un dossier est facturée ou prélevée en jeu	Amendes
Facturation des soins	les soins d’un passage médical sont facturés ou prélevés en jeu, avec les mêmes modes que les amendes (réglée sur le service médical)	Amendes et soins
Impression en jeu	un document exporté devient une feuille dans l’inventaire, à lire, montrer ou donner (réglée par service, module Documents)	Impression en jeu
Lecteur de plaques en jeu	les plaques lues par Wraith ARS 2X ou le lecteur intégré sont vérifiées dans le MDT, alerte en jeu	Lecteur de plaques
Propriétés des personnages	les logements des personnages, en lecture seule, sur la fiche citoyen	Propriétés

Le numéro de téléphone des fiches citoyen n’a pas d’interrupteur : la passerelle le lit dans le téléphone en jeu quand elle le reconnaît (Téléphone).

Les alertes et ton script de dispatch

Les alertes du jeu n’ont pas d’interrupteur ici non plus : SuperMDT travaille avec ton script de dispatch, sans le remplacer. La passerelle écoute ps-dispatch Testé en jeu, cd_dispatch, qs-dispatch ou rcore_dispatch Expérimental (core_dispatch n’est pas pris en charge : passe par l’export Alert) ; le titre de l’alerte en jeu devient la nature de l’appel. Sans script de dispatch, ses détections intégrées signalent les coups de feu, les personnes à terre et les vols de véhicule ; avec un script, elles se coupent d’elles-mêmes pour éviter les doublons. S’y ajoutent l’alerte police et EMS du framework, les braquages, /911p et /911e, les appels au 911 des téléphones et l’export Alert.

La ligne Alertes et dispatch de Configuration › Jeu › Intégrations montre ce que la passerelle écoute sur ton serveur (script de dispatch, téléphones, état des détections, niveau de prise en charge) et mène à Régler les alertes du jeu : chaque service choisit les alertes qu’il reçoit dans Configuration › Opérations › Alertes du jeu.

Sous chaque interrupteur, SuperMDT affiche ce que la passerelle a détecté sur ton serveur (« Utilise ox_inventory », « Détecté mais pas encore pris en charge : … ») et t’avertit si tu actives une intégration sans ressource compatible.

Trois niveaux de prise en charge

Chaque script tiers porte un badge, dans les tableaux de compatibilité, dans Configuration › Jeu et dans supermdt status :

• 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 et couvert par les tests de la passerelle, mais pas encore essayé en jeu ;
• Expérimental : écrit d’après la documentation publique de l’éditeur (script payant ou chiffré), jamais essayé.

Tant qu’un script n’est pas Testé en jeu, vérifie-le sur ton serveur avant de t’y fier.

Par où commencer

1. Installe la passerelle et relie tes jobs à tes services.
2. Demande à tes membres de relier leur compte de jeu.
3. Montre-leur la tablette en jeu.
4. Active ensuite les intégrations dont tu as besoin, une par une.