Lecteur de plaquesJeu

Avec le lecteur de plaques en jeu, chaque plaque lue devant une voiture de patrouille est vérifiée dans le MDT. Si le véhicule est volé, recherché, ou si son propriétaire a un mandat d’arrêt, l’agent reçoit une alerte à l’écran, en jeu, sans rien saisir.

La lecture vient du radar Wraith ARS 2X s’il est installé sur ton serveur, sinon du lecteur intégré de la passerelle.

L’activer

1. Dans Configuration › Jeu › Intégrations, active Lecteur de plaques en jeu (administrateurs, ou un grade qui a Administration déléguée › Régler le jeu). Désactivé par défaut. Sous l’interrupteur, SuperMDT indique s’il utilise Wraith ou le lecteur intégré.
2. Dans Configuration › Opérations, choisis le service puis ouvre la carte Lecteur de plaques. Coche Lecteur actif dans ce service. Il faut aussi le module Véhicules dans ce service : sans lui, le lecteur n’a rien à vérifier.
3. Choisis ce qui déclenche une alerte, puis enregistre.

Capture à venirplate-reader-settings

Configuration › Opérations › Lecteur de plaques

Côté serveur de jeu, le lecteur se coupe avec Config.PlateReader.enabled = false dans config_shared.lua.

Les réglages du service

Réglage	Rôle	Défaut
Lecteur actif dans ce service	Les agents en service de ce service reçoivent les alertes	désactivé
Lecteur intégré (serveurs sans Wraith)	Les agents peuvent l’activer eux-mêmes en jeu ; seulement sur un serveur sans Wraith	activé
Le passager avant peut s’en servir	Le conducteur peut toujours ; le serveur de jeu peut aussi l’interdire au passager	activé
Ce qui déclenche une alerte	Les motifs retenus (voir plus bas)	volé, avis de recherche, mandat, propriétaire recherché
Champs contrôlés de la fiche véhicule	Jusqu’à 4 champs personnalisés : alerte s’il est vide ou non coché, ou si la date est passée	aucun
Alerte sonore en jeu	Un son accompagne l’alerte	activé
Garder une trace dans l’historique du véhicule	Une plaque signalée laisse une ligne sur la fiche	activé
Fusionner les lectures rapprochées	Une même plaque relue dans ce délai prolonge la même ligne	15 min (de 1 à 240)

Régler le lecteur demande Lecteur de plaques › Régler le lecteur.

Les motifs d’alerte

Motif	Quand	Permission MDT nécessaire pour le voir
Véhicule volé	la fiche du véhicule est au statut volé	Véhicules › Voir les véhicules
Avis de recherche sur le véhicule	un avis actif vise cette plaque	Avis de recherche › Voir les avis
Mandat d’arrêt contre le propriétaire	le propriétaire a un mandat d’arrêt en vigueur	Mandats › Voir les mandats
Propriétaire recherché	un avis de recherche actif vise le propriétaire	Avis de recherche › Voir les avis
Véhicule saisi	statut saisi	Véhicules › Voir les véhicules
Véhicule en fourrière	statut en fourrière	Véhicules › Voir les véhicules
Plaque inconnue du MDT	aucune fiche ne porte cette plaque	Véhicules › Voir les véhicules
Champ de la fiche manquant ou échu	un champ contrôlé est vide, non coché ou dépassé (assurance, contrôle technique…)	Véhicules › Voir les véhicules

Un agent ne voit un motif que s’il a la permission MDT qui correspond : le lecteur ne montre jamais plus que ce que la fiche lui montrerait. Il lui faut en plus Lecteur de plaques › Utiliser en jeu et d’être en service.

L’alerte en jeu

Quand une plaque est signalée, l’agent voit une notification rouge qui clignote : la plaque, les motifs et le modèle du véhicule. Un son l’accompagne si le service le veut.

