Docs /Foltone Garage/Configuracion
v2.0.0

Configuracion — foltone_garage

La configuracion se divide en dos archivos: Config.lua (opciones generales) y config_garage.lua (garajes, depositos, vehiculos de servicio).

Config.lua — Opciones generales

Framework

Config.Framework = "esx" -- "esx", "qbcore" o "qbx"
ValorFrameworkDependencias requeridas
"esx"ESX Legacyes_extended, oxmysql
"qbcore"QBCoreqb-core, oxmysql
"qbx"QBXqbx_core, oxmysql

Idioma

Config.Locale = "en" -- "en" o "fr"

Las traducciones se encuentran en locales/en.lua y locales/fr.lua. Puedes agregar tu propio idioma creando un nuevo archivo.

Tipo de menu

Config.MenuType = "nui" -- "nui" o "rageui"
ModoDescripcion
"nui"Panel HTML moderno con 4 pestanas (vehiculos, almacenar, deposito, etiqueta)
"rageui"Menu clasico RageUI con 3 submenus (vehiculos, almacenar, deposito)

El modo "rageui" no soporta etiquetas personalizadas de vehiculos.

Tipo de interaccion

Config.InteractionType = "ox_target" -- 5 opciones disponibles
ModoDescripcionDependencia
"ox_target"Target 3D via ox_targetox_target
"qb-target"Target 3D via qb-targetqb-target
"interact"Target 3D via interactinteract
"drawtext"Texto de ayuda en pantalla con tecla ENinguna
"marker"Marcador en el suelo con tecla ENinguna

Distancia de interaccion

Config.InteractionDistance = 2.5

Distancia en metros para activar la interaccion (solo modos drawtext y marker).

Texto de ayuda (modo drawtext)

Config.DrawText = {
    label = "interact_label", -- clave de traduccion
}

Marcador (modo marker)

Config.Marker = {
    type = 1,
    scale = vector3(1.0, 1.0, 0.5),
    color = { r = 59, g = 130, b = 246, a = 120 },
}
ParametroDescripcion
typeTipo de marcador GTA (1 = cilindro)
scaleDimensiones del marcador
colorColor RGBA del marcador

PED

Config.Ped = {
    model = "a_m_y_business_03",
    scenario = "WORLD_HUMAN_STAND_IMPATIENT",
}
ParametroDescripcion
modelModelo del PED administrador del garaje
scenarioAnimacion del PED (escenario nativo de GTA)

Blip

Config.Blip = {
    enabled = true,
    sprite = 357,
    color = 3,
    scale = 0.7,
}
ParametroDescripcion
enabledActivar/desactivar blips en el mapa
spriteID del sprite del blip de GTA
colorID del color del blip de GTA
scaleTamano del blip

Sistema de deposito

Config.Pound = {
    basePrice = 500,
    pricePerHour = 100,
    maxPrice = 5000,
    minPrice = 200,
}
ParametroDescripcion
basePricePrecio base para recuperar un vehiculo del deposito
pricePerHourMonto adicional por hora en el deposito
maxPricePrecio maximo tope para la tarifa del deposito
minPricePrecio minimo garantizado (nunca baja de este valor)

El precio se calcula dinamicamente segun el tiempo transcurrido desde la incautacion.

Etiqueta personalizada

Config.Label = {
    maxLength = 30,
}
ParametroDescripcion
maxLengthLongitud maxima permitida para la etiqueta de un vehiculo

config_garage.lua — Garajes y depositos

Nombres de garaje predeterminados

ConfigGarage.defaultGarageCarName = "garage"
ConfigGarage.defaultGarageBoatName = "garage_bateau1"
ConfigGarage.defaultGaragePlaneName = "garage_plane1"
ConfigGarage.defaultGarageHeliName = "garage_heli1"

Estos nombres corresponden a los garajes donde se colocaran los vehiculos cuando se almacenen desde un garaje con saveGarage = false.

Estructura de una entrada de garaje

