Instalación

Antes de empezar#

Antes de instalar MLO Creator, asegúrate de que tu servidor cumple los requisitos mínimos. Tres cosas son obligatorias; tu framework es opcional y se detecta solo.

Sin ESX, QBCore ni Qbox, el script funciona en modo standalone y usa permisos ACE para decidir quién es admin. Todo lo demás del script funciona igual.

Descargar MLO Creator#

MLO Creator se entrega a través del CFX Portal. Inicia sesión con la cuenta de Cfx.re con la que compraste el script, abre Granted Assets y descarga la última versión.

La descarga es una sola carpeta [mlocreator]. Cada pieza dentro de ella tiene una función:

[mlocreator]/
├── qs-mlocreator/        -- the script itself
├── qs_mlotextures/       -- texture pack used by every interior you build
├── [maps]/               -- ships empty: every map you build lands here
└── [sql]/
    └── database.sql      -- optional, the tables are created automatically

-- created on the first start, never part of a download:
└── qs-mlocreator-data/   -- editor base interiors and a copy of every export

No cambies el nombre de qs-mlocreator ni de qs_mlotextures. La interfaz, los permisos y cada interior exportado se refieren a ellos por su nombre.

Instalar el recurso#

Coloca toda la carpeta [mlocreator] en tu directorio resources, tal como viene:

resources/
├── [ox]/
│   ├── ox_lib/
│   └── oxmysql/
├── [framework]/          -- es_extended, qb-core or qbx_core (optional)
└── [mlocreator]/
    ├── qs-mlocreator/
    ├── qs_mlotextures/
    └── [maps]/

Luego abre tu server.cfg y añade los permisos y la línea ensure después de ox_lib, oxmysql y tu framework:

ensure ox_lib
ensure oxmysql
ensure es_extended          # or qb-core / qbx_core, if you use one

# MLO Creator starts and stops the maps you build while the server runs.
# It needs these five permissions to do it.
add_ace resource.qs-mlocreator command.ensure allow
add_ace resource.qs-mlocreator command.start allow
add_ace resource.qs-mlocreator command.stop allow
add_ace resource.qs-mlocreator command.restart allow
add_ace resource.qs-mlocreator command.refresh allow

ensure [mlocreator]

El orden de carga importa. ensure [mlocreator] inicia el script, el pack de texturas y cada mapa que ya hayas construido, así que los tres deben ir después de sus dependencias.

La base de datos#

No tienes que importar nada. En el primer inicio el script crea sus dos tablas por sí solo. El mismo SQL viene en [sql]/database.sql por si prefieres ejecutarlo tú mismo con HeidiSQL o cualquier otro cliente.

Como los ajustes y los proyectos viven en la base de datos, actualizar el script nunca borra tu trabajo ni tus ajustes.

Obtener el acceso de administrador#

Solo los admins pueden abrir el estudio. Quién cuenta como admin depende del framework que detectó el script:

-- custom/esx/server.lua
return player.getGroup() == 'admin' or player.getGroup() == 'superadmin'

-- custom/qb/server.lua
return QBCore.Functions.HasPermission(source, 'god')
    or IsPlayerAceAllowed(source, 'command')
    or QBCore.Functions.HasPermission(source, 'admin')

add_principal identifier.license:YOUR_LICENSE group.admin
add_ace group.admin command allow

Para usar otra regla — un trabajo, un permiso personalizado, una lista de identificadores — edita playerIsAdmin en qs-mlocreator/custom/<framework>/server.lua. Cada acción de cada herramienta pasa por esa única función.

Configurar el recurso#

Casi nada se configura en archivos. La cámara, el gizmo, cada herramienta, los recursos de mapa, la construcción y el idioma viven en el panel Settings del juego (el engranaje en la cabecera del estudio), cada campo con su propia explicación. Los pocos archivos que puedes tocar:

-- config/main.lua
Config.Locale = 'en'   -- language used until the database answers with the one chosen in game

Cada ajuste guardado en el juego llega a todos los jugadores al instante. Solo el comando, la tecla de apertura, la tecla del cursor y la tecla de vaciado de la construcción necesitan un restart qs-mlocreator — el panel te avisa cuándo.

Verificar la instalación#

Inicia el servidor y observa la consola. Un inicio correcto imprime el framework elegido:

[INFO] Successfully loaded the framework. esx    # or qb / standalone

Si en cambio ves un bloque rojo de líneas add_ace que se repite, falta uno de los cinco permisos de arriba. Después entra en el juego:

1. Abre el estudio

   Entra como admin y escribe /mlocreator. El estudio se abre con una tarjeta por herramienta.

2. Configura tu idioma y tus teclas

   Pulsa el engranaje de la cabecera. Elige un idioma y, si quieres, una tecla para abrir el estudio.

3. Construye tu primer mapa

   Sigue el tablero Where to start del estudio, o lee Uso.

Actualizar#

Reemplaza qs-mlocreator y qs_mlotextures con la nueva versión y reinicia. Si editaste config/, custom/ o locales/, vuelve a copiar tus cambios después.

Haz una copia de seguridad de la base de datos, [maps] y qs-mlocreator-data a la vez. Restaurados juntos, lo recuperan todo.