• Couper le son : chaque joueur peut le couper de son côté avec la commande supermdt_plate_sound (son choix est retenu sur son PC).
• Ouvrir la fiche : pendant 20 secondes après l’alerte, la touche Page haut (PAGEUP par défaut, action « ouvrir la fiche du véhicule signalé ») ouvre la fiche du véhicule dans la tablette. Seulement avec Véhicules › Voir les véhicules. La notification affiche la touche que le joueur a vraiment attribuée ; s’il n’en a aucune, elle renvoie vers le menu SuperMDT et sa touche. Le menu propose aussi Ouvrir la dernière alerte pendant 10 minutes.

Une plaque propre ne déclenche aucune notification. Avec le lecteur intégré, sa caméra affiche En règle.

Le lecteur intégré en jeu : ce que voit l’agent

Sur un serveur sans Wraith, l’agent active le lecteur lui-même. Une fois activé, il reste allumé jusqu’à ce qu’il le coupe, qu’il sorte du véhicule, change de siège ou quitte son service.

1. Activer : l’agent, en service, monte au volant d’un véhicule de patrouille (ou à la place du passager avant si c’est permis), ouvre le menu SuperMDT (F9 ; sur ESX, la touche que le joueur a choisie) et choisit Activer le lecteur de plaques. Un court message confirme « Lecteur de plaques activé ». Aucune touche directe par défaut : chaque joueur peut en attribuer une dans Paramètres › Raccourcis clavier › FiveM (« Lecteur de plaques SuperMDT : activer ou couper »).
2. Lire : un petit panneau s’affiche en permanence, en bas au centre de l’écran comme le radar Wraith, avec deux caméras côte à côte : Avant et Arrière. Chacune montre la plaque du véhicule qu’elle voit (jusqu’à 40 m devant, ou derrière), son modèle et un état, mis à jour toutes les 500 ms.
3. Couper : même entrée du menu (ou la touche). Le message « Lecteur de plaques désactivé » le confirme et le panneau disparaît.

Capture à venirgame-plate-reader-cameras

Le lecteur intégré : caméra avant verrouillée sur une plaque signalée, caméra arrière vérifiée

La dernière plaque reste affichée

Quand plus rien n’est devant une caméra, elle garde la dernière plaque lue au lieu de s’effacer. Sous la plaque, discrètement, depuis combien de temps elle a été lue : « à l’instant » tant que le véhicule est en vue, puis « il y a 12 s », « il y a 3 min ».

Le verrouillage

• Automatique : dès qu’une plaque a quelque chose à signaler (volée, avis de recherche, mandat, propriétaire recherché…), sa caméra se fige sur elle, avec l’alerte visible, pendant 30 secondes (Config.PlateReader.autoLockSeconds) ou jusqu’à ce que l’agent déverrouille. Le compte à rebours s’affiche sur la caméra (« Verrouillée · 24 s »). Les autres véhicules continuent d’être lus en arrière-plan, sans remplacer l’affichage. Une plaque sans rien à signaler ne verrouille rien, et une plaque déverrouillée ne se reverrouille pas seule tant qu’elle reste en vue.
• Manuel : l’agent verrouille ou déverrouille chaque caméra depuis le menu SuperMDT (Verrouiller la caméra avant, … arrière), ou avec ses propres touches (« Lecteur de plaques SuperMDT : verrouiller la caméra avant / arrière », aucune touche par défaut). Un verrou manuel dure jusqu’au déverrouillage. Une pastille Verrouillée avec un cadenas le signale sur la caméra.

État d’une caméra	Ce que ça veut dire
En attente	La plaque vient d’être lue, le MDT la vérifie.
En règle	Rien à signaler pour cet agent.
Plaque signalée (carte rouge)	La plaque est signalée : les motifs s’affichent sur la caméra, en plus de la notification rouge, du son et du raccourci vers la fiche.
Aucun véhicule	Cette caméra n’a encore rien lu depuis l’activation.
Nouvel essai…	Le MDT n’a pas répondu ; la plaque est relue un peu plus tard.
Plaque illisible	Le véhicule vu n’a pas de plaque lisible.

