Lo que falla con más frecuencia, qué significa realmente y cómo solucionarlo. La mayoría de estos casos los explica la consola del servidor: léela desde el momento en que se inicia el recurso, y activa Config.Debug mientras investigas.
Instalación y acceso#
El recurso no se inicia: "Could not find dependency"
El manifiesto requiere ox_lib, bob74_ipl, VehicleDeformation y screenshot-basic, OneSync, la build del juego 2802 o superior y el artefacto del servidor 5895 o superior. Instala el que indique el mensaje y asegúrate de que se inicia con ensure antes de qs-advancedgarages.
La consola se cierra: "qs-advancedgarages changed its name"
Se renombró la carpeta. Vuelve a llamarla qs-advancedgarages; los exports, la interfaz y otros scripts dependen de ese nombre exacto.
"You do not have permission" en /garagecreator
Necesitas ser administrador del framework (ESX admin / superadmin, QBCore god / admin), o tener un trabajo y rango incluidos en Config.CreatorJobs.
Importar esx.sql falla con "Duplicate column name 'hash'"
Tu tabla owned_vehicles ya tiene esa columna. Omite esa línea e importa el resto del archivo. Lee La base de datos antes de importar en un servidor que ya tiene coches de jugadores.
Las llaves, el combustible o el alijo no hacen nada
Ese recurso se inicia después de los garajes, así que no se detectó, o no está en la lista de compatibles. Mueve su línea ensure por encima de qs-advancedgarages y reinicia el servidor. Si no se detecta ningún script de combustible, la consola indica You did not configure your fuel system y los coches salen con el depósito lleno. Para un recurso que no está en la lista, consulta Añadir un backend.
La consola está llena de líneas DEBUG
Config.Debug viene como true. Ponlo en false en config/config.lua en un servidor en producción.
Garajes y vehículos#
Faltan los garajes predeterminados
Busca queries of sql/default_garages.sql failed en la consola: la importación se reintenta en cada inicio hasta que funciona, normalmente después de corregir un problema de permisos o de columnas en la base de datos. Si se importaron una vez y se eliminaron después, ejecuta importdefaultgarages en la consola del servidor.
/dv no elimina los coches, o vuelven
Es el comportamiento correcto con Config.PersistentVehicles: los coches con propietario vuelven a aparecer donde se dejaron. Usa /mdv para el coche más cercano o /mdvall para todos los vacíos; ambos los envían al depósito para que el propietario pueda recogerlos.
No se puede guardar un coche
No es tuyo: solo se pueden guardar coches registrados y con propietario. Los administradores registran uno con
/addcar.No eres el conductor.
Tipo de garaje incorrecto: los barcos van a los muelles, los helicópteros y aviones a los hangares.
El garaje está lleno: un interior admite tantos coches como plazas tiene, un garaje MLO tantos como plazas dibujadas.
No tienes suficiente dinero para la tarifa de almacenamiento del garaje.
No se puede guardar una grúa plataforma: "You cannot store this vehicle here!"
Tiene coches cargados encima. Las versiones antiguas de qs-mechanic-creator no pueden llevar coches al garaje, así que descarga primero la grúa o actualiza qs-mechanic-creator. Una grúa de trabajo alquilada siempre debe descargarse antes de guardarla, porque no tiene dónde guardar una carga.
Un jugador con las llaves del coche no lo ve en el garaje
El acceso al garaje con llaves está desactivado de forma predeterminada. Configura Config.VehicleKeysGarageAccess = true y asegúrate de que qs-vehiclekeys está en ejecución; otros sistemas de llaves no son compatibles con esto. El coche solo aparece en el garaje en el que está guardado, nunca en un depósito, y los vehículos de trabajo no se comparten de esta forma.
"You need grade X to take out this vehicle"
Ese vehículo de trabajo tiene su propio rango en config/jobgarages.lua, por ejemplo { model = `police3`, grade = 3 }. Asciende al jugador o baja ese rango.
"Transferring vehicles to other players is disabled"
Config.EnabledButtons.transfer está en false, así que el servidor rechaza las transferencias además de ocultar el botón. Ponlo en true para permitirlas.
Los coches perdidos o destruidos ya no van al depósito
Config.Impound.Enabled está en false: esos coches quedan perdidos, y sus propietarios los recogen en un punto de recuperación (Config.Recovery). Vuelve a ponerlo en true para enviarlos de nuevo al depósito.
Los coches embargados o perdidos no van a ninguna parte: "No impound for type"
Cada tipo de vehículo que puede perderse necesita al menos un depósito: uno para coches, uno para barcos y uno para aeronaves. Los predeterminados incluyen los tres; si eliminaste uno, crea un depósito de ese tipo en el creador. Una advertencia que menciona Config.DefaultImpounds significa que el nombre que configuraste ahí no es un depósito de ese tipo, así que se usa el más cercano.
Tras actualizar, faltan coches de jugadores en un garaje
Estaban guardados en un garaje del antiguo config/garages.lua, que la 5.1 ya no lee. Vuelve a crear ese garaje en el creador con el mismo nombre y los coches aparecerán de nuevo, o ejecuta migratev5 para moverlos al depósito. Consulta Actualizar a 5.1.
No hay [G] para entrar en el garaje
Los depósitos, los muelles y los garajes MLO no tienen interior. Para otros garajes, revisa Allow enter shell / interior en el creador, y Config.EnablePublicInteriors para los garajes públicos.
"Shell not found" al entrar en un garaje shell
El modelo del shell no se está transmitiendo. Inicia con ensure el recurso que lo contiene (por ejemplo, la carpeta [shells] de la descarga) y comprueba el nombre del modelo en Config.Shells.
La cámara del menú del garaje no mira al coche
En versiones anteriores a la 5.1.58, los garajes predeterminados podían abrirse con la cámara mirando hacia el lado equivocado. Actualiza el recurso. Para un garaje con una toma personalizada, ábrelo en el creador y usa Edit in studio para rehacerla, o Use default para la cámara de exposición compartida.
Garajes MLO#
No se dibujan plazas y los coches no se aparcan dentro
Un garaje funciona como garaje MLO solo cuando es un garaje de vehículos, no un depósito, con Interior Type MLO y al menos una plaza guardada. Dibuja primero la zona, luego coloca las plazas y después guarda el garaje.
No se puede colocar una plaza
Se vuelve roja cuando está fuera de la zona, a menos de MinSlotDistance de otra plaza, o no está sobre un suelo (una pared o una rampa empinada). R necesita dos plazas colocadas antes para conocer la separación.
"Stored without a slot"
Había más coches en ese garaje que plazas. El coche está guardado de forma segura pero no se muestra en el aparcamiento; añade plazas o saca otro coche.
Muebles y seguro#
/garagedecorate dice que el garaje no admite decoración
Solo se pueden decorar los garajes privados, por su propietario y desde dentro. Puede que otra persona ya lo esté decorando: una persona a la vez.
Las imágenes de los muebles no se suben: "FiveManage token is not set"
Pega tu token de FiveManage en config/fivemanage.lua y reinicia. La captura en sí necesita screenshot-basic en ejecución. Mantén el token en privado: cualquiera que lo tenga puede subir archivos a tu cuenta.
El seguro de todos los coches se calcula como si valieran $50,000
No se encontró su precio. Los precios se leen de qbx_core, de los vehículos compartidos de QBCore o de la tabla vehicles de ESX; los coches addon que falten ahí, u otra tienda de vehículos, necesitan GetInsuranceVehicleValue en server/custom/insurance.lua. El valor por defecto es Config.Insurance.DefaultVehicleValue.
Una póliza caducó aunque la renovación automática estaba activada
La renovación se produce mientras el propietario está conectado y puede pagar desde Config.Insurance.MoneyType. Sin dinero, la renovación automática se desactiva sola y se avisa al propietario.
Se cancela una reclamación: "vehicle not in impound"
El coche se recogió del depósito, o se vendió, antes de presentar la reclamación. Las reclamaciones son para coches destruidos que siguen esperando en el depósito.
¿Sigues atascado? Abre un ticket e incluye la consola del servidor desde el momento en que se inicia
qs-advancedgarages, conConfig.Debugactivado, tu framework y la versión defxmanifest.lua.