MLO d'entreprise FiveM + script de job : guide de compatibilité et de configuration

Une entreprise FiveM nécessite généralement deux couches distinctes : un MLO fournit le bâtiment, les pièces et la collision ; un script de job fournit les employés, l'artisanat, la facturation, le stock, les ventes et la gestion. Acheter les deux ne garantit pas qu'ils fonctionnent ensemble. La compatibilité dépend de votre framework et des autres ressources qui les relient.

Matrice de compatibilité rapide

Couche	Ce qu'il faut vérifier	Incompatibilité courante
MLO	Coordonnées, portes, collision et conflits de carte	Une autre carte modifie le même emplacement
Framework	Prise en charge ESX, QBCore, Qbox ou standalone	Une mention QBCore est considérée comme une preuve de prise en charge de Qbox
Inventaire	Définitions d'objets, images, métadonnées et exports	Le script attend une API d'inventaire différente
Interaction	Ressource de ciblage, zones, marqueurs ou indications de touches	Les points d'interaction sont conçus pour un autre système de ciblage
Fonctionnement de l'entreprise	Grades de job, prise de service, facturation, compte de société et menu du patron	Les noms de grade ou les identifiants de compte ne correspondent pas
Base de données	Modifications SQL, propriété et persistance	Les tables sont importées sans plan de sauvegarde ni de migration

1. Choisissez le lieu et le gameplay séparément

Commencez par la boucle de roleplay : mécanicien, restaurant, café, concessionnaire, boîte de nuit ou autre entreprise de joueur. Choisissez ensuite la carte et le script indépendamment. Un intérieur soigné ne fournit pas de recettes ni de factures, et un script de job complet ne déplace pas automatiquement ses points d'interaction dans un bâtiment personnalisé.

2. Lisez les manifestes de ressources et les listes de dépendances

Ouvrez chaque fichier livré fxmanifest.lua avant d'ajouter la ressource à server.cfg. Le manifeste peut identifier les scripts, les fichiers et les dépendances, tandis que la documentation du créateur doit indiquer le framework, l'inventaire, la cible, le menu, la notification, l'audio et les ressources de base de données requis. Utilisez la référence officielle du manifeste de ressources Cfx.re lorsqu'une directive n'est pas claire.

Pour Qbox, ne supposez pas que chaque ressource QBCore est compatible. Lisez le guide Qbox vs QBCore et exigez une mention de prise en charge native de Qbox ou un chemin de bridge documenté sur le produit concerné.

3. Installez d'abord le MLO

1. Sauvegardez le serveur et la base de données, puis créez une copie de préproduction.
2. Démarrez uniquement le MLO et ses dépendances de carte documentées.
3. Vérifiez les entrées, les portes, les collisions, l'éclairage et l'accès des véhicules.
4. Recherchez les ressources YMAP, MLO ou de végétation qui se chevauchent au même endroit.
5. Relevez les coordonnées exactes des comptoirs de service, du stockage, de l'artisanat, de la prise de service et de la gestion.

Cela permet de distinguer un problème de carte d'un problème de script de job. Si le bâtiment ne fonctionne pas seul, l'ajout de ressources de facturation et d'inventaire rend le diagnostic plus difficile.

4. Définissez les jobs, les grades et les comptes

Créez la structure de jobs et de grades attendue par le script. Faites correspondre exactement les noms internes : mechanic et mechanic2 sont des identifiants différents. Décidez quels grades peuvent embaucher, retirer de l'argent, fabriquer des objets restreints ou accéder à la gestion. Si le script utilise un compte de société ou d'entreprise, vérifiez que les dépôts et les retraits atteignent bien ce compte après une reconnexion et un redémarrage de la ressource.

5. Associez l'inventaire, les zones de ciblage et les coordonnées

Ajoutez chaque objet requis à l'inventaire utilisé sur votre serveur, y compris les images et les métadonnées si nécessaire. Remplacez les coordonnées d'interaction par défaut du script par les points relevés à l'intérieur du MLO. Vérifiez ensuite les zones cibles ou les invites de touche à différentes distances et positions de joueur.

Les ressources de restaurant et de pub demandent une attention particulière sur les recettes : les noms des ingrédients, les quantités, les objets produits et les prix de vente doivent correspondre à l'économie en place. Les ressources de mécanicien nécessitent des vérifications de propriété du véhicule, des objets de réparation et de la facturation. Les ressources de concessionnaire nécessitent des apparitions en salle d'exposition, du stock et une validation des achats.

6. Testez le parcours complet du client et de l'employé

• L'employé prend son service et ne peut accéder qu'aux actions autorisées par son grade.
• Le client peut acheter, recevoir une facture ou interagir sans occuper le job d'employé.
• Les objets sont retirés et accordés exactement une fois.
• Les revenus de l'entreprise arrivent sur le bon compte.
• Les inventaires pleins, les actions annulées et les dépendances indisponibles échouent sans danger.
• L'état survit aux reconnexions, aux redémarrages de script et à un redémarrage complet du serveur.
• Deux joueurs utilisant le même poste ne peuvent pas dupliquer le stock ou les récompenses.

Ordre d'installation recommandé

1. Choisissez la boucle commerciale et le framework.
2. Installez le MLO sous licence sur un serveur de test, puis vérifiez qu'il ne provoque aucun conflit de carte.
3. Sélectionnez un script de job prenant explicitement en charge votre framework et votre pile de dépendances.
4. N'ajoutez des ressources de gestion, d'inventaire ou d'interaction que si le job choisi les exige.
5. Effectuez tous les tests en préproduction avant d'importer la configuration en production.

Liste de contrôle finale

Avant l'achat, vous devriez être en mesure de nommer la version du framework, l'inventaire, le système de ciblage, la ressource de gestion, la méthode de compte d'entreprise, les modifications de base de données et l'emplacement sur la carte. Si l'un de ces éléments est inconnu, interrogez le créateur ou choisissez un produit mieux documenté. C'est plus rapide et moins coûteux que de réparer une pile d'entreprise incompatible après le lancement.

Documentation de référence

Source : docs.qbox.re

Guide de compatibilité MLO FiveM : Frameworks, conflits et tests