Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría de los problemas vienen del orden de carga o de un ítem que falta — lee la primera sección antes que nada.
Instalación y acceso#
El recurso no se inicia
La consola indica la dependencia que falta. qs-housing necesita que oxmysql, ox_lib, bob74_ipl, screenshot-basic, housing-shellcreator y qs_pet_cages se inicien antes que él, y la build del juego 3095 o superior:
sv_enforceGameBuild 3095Las dos últimas vienen en [props]. Si faltan, vuelve a descargar el asset Housing [props] desde el CFX Portal.
Si la consola dice You have renamed the script!, vuelve a renombrar la carpeta a qs-housing.
/realestate (F7) no hace nada
El jugador no tiene permiso y el creador falla sin avisar. Necesita una de estas opciones:
Un trabajo y rango en
Config.CreatorJobs(por defectorealestate). En QBCore y Qbox el trabajo debe existir en tu archivo de trabajos.Grupo de ESX
admin/superadmin, o QBCoregod/admin, conConfig.AllowAdminsToCreateHouses = true.En standalone, su identificador en la tabla
Adminsdeserver/custom/framework/standalone.lua.
Comprueba también que F7 no se haya reasignado en los ajustes de teclas de FiveM del jugador y que ninguna otra interfaz tenga el ratón.
Error de SQL cerca de "IF NOT EXISTS" al importar
esx.sql y qb.sql usan sintaxis de MariaDB para poder ejecutarse de nuevo sin riesgo. Usa MariaDB o, en MySQL 8, ejecuta cada sentencia sin IF NOT EXISTS y omite las columnas que ya tienes.
"Duplicate entry 'realestate'" al final de esx.sql
El trabajo ya existe de una importación anterior. Es inofensivo — todo lo anterior a esa línea se aplicó.
"Illegal mix of collations" al importar qb.sql en Qbox
Corregido en la 5.5.41. Descarga la versión actual e importa su qb.sql.
Errores de clave duplicada al importar las casas preset
mirror_park.sql forma parte de all_houses.sql, o las casas ya se importaron. Importa solo uno de los dos, una vez.
"Waiting for houses to be initialized" en la consola
Un jugador entró antes de que las casas terminaran de cargar. Si se repite, busca errores de SQL encima: el esquema no se importó o la base de datos no es accesible. Un jugador que entró demasiado pronto puede escribir /houseload.
Las llaves, ganzúas o comederos de mascotas no hacen nada
Los ítems no están registrados en tu inventario. Añade housekey, lockpick, police_stormram, pet_food y pet_water como se muestra en Instalación, además de la comida de items.lua para cocinar. La llave de la casa debe ser única (no apilable). Los comederos de mascotas solo funcionan en el exterior, en tu propia propiedad.
El texto aparece en inglés o la consola avisa sobre el idioma
El código de idioma no existe o a una traducción personalizada le faltan líneas nuevas (esas pasan a inglés). Usa uno de los 41 códigos de locales/ y reinicia el recurso. El aviso lleva la etiqueta [GARAGES] pero viene de qs-housing.
Casas e interiores#
Pantalla negra o caída al entrar en un shell
El modelo del shell no está en streaming. Haz ensure de los recursos [shells] antes de qs-housing y comprueba que el model del shell en Config.Shells coincide con el nombre en streaming. Con conexiones lentas, aumenta Config.DefaultRequestModelTimeout. El creador rechaza un modelo que no está en streaming con "Model is not valid".
Una casa IPL me devuelve dentro o la salida está en el lugar equivocado
Los interiores IPL con zona mantienen al jugador dentro, y su salida viene de Config.IplData. Asegúrate de que bob74_ipl se inicie primero y de usar la última versión.
"Please add PolyZone / exit coords" en la consola
A una casa le falta un punto obligatorio y se omite. Ábrela en el creador y coloca el punto que falta, o vuelve a crearla. Para las casas escritas a mano en Config.Houses, completa sus coords.
"House ... has invalid coordinates and was skipped"
Una casa tiene guardadas coordenadas rotas, así que se deja fuera y todas las demás cargan con normalidad. Ejecuta housing_checkcoords en la consola del servidor para listarlas, y housing_checkcoords fix para reparar las que se pueden reparar. El resto se listan para que las corrijas en el creador. Reinicia el recurso después.
Las puertas de MLO no se cierran con llave, o solo desde un punto
Solo los poseedores de llaves pueden cerrar las puertas de MLO. Actualiza a la última versión, dale una llave al jugador y ajusta Config.DoorDistance y Config.DoorDuplicateDistance para puertas anchas o dobles. Las puertas de muebles necesitan setr game_enableDynamicDoorCreation "true".
Un jugador está atrapado dentro o aparece en el vacío
Su indicador "inside" sobrevivió a un crash. Desde la consola del servidor o un script:
exports['qs-housing']:ClearPlayerInsideByIdentifier('char1:xxxx')"Unknown column 'inside'" significa que el archivo SQL no se importó. OneSync debe estar activado: los interiores usan routing buckets.
Un jugador no puede comprar una casa
Lee la notificación. Normalmente ha alcanzado Config.MaxOwnedHouses, no tiene dinero en el método de pago de la casa (precio más un 20% de comisiones por defecto) o la casa se retiró del mercado con SetHouseForSale. Desde la app del teléfono también debe estar a menos de 48 m.
El alquiler nunca se cobra, o se cobra en un momento extraño
El valor por defecto Config.RentScheduler.Mode cobra una vez por mes real, el día en que empezó el alquiler. Config.RentTime solo se aplica con Mode = 'interval'.
La casa de un jugador desapareció
Busca "Auto Eviction" en el log de Discord: Config.Bills.AutoEviction elimina a los propietarios tras MaxUnpaidBills facturas sin pagar (400 por defecto). Auméntalo o desactívalo, y reasigna la casa con AssignHouseToPlayer si hace falta.
La casa está a oscuras
Las luces están apagadas (Door Menu → lights) o hay más de una factura sin pagar. Págalas en F3 → Bills.
Decoración y muebles#
Decorar no se abre
La notificación dice por qué:
No eres el propietario —
Config.DecorateOnlyAccessForOwnerestá activado.Sin llave, o el poseedor de la llave no tiene acceso a muebles en F3 → Settings → Permissions.
Facturas sin pagar — págalas en F3.
Robot no acoplado — detén primero el robot de limpieza.
"You are too far from the decoration area"
La cámara fue más allá de Config.MaximumDistanceForDecorate (350 m). Quédate más cerca, auméntalo o ponlo en false.
No se pueden comprar más muebles
La casa alcanzó Config.FurnitureLimits — 50 piezas, o 150 con la Furniture Upgrade. Las piezas guardadas también cuentan: vende las que no uses.
Los muebles volvieron a donde estaban
Mover una pieza que ya tienes solo se conserva si pulsas Save antes de seleccionar otra o cerrar.
Los muebles son invisibles
Su modelo no está en streaming: haz ensure de [props] y de los packs de [dlc] que uses. Además, los muebles solo aparecen dentro de Config.SpawnDistance (100 m).
Faltan en el catálogo los packs de muebles de [dlc]
Se iniciaron antes de qs-housing. Haz ensure de ellos después, uno a uno — no con ensure [housing].
"Category does not exist in furniture settings"
Se añadieron muebles a una categoría que no está en config/furniture.lua. Usa una categoría existente. AddFurniture es un export de servidor; el de cliente solo imprime que se movió.
"FiveManage token is not set" o las fotos no se suben
Pon tu token en config/fivemanage.lua. "Failed to get presigned url" significa que el token es incorrecto o ha caducado.
Faltan muebles tras actualizar desde una versión muy antigua
Haz una copia de seguridad de la base de datos, ejecuta revert_decorations en la consola del servidor y reinicia cuando te lo pida.
No se puede colocar una cama de mascota o una mascota
Cada mascota necesita la mejora Companion Animal, y las mascotas no están permitidas en edificios de apartamentos. Una cama de mascota debe quedar en el exterior, dentro del límite de la propiedad; las jaulas para hámsteres y ratas van en cualquier parte de la casa. Si las jaulas son invisibles, qs_pet_cages no está iniciado.
Integraciones#
El almacén no se abre
No se encontró ningún inventario compatible al iniciar. Haz ensure de tu inventario antes de qs-housing, o configúralo a mano — en ESX básico, Config.Inventory = 'esx_inventory'. Si los jugadores reciben "you do not have keys", eso es Config.StashNeedsKey.
Las casas no tienen garaje
No había ningún script de garajes compatible en marcha cuando se inició qs-housing, así que los garajes están desactivados. Haz ensure de él primero, o configura Config.Garage a mano. Los apartamentos nunca tienen garaje.
Las opciones de target no aparecen
Configura Config.UseTarget = true y ejecuta ox_target o qb-target. Config.ZoneDebug = true dibuja las zonas para que veas dónde están.
La comisión inmobiliaria nunca llega (QBCore)
Config.Society tiene por defecto 'esx_society'. Cámbialo a 'qb-management', tu script bancario o 'none' — consulta Integraciones.
No se usa el guardarropa, el teléfono o el dispatch
La misma causa: se inició después de qs-housing o se renombró. Corrige el orden o configura el valor a mano.
Baneos de FiveGuard en el creador, en el modo decorar o al entrar
Configura Config.FiveGuard con el nombre de tu recurso de FiveGuard. "FiveGuard SetTempPermission failed" en la consola significa que el nombre es incorrecto. Si el sonido del timbre está bloqueado, configura Config.DisableInteractSound = true.
La música de la casa no suena
Necesita mx-surround, qs-3dsound o xsound, archivos (no enlaces) en qs-housing/music/, y una casa shell o IPL.
"Do not use qb-houses exports anymore"
Otro script todavía llama a qb-houses. Sigue funcionando; pásalo a los exports de qs-housing cuando puedas.
Rendimiento#
La consola está llena de líneas [DEBUG]
Config.Debug viene activado. Ponlo, junto con Config.ZoneDebug, en false en un servidor en producción; eso también elimina los comandos de desarrollador.
FPS bajos cerca de muchas casas
Reduce Config.SpawnDistance, mantén Config.ShowClosestBlips activado y evita edificios de apartamentos enormes (Config.MaxApartmentCount).
Mensajes del comprobador de actualizaciones
Al iniciar, [UPDATER] Started muestra tu versión, la más reciente y el estado. Cuando sale una actualización, el bloque [UPDATE] indica su urgencia y sus cambios, con un enlace al registro de cambios completo. Descárgala desde el CFX Portal. Si el comprobador no puede conectar con Quasar Store, no imprime nada y el script funciona con normalidad.
¿Sigues atascado? Abre un ticket con los nombres de tu framework, inventario y garaje, tu orden de ensure en server.cfg y la salida de la consola desde el inicio del servidor.