Antes de empezar#
Antes de instalar Housing Creator, asegúrate de que tu servidor cumple los requisitos siguientes. Cuatro recursos son dependencias obligatorias: el script no arrancará sin ellos.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos. Se recomienda MariaDB: los archivos SQL usan sintaxis de MariaDB. |
| Obligatorio | Callbacks, zonas, menús y barras de progreso. |
| Obligatorio | Carga los interiores IPL y sus temas de color. |
| Obligatorio | Fotos de los anuncios y miniaturas de muebles. |
Build del juego 3095+ | Obligatorio | Establece |
OneSync | Obligatorio | Cada interior de casa se ejecuta en su propio routing bucket. |
Framework | Opcional | ESX, QBCore o Qbox — detectado automáticamente. El modo standalone funciona con tu propio puente. |
Inventario | Recomendado | Almacenes de la casa, almacenes de muebles e ítems de llave. Se admiten 11 inventarios. |
Garaje | Opcional | Sin un script de garaje compatible, las casas no tienen garaje. |
Target | Opcional |
|
Sonido 3D | Opcional |
|
Los scripts de ropa, teléfono, banca, dispatch y clima también se detectan automáticamente. La lista completa está en Integraciones.
github.comReleases · overextended/oxmysqlMySQL resource for FXServer.github.comReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.github.comReleases · Bob74/bob74_iplIPL loader for FiveM: interiors, apartments and offices.github.comcitizenfx/screenshot-basicScreenshot resource for FiveM.Descargar Housing Creator#
Después de comprar Housing Creator, el recurso queda vinculado a tu cuenta de CFX Portal.
Inicia sesión en CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga la última versión.
Tras extraer la descarga, deberías tener la siguiente carpeta:
[housing]/
├── qs-housing/ -- the script
│ ├── config/ -- what you may edit
│ ├── client/custom/ -- bridges to other resources (editable)
│ ├── server/custom/ -- bridges to other resources (editable)
│ ├── locales/ -- 41 languages
│ └── music/ -- tracks for the house music player
├── [shells]/ -- interior shells (maruii, navypanda, subhampro)
├── [props]/ -- housing-addons, housing-island, housing-sign,
│ housing-shellcreator, qs_pet_cages
├── [dlc]/ -- optional furniture packs
├── [sql]/ -- database files
├── [img]/ -- inventory item images
├── qs-weed/ -- optional weed growing for houses
└── items.lua -- food and cooking itemsLa carpeta debe llamarse
qs-housing. Las rutas de la interfaz dependen de ello, y una copia renombrada imprime You have renamed the script! y detiene el servidor a propósito.
Instalar el recurso#
Mueve toda la carpeta [housing] al directorio resources de tu servidor. [sql], [img] y items.lua no son recursos — se explican más abajo.
Después abre tu server.cfg y enumera cada recurso explícitamente, en este orden:
sv_enforceGameBuild 3095
ensure oxmysql
ensure ox_lib
ensure bob74_ipl
ensure screenshot-basic
# Framework
ensure es_extended # or qb-core / qbx_core
# Everything Housing Creator should detect starts BEFORE it
ensure ox_inventory # your inventory
ensure ox_target # your target (optional)
ensure qs-advancedgarages # your garage, clothing, phone, sound...
# Housing assets
ensure housing-sign
ensure housing-addons
ensure housing-island
ensure housing-shellcreator # Shell Studio pieces (required)
ensure qs_pet_cages # hamster and rat cages (required)
ensure maruii_shells
ensure navypanda_shells
ensure subhampro_exclusive_shells
# The script
ensure qs-housing
# These call qs-housing, so they start AFTER it
ensure qs-weed
ensure KawaiixQuasar_props
ensure KillstorexQuasar_props
ensure lunaticstudio_promo001
ensure murm_dec_packEl orden de carga importa. Las integraciones se detectan una sola vez, cuando arranca qs-housing, así que un inventario o garaje que arranque después se ignora. Los packs de muebles de [dlc] añaden sus ítems al catálogo a través de qs-housing, así que deben arrancar después. Evita ensure [housing]: un ensure de carpeta arranca los packs demasiado pronto.
Recurso | Qué contiene |
|---|---|
| Robots de limpieza, polvo y basura, aire acondicionado y chimeneas, cuadros y alfombras intercambiables, suciedad de mascotas y arenero, el panel de casa inteligente. Necesario para esas funciones. |
| El cartel de "se vende" fuera de las casas. |
| 16 islas privadas que puedes colocar bajo una casa. Opcional. |
| Todas las piezas de Shell Studio: suelos, paredes, puertas, ventanas, escaleras, ascensores, plazas de aparcamiento, luces y decoración. Obligatorio: qs-housing no arranca sin él. |
| Las jaulas de hámster y rata con su rueda, las dos mascotas y sus animaciones. Obligatorio: qs-housing no arranca sin él. |
| Los shells de interior: Maruii, NavyPanda y los exclusivos de SubhamPRO. No renombres sus archivos. |
| Packs de muebles adicionales (setups gaming, muebles modernos, decoración). Opcional. |
La base de datos#
Importa un solo archivo de esquema para tu framework. Ambos archivos se pueden ejecutar de nuevo sin riesgo al actualizar: solo añaden lo que falta. Algunas columnas pequeñas también se añaden automáticamente al arrancar.
Archivo | Cuándo importarlo |
|---|---|
| ESX. Crea las tablas y añade el trabajo |
| QBCore y Qbox. Crea las tablas. El trabajo se añade en tu framework (más abajo). |
| Opcional. 421 casas y apartamentos listos en Vinewood, Mirror Park, Sandy Shores, Paleto Bay, Richman, Banham Canyon y Chumash. |
| Opcional. Solo las 71 casas de Mirror Park. Ya están en |
| Elimina todas las tablas de viviendas. Solo para borrar una instalación antigua o rota antes de empezar de cero. |
Tablas | Contienen |
|---|---|
| Cada casa, y quién la posee, la alquila o tiene sus llaves. |
| Pagos de alquiler y facturas de suministros. |
| Muebles colocados, muebles añadidos en el juego, tiendas de muebles y sus entregas. |
| Ítems de llave físicos. |
| Polvo y basura, bolsas de basura y muebles robados en atracos. |
| Modelos exteriores de casas e islas, y plantas de marihuana para |
| Inmobiliarias: miembros, rangos, anuncios, finanzas y estadísticas. |
| Shells creados en Shell Studio y sus fotos. Se crean automáticamente la primera vez que arranca el recurso. |
| Instalaciones, publicaciones y fotos de Quasar Matrix. Se crean automáticamente la primera vez que arranca el recurso. |
El trabajo realestate en QBCore y Qbox#
En ESX el trabajo viene de esx.sql. En QBCore añádelo a qb-core/shared/jobs.lua (en Qbox, qbx_core/shared/jobs.lua) para que los agentes inmobiliarios puedan abrir el creador:
['realestate'] = {
label = 'Real Estate',
defaultDuty = true,
offDutyPay = false,
grades = {
['0'] = { name = 'Agent', payment = 50 },
['1'] = { name = 'Senior Agent', payment = 75 },
['2'] = { name = 'Manager', payment = 100 },
['3'] = { name = 'Boss', isboss = true, payment = 150 },
},
},Registrar los ítems#
Estos ítems deben existir en tu inventario. Housing Creator los registra como utilizables; no los crea.
Ítem | Config | Para qué se usa |
|---|---|---|
|
| Una llave física. Debe ser única (no apilable) para que cada llave conserve su casa. |
|
| Entrar a la fuerza en una casa. |
|
| Redadas policiales. |
|
| Cuencos de comida y agua para mascotas. |
Ítems de comida |
| 34 ingredientes, platos y comidas a domicilio que usan la cocina y el reparto de comida. |
Añade a ox_inventory/data/items.lua. La llave usa el export que proporciona Housing Creator:
['housekey'] = {
label = 'House Key',
weight = 100,
stack = false,
close = true,
description = 'Your house key, do not lose it.',
server = { export = 'qs-housing.useHouseKey' },
},
['lockpick'] = { label = 'Lockpick', weight = 100, stack = true },
['police_stormram'] = { label = 'Police Storm Ram', weight = 800, stack = false },
['pet_food'] = { label = 'Pet Food', weight = 200, stack = true },
['pet_water'] = { label = 'Pet Water', weight = 200, stack = true },Añade a qb-core/shared/items.lua (Qbox usa ox_inventory — consulta esa pestaña):
['housekey'] = { name = 'housekey', label = 'House Key', weight = 100, type = 'item', image = 'housekey.png', unique = true, useable = true, shouldClose = true, description = 'Your house key, do not lose it.' },
['lockpick'] = { name = 'lockpick', label = 'Lockpick', weight = 100, type = 'item', image = 'lockpick.png', unique = false, useable = true, shouldClose = true, description = 'Opens doors that should stay closed.' },
['police_stormram'] = { name = 'police_stormram', label = 'Police Storm Ram', weight = 800, type = 'item', image = 'police_stormram.png', unique = false, useable = true, shouldClose = true, description = 'Opens any door, legally.' },
['pet_food'] = { name = 'pet_food', label = 'Pet Food', weight = 200, type = 'item', image = 'pet_food.png', unique = false, useable = true, shouldClose = true, description = 'Food for your companion.' },
['pet_water'] = { name = 'pet_water', label = 'Pet Water', weight = 200, type = 'item', image = 'pet_water.png', unique = false, useable = true, shouldClose = true, description = 'Water for your companion.' },Añade a qs-inventory/shared/items.lua, con el mismo formato que el items.lua raíz:
['housekey'] = {
['name'] = 'housekey',
['label'] = 'House Key',
['weight'] = 100,
['type'] = 'item',
['image'] = 'housekey.png',
['unique'] = true,
['useable'] = true,
['shouldClose'] = true,
['combinable'] = nil,
['description'] = 'Your house key, do not lose it.'
},
-- lockpick, police_stormram, pet_food and pet_water follow the same patternPara un inventario de ESX que lee la tabla items:
INSERT IGNORE INTO `items` (`name`, `label`, `weight`) VALUES
('housekey', 'House Key', 1),
('lockpick', 'Lockpick', 1),
('police_stormram', 'Police Storm Ram', 1),
('pet_food', 'Pet Food', 1),
('pet_water', 'Pet Water', 1);Los ítems de comida y cocina (pan, queso, hamburguesa, pizza, café y el resto) están listos para pegar desde items.lua en la descarga. Sus imágenes, y la mayoría de las anteriores, están en [img]: cópialas a la carpeta de imágenes de tu inventario (por ejemplo ox_inventory/web/images/).
Comer la comida lo gestiona tu framework o tu script de consumibles, no Housing Creator. Si la opción de combustible de la chimenea está activada, sus ítems de leña también deben existir.
Obtener acceso al creador#
El creador de casas (/realestate o F7) es donde se construye cada propiedad, así que solo los admins y los trabajos inmobiliarios pueden abrirlo. Cuando un jugador no tiene permiso, el comando simplemente no hace nada.
Cualquier trabajo y rango listado en config/main.lua. false significa todos los rangos:
Config.CreatorJobs = {
{ job = 'realestate', grade = { 0, 1, 2, 3 } },
{ job = 'realestatejob', grade = false },
}Con Config.AllowAdminsToCreateHouses = true (por defecto): grupos de ESX admin y superadmin; en QBCore y Qbox, permiso god o admin, o el ace command.
Añade el identificador del jugador a la tabla Admins al principio de server/custom/framework/standalone.lua:
Admins = {
['license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'] = true,
}Algunas herramientas son solo para admins incluso para los trabajos inmobiliarios: teletransportarse a una casa desde la lista del creador y el creador de muebles.
Configurar el recurso#
Las casas, las tiendas de muebles y las inmobiliarias se construyen en el juego. Los archivos contienen las reglas de la economía y las funciones que activas o desactivas.
Archivo | Contenido |
|---|---|
| Idioma, dinero, comisiones, hipoteca, alquiler, facturas, llaves, mejoras, teclas, blips, shells, IPLs, limpieza, climatización, robos, entregas y cocina. |
| El catálogo de muebles: habitaciones, categorías, cada prop y su precio. |
| Mascotas, sus precios, necesidades, niveles, juego de buscar y suciedad, y las jaulas de hámster y rata ( |
| Shell Studio: su comando, quién puede usarlo, el almacén por defecto, el límite de objetos, el autoguardado y los estilos de ascensor, aparcamiento y luces. |
| El catálogo de Shell Studio: cada pieza de techo, suelo, pared, puerta, ventana, escalera y decoración que ofrece. |
| Inmobiliarias: el comando del menú de jefe, los permisos por defecto de los rangos, el tamaño del almacén, el precio mínimo de anuncio. |
| Aura Voice, los comandos de voz de la casa (no es una IA): nombre, idioma de voz, tecla de pulsar para hablar. |
| El webhook de Discord para logs y, opcionalmente, uno por acción: compra y venta, creación de casas, alquiler y desahucios. Solo servidor. |
| Tu token de FiveManage, necesario para las fotos de los anuncios y las miniaturas de muebles. Solo servidor. |
Los valores que conviene revisar primero:
Config.Locale = 'en' -- or setr qs:locale "es" in server.cfg
Config.MoneyType = 'money' -- 'money' (cash) or 'bank'
Config.Society = 'esx_society' -- on QBCore: 'qb-management', 'qb-banking'... or 'none'
Config.UseTarget = false -- true for ox_target / qb-target
Config.MaxOwnedHouses = 15
Config.BankFee = function(price) return price / 100 * 10 end -- 10%
Config.BrokerFee = function(price) return price / 100 * 5 end -- 5%
Config.Taxes = function(price) return price / 100 * 5 end -- 5%
Config.CreditTime = 5 -- minutes between mortgage instalments
Config.Intl = { locales = 'en-US', options = { style = 'currency', currency = 'USD', minimumFractionDigits = 0 } }
Config.Debug = false -- ships as true: turn it off on a live serverEl temporizador de la hipoteca viene corto para que puedas probarlo en minutos. Antes de salir a producción, aumenta
Config.CreditTimey revisaConfig.RentScheduler— consulta Uso.
Verificar la instalación#
Reinicia el servidor y lee la consola. El comprobador de actualizaciones imprime tu versión, la última y si estás al día:
[UPDATER] Started | local v5.6.57 | remote v5.6.57 | status LATEST
# or, when an update is out
[UPDATE] Resource : housing-creator
[UPDATE] Local version : v5.6.55
[UPDATE] Remote version: v5.6.57
[UPDATE] Urgency : CRITICAL
[UPDATE] How to update : Go to https://portal.cfx.re, download the latest asset and reinstall/replace this resource.
[UPDATE] Full changelog: https://www.quasar-store.com/updates/housing-creator/changes?from=5.6.55Si hay errores SQL en rojo encima, el esquema no se importó. Luego entra y recorre el primer ciclo:
Abre el creador
Pulsa F7 o escribe
/realestate. La tablet enumera todas las casas; si importasteall_houses.sql, ya están ahí.Visita y compra una casa
Camina hasta una casa en venta y pulsa [E] Property Details. Prueba Visit, luego Buy y firma el contrato.
Gestiónala
En la casa, pulsa F3. Coloca el almacén y el armario, luego abre Decorate y coloca un mueble.
Los archivos de idioma de
locales/se leen al arrancar: editar una traducción solo requiere reiniciar el recurso.