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 fxmanifest.lua entregado antes de añadir el recurso a server.cfg. El manifiesto puede identificar scripts, archivos y dependencias, mientras que la documentación del creador debería indicar los recursos necesarios de framework, inventario, sistema de interacción (target), menús, notificaciones, audio y base de datos. Consulta la referencia oficial de manifiestos 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
- Haz una copia de seguridad del servidor y de la base de datos, y luego crea una copia de staging.
- Inicia solo el MLO y sus dependencias de mapa documentadas.
- Comprueba las entradas, las puertas, la colisión, la iluminación y el acceso de vehículos.
- Busca recursos YMAP, MLO o de vegetación que se solapen en la misma ubicación.
- 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
- Elige el ciclo de negocio y el framework.
- Instala el MLO con licencia en un servidor de pruebas y comprueba que no tiene ningún conflicto de mapa.
- Selecciona un script de trabajo con soporte explícito para tu framework y tu pila de dependencias.
- Añade recursos de gestión, inventario o interacción solo cuando el trabajo elegido los requiera.
- 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
Guía de compatibilidad de MLO de FiveM: frameworks, conflictos y pruebas