Uso

La ventana del creador#

Todo en Doorlock Creator ocurre en una sola ventana, que abren con /doorlockcreator el staff y los trabajos indicados en Config.CreatorJobs (consulta Instalación). Los jugadores nunca la ven: solo ven el aviso en la puerta.

Nada se configura en archivos. Cada puerta, regla y código se define aquí, se guarda en la base de datos y se envía a todos los jugadores en cuanto pulsas Save; la lista incluso se actualiza para otro admin que tenga el creador abierto.

Crear una puerta#

1. Ponle nombre

   Pulsa Create new. En Door Settings dale un nombre que reconozcas después — mrpd_armory, pdm_office. Los nombres son únicos en todo el servidor.

2. Elige la puerta

   En Door Coordinates pulsa Select 1 Door Entity (o Select 2 Door Entities para una puerta doble). La ventana se oculta; apunta a la puerta —se resalta y se marca— y haz clic izquierdo. La selección termina sola cuando se han elegido suficientes puertas y la ventana vuelve.

3. Decide quién la abre

   Añade trabajos, jugadores, un ítem, una tarifa o un código en Requirements — o nada, para una puerta que cualquiera puede bloquear y desbloquear.

4. Guarda

   La puerta se crea bloqueada y aparece en la lista. Acércate a ella para probarla.

Door Settings#

Qué puertas se pueden bloquear#

Cualquier cosa que el propio juego trate como puerta: puertas batientes, puertas correderas de cristal, persianas de garaje, portones y barreras, de GTA o de un MLO. Cada una se registra en el sistema nativo de puertas de GTA, así que se abre y gira con normalidad cuando está desbloqueada y se mantiene cerrada cuando está bloqueada. Un prop estático que no es un modelo de puerta no se puede bloquear: no se mueve, así que el creador no tiene nada que sujetar.

Puertas simples y dobles#

Una puerta simple es una entidad. Una puerta doble — marca Multi Door (requires two doors) — son dos hojas que siempre se bloquean y desbloquean juntas, con un solo aviso en medio de ambas.

El formulario no permite guardar una puerta simple con dos hojas ni una doble con una, así que una puerta nunca queda medio bloqueada. Para cambiar de una a otra, marca o desmarca la casilla y vuelve a seleccionar las puertas.

Requisitos de acceso#

Los requisitos deciden quién puede usar una puerta. Se comprueban en el servidor cada vez, en este orden:

1. Código — si la puerta tiene uno, para desbloquearla primero hace falta el código correcto. Bloquearla nunca lo pide.

2. Ninguna otra regla — la puerta es pública: cualquiera dentro del alcance puede bloquearla y desbloquearla.

3. Si no, basta con una regla cualquiera — el jugador está en la lista de jugadores, o tiene un trabajo y rango permitidos, o lleva el ítem, o (para desbloquear) tiene el dinero.

Job Access#

Elige un trabajo de la lista que conoce tu framework, selecciona uno o más rangos en Allowed Grades y pulsa Add Job Rule. Añade tantos trabajos como necesite la puerta: police rangos 2–4 y sheriff rangos 3–5 en la misma puerta de la armería, por ejemplo. Los rangos son exactos: seleccionar solo el rango 4 no deja pasar al rango 5, así que selecciona todos los rangos que deban pasar.

Player Access#

Escribe al menos dos caracteres de un nombre o identificador en Allowed Players y haz clic en un resultado. Los jugadores se buscan en tu base de datos, así que no necesitan estar conectados. Lo que se guarda es el personaje —el identifier de ESX o el citizenid de QBCore / Qbox—, así que los otros personajes del jugador no pueden pasar. Haz clic en una etiqueta para quitar a alguien. Se muestran hasta Config.MaxSearchResults (20) resultados por búsqueda.

Item Access#

Elige un ítem en Required Item, de la lista de ítems de tu inventario. Basta con llevarlo: el ítem nunca se consume, así que una tarjeta sigue funcionando. El script no incluye ítems: usa uno que ya tengas o añade una tarjeta:

-- ox_inventory/data/items.lua
['door_keycard'] = {
    label = 'Door Keycard',
    weight = 10,
    stack = false,
    close = true,
    description = 'Opens restricted doors',
},

