Inicio › Documentación › Configuración · origen_housing

Configuración · origen_housing

La configuración está repartida en varios ficheros dentro de config/.


config/_main.lua — General

Variable Por defecto Descripción
Config.Language 'en' Idioma de la interfaz — 'en' | 'es' | 'fr' | 'it'
Config.Debug false Activa el registro de depuración
Config.DatabaseStructureCheck true Valida la estructura de la base de datos al arrancar
Config.RenderDistance 200 Distancia en metros para renderizar edificios y mobiliario exterior
Config.DoorLimit 10 Máximo de puertas por casa (solo MLO). false = sin límite
Config.LightsLimit.interior 10 Máximo de luces interiores por casa
Config.LightsLimit.exterior 10 Máximo de luces exteriores por casa
Config.SaveDoorStatus true Guarda en la base de datos el estado abierto/cerrado de las puertas
Config.StartBuildingOnBuy true Inicia la construcción inmediatamente al comprar. false = se inicia al crear la casa
Config.LoadFurnitureOnlyInPolyzone false Carga el mobiliario solo cuando el jugador está dentro de la polyzone
Config.GarageNeedMainDoorUnlocked false El garaje se bloquea cuando la puerta principal está bloqueada
Config.KeyHoldersNeedDoorUnlocked false Los poseedores de llave solo pueden entrar si la puerta principal está desbloqueada
Config.LimitOfHouses 10 Máximo de casas que puede tener un jugador. false = sin límite
Config.LimitOfKeyHolders 15 Máximo de poseedores de llave por casa. false = sin límite
Config.CustomDrawText false Usa Custom.DrawText en lugar del texto en pantalla del framework
Config.CustomNotify false Usa Custom.Notify en lugar de las notificaciones de ox_lib
Config.ExternalInteractionSystem false Usa Custom.CreateCoordsInteraction para los puntos de interacción
Config.EnableStashesLimit false Limita el número de alijos por casa
Config.StashesLimit 5 Máximo de alijos por casa (cuando EnableStashesLimit = true)
Config.ShowHousePanelOnBuy true Muestra el panel de la casa justo después de comprarla
Config.CustomInventory false Usa Custom.OpenStash en lugar del inventario detectado automáticamente
Config.CustomClothing false Usa Custom.Wardrobe en lugar del sistema de ropa detectado automáticamente
Config.EnterHouseOnSpawn true Teletransporta al jugador a su última casa al aparecer
Config.UseNameInBlipInsteadOfId false Muestra el nombre de la casa en lugar del ID en los blips del mapa
Config.UseHouseGarages false Activa el sistema de garajes integrado
Config.ForceDisableRain false Desactiva la lluvia dentro de los interiores shell
Config.FurnitureEnable.interior true Permite colocar mobiliario interior
Config.FurnitureEnable.exterior true Permite colocar mobiliario exterior

Blip

lua
Config.Blip = {
    sprite              = 350,
    scale               = 0.6,
    color               = 0,
    buyedSprite         = 40,        -- sprite for owned houses
    showBlipInDistance  = false,     -- short range blip
}

Marcadores

lua
Config.Markers = {
    ['general'] = { type = 20, color = {0, 0, 0, 200}, ... },  -- entry/exit points
    ['garage']  = { type = 36, color = {0, 0, 0, 200}, ... },  -- garage points
}

Pago

lua
Config.DefaultPaymentMethod = 'cash'
 
Config.PaymentMethods = {
    ['cash'] = true,
    ['bank'] = true,
}

Distancias de las puertas

lua
Config.DoorDistances = {
    ['normal'] = 2.0,
    ['double'] = 2.0,
    ['garage'] = 3.5,
}

Correspondencia de columnas de la base de datos

Relaciona los nombres internos de campo con las columnas de las tablas de tu framework. Usa valores 'custom' cuando uses Config.Framework = 'custom':

Campo QBCore ESX
tabla players players users
columna identifier citizenid identifier
tabla vehicles player_vehicles owned_vehicles
columna owner citizenid owner
columna mods mods vehicle
columna state state stored
columna garage garage parking

config/permissions.lua

Grupos de administración que pueden crear, eliminar o editar casas:

lua
Config.Permissions = {
    ['create'] = {'god', 'admin'},
    ['delete'] = {'god', 'admin'},
    ['edit']   = {'god', 'admin'},
}

Permisos por trabajo (agente inmobiliario)

lua
Config.Job = {
    active = true,
    allowed = {
        ['realestate'] = {
            minGrade = 1,
            create   = true,
            delete   = false,
            edit     = false,
        },
    }
}

config/commands.lua

Comando Tecla por defecto Descripción
/housing — Abre el menú de administración / gestión inmobiliaria
/management O Abre el menú de gestión de la casa (dentro de una casa)
/furniture K Abre el menú de colocación de mobiliario (dentro de una casa)

config/logs.lua — Webhooks de Discord

lua
ServerConfig.UseIdentifiers = true  -- include player identifiers in logs
 
ServerConfig.Logs = {
    CreateHouse  = 'YOUR_DISCORD_WEBHOOK',
    DeleteHouse  = 'YOUR_DISCORD_WEBHOOK',
    BuyHouse     = 'YOUR_DISCORD_WEBHOOK',
    BuyUpgrade   = 'YOUR_DISCORD_WEBHOOK',
    CreateDoor   = 'YOUR_DISCORD_WEBHOOK',
}

config/upgrades.lua

Mejoras que se pueden comprar y sus precios:

Clave Nombre Precio
alarm Alarma $10,000
cameras Cámaras $12,000
doors Puertas $15,000
sensors Sensores $10,000
storage_security Seguridad del almacén $10,000
domotic Domótica $10,000

config/stashes.lua

Tipos de alijo disponibles para guardar objetos en la casa:

Clave Peso Huecos
small 5 1
normal 20 5
medium 25 6
big 50 10
extrabig 100 30

config/raid.lua

lua
Config.Raid = {
    enabled      = true,
    item         = 'stormram',
    allowedJobs  = { ['police'] = true, ['sheriff'] = true, ['fib'] = true },
    triggerAlarm = true,
    skillcheck   = true,
    animation    = { dict = 'melee@unarmed@streamed_core', anim = 'kick_close_a' },
}

config/robbery.lua

lua
Config.Lockpick = {
    enabled               = true,
    customLockpickMinigame = false,  -- use Custom.LockpickMinigame if true
    policeNeed            = 2,
    maxTry                = 3,
    item                  = 'lockpick',
    advancedItem          = 'advancedlockpick',
    alertOwner            = true,
}
 
Config.AlarmDuration = 5   -- alarm duration in minutes
Config.Dispatch      = 'origen_police'  -- 'origen_police' | 'custom'
Config.PoliceJob     = 'police'

config/garages.lua

Activa el garaje integrado poniendo Config.UseHouseGarages = true.

Tipos de garaje disponibles:

Nombre Modelo Plazas
Garaje básico basic 1
Garaje mediano medium 4
Garaje grande large 10
Garaje premium premium 16 (3 plantas)

Pon Config.CustomGarage = true e implementa Custom.OpenCustomGarage(houseID, garageType, coords) para usar tu propio sistema de garajes.