Lo que falla con más frecuencia, lo que significa realmente y qué hacer al respecto. La mayoría son problemas de configuración, no fallos. Cuando algo no esté claro, activa Config.Debug y repítelo: las líneas [DEBUG] en la consola del servidor y en F8 muestran dónde se detiene.
Instalación y arranque#
[ERROR] Framework not found! se repite en la consola
Tu framework arranca después de Apartments, o no se llama es_extended, qb-core o qbx_core. Mueve su línea ensure por encima de ensure qs-apartments y reinicia el servidor.
Please remove qbx_property if you want to use qs-apartments in qbx
Un recurso de propiedades de Qbox se está ejecutando junto a Apartments. Elimínalo — y también qbx_properties o qbx_apartments si los tienes. Consulta Migrar y actualizar.
Los jugadores perdieron sus apartamentos tras la instalación
Se importó el database.sql completo en un servidor que ya tenía player_apartments — su primera línea elimina esa tabla. Restaura la tabla desde una copia de seguridad y luego ejecuta solo el bloque de actualización de Migrar y actualizar.
[GARAGES] WARNING: Locale … is missing key
A pesar del nombre, esto viene del cargador de idiomas de Apartments. Falta el archivo de Config.Locale, o le falta la clave indicada. Ese texto se muestra en inglés hasta que añadas la clave a locales/<code>.json.
La consola está llena de líneas [DEBUG]
Config.Debug viene configurado en true. Cámbialo a false en config/main.lua una vez que el servidor esté configurado.
Un jugador se quedó atascado tras reiniciar el recurso
Reiniciar qs-apartments quita el interior a cualquiera que esté dentro. Reinicia sin nadie en casa. Un jugador afectado se reconecta y vuelve a su apartamento.
Edificios e interiores#
No hay blips de apartamentos en el mapa
Es el comportamiento correcto para un jugador sin apartamento. Los blips aparecen cuando tiene uno — al aparecer, con /Apartment, o en una puerta.
No pasa nada en la puerta de un edificio
Sin target, acércate del todo a la puerta: el aviso solo aparece muy cerca del coords.enter del edificio. Con Config.UseTarget = true, el target debe arrancar antes que Apartments, y Config.ZoneDebug = true dibuja las cajas para que veas dónde están.
El propietario solo ve Move Apartment
Su apartamento pertenece a otro edificio — o, tras una migración, a una clave de edificio que el catálogo no tiene. Compara el type de su fila en player_apartments con Config.ApartmentCatalog.
No exit coords found, y una cámara sobre una habitación vacía
El nivel de ese edificio no tiene puerta de salida en shell_offsets.json — un nivel nuevo, o un archivo reemplazado durante una actualización. Colócala una vez y se guarda para todos: Uso → Colocar una puerta de salida.
Tier is not valid en F8, y la puerta no hace nada
El tier del edificio no es un número en Config.Shells. Añade ese nivel, o apunta el edificio a uno que exista.
El interior es invisible, o los jugadores caen a través de él
El modelo del shell no está en streaming. Asegúrate de que K4MB1-StarterShells — o tu propio pack de shells — esté iniciado, y de que el nombre del modelo en Config.Shells esté escrito exactamente como lo carga el pack.
"You are too far away from the door" después de tocar el timbre
El visitante se alejó más de 5 metros de la entrada antes de que el residente abriera. Vuelve a llamar y espera en la puerta.
Stash, armario y códigos de bóveda#
No hay stash ni armario en el apartamento
Es el comportamiento correcto para un apartamento nuevo: el propietario los coloca con /ApartmentLocation. Mudarse a otro edificio también los reinicia.
El stash no se abre
No se encontró ningún inventario compatible cuando arrancó Apartments — comprueba que esté en la lista de Integraciones y que arranque primero, o configura Config.Inventory a mano. Con qb-inventory y sin Quasar Housing en el servidor, cambia el bridge de qb-inventory como se indica allí.
El armario no abre nada
No se encontró ningún script de ropa compatible, o el tuyo cambió el nombre de su menú de atuendos en una actualización. Configura Config.Wardrobe a mano, o ajusta openWardrobe() en client/custom/wardrobe/. En ESX, instala uno de los scripts de ropa compatibles.
Un jugador olvidó su código de bóveda
Pulsa G en ese stash y elige Remove Code, y luego define uno nuevo. Un administrador también puede vaciar la columna vaultCodes de ese apartamento en player_apartments.
You cannot create more vault codes in this house
Un apartamento admite 10 códigos entre todos sus stashes. Elimina uno, o añade Config.MaxVaultCodes = 20 a config/main.lua.
El cargador no hace nada
Tu teléfono no gestiona phone:CreateChargeLocation. Consulta Integraciones → Cargador del teléfono.
Decoración#
"You are not in a garage" al pulsar F9
El texto se comparte con otro script de Quasar: significa que no estás dentro de un apartamento. El menú de decoración solo se abre en interiores.
Decoration is not available, someone using it
Otro jugador del apartamento tiene el menú abierto — solo uno a la vez. Se libera cuando lo cierra o se desconecta.
Please wait for the cleaning robot to return to its dock
Hay un robot limpiando. Detenlo en su base, o espera — vuelve como máximo en cinco minutos.
The entity selection is disabled, you need to go stash category first
Hiciste clic en una pieza colocada mientras estabas en la pestaña Dynamic u Objects. Las piezas que ya tienes se eligen y mueven desde la pestaña Stash.
Una pieza que moví volvió a donde estaba
Una pieza que ya tienes conserva su nueva posición solo después de Save Location en Furniture Management.
Una pieza es invisible, con "This model is not loaded" en F8
El modelo no existe en el juego — normalmente un prop addon que no está en streaming. Cárgalo, o elimina esa pieza de config/furniture.lua.
Las puertas colocadas no se abren
Las puertas solo giran con Config.DynamicDoors = true y setr game_enableDynamicDoorCreation "true" en server.cfg, tras un reinicio completo del servidor.
Cambié Config.FurnitureShops y no apareció nada
Los muebles se compran desde el menú de decoración dentro del apartamento. FurnitureShops y IllegalFurnitures en config/furniture.lua no los lee Apartments.
El Furniture Creator#
"You do not have permissions" en /apartmentfurniture
Tu framework no reconoce a ese jugador como administrador: grupo de ESX admin o superadmin; en QBCore god o admin, o el ace command. Las líneas añadidas a server.cfg se aplican tras un reinicio. Consulta Acceso de administrador.
FiveManage token is not set
El fotomatón no tiene dónde subir las fotos. Pega tu token en config/fivemanage.lua y reinicia — o escribe la URL de una imagen en lugar de usar el botón de la cámara.
Object name is not valid, are you sure it is in the game?
Tu cliente no conoce ese modelo. Revisa cómo está escrito y que el addon que lo carga esté iniciado.
The Object name … is already in this category
Cada modelo puede estar una sola vez en una categoría. Edita la pieza existente o añádele una variante de color.
Cannot delete config items, only database items
Las piezas que vienen en config/furniture.lua se eliminan en ese archivo. El creador solo borra lo que se creó con él.
La basura y el robot de limpieza#
Nunca aparece basura
Config.Cleaning está desactivado, el apartamento ya tiene Config.MaxJunkPerHouse piezas, o nadie ha permanecido dentro durante Config.JunkObjectTime — el reloj se reinicia cada vez que el apartamento se vacía.
You don't have permission to clean this
Solo el propietario del apartamento barre la basura a mano. El robot de limpieza funciona para cualquiera que lo ponga en marcha.
This robot is already being used by someone
Otro jugador lo puso en marcha. Vuelve a su base cuando lo detiene, se va o se desconecta, o al cabo de cinco minutos.
El robot se aleja demasiado o se queda atascado
Coloca la base en suelo despejado, lejos de las patas de los muebles y de las puertas. maxDistanceFromDock en Config.CleanerRobot lo mantiene cerca de casa; redúcelo para un interior pequeño.
Mensajes#
Los mensajes que los jugadores reportan con más frecuencia, en inglés:
Mensaje | Significado |
|---|---|
You don't have enough money! | No hay suficiente en el banco para un apartamento, o en |
You already have an apartment |
|
House not found |
|
Nobody is home | Ahora mismo no hay nadie dentro de un apartamento de ese edificio. |
No exit coords found | El nivel del shell todavía no tiene puerta de salida — colócala. |
Invalid vault code | El código introducido no coincide con el de ese stash. |
This furniture can only be purchased while inside the house | La pieza — un robot de limpieza — debe comprarse desde dentro del apartamento. |
You do not have permissions | El Furniture Creator es solo para administradores. |
¿Sigues atascado? Abre un ticket e incluye la consola del servidor desde el inicio del arranque, tu framework, tu inventario y tu script de ropa con sus versiones, y las líneas
[DEBUG]al repetir el problema conConfig.Debug = true. Una captura de la consola F8 ayuda con cualquier cosa que ocurra en el juego.