Prueba ya Smartphone V3Consíguelo Black Friday empieza enBlack Friday · 25% de descuento en toda la tienda · Tiempo limitadoComprar ahora

QUASARSTORE

[80.5] Shutters Creator

Comandos yexports

El comando /shuttercreator, los exports de cliente y servidor para encontrar, abrir, cerrar y forzar persianas desde tus scripts, y los eventos a escuchar.

Sección: 80.5
Leer: 4 min
Actualizado: 1 nov

■ 4 min read · Actualizado 1 nov 2026

Comandos#

Shutters Creator registra un único comando en el juego. Todo lo demás — crear, editar, eliminar, teletransportarse — ocurre dentro de la ventana que abre.

Comando	Dónde	Descripción
`/shuttercreator`	En el juego	Abre el creador. Solo administradores — consulta Reclamar el acceso de administrador. A cualquier otra persona se le indica que no tiene permiso.

No hay comandos de consola. Para seguir lo que hace el script, establece Config.Debug = true y lee la consola del servidor y la consola F8.

Exports de cliente#

Para saber en qué persiana está un jugador — una app de teléfono, un menú radial, un script de robo — y para iniciar el forzado con ganzúa desde tu propio ítem.

getCurrentShutterId

Devuelve el id de la persiana en cuyo punto de interacción está el jugador, y ese punto — o nil cuando no está dentro de la distancia de ningún punto.

lua

local shutterId, point = exports['qs-shutter-creator']:getCurrentShutterId()
if shutterId then
    print(('At shutter %d, within %.1f m, lockpick allowed: %s'):format(
        shutterId, point.distance, tostring(point.enable_lockpick)
    ))
end

getCurrentShutter

Devuelve los datos completos de la persiana en la que está el jugador, o nil. La copia del cliente nunca contiene el código PIN.

lua

local shutter = exports['qs-shutter-creator']:getCurrentShutter()
if shutter then
    print(shutter.name, shutter.job or 'public', shutter.enable_pin and 'PIN' or 'no PIN')
end

lockpick

Ejecuta todo el forzado con ganzúa en el punto de interacción más cercano — comprobaciones, animación, prueba de habilidad y, si tiene éxito, el movimiento de la persiana — exactamente igual que al usar shutter_lockpick. Úsalo cuando otro script ya gestiona el ítem que debe forzar las persianas.

Espera a que termine el intento y luego devuelve 'remove' cuando se hizo un intento — superado o fallido — o false cuando no hay ningún punto forzable al alcance. No consume el ítem por sí mismo:

lua

-- client side, in your own item-use handler
local result = exports['qs-shutter-creator']:lockpick()
if result == 'remove' then
    TriggerServerEvent('my-heist:removeLockpick') -- your own event that removes one item
end

Exports de servidor#

Cómo otro recurso controla Shutters Creator — una tienda que cierra de noche, un atraco que abre la persiana de la cámara acorazada, un script de trabajo que bloquea un garaje cuando el último mecánico sale de servicio.

getShutters

Devuelve todas las persianas del servidor, en el formato descrito en Los datos de la persiana más abajo. Es la lista activa con la que trabaja el script: léela, pero cambia las persianas mediante setLocked o el creador — las ediciones en la propia tabla no se guardan.

lua

local shutters = exports['qs-shutter-creator']:getShutters()
for _, shutter in ipairs(shutters) do
    print(shutter.id, shutter.name, shutter.job or 'public')
end

setLocked

Mueve una persiana para todos los jugadores y guarda su nuevo estado en la base de datos, sin comprobación de acceso — tu script decide quién puede. state se escribe en el campo is_closed de la persiana: true coloca la persiana a su altura de apertura, false la baja hasta donde fue colocada. Devuelve true, o false cuando el id no existe o state no es un booleano.

lua

exports['qs-shutter-creator']:setLocked(3, false) -- shutter 3 down, at its placed position
exports['qs-shutter-creator']:setLocked(3, true)  -- shutter 3 up, at its open height

Bajar todas las persianas de Burger Shot a las tres de la madrugada, con el cron de ox_lib:

lua

lib.cron.new('0 3 * * *', function()
    for _, shutter in ipairs(exports['qs-shutter-creator']:getShutters()) do
        if shutter.job == 'burgershot' then
            exports['qs-shutter-creator']:setLocked(shutter.id, false)
        end
    end
end)

Eventos#

El servidor informa a todos los clientes de cada cambio mediante estos eventos. Tus propios scripts de cliente pueden escucharlos — para reproducir una alarma cuando se fuerza una persiana, o para actualizar un mapa de tiendas abiertas.

Evento de cliente	Recibe	Se dispara cuando
`shutters:createShutter`	La nueva persiana	Un administrador crea una persiana.
`shutters:updateShutter`	La persiana editada	Un administrador guarda cambios en una persiana.
`shutters:updateShutterPartial`	`{ id, is_closed }`	Una persiana se mueve — con E, con ganzúa o con `setLocked`.
`shutters:removeShutter`	El id de la persiana	Un administrador elimina una persiana.

lua

-- client side, in your own resource
RegisterNetEvent('shutters:updateShutterPartial', function(data)
    print(('Shutter %d moved'):format(data.id))
end)

Los datos de la persiana#

Todos los exports y eventos anteriores entregan las persianas con esta forma. types.lua incluye la misma descripción como anotaciones de Lua (Shutter, InteractPoint).

Campo	Contiene
`id` · `name` · `model`	El id de la base de datos, el nombre que se muestra en el creador y el modelo del prop.
`coords`	`{ x, y, z, w }` — dónde se colocó la persiana, y su orientación.
`open_offset`	Cuánto se mueve, en metros, para alcanzar su altura de apertura. Positivo es hacia arriba.
`interact_points`	Una lista de `{ coords = { x, y, z }, distance, enable_lockpick }`.
`item`	El nombre del ítem requerido, o `nil`.
`job` · `job_grades`	El trabajo requerido y la lista de rangos permitidos; una lista vacía permite todos los rangos.
`gang` · `gang_grades`	Lo mismo para las bandas.
`enable_pin` · `pin_length`	Si se pide un PIN, y su longitud: 4 o 6.
`pin_code`	El propio código. Solo servidor — se elimina de todo lo que se envía a los clientes.
`blip`	`{ enable, label, sprite, color, scale, coords }`.
`is_closed`	El estado guardado: `true` mientras la persiana está a su altura de apertura, `false` mientras está bajada — el mismo valor que escribe `setLocked`.
`creator`	El identificador del administrador que la creó.

[··] Documentación

Cargandola guía