Une plaque déjà vérifiée n’est pas redemandée au MDT : la caméra affiche tout de suite le résultat gardé par la passerelle (2 minutes pour une plaque propre, dans tout le service). La même plaque vue par les deux caméras n’est envoyée qu’une fois. Une plaque propre n’écrit jamais rien en base.

Dès que la situation d’une plaque change dans le MDT (véhicule déclaré volé ou retrouvé, avis de recherche, mandat d’arrêt ou avis de recherche sur le propriétaire, plaque ou propriétaire modifiés), le serveur de jeu l’oublie en quelques secondes : elle est relue au passage suivant. Changer les motifs d’un service vide tout ce qui était gardé.

Si l’activation est impossible, un message court dit pourquoi (« Lecteur impossible à activer : … ») :

Motif affiché	Que faire
prends ton service dans un service équipé	Prends ton service ; vérifie que ton service a le lecteur actif.
ton service l’a coupé	Réglage Lecteur intégré du service, dans Configuration › Opérations.
tu n’as pas la permission	Il faut Lecteur de plaques › Utiliser en jeu.
monte dans un véhicule de patrouille	L’agent est à pied.
place-toi au volant (ou « au volant ou à l’avant »)	Mauvais siège.
réservé aux véhicules d’urgence	Véhicule civil : ajoute les voitures banalisées à allowedModels.
véhicule non autorisé	Avec strictModels = true, seul un modèle de allowedModels est accepté.
sers-toi du radar Wraith ARS 2X	Wraith est installé : c’est lui qui lit les plaques.
désactivé sur ce serveur	Lecteur coupé dans la ressource (Config.PlateReader).
indisponible pour ton organisation	Lecteur de plaques en jeu n’est pas activé dans Configuration › Jeu › Intégrations.
ton métier n’est relié à aucun service	Relie le job dans Configuration › Jeu › Jobs et services.
lie d’abord ton compte au MDT	Voir Comptes et personnages.
refusé par le MDT, réessaie plus tard	Le MDT a refusé la dernière lecture : plus rien n’est envoyé pour ce joueur pendant 5 minutes (deniedTtlSeconds).

Quand l’agent sort du véhicule, le motif est « tu es sorti du véhicule ». D’autres messages courts : « active d’abord le lecteur de plaques » (verrouiller une caméra lecteur coupé), « aucune plaque lue par cette caméra » (rien à verrouiller), « aucune plaque signalée récemment à ouvrir » (touche de la fiche sans alerte récente). La commande /supermdt_plate_sound confirme « son des alertes de plaque coupé » ou « rétabli ».

Le lecteur se coupe tout seul, avec le motif, quand l’agent sort du véhicule, change de siège ou quitte son service. Ses caméras et ses verrous repartent alors de zéro.

• Activation automatique : avec Config.PlateReader.autoOn = true, le lecteur s’active seul quand l’agent monte au bon siège d’un véhicule de patrouille. Le couper (menu ou touche) le laisse coupé jusqu’au véhicule suivant. Désactivé par défaut.
• Déplacer le panneau : dans la disposition du HUD (menu SuperMDT, ou /mdthud), avec les autres éléments SuperMDT. La place est retenue sur le PC du joueur ; la place par défaut se règle avec Config.PlateReader.panel.

Les touches

Action	Touche par défaut	Aussi dans le menu SuperMDT
Activer ou couper le lecteur	aucune	oui
Verrouiller ou déverrouiller la caméra avant	aucune	oui
Verrouiller ou déverrouiller la caméra arrière	aucune	oui
Ouvrir la fiche du véhicule signalé	Page haut (20 s après l’alerte)	oui (Ouvrir la dernière alerte, 10 min)