{
    garageName = "garage",           -- identificador unico (minusculas, sin espacios)
    garageLabel = "Downtown Garage", -- etiqueta mostrada en el menu
    saveGarage = true,               -- guardar vehiculos en este garaje en la BD
    job = nil,                       -- trabajo requerido (acceso exclusivo para este trabajo)
    job2 = nil,                      -- trabajo secundario (banda / trabajo alternativo)
    annyJob = nil,                   -- restringir acceso a CUALQUIER grado de este trabajo
    -- maxVehicles = 10,             -- limite de vehiculos (opcional, comentar para ilimitado)
    distanceStore = 25.0,            -- radio de almacenamiento en metros
    positionMenu = vector3(x, y, z), -- posicion del PED / interaccion
    spawnVehPositions = {
        vector4(x, y, z, heading),   -- posiciones de aparicion del vehiculo
    },
    storeVeh = vector3(x, y, z),     -- zona de almacenamiento del vehiculo
}
ParametroDescripcion
garageNameIdentificador unico del garaje — debe ser unico si saveGarage = true
garageLabelNombre mostrado en la interfaz
saveGarageSi es true, los vehiculos se asocian a este garaje en la BD
jobSi se define, solo los jugadores con este trabajo pueden acceder al garaje
job2Trabajo secundario (util para bandas o trabajos duplicados)
annyJobRestringe el acceso a cualquier grado de este trabajo (police, ambulance…)
maxVehiclesNumero maximo de vehiculos (opcional — comentar para ilimitado)
distanceStoreDistancia maxima para almacenar un vehiculo desde storeVeh
positionMenuCoordenadas del punto de interaccion / PED
spawnVehPositionsArray de posiciones de aparicion (incluye heading)
storeVehPunto de almacenamiento del vehiculo

Vehiculos de servicio

Para garajes de trabajo, puedes definir vehiculos de servicio accesibles desde la pestana Almacenar (o el submenu correspondiente en RageUI):

serviceVehicles = {
    { model = "police",  label = "Police Cruiser" },
    { model = "police2", label = "Police Buffalo" },
},

Los vehiculos de servicio solo estan disponibles para jugadores con el trabajo requerido. No se guardan en la base de datos.

Color de blip personalizado por garaje

blipColor = 38,
color = {r = 20, g = 100, b = 80},
ParametroDescripcion
blipColorColor del blip de GTA para este garaje especifico
colorColor RGB del indicador en la interfaz NUI

Tipos de vehiculo

Los vehiculos se organizan en 4 categorias:

ClaveDescripcion
"car"Coches y motocicletas
"boat"Barcos
"plane"Aviones
"heli"Helicopteros

Cada tipo puede activarse o desactivarse:

["car"] = {
    enable = true,
    positionGarageList = { ... },
},

Agregar un garaje

Agrega una entrada al array positionGarageList del tipo deseado:

{
    garageName = "my_garage",
    garageLabel = "My New Garage",
    saveGarage = true,
    job = nil,
    job2 = nil,
    annyJob = nil,
    distanceStore = 25.0,
    positionMenu = vector3(x, y, z),
    spawnVehPositions = {
        vector4(x, y, z, 0.0),
    },
    storeVeh = vector3(x, y, z)
},

Depositos (poundList)

ConfigGarage.poundList = {
    ["car"] = {
        ["pound_car_1"] = {
            label = "Davis Pound",
            positionMenu = vector3(x, y, z),
            spawnVehPositions = { vector4(x, y, z, heading) },
        },
    },
    ["boat"] = { ... },
    ["plane"] = { ... },
    ["heli"] = { ... },
}
ParametroDescripcion
labelNombre del deposito mostrado en la interfaz
positionMenuPunto de interaccion / PED del deposito
spawnVehPositionsPosiciones de aparicion para los vehiculos recuperados

Agregar un deposito

Agrega una entrada al array del tipo de vehiculo deseado:

["pound_car_3"] = {
    label = "North Pound",
    positionMenu = vector3(x, y, z),
    spawnVehPositions = { vector4(x, y, z, 0.0) },
},

La clave debe ser unica por tipo de vehiculo (ej. "pound_car_3", "pound_boat_2").