Comandos#
Loading Screen Creator registra un único comando en el juego. Respeta los permisos, y ejecutarlo una segunda vez cierra la ventana.
Comando | Dónde | Descripción |
|---|---|---|
| En el juego | Abre el creador para los administradores: el ACE |
Un jugador sin acceso recibe una notificación en su lugar. El permiso se comprueba una vez por sesión, así que un jugador al que se le da acceso después de intentarlo tiene que reconectarse.
Exports de cliente#
Para cerrar la pantalla de carga desde un multicharacter o selector de spawn, y para abrir el creador desde tu propio menú de administración.
Cerrar la pantalla de carga
-- Close it now, from the point where your own interface is ready
exports['qs-loadingscreen']:CloseLoadingScreen()
-- true while the loading screen is still up
local open = exports['qs-loadingscreen']:IsLoadingScreenOpen()Se puede llamar más de una vez, y después de que la pantalla ya haya desaparecido. El relevo es instantáneo: no hay fundido que esperar.
Abrir el creador
-- Same as /loadingcreator, permission check included. A second call closes it.
exports['qs-loadingscreen']:OpenCreator()Eventos de cliente#
Ambos son eventos locales de cliente, que se activan y gestionan en la propia máquina del jugador.
Pedir que se cierre la pantalla
TriggerEvent('qs-loadingscreen:fadeOut')Lo mismo que CloseLoadingScreen sin una dependencia estricta: si el recurso no está en ejecución, no pasa nada y no hay errores.
Saber cuándo se cerró
AddEventHandler('qs-loadingscreen:client:closed', function()
-- the loading screen has just closed: show your HUD, start your intro…
end)Se dispara cuando la pantalla se cierra mediante el export, el evento o el límite de seguridad, no cuando otro recurso cierra la pantalla de carga por su cuenta.
Exports de servidor#
Cómo otro recurso lee o cambia el tema activo: un diseño de temporada para las fiestas, una pantalla distinta para una noche de evento.
GetActiveTheme
local id = exports['qs-loadingscreen']:GetActiveTheme()
-- 'cinematic', 'theme_k3x9…', or nil when players get the defaultGetThemes
local themes = exports['qs-loadingscreen']:GetThemes()
for _, theme in ipairs(themes) do
print(theme.id, theme.name)
endTodos los temas guardados en data/themes.json, ordenados por nombre, cada uno completo: id, nombre, descripción, fondo, banda sonora, identidad y módulos. Un tema integrado solo aparece una vez que lo has guardado.
SetActiveTheme
-- An event-night screen, switched from the server console
RegisterCommand('eventscreen', function(source)
if source ~= 0 then return end
local ok = exports['qs-loadingscreen']:SetActiveTheme('overdrive')
print(ok and 'event screen is live' or 'could not switch')
end, true)Activa un tema, guarda la elección y lo envía a todos los que aún están cargando, exactamente igual que Set live en el creador. Acepta un id integrado (cinematic, midnight, neon, welcome, cyberpunk, aurora, overdrive) o el id de uno de los tuyos, que se muestra en la pestaña Settings del creador.
Devuelve false si el id está vacío o no se pudo escribir el archivo. El id no se comprueba contra la lista, así que un error tipográfico deja a los jugadores con el tema predeterminado.
Sobre los errores#
Guardar, eliminar y activar un tema responden { ok = true } o { ok = false, error = 'code' }. El creador lo convierte en un mensaje breve; lo que significa cada código se indica en Errores comunes.