Chaque joueur attribue ou change ses touches dans Paramètres › Raccourcis clavier › FiveM ; les textes du jeu affichent toujours la touche qu’il a choisie.

La trace dans la fiche du véhicule

Une plaque signalée laisse une ligne dans la section Lecteur de plaques de la fiche du véhicule : les motifs, la période, qui l’a lue, par le Radar Wraith ou le Lecteur intégré, et le lieu sur la carte (Voir sur la carte). Les 20 derniers passages sont affichés.

Capture à venirplate-reader-history

La section Lecteur de plaques d’une fiche véhicule

• Les lectures rapprochées de la même plaque (dans le délai de fusion du service) prolongent la même ligne au lieu d’en ajouter une.
• Une plaque propre n’écrit rien, jamais.
• Une plaque inconnue du MDT ne laisse pas de trace : il n’y a pas de fiche où l’écrire.
• Sans Garder une trace, rien n’est écrit, même pour une plaque signalée.

Wraith ARS 2X ou lecteur intégré : qui peut s’en servir, où

	Wraith ARS 2X (wk_wars2x, gratuit, licence MIT)	Lecteur intégré de la passerelle
Quand	Dès que Wraith est démarré sur le serveur	Seulement sans Wraith (sauf builtinWithWraith = true, déconseillé)
Véhicule	Les règles de Wraith : véhicule d’urgence (classe 18 de GTA)	Véhicule d’urgence (classe 18) ou modèle de Config.PlateReader.allowedModels (voitures banalisées), avec emergencyOnly = true
Siège	Conducteur ; passager avant si la config de Wraith le permet (allow_passenger_view)	Conducteur ; passager avant seulement si Config.PlateReader.allowPassenger et le réglage du service le permettent
Lecture	Les caméras avant et arrière de Wraith	Deux caméras, avant et arrière : le véhicule devant et celui derrière, jusqu’à 40 m (range), toutes les 500 ms (scanIntervalMs) tant que l’agent a activé le lecteur (menu SuperMDT, ou sa touche)
Affichage	L’écran de Wraith	Le panneau du lecteur intégré : deux caméras côte à côte (plaque, modèle, état, dernière plaque gardée, verrou)
Ce que la passerelle ajoute	En service, service avec lecteur actif, permission Utiliser en jeu	Les mêmes
Prise en charge	Vérifié sur le code	Testé en jeu

• Wraith n’est jamais contourné : ses propres règles s’appliquent d’abord. La passerelle écoute ses événements (wk:onPlateScanned, wk:onPlateLocked) et ajoute les siennes.
• Verrouillage automatique : Config.PlateReader.wraithLockOnHit verrouille la plaque dans Wraith quand elle est signalée. Désactivé par défaut : la réponse de SuperMDT arrive après coup, et la plaque affichée par Wraith peut avoir changé entre-temps.
• Ce que le serveur revérifie : le siège, toujours. La classe du véhicule (classe 18) n’est lisible que chez le joueur ; avec strictModels = true, le serveur vérifie aussi le modèle, et seuls les modèles de allowedModels sont acceptés.

Voitures banalisées

Une voiture banalisée n’est souvent pas de classe 18. Ajoute son modèle à Config.PlateReader.allowedModels (par exemple { 'police4', 'fbi', 'fbi2' }) pour que le lecteur intégré y fonctionne.

Réglages de la passerelle

Dans config_shared.lua, Config.PlateReader :

Réglage	Rôle	Défaut
enabled	Le lecteur de plaques côté serveur de jeu	activé
builtin	Le lecteur intégré (false : Wraith seulement)	activé
builtinWithWraith	Lecteur intégré même avec Wraith (double lecture)	désactivé
emergencyOnly	Véhicules d’urgence et allowedModels seulement	activé
allowedModels	Modèles autorisés en plus des véhicules d’urgence	aucun
strictModels	Seulement les modèles de allowedModels, vérifiés aussi par le serveur	désactivé
allowPassenger	Le passager avant peut lire (si le service l’autorise aussi)	activé
range	Portée devant le véhicule, en mètres	40
scanIntervalMs	Lecteur activé : une lecture toutes les…	500 ms
key	Touche par défaut qui active ou coupe le lecteur (supermdt_plate_toggle) ; aussi dans le menu SuperMDT	aucune
autoOn	Activer le lecteur en montant dans un véhicule de patrouille	désactivé
autoLockSeconds	Durée du verrouillage automatique d’une caméra sur une plaque signalée (0 : jamais)	30 s
lockFrontKey, lockRearKey	Touches par défaut du verrouillage de chaque caméra	aucune
panel	Place par défaut du panneau (position, offset en pixels) ; chaque joueur la change dans la disposition du HUD	en bas au centre, 32 px du bord
alertSound	Son d’alerte	activé
openKey	Touche par défaut de supermdt_plate_open	PAGEUP (Page haut)
openWindowMs	Cette touche ouvre la fiche pendant… après l’alerte	20 s
menuRecordMinutes	« Ouvrir la dernière alerte » reste dans le menu pendant…	10 min
wraithLockOnHit	Verrouiller la plaque dans Wraith sur alerte	désactivé

Dans config.lua, Config.PlateReaderServer règle le cache et les limites :

Réglage	Rôle	Défaut
perPlayerMs	Une lecture envoyée par joueur au plus toutes les…	1,5 s
batchWindowMs	Les lectures partent ensemble après ce délai (16 au plus par envoi)	750 ms
cleanTtlSeconds	Une plaque propre n’est pas redemandée, pour tout le service, pendant… (oubliée plus tôt si elle change dans le MDT)	2 min
hitTtlSeconds	Une plaque signalée n’est pas redemandée, pour cet agent, pendant…	60 s
deniedTtlSeconds	Après un refus (permission, hors service…), plus rien n’est envoyé pour ce joueur pendant…	5 min
maxPerMinute	Lectures envoyées par minute pour tout le serveur	120

Permissions

Permission	Ce qu’elle permet	Par défaut
Lecteur de plaques › Utiliser en jeu	Recevoir les alertes en jeu, en service	tous les grades
Lecteur de plaques › Régler le lecteur	La carte Lecteur de plaques de Configuration › Opérations	commandement

Elles se trouvent sous le module Véhicules de la matrice des permissions, et n’y apparaissent que si l’intégration au jeu est activée.

Dépannage

Ce que tu vois	Cause	Que faire
Aucune alerte, jamais	Lecteur non activé pour l’organisation ou pour le service, module Véhicules absent, agent hors service ou sans Utiliser en jeu	Vérifie les deux interrupteurs et la permission.
Rien ne s’affiche en choisissant « Activer le lecteur »	Lecteur intégré coupé côté serveur de jeu (builtin = false), ou l’entrée absente du menu (hors service, service sans lecteur)	Vérifie Config.PlateReader et ton service ; sinon, le message affiché dit pourquoi le lecteur ne s’active pas.
Le lecteur intégré ne lit rien dans une voiture banalisée	Le véhicule n’est pas de classe 18	Ajoute le modèle à allowedModels.
Le passager ne reçoit rien	Passager interdit par le service, par allowPassenger ou par la config de Wraith	Autorise-le aux trois endroits.
Une plaque volée ne déclenche rien	Motif non coché dans le service, ou l’agent n’a pas Voir les véhicules	Coche le motif, vérifie la permission.
Pas de ligne dans la fiche	Plaque inconnue du MDT, ou Garder une trace décoché	Normal dans le premier cas.

Dans la console du serveur, supermdt status (ligne « Lecteur de plaques ») dit si le lecteur est actif (et sinon pourquoi), son mode (Wraith, ou lecteur intégré activé par l’agent ou automatiquement), le nombre de services où il est actif, et compte les lectures, les envois, le cache, les alertes et les refus.