Installation

Ce guide couvre l'installation de lo_mdtbf sur un serveur RedM sous VORP.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Un serveur RedM fonctionnel avec le framework VORP.
• Les ressources vorp_core, vorp_inventory et oxmysql installées et démarrées.
• Une base de données MySQL/MariaDB connectée via oxmysql.
• Les trois objets du MDT déclarés dans vorp_inventory.items : mdt_bf, official_warrant, official_prescription.

1. Ajouter la ressource

Placez le dossier lo_mdtbf dans votre dossier resources/ (par exemple resources/[scripts]/lo_mdtbf), puis ajoutez-le à votre server.cfg (voir l'ordre de démarrage ci-dessous).

2. Base de données

L'installation du schéma est automatique. Au démarrage de la ressource, server/database.lua lit sql/install.sql via LoadResourceFile et exécute chaque instruction. Vous n'avez aucun import manuel à effectuer.

Tables créées (préfixe lo_mdtbf_) :

• lo_mdtbf_citizens — registre des citoyens
• lo_mdtbf_reports — rapports (et casiers de prison via le champ jail)
• lo_mdtbf_notes — notes attachées aux citoyens
• lo_mdtbf_mandats — mandats
• lo_mdtbf_ordonnances — ordonnances / contrats judiciaires
• lo_mdtbf_enquetes — enquêtes
• lo_mdtbf_effectifs — fiches du personnel (FDO)

NOTE

Le script tente d'abord de renommer d'anciennes tables jo_mdt_* vers lo_mdtbf_* (migration depuis une version antérieure). Si ces tables n'existent pas, l'erreur est ignorée silencieusement — c'est normal lors d'une première installation. La console affiche un récapitulatif du type Database ready - N statement(s) ok, M failed, où les échecs correspondent aux migrations déjà appliquées.

3. Ordre de démarrage

Démarrez lo_mdtbf après ses dépendances. Dans votre server.cfg :

ensure vorp_core
ensure vorp_inventory
ensure oxmysql
ensure lo_mdtbf

4. Configurer les jobs

Par défaut, le MDT n'est ouvrable que par une liste de métiers (jobs) prédéfinis. Adaptez Config.AllowedJobs (ouverture) et Config.AllowedJobsManage (création/édition/suppression) aux jobs de votre serveur.

Reportez-vous à la page Configuration pour le détail des jobs, des postes (stations) et des grades.

5. Interface (UI)

Aucune compilation n'est nécessaire : l'interface NUI (Vue 3) est déjà fournie pré-buildée dans web/dist/. La ressource pointe directement sur web/dist/index.html. Vous n'avez pas besoin d'installer Node.js ni de lancer npm run build.

Vérification

1. Démarrez le serveur et vérifiez la console : un message [lo_mdtbf] Database ready - ... doit apparaître.
2. Connectez-vous avec un personnage dont le job figure dans Config.AllowedJobs.
3. Utilisez l'objet mdt_bf (ou la commande /mdtbf) pour ouvrir le MDT.

WARNING

Avec Config.DevMode = true (valeur par défaut), la vérification d'être en service (on-duty) est ignorée côté serveur : seul le job est vérifié. C'est pratique pour les tests, mais en production il faut passer Config.DevMode = false pour que seuls les agents en service puissent ouvrir le MDT.