Lo que falla con más frecuencia, qué significa realmente y qué hacer. La mayoría se reduce al orden de carga, a otro doorlock que sigue en marcha o a una regla que hace exactamente lo que se le dijo.
Instalación y acceso#
El recurso se detiene al iniciar con un error "custom.none" o de framework
No había ningún framework en marcha cuando se inició Doorlock Creator, así que buscó un puente llamado none. Inicia es_extended, qb-core o qbx_core por encima de él en server.cfg. Un framework con otro nombre de carpeta necesita una línea en la tabla frameworks de config/main.lua — consulta Integraciones.
Errores sobre la tabla qs_doorlocks
La tabla no existe: no se crea automáticamente. Importa database/database.sql en la misma base de datos a la que apunta tu mysql_connection_string y reinicia. Un inicio correcto muestra Loaded N doors from database.
"Waiting for db and sv_inventory.formatItemList" se repite sin fin
El recurso está esperando a la base de datos o a un puente de inventario. Comprueba que oxmysql se inicia primero y se conecta, y que la línea indica un inventario que existe en server/custom/inventory/. Una clave añadida a la tabla inventories sin su archivo puente provoca exactamente esto.
Un aviso sobre el inventario standalone se repite cada pocos segundos
No se encontró ningún inventario compatible al iniciar el recurso, normalmente porque se inicia después de Doorlock Creator. Mueve el inventario por encima en server.cfg. Las puertas siguen funcionando, pero la lista Required Item queda vacía hasta que lo arregles.
/doorlockcreator dice "You do not have permission to do this."
No eres staff ni estás en Config.CreatorJobs. En ESX tu grupo debe ser admin o superadmin; en QBCore y Qbox necesitas el permiso god o admin o el ace command. Los rangos de trabajo en Config.CreatorJobs son números exactos: { 1, 2, 3 } no incluye el rango 4. Consulta Instalación.
El creador se abre en blanco o no se abre
La interfaz se carga desde nui://qs-doorlock-creator/web/. Si la carpeta se renombró, vuelve a llamarla qs-doorlock-creator. Comprueba también que la carpeta web/ llegó completa desde la descarga, y busca en la consola F8 un archivo que no se haya cargado.
La consola está llena de líneas [DEBUG]
Config.Debug viene como true. Ponlo en false en config/main.lua cuando todo funcione.
Crear puertas#
La puerta se guardó pero no se bloquea
Durante la selección se puede hacer clic en cualquier objeto, así que es fácil elegir el marco, un panel de pared o un prop junto a la puerta. Se guardan sin problema, pero no se pueden mantener cerrados. Abre la puerta en el creador, pulsa Select 1 Door Entity de nuevo y apunta a la propia hoja que se mueve: la parte que gira o se desliza. En un MLO, la puerta debe ser un objeto de puerta real, no parte de la malla del edificio.
"Single door mode requires exactly one selected door" (o dos en multi)
La casilla Multi Door y el número de puertas seleccionadas no coinciden. Márcala para una puerta doble y selecciona ambas hojas, o desmárcala y selecciona una.
"Door name already exists"
Los nombres son únicos, sin distinguir mayúsculas: Armory y armory chocan. Busca el nombre en la lista; una puerta creada por un script con hidden activado no aparece ahí, pero su nombre sigue ocupado.
La lista Required Item está vacía
No se detectó ningún inventario: inícialo antes que Doorlock Creator. Un ítem añadido después de iniciar el servidor aparece cuando se han reiniciado tanto el inventario como el doorlock.
La búsqueda de jugadores no encuentra a nadie
Escribe al menos dos caracteres. La búsqueda lee la tabla de personajes de tu framework — users en ESX, players en QBCore y Qbox—, así que el personaje debe haber entrado al menos una vez. Buscar por identificador o citizen ID es lo más fiable.
Usar puertas#
Las puertas se desbloquean y se cierran de golpe, o el aviso muestra el estado incorrecto
Otro doorlock sigue en marcha y se pelea por la misma puerta: ox_doorlock, qb-doorlock, nui_doorlock o un doorlock incluido dentro de un mapa o un script de trabajo. Elimínalo: Reemplazar otros doorlocks.
No aparece el aviso [E] en la puerta
Acércate: el aviso aparece dentro de la Visible Distance de la puerta más 1,25 m desde su centro.
Con
Config.UseTarget = trueno hay aviso: usa el ojo de tu target. Si no hay ningún recurso de target en marcha, vuelve a ponerlo enfalse.Una puerta con
hiddenactivado nunca muestra aviso; solo la abren los scripts.
"You are not allowed to use this door"
El jugador no cumple ninguna de las reglas de la puerta. Comprueba el trabajo y los rangos exactos (una regla para los rangos 2 y 3 rechaza el rango 4), que el ítem está en su inventario y que la entrada de la lista es el personaje con el que juega. Las reglas se combinan con o: basta con cumplir una.
"Invalid passcode"
El código escrito no coincide. El código se pide en cada desbloqueo, incluso a jugadores que tienen el trabajo: es un bloqueo extra, no una alternativa. Para dejar pasar a un trabajo sin el código, quita el código.
"Not enough money", o al staff se le cobra por abrir su propia puerta
Una puerta con un Money Requirement cobra a todos los que la desbloquean, incluidos los jugadores que pasan por trabajo, ítem o lista. Si el staff debe abrirla gratis, dale al staff su propia puerta o quita la tarifa. Comprueba también que el Money Type es la cuenta en la que el jugador realmente tiene el dinero.
Una puerta de pago no se puede volver a bloquear
Pagar solo desbloquea. Si el dinero es la única regla de la puerta, nadie cumple los requisitos para bloquearla. Añade un trabajo o un jugador que la cierre, o un autobloqueo — consulta Uso.
Pulsar E no hace nada
Las peticiones separadas por menos de Config.Doorlock.ToggleCooldownMs (750 ms) se ignoran, y el servidor rechaza a un jugador que esté más lejos que la distancia de la puerta más MaxInteractDistance (3 m). Acércate y pulsa una vez.
El autobloqueo no funciona
El autobloqueo está desactivado por defecto (DefaultAutolockSeconds = 0). Un autolockSeconds por puerta definido en la base de datos solo se lee al iniciar el recurso, así que reinícialo tras el cambio. Una puerta desbloqueada con el export SetDoorState no se autobloquea.
No hay sonido de bloqueo / desbloqueo
Comprueba UI sounds en la puerta y Config.DisableSounds. El sonido solo se oye cerca de la puerta y usa el volumen de la interfaz del juego.
¿Sigues atascado? Abre un ticket e incluye la consola de tu servidor desde el inicio del recurso (con
Config.Debug = true), tu framework e inventario, y el nombre de la puerta que falla.