Integraciones

Usar tus shells en un script de housing#

Cada shell guardada es un modelo llamado qs_shells_<id>, así que cualquier script de housing que pueda generar un modelo de shell puede usarla. Lo que cambia entre scripts es la forma de su entrada de configuración, y eso es lo que el cuadro Export Code del gestor de shells escribe por ti.

1. Selecciona la shell

   /shellcreator y luego haz clic en la shell de la lista.

2. Elige tu script de housing

   En Export Code, elige el formato. La entrada se genera con el nombre del modelo, la etiqueta de la shell y la entrada medida desde su punto de aparición.

3. Cópiala y pégala

   Copy Code la copia al portapapeles. Pégala en la lista de shells o interiores de ese script, completa todo lo marcado como -- Change me y reinicia el script de housing.

Formatos incluidos#

¿Shell o IPL? Un formato Shell permite que el script de housing genere qs_shells_<id> donde quiera y mide la puerta como un desplazamiento desde ese objeto: la opción habitual, y la que permite que varias casas compartan una shell. Un formato IPL usa la shell donde la colocó el propio Shell Creator, con coordenadas absolutas, como un interior fijo.

Añadir tu propio formato de exportación#

Cada formato es una plantilla de texto en Config.Exports (config/main.lua). Añade una entrada y aparecerá en la lista del gestor tras reiniciar:

Config.Exports['my_housing-shell'] = {
    label  = 'My Housing (Shell)',
    export = [[{
    name   = '{LABEL}',
    model  = '{MODEL}',
    door   = vector4({EXIT_OFFSET_X}, {EXIT_OFFSET_Y}, {EXIT_OFFSET_Z}, {EXIT_HEADING}),
}]]
}

Estos marcadores se sustituyen al generar el código:

Una shell guardada sin punto de aparición rellena cada coordenada con 0.0; en la práctica eso no puede ocurrir, porque el constructor se niega a guardarla.

Frameworks y reglas de admin#

El framework solo se usa para dos preguntas (¿este jugador es admin? y ¿cuál es su identificador?), que responde un pequeño bridge sin cifrar por framework:

Para usar tu propia regla (un ace dedicado, un rol de Discord, una lista de constructores), cambia playerIsAdmin en custom/<framework>/server.lua:

-- custom/qb/server.lua
function framework:playerIsAdmin(source)
    return IsPlayerAceAllowed(source, 'shellcreator.builder')
end

# server.cfg
add_ace group.builder shellcreator.builder allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.builder

Si tu core tiene otro nombre, Shell Creator vuelve a standalone. Apunta a mano Config.Framework en config/main.lua a 'esx', 'qb' o 'standalone', y cambia la línea exports['es_extended'] / exports['qb-core'] de ese bridge al nombre de tu recurso.

Text UI, barras de progreso y el HUD#

Todo esto está en custom/client.lua, sin cifrar, y elige lo que esté en ejecución:

Para cualquier otro HUD, añade sus llamadas de ocultar y mostrar dentro de ToggleHud(bool). Se ejecuta cuando el gestor o el constructor se abren y cuando se cierran:

function ToggleHud(bool)
    DisplayRadar(bool)
    if GetResourceState('my-hud') == 'started' then
        exports['my-hud']:SetVisible(bool)
    end
end

Para teléfonos, menús radiales o inventarios que no deban abrirse mientras alguien construye, usa los exports y state bags de Comandos y exports.

Clima y hora#

Mientras el constructor está abierto, el clima se mantiene despejado y a mediodía para que la construcción se vea siempre igual y la foto de portada esté iluminada. La sincronización de estos scripts se pausa durante el constructor y se reanuda después:

• Renewed-Weathersync

• qb-weathersync

• cd_easytime

• vSync

• av_weather

Para otro script de clima, añade sus eventos de pausa y reanudación a FreezeWeather en client/custom/weather/weather.lua.

Idiomas#

Se incluyen 25 traducciones en locales/: árabe (ar), búlgaro (bg), checo (cs), danés (da), alemán (de), griego (el), inglés (en), español (es), persa (fa), francés (fr), hindi (hi), húngaro (hu), italiano (it), japonés (ja), coreano (ko), neerlandés (nl), noruego (no), polaco (pl), portugués (pt), ruso (ru), esloveno (sl), sueco (sv), tailandés (th), turco (tr) y chino simplificado (zh-CN). Establece Config.Locale con el código.

Para añadir un idioma, copia locales/en.json a locales/<code>.json, traduce los valores (mantén las claves y los {{placeholders}}) y establece Config.Locale con ese código. Cualquier clave que omitas vuelve al inglés, con un aviso en la consola que la nombra.