Instalación

Antes de empezar#

Antes de instalar Tutorial Creator, asegúrate de que tu servidor cumple los requisitos mínimos. Solo es obligatorio un recurso de base de datos; todo lo demás es opcional y se detecta solo.

Cada capa se busca en este orden, y gana la primera que se encuentre en ejecución:

Nada de esto necesita ox_lib. Cada línea específica del framework vive en la carpeta abierta custom/, así que si falta una integración, solo esa parte funciona en modo standalone.

Descargar Tutorial Creator#

Después de comprar Tutorial Creator, el recurso se vincula automáticamente a tu cuenta de CFX Portal.

Inicia sesión en CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Tutorial Creator.

Después de extraer la descarga, deberías tener la siguiente carpeta:

qs-tutorial/
├── shared/config.lua    -- the config
├── custom/              -- framework layer and notifications (yours to edit)
├── presets/             -- the eight bundled tutorials, as JSON
├── locales/             -- 41 translations
├── images/              -- portraits, logos, slides
├── videos/              -- WebM clips
├── audio/               -- music and sound
├── database/sql.sql     -- the schema, if you prefer to import it by hand
└── client/ server/ web/ -- the resource itself

Mantén el nombre de la carpeta qs-tutorial. Cada export y evento que llaman tus otros scripts está escrito como exports['qs-tutorial'] y qs-tutorial:…, y los scripts de multipersonaje buscan exactamente ese nombre.

Instalar el recurso#

Mueve la carpeta qs-tutorial al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:

resources/
└── [qs]/
    └── qs-tutorial/

Una vez copiada, abre tu server.cfg y asegúrate de que la base de datos, tu framework y tus pantallas de personaje se inician antes de Tutorial Creator:

ensure oxmysql

# Framework (one of them)
ensure qb-core
# ensure qbx_core
# ensure es_extended
# ensure qs-core

# Optional
ensure ox_lib
ensure qb-multicharacter
ensure qb-spawn

ensure qs-tutorial

El orden de carga importa para la base de datos: el driver se busca cuando el recurso se inicia, y si en ese momento no está en ejecución ni oxmysql ni mysql-async, no se puede guardar nada. La detección del framework es más tolerante — con Config.Framework = 'auto', un framework que se inicia tarde se detecta unos segundos después — pero iniciarlo primero sigue siendo la configuración limpia.

La base de datos#

No tienes que importar nada. En cada inicio, Tutorial Creator ejecuta CREATE TABLE IF NOT EXISTS para sus tres tablas. database/sql.sql contiene las mismas sentencias en SQL plano — pégalo en HeidiSQL o phpMyAdmin si tu usuario de base de datos no tiene permiso para crear tablas.

Los ocho tutoriales incluidos no están en la base de datos. Vienen en presets/ y dentro de la interfaz, así que no hay nada que precargar y la superposición se dibuja correctamente incluso antes de que el cliente haya hablado con el servidor. Las tablas solo contienen lo que creas tú.

Quién puede abrir el creador#

Cualquiera puede ver el tutorial, pero /tutorialcreator — donde se crean los tutoriales y se activan — es para el staff. Cualquiera de estas opciones lo concede:

add_ace group.admin command.tutorialcreator allow
add_principal identifier.license:your_license_here group.admin

Config.Creator = {
    command = 'tutorialcreator',
    permission = 'command.tutorialcreator',
    adminGroups = { 'admin', 'superadmin', 'god' },
}

El permiso se comprueba una vez por sesión, la primera vez que el jugador escribe el comando. Alguien a quien se le da acceso mientras está conectado debe reconectarse para que funcione.

Configurar el recurso#

La configuración es corta a propósito — el tutorial en sí, sus cámaras, su aspecto y su comportamiento viven en el creador. Lo que puedes abrir y editar:

Los valores que conviene revisar primero:

Config.Language = 'en'      -- any file in locales/
Config.Framework = 'auto'   -- 'auto' | 'qs' | 'esx' | 'qb' | 'standalone'

Config.Tutorial = {
    command = 'tutorial',            -- plays the live tutorial on demand
    resetCommand = 'resettutorial',  -- forgets what this character has watched
    autoStart = true,                -- play it by itself on first spawn
    autoStartDelay = 5000,           -- ms after spawn (and after the spawn screens close)
    defaultTutorial = 'welcome',     -- used until you set one live
    updateInterval = 250,            -- ms between player data pushes while it plays
    enableControlsWhenFocus = false, -- let the game keep reading keys during it
}

Config.Cinematic = {
    focusStreaming = true,  -- load the world at the camera. Leave this on.
    teleportPlayer = false, -- also move the ped to each shot. Rarely needed.
    streamWait = 900,       -- ms a shot may spend loading between steps
    maxStreamWait = 8000,   -- ms for the first shot, hidden by the fade
    restoreWeather = true,  -- put the weather back when it ends
    restoreTime = true,     -- put the clock back when it ends
}

Config.Server = {           -- read by text elements bound to these values
    name = 'Quasar Roleplay',
    discord = 'discord.gg/quasar-store',
    website = 'quasar-store.com',
}

Config.MaxTutorials = 45    -- how many may be saved; the bundled ones do not count
Config.Debug = false        -- print what the resource is doing

Si un tutorial se reproduce solo una vez, se puede saltar o congela al jugador se define por tutorial, en la pestaña Settings del creador — no en este archivo. Config.Hud y Config.Actions se explican en Integraciones y Uso.

Verificar la instalación#

Después de completar la instalación, reinicia tu servidor y lee la consola. Dos líneas confirman las capas que eligió:

[qs-tutorial] framework loaded: qb
[qs-tutorial] storage driver: oxmysql

framework loaded: standalone significa que no se encontró ningún framework — correcto en un servidor standalone, un problema de orden de carga en otro caso. Un no database resource found en rojo significa que no se guardará nada; consulta Errores comunes.

Luego entra a tu servidor y recorre el primer ciclo:

1. Míralo como jugador

   Un personaje nuevo recibe el tutorial activo unos segundos después de aparecer — Welcome to the city hasta que elijas otro. En un personaje que ya lo ha visto, /tutorial lo reproduce bajo demanda.

2. Abre el creador

   /tutorialcreator se abre en el selector: los ocho tutoriales incluidos, todo lo que hayas guardado y Start from nothing.

3. Hazlo tuyo y actívalo

   Elige uno, cambia una línea de narración, pulsa Save y luego Set live. Todos los jugadores conectados tienen la nueva versión al instante.

A partir de aquí nada necesita reinicio. Cada cámara, línea, elemento y ajuste se cambia en el creador y se envía a los jugadores en cuanto se guarda. La única excepción son los archivos multimedia: los que añadas a images/, videos/ o audio/ necesitan reiniciar el recurso para poder servirse.