-- qb-core/shared/items.lua
door_keycard = { name = 'door_keycard', label = 'Door Keycard', weight = 10, type = 'item', image = 'door_keycard.png', unique = true, useable = false, shouldClose = true, description = 'Opens restricted doors' },

-- qs-inventory/shared/items.lua
['door_keycard'] = {
    name = 'door_keycard',
    label = 'Door Keycard',
    weight = 10,
    type = 'item',
    image = 'door_keycard.png',
    unique = true,
    useable = false,
    shouldClose = true,
    description = 'Opens restricted doors',
},

INSERT INTO `items` (`name`, `label`, `weight`) VALUES ('door_keycard', 'Door Keycard', 1);

Reinicia el inventario y luego el doorlock para que el nuevo ítem aparezca en la lista.

Money Access#

Define una cantidad en Money Requirement y una cuenta en Money Type — las opciones vienen de Config.MoneyTypes (Money, Bank, Black Money). En QBCore y Qbox, Money es la cuenta cash, y Black Money es markedbills en QBCore y el ítem black_money en Qbox.

La tarifa se cobra en cada desbloqueo, incluso a jugadores que pasaron por una regla de trabajo, jugador o ítem. Eso la convierte en un peaje, no en una llave alternativa: úsala para un gimnasio de pago, la barrera de un lavadero de coches o una zona VIP. A un jugador que no puede pagar se le indica Not enough money y la puerta sigue bloqueada. Bloquear siempre es gratis.

Código#

Escribe cuatro dígitos en Door Passcode (optional). Cuando un jugador desbloquea la puerta se abre un teclado; escribe el código con las teclas numéricas o haciendo clic, Enter confirma, Backspace borra y Esc cierra. Un código incorrecto muestra Invalid passcode.

El código se comprueba en el servidor y nunca se envía a los jugadores, así que no se puede leer desde un cliente. Un código por sí solo abre la puerta a quien lo conozca; combinado con un trabajo, el jugador necesita ambos: el trabajo y el código. Vacía el campo para quitarlo.

Animación y sonidos#

Cada puerta tiene su propia Interaction animation —el deslizamiento de tarjeta por defecto— que reproduce el jugador que la bloquea o desbloquea, solo cuando el servidor lo ha aprobado.

UI sounds reproduce un clic de bloqueo o desbloqueo para todos los que estén a unos 12 m del alcance de la puerta. Desmárcalo por puerta, o pon Config.DisableSounds = true para silenciar todas las puertas y la interfaz a la vez.

Cómo usan los jugadores una puerta#

El aviso se muestra a todos dentro del alcance; las reglas se comprueban al usarlo, y un jugador que no las cumple recibe You are not allowed to use this door. El servidor también comprueba que el jugador está realmente junto a la puerta e ignora las pulsaciones repetidas dentro de Config.Doorlock.ToggleCooldownMs (750 ms).

Autobloqueo#

Una puerta puede volver a bloquearse sola unos segundos después de que alguien la desbloquee: la puerta de una celda, una entrada trasera que nunca debe quedar abierta. Bloquearla a mano antes de que se acabe el tiempo cancela el temporizador.

El valor por puerta se define en la base de datos. Ejecuta esto con el nombre de la puerta y luego reinicia el recurso para que recargue las puertas:

UPDATE `qs_doorlocks`
SET `data` = JSON_SET(`data`, '$.autolockSeconds', 10)
WHERE `name` = 'mrpd_cells_main';

Otros valores por puerta#

Otros dos valores se leen de los mismos datos y se definen igual:

Editar, teletransportar y borrar#

Haz clic en una puerta de la lista para abrirla. Cambia lo que quieras —reglas, distancia, animación, incluso las entidades de puerta— y pulsa Save; todos los jugadores reciben la nueva versión al instante y la puerta mantiene su estado de bloqueo actual. Delete pide confirmación y no se puede deshacer: la puerta se libera y gira libremente para todos.

Guardado y sincronización#

• Cada bloqueo y desbloqueo se escribe en la base de datos, así que las puertas mantienen su estado tras un reinicio.

• Un jugador que entra recibe todas las puertas en paquetes pequeños (Config.Doorlock.SyncChunkSize, 25 por paquete), así que un servidor con cientos de puertas no se atasca al conectar.

• Los estados se vuelven a aplicar poco después de entrar, para las puertas de MLO que cargan tarde.

• Cada cambio —de un jugador, un autobloqueo o un script— llega a todos a la vez.