Impression en jeuNouveau

Dans la tablette en jeu, le menu Exporter d’une fiche propose en plus Imprimer en jeu. L’agent reçoit un objet d’inventaire « document » : la feuille imprimée, avec son titre, son numéro, son émetteur et son service.

• Utiliser l’objet affiche la feuille à l’écran (une image par page, « 1 / 3 » quand il y en a plusieurs ; flèches ← → ou boutons pour changer de page).
• Pour lire un détail, zoome jusqu’à 400 % : molette (centrée sur le curseur), boutons − / + / Ajuster sous la feuille, touches +, − et 0, double-clic (ajustée ↔ 200 %) ou pincement sur un écran tactile. Zoomée, la feuille se déplace en maintenant le clic. Le pourcentage s’affiche à côté des boutons ; chaque changement de page repart ajusté à la fenêtre.
• Depuis la feuille, Montrer la fait voir au joueur le plus proche (3 m) sans lui donner l’objet ; Donner fait passer l’objet au joueur le plus proche (2 m).
• Le code de vérification d’un document émis figure au bas de la feuille : n’importe quel service peut le vérifier.

La feuille se ferme avec Fermer ou Échap. Un joueur à qui on la montre voit « On te montre ce document », sans Montrer ni Donner.

Un script d’imprimante à la place

Si ton serveur a déjà un script d’imprimante qui imprime une image à partir d’un lien, le même menu Exporter propose Copier le lien de l’image (un lien par page) : voir Export PDF et image. Aucun objet SuperMDT n’est alors nécessaire.

Activer l’impression

1. Dans le module Documents, onglet Réglages (permission « Régler les documents »), active Autoriser l’impression en jeu.
2. Indique le Nom de l’objet d’inventaire : supermdt_document par défaut, ou un nom propre au service (police_report…).
3. Déclare cet objet dans l’inventaire de ton serveur (ci-dessous).
4. Chaque agent qui doit imprimer a besoin de « Imprimer en jeu » dans son grade (donnée à tous par défaut).

Capture à venirdocument-print-settings

Le réglage de l’impression du service

L’impression demande l’intégration au jeu et la passerelle 0.7.0 ou plus.

Inventaires pris en charge

Inventaire	Statut
ox_inventory (ESX, QBCore, Qbox)	Vérifié sur le code
qb-inventory (QBCore)	Testé en jeu
ps-inventory	Expérimental
qs-inventory	Expérimental
codem-inventory	Expérimental
Inventaire d’ESX sans ox_inventory	Non pris en charge (pas d’objets avec informations)

Testé en jeu essayé en jeu sur un vrai serveur. Vérifié sur le code écrit d’après le code source de l’inventaire, pas encore essayé en jeu. Expérimental écrit d’après la documentation de l’éditeur, pas encore essayé sur un vrai serveur.

Déclarer l’objet

L’objet doit être unique (jamais empilé) : chaque feuille garde ses informations.

ox_inventory (ox_inventory/data/items.lua) :

['supermdt_document'] = {
    label = 'Document',
    weight = 10,
    stack = false,
    close = true,
    consume = 0,
    description = 'Document imprimé depuis la tablette SuperMDT',
    server = { export = 'supermdt-bridge.useDocument' },
},

qb-inventory, ps-inventory (qb-core/shared/items.lua) :

supermdt_document = { name = 'supermdt_document', label = 'Document', weight = 10, type = 'item', image = 'supermdt_document.png', unique = true, useable = true, shouldClose = true, description = 'Document imprimé depuis la tablette SuperMDT' },

qs-inventory, codem-inventory : même déclaration, dans leur propre liste d’objets. Fournis une image supermdt_document.png dans le dossier d’images de ton inventaire, puis démarre la passerelle après l’inventaire.

Attention

L’image d’une feuille imprimée est lisible par son lien court (dix caractères aléatoires, impossibles à deviner) : c’est ce qui permet de l’afficher en jeu à qui la reçoit. N’imprime donc que ce que tu acceptes de remettre à un joueur, notamment un document médical.

Une feuille imprimée n’expire pas : SuperMDT ne sait pas si l’objet est encore dans un inventaire. Elle reste révocable dans Documents › Liens publics (par l’agent qui l’a imprimée, « Régler les documents » ou un administrateur) : l’objet reste alors en jeu mais sa feuille ne s’affiche plus. Elle cesse aussi de s’afficher si la fiche d’origine est archivée ou si l’organisation est suspendue. Une impression jamais réclamée en jeu meurt après 10 minutes.

Ce que voit l’agent

Dans la tablette, après Imprimer en jeu : « Document imprimé : regarde ton inventaire », ou une erreur.

Message	Cause	Que faire
« L’impression en jeu est désactivée pour ce service. »	Autoriser l’impression en jeu est coupé	Active-le dans Documents › Réglages.
« L’inventaire du serveur ne gère pas les objets avec informations. »	Aucun inventaire compatible détecté (ESX sans ox_inventory…)	Voir les inventaires pris en charge.
« Ton inventaire est plein. »	Pas de place pour la feuille	Libère de la place, puis relance.
« Attends un instant avant d’imprimer de nouveau. »	Une impression par joueur toutes les 4 secondes (et une par seconde pour tout le serveur)	Patiente.
« L’impression a expiré : recommence. »	Le code d’impression (10 minutes) n’est plus valable	Relance depuis la tablette.
« L’impression en jeu n’est pas disponible ici. »	Page ouverte hors de la tablette, passerelle ancienne ou impression coupée côté serveur (Config.Documents.enabled)	Imprime depuis la tablette en jeu ; mets la passerelle à jour.

En jeu, avec la feuille : « Personne n’est assez près de toi. » (Montrer ou Donner sans joueur dans le rayon), « L’inventaire de l’autre personne est plein : tu gardes le document. », « Tu n’as plus ce document sur toi. » (l’objet a quitté l’inventaire), et chez celui qui reçoit : « On t’a donné un document : … ».

Réglages de la passerelle

Dans config.lua, Config.Documents :

Réglage	Rôle	Défaut
enabled	L’impression côté serveur de jeu (false : coupée, quoi que dise SuperMDT)	activé
item	Le nom de l’objet par défaut ; les noms réglés par les services dans SuperMDT sont aussi rendus utilisables	supermdt_document
showDistance	Rayon de Montrer, en mètres	3
giveDistance	Rayon de Donner, en mètres	2
cooldownMs	Une impression par joueur au plus toutes les…	4 s
globalRate	Impressions par seconde pour tout le serveur (pointe : le double)	1
actionCooldownMs	Utiliser, Montrer, Donner : une action par joueur toutes les…	1,5 s

Au démarrage, la passerelle vérifie que l’objet est bien déclaré dans l’inventaire : sinon, supermdt log le signale (« l’objet … n’est pas déclaré dans … »).

Sécurité

• Le joueur ne fait que demander : le serveur de jeu réclame l’impression à SuperMDT avec sa licence et un code à usage unique (10 minutes), créé par le même membre.
• SuperMDT vérifie avant tout que l’agent voit l’objet, comme pour un export, et inscrit l’impression au journal d’audit.
• Montrer et donner relisent l’objet dans l’inventaire côté serveur et mesurent la distance avec les positions du serveur.

Diagnostic : supermdt status (ligne « Documents imprimés »), supermdt log.