Uso

La ventana del creador#

Todo lo relativo a una persiana se hace desde una sola ventana, que un administrador abre con /shuttercreator. Tu HUD y tu minimapa se ocultan mientras está abierta. A la izquierda está la lista de todas las persianas del servidor; a la derecha, el formulario de la que estás creando o editando.

Crear una persiana#

El formulario tiene cinco paneles, de arriba abajo. Nada se escribe como coordenada: cada posición se elige en el mundo con un botón Select, que cierra la ventana mientras colocas.

Colocar la persiana#

Elige primero un Model, y luego pulsa Select junto a Shutter. Aparece una copia transparente de la persiana donde miras, y colocarla lleva tres pasos. Las teclas de cada paso se muestran en la parte inferior de la pantalla, y una notificación explica cada uno al empezar.

1. Posición aproximada

   Mira hacia la entrada: la persiana sigue el punto al que apuntas. Gírala con Z y X hasta que mire hacia el lado correcto, y haz clic izquierdo cuando esté más o menos en su sitio. Todavía no tiene que ser exacta.

2. Ajuste fino

   Encájala en el marco. Las flechas la mueven hacia delante, atrás, izquierda y derecha según hacia dónde mira, Q y E la suben y la bajan, y Z / X la giran en pasos pequeños. Pulsa ENTER cuando quede bien ajustada.

3. Altura de apertura

   Un círculo y una línea verdes muestran adónde va la persiana al abrirse. Mueve el círculo con Arrow Up y Arrow Down hasta que quede donde la persiana debe desaparecer, normalmente dentro de su caja sobre la puerta. Pulsa SPACE para verla subir y volver a bajar, Arrow Left para volver al ajuste fino y ENTER para terminar.

¿Cambias el modelo de una persiana ya colocada? Elige el nuevo modelo y pulsa Select de nuevo: una persiana pequeña y una grande del mismo estilo no quedan en el mismo sitio, así que conviene colocarla otra vez.

Puntos de interacción#

Un punto de interacción es un lugar donde un jugador puede abrir o cerrar la persiana. Una persiana puede tener tantos como quieras: uno en la calle y otro dentro es la pareja habitual, para que el personal pueda cerrar desde detrás del mostrador. Pulsa Add Point para cada uno:

Blip#

El interruptor de la cabecera del panel activa o desactiva el blip. Con él activado:

Control de acceso#

Todas las reglas que pongas deben cumplirse a la vez, y una regla vacía no se comprueba, así que una persiana sin nada configurado aquí es pública. Las reglas se comprueban en el servidor cada vez que alguien pulsa.

Un uso exitoso de la ganzúa ignora todas las reglas de este panel, PIN incluido. Para crear una persiana que no se pueda forzar, deja Enable Lockpick desactivado en todos sus puntos.

Guardar#

Pulsa Create shutter. Los campos que faltan se marcan en rojo y aparece Please fill in all fields. Una vez guardada, la persiana está en la base de datos y en el mundo de todos los jugadores al instante, en su posición bajada y cerrada.

Editar, teletransportarse y eliminar#

Cómo usan los jugadores una persiana#

1. Acercarse

   Dentro de la distancia de un punto, Press [E] to enter the shutter aparece flotando sobre él, con el estilo de qs-textui si está en marcha. Con Config.UseTarget activado, el punto es en su lugar una opción de target llamada Access <shutter name>.

2. Pulsar E

   El servidor comprueba las reglas de acceso. A un jugador que no cumple una se le indica cuál: You do not have access to this shutter. Reason: Required job: police.

3. Escribir el PIN

   Solo si la persiana tiene uno. El teclado admite clics o las teclas numéricas; Backspace borra, Enter confirma y Esc cancela. Un código incorrecto muestra Invalid PIN code.

4. La persiana se mueve

   El jugador pasa una tarjeta, suena el sonido de apertura o cierre y la persiana sube o baja para todos los que están cerca. Hay una pausa de dos segundos antes de que el mismo jugador pueda volver a pulsar.

Los jugadores que están más lejos no la ven moverse, pero cuando llegan la persiana ya está en la posición correcta, porque el estado se guarda en el servidor y en la base de datos.

Ganzúa#

La ganzúa convierte cualquier persiana que permitas en un objetivo de robo. Solo funciona en puntos de interacción con Enable Lockpick activado, y el ítem se configura como se describe en Ítems de inventario.

1. Usa el ítem en el punto

   Colócate dentro de la distancia del punto y usa shutter_lockpick desde el inventario. El jugador se arrodilla y empieza a trabajar la cerradura.

2. Supera la prueba de habilidad

   Cuatro rondas de la prueba de habilidad de ox_lib: pulsa la tecla indicada cuando el marcador cruce la zona. Con Config.LockpickMinigame = false este paso se omite.

3. La persiana se mueve

   Si tiene éxito, cambia de estado (una persiana abierta también puede forzarse para cerrarla) y aparece Lockpick successful!. Se gasta una ganzúa en cada intento, tenga éxito o no.

Persistencia y seguridad#

• Cada persiana se guarda con su estado, subida o bajada, así que la ciudad se ve igual después de un reinicio que antes.

• Cada cambio se envía a todos los jugadores (al crear, editar, eliminar, abrir o cerrar) sin reinicios ni reconexiones.

• Las reglas de acceso y los códigos PIN se comprueban en el servidor. El propio código se elimina de los datos de la persiana antes de llegar a cualquier jugador, así que no se puede leer desde el cliente.

• Las persianas son ligeras. El modelo de una persiana solo existe para los jugadores que están a unos 10 m de ella, y sus puntos solo se comprueban mientras están allí.

Referencia de configuración#

Todo lo siguiente está en config/main.lua. Reinicia el recurso después de cambiarlo.

Config.Framework y Config.Inventory se detectan al iniciar y se marcan como [AUTO] — nunca los configures a mano; Integraciones explica cómo añadir un recurso renombrado. Config.DefaultStashData, Config.MinPointLength, Config.FreeModeKeys y CameraOptions no se usan al colocar persianas y pueden dejarse como están.

Añadir tu propio modelo de persiana#

Cualquier prop que tu servidor transmita puede ofrecerse como persiana. Añádelo a la lista con la etiqueta que debe mostrar el creador:

Config.ObjectList = {
  { label = 'Small 1', object = 'qs-shutter_prop_1_small' },
  { label = 'Large 1', object = 'qs-shutter_prop_1_large' },
  { label = 'Small 2', object = 'qs-shutter_prop_2_small' },
  { label = 'Large 2', object = 'qs-shutter_prop_2_large' },
  { label = 'Small 3', object = 'qs-shutter_prop_3_small' },
  { label = 'Large 3', object = 'qs-shutter_prop_3_large' },
  { label = 'Garage door', object = 'my_garage_door' }, -- streamed by another resource
}

Un modelo que no se transmite se rechaza al pulsar Select, con Model … is not valid.

Teclas de colocación#

ActionControls asigna cada acción de colocación a ids de controles de GTA, que aparecen en la referencia de controles de FiveM. Las teclas de clic, girar, terminar, cancelar y atrás se pueden cambiar aquí; las flechas, Q / E y SPACE del ajuste fino son fijas.

ActionControls = {
  leftClick  = { label = 'Left Click',  codes = { 24 } },     -- step 1: next step · points: place
  rotate_z   = { label = 'RotateZ +/-', codes = { 20, 73 } }, -- Z / X: rotate
  done       = { label = 'Done',        codes = { 191 } },    -- ENTER: next step / finish
  cancel     = { label = 'Cancel',      codes = { 194 } },    -- BACKSPACE: cancel
  arrow_left = { label = 'Arrow Left',  codes = { 174 } },    -- step 3: back to step 2
  -- ...
}

Los modelos de persiana#

Tres estilos, cada uno en un tamaño pequeño para la puerta de una tienda y otro grande para un garaje o una zona de carga, todos transmitidos por shutters_props: