Antes de empezar#
Antes de instalar Loading Screen Creator, comprueba qué necesita tu servidor. La respuesta corta es nada: una pantalla de carga tiene que dibujarse antes que cualquier otro recurso, así que no depende de ninguno.
Requisito | Estado | Notas |
|---|---|---|
oxmysql | No necesario | Los temas se guardan en un archivo dentro del recurso, no en una base de datos. |
ox_lib | No necesario | Se usa para las notificaciones del creador solo cuando está en ejecución. |
Framework | Opcional | ESX, QBCore, Qbox o qs-core — detectado automáticamente. También funciona en standalone. |
Artifacts del servidor | Recientes | El creador lista tu música, vídeos e imágenes con una función del servidor que no tienen las builds muy antiguas. En ellas, los desplegables de medios quedan vacíos. |
Al framework solo se le hacen dos preguntas: si un jugador es administrador y cómo mostrarle una notificación. Todo lo que ve un jugador durante la carga funciona igual con o sin framework.
Descargar Loading Screen Creator#
Loading Screen Creator se entrega a través de tu cuenta de CFX Portal.
Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Loading Screen Creator.
Después de extraer la descarga, deberías tener la siguiente carpeta:
qs-loadingscreen/
├── shared/config.lua -- the few settings that live in a file
├── custom/ -- framework bridges: admin check and notifications
├── locales/ -- the creator in 41 languages
├── data/themes.json -- the themes you save from the creator
├── song/ -- soundtrack files
├── videos/ -- background clips
└── web/ -- the interface, ready to runLa carpeta debe llamarse
qs-loadingscreen. Multicharacter y tus propios scripts cierran la pantalla medianteexports['qs-loadingscreen']y el eventoqs-loadingscreen:fadeOut, así que nunca cierran una copia renombrada, que en su lugar espera a su límite de seguridad.
Instalar el recurso#
Mueve la carpeta qs-loadingscreen al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
└── qs-loadingscreen/Después, añádelo a tu server.cfg. Es lo primero que ve un jugador y no tiene que esperar a nada, así que inícialo pronto:
ensure qs-loadingscreen
# Framework and the rest of your server
ensure qb-core
# ensure qbx_core
# ensure es_extended
# ensure qs-core
ensure qs-multicharacterA diferencia de la mayoría de los recursos, el orden de inicio no afecta a la detección: el framework se busca la primera vez que un administrador abre el creador, mucho después de que todo se haya iniciado.
Dónde se guardan los temas#
No hay ningún archivo SQL que importar, ni base de datos en absoluto. La pantalla de carga se dibuja antes de que se pueda acceder a una base de datos, así que todo lo que necesita viaja con el recurso:
Qué | Dónde está |
|---|---|
Los siete temas integrados | Dentro de la propia interfaz, para que la pantalla dibuje un diseño terminado antes de haber hablado con el servidor. |
Los temas que guardas |
|
Qué tema está activo | El mismo archivo. Una instalación nueva viene con Cinematic activo. |
El último tema que vio cada jugador | Se guarda en caché en el juego del jugador, para que un diseño personalizado se muestre desde el primer fotograma de su siguiente conexión en lugar de mostrar brevemente el predeterminado. |
Haz una copia de seguridad de
data/themes.jsonjunto con el resto de tu servidor. Es el único archivo que escribe el creador y contiene todos los diseños que has hecho: copiarlo a otro servidor los traslada todos.
Obtener acceso al creador#
El creador decide lo que ve cada jugador al conectarse, así que está limitado a los administradores. Cualquiera de las dos vías siguientes basta por sí sola:
La vía habitual, y la única en un servidor standalone. Añade esta línea a server.cfg:
add_ace group.admin command.loadingcreator allow
# or for a single player
add_ace identifier.license:xxxxxxxxxxxxxxxx command.loadingcreator allowEl nombre ACE es Config.Creator.permission si quieres cambiarlo.
Automático para los grupos de Config.Creator.adminGroups — admin, superadmin y god por defecto. ESX y qs-core leen el grupo del jugador; QBCore y Qbox usan la comprobación de permisos del propio framework, así que el staff que ya tienes cuenta aquí.
La respuesta se recuerda durante la sesión. Un jugador que probó /loadingcreator antes de que le dieras acceso tiene que reconectarse para que se le abra.
Configurar el recurso#
Casi nada está en un archivo, a propósito. Todo lo que puede ver un jugador (textos, fuentes, colores, música, el nombre del servidor, Discord y la web) se edita en el juego y se guarda con el tema. Solo lo que un tema no puede decidir por sí mismo se queda en un archivo:
Archivo | Contenido |
|---|---|
| El idioma del creador, su comando y quién puede usarlo, la detección del framework, los límites de seguridad y el límite de temas. |
| Una carpeta por framework ( |
| Los textos del creador en 41 idiomas. |
Los valores que conviene revisar primero:
Config.Locale = GetConvar('qs:locale', 'en') -- the creator's language
Config.Framework = false -- auto · or 'esx' · 'qb' · 'qs' · 'standalone'
Config.Creator = {
command = 'loadingcreator', -- the chat command
permission = 'command.loadingcreator', -- the ACE that opens it
adminGroups = { 'admin', 'superadmin', 'god' },
}
Config.MaxDuration = 45000 -- ms the screen may stay up after the player spawns
Config.MaxDurationHandoff = 180000 -- the same ceiling while a handoff resource runs
Config.HandoffResources = { 'qs-multicharacter' }
Config.MaxThemes = 50 -- themes saved in data/themes.json
Config.Debug = false
Config.MaxDurationes una red de seguridad, no un temporizador. La pantalla se cierra en cuanto Multicharacter (o tu propio script de spawn) dice que puede; el límite solo importa cuando nada lo hace nunca. Consulta Cómo se cierra la pantalla.
Añadir tus medios#
La música, los vídeos y las imágenes se eligen de tres carpetas dentro del recurso. Coloca un archivo, reinicia el recurso y aparecerá en los desplegables del creador: nadie escribe una ruta ni un enlace.
Carpeta | Formatos | Se usa para |
|---|---|---|
| mp3 · ogg · wav · m4a | La lista de reproducción de la banda sonora. |
| webm (VP9) | Fondos de vídeo y el módulo Video. |
| png · jpg · jpeg · webp · gif | Fondos de imagen y de presentación, los módulos Image y Slideshow, los avatares del staff y las portadas de las pistas. |
La carpeta images/ no viene con el recurso: créala junto a song/ y videos/ la primera vez que añadas una imagen. Las carpetas se leen cuando se inicia el recurso, así que después de añadir archivos ejecuta restart qs-loadingscreen y vuelve a abrir el creador.
El vídeo debe ser WebM (VP9). El navegador de FiveM no incluye la licencia de H.264, así que un .mp4 se reproduce como una pantalla negra. El creador sigue listando los archivos .mp4, marcados como will not play.
No hay soporte para YouTube ni enlaces web, a propósito: un vídeo incrustado de YouTube se niega a iniciarse dentro de FiveM, y un enlace a otro host deja de funcionar el día que ese host falla. Solo se ofrecen archivos de tu propio servidor. Para un clip de fondo pesado, añade también una copia más ligera llamada <name>_low.webm junto a él: los jugadores con PC lentos cargan esa en su lugar.
Verificar la instalación#
Reinicia tu servidor y conéctate. Deberías ver el tema Cinematic en lugar de la pantalla predeterminada de FiveM: eso ya significa que el recurso está en ejecución. Después, recorre el primer ciclo:
Abre el creador
Con una cuenta de administrador, escribe
/loadingcreator. El editor se abre con el tema activo: la lista de temas a la izquierda, el lienzo en el centro y los módulos y el inspector a la derecha.Cambia algo
Abre la pestaña Settings y escribe el nombre de tu servidor, Discord y web, o haz clic en una zona vacía del lienzo y elige otro fondo. Pulsa Preview para verlo a pantalla completa con la música sonando;
Escvuelve al editor.Actívalo
Pulsa Save y luego Set live. Desconéctate y vuelve a conectarte: la pantalla que acabas de crear es la que verás al cargar.
A partir de aquí nada necesita reinicio. Cada diseño, texto y canción se cambia en el creador y llega al siguiente jugador que se conecte.