MLO de negocio + script de trabajo en FiveM: guía de compatibilidad y configuración

Un negocio en FiveM normalmente necesita dos capas separadas: un MLO aporta el edificio, las estancias y las colisiones; un script de trabajo aporta empleados, elaboración, facturación, stock, ventas y gestión. Comprar ambos no garantiza que funcionen juntos. La compatibilidad depende de tu framework y de los demás recursos que hay entre ellos.

Matriz rápida de compatibilidad

Capa	Qué verificar	Incompatibilidad común
MLO	Coordenadas, puertas, colisión y conflictos de mapa	Otro mapa edita la misma ubicación
Framework	Compatibilidad con ESX, QBCore, Qbox o standalone	Una etiqueta de QBCore se toma como prueba de compatibilidad con Qbox
Inventario	Definiciones de ítems, imágenes, metadatos y exports	El script espera una API de inventario diferente
Interacción	Recurso de target, zonas, marcadores o avisos de tecla	Los puntos de interacción están escritos para otro sistema de target
Lógica de negocio	Grados de trabajo, servicio, facturación, cuenta de sociedad y menú de jefe	Los nombres de los grados o los identificadores de cuenta no coinciden
Base de datos	Cambios en SQL, propiedad y persistencia	Las tablas se importan sin una copia de seguridad ni un plan de migración

1. Elige el local y la jugabilidad por separado

Empieza por el ciclo de rol: mecánico, restaurante, cafetería, concesionario, discoteca u otro negocio de jugadores. Después elige el mapa y el script de forma independiente. Un interior cuidado no aporta recetas ni facturas, y un script de trabajo completo no traslada sus puntos de interacción a un edificio personalizado de forma automática.

2. Lee los manifiestos de recursos y las listas de dependencias

Abre cada archivo recibido fxmanifest.lua antes de añadir el recurso a server.cfg. El manifiesto puede identificar scripts, archivos y dependencias, mientras que la documentación del creador debe indicar el framework, inventario, objetivo, menú, notificación, audio y recursos de base de datos requeridos. Usa el oficial Referencia del manifiesto de recursos de Cfx.re cuando una directiva no está clara.

En el caso de Qbox, no des por hecho que todos los recursos de QBCore son compatibles. Lee la guía Qbox vs QBCore y exige una declaración de compatibilidad nativa con Qbox o una vía de bridge documentada en el producto concreto.

3. Instala primero el MLO

1. Haz una copia de seguridad del servidor y de la base de datos, y luego crea una copia de staging.
2. Inicia solo el MLO y sus dependencias de mapa documentadas.
3. Comprueba las entradas, las puertas, la colisión, la iluminación y el acceso de vehículos.
4. Busca recursos YMAP, MLO o de vegetación que se solapen en la misma ubicación.
5. Registra las coordenadas exactas de los mostradores de atención, el almacenamiento, el crafteo, el turno y la gestión.

Esto separa un problema del mapa de un problema del script de trabajo. Si el edificio no funciona por sí solo, añadir recursos de facturación e inventario dificulta el diagnóstico.

4. Define trabajos, grados y cuentas

Crea la estructura de trabajos y grados que espera el script. Haz coincidir exactamente los nombres internos: mechanic y mechanic2 son identificadores diferentes. Decide qué grados pueden contratar, retirar dinero, craftear ítems restringidos o acceder a la gestión. Si el script usa una cuenta de sociedad o de negocio, verifica que los depósitos y las retiradas lleguen a esa cuenta después de reconectar y de reiniciar el recurso.

5. Asigna inventario, targets y coordenadas

Añade todos los ítems necesarios al inventario que usas en tu servidor, incluidas las imágenes y los metadatos cuando sea necesario. Sustituye las coordenadas de interacción por defecto del script por los puntos registrados dentro del MLO. Después, verifica las zonas de target o los avisos de tecla desde distintas distancias y posiciones del jugador.

Los recursos de restaurante y pub requieren atención adicional en las recetas: los nombres de los ingredientes, las cantidades, los ítems resultantes y los precios de venta deben coincidir con la economía real. Los recursos de mecánico requieren comprobaciones de propiedad del vehículo, de ítems de reparación y de facturación. Los recursos de concesionario requieren spawns de sala de exposición, stock y validación de compra.

6. Prueba el recorrido completo del cliente y del empleado

• El empleado ficha y solo puede acceder a las acciones permitidas por su grado.
• El cliente puede comprar, recibir una factura o interactuar sin tener el trabajo de empleado.
• Los objetos se retiran y se entregan exactamente una vez.
• Los ingresos del negocio llegan a la cuenta correcta.
• Los inventarios llenos, las acciones canceladas y las dependencias no disponibles fallan de forma segura.
• El estado sobrevive a las reconexiones, a los reinicios de scripts y a un reinicio completo del servidor.
• Dos jugadores que usen la misma estación no pueden duplicar stock ni recompensas.

Orden de configuración recomendado

1. Elige el ciclo de negocio y el framework.
2. Instala el MLO con licencia en un servidor de pruebas y comprueba que no tiene ningún conflicto de mapa.
3. Selecciona un script de trabajo con soporte explícito para tu framework y tu pila de dependencias.
4. Añade recursos de gestión, inventario o interacción solo cuando el trabajo elegido los requiera.
5. Completa las pruebas en staging antes de importar la configuración a producción.

Lista de verificación final

Antes de comprar, deberías poder nombrar la versión del framework, el inventario, el sistema de target, el recurso de gestión, el método de cuenta de negocio, los cambios en la base de datos y la ubicación en el mapa. Si alguno de esos datos es desconocido, pregunta al creador o elige un producto con documentación más clara. Eso es más rápido y más barato que reparar una pila de negocio incompatible después del lanzamiento.

Documentación de referencia

Fuente: docs.qbox.re

Guía de compatibilidad de MLO de FiveM: frameworks, conflictos y pruebas