Uso

Cómo llegan los jugadores a un garaje#

Cada garaje tiene una zona (el área que cubre), un punto de menú donde los jugadores lo abren a pie, y uno o más puntos de aparición donde los coches salen y se guardan. Cómo interactúa un jugador con esos puntos depende de Config.UseTarget:

Un garaje puede desactivar cualquiera de las dos acciones por separado: Allow open garage menu y Allow enter shell / interior en el creador. Así es como un garaje pasa a ser solo de interior o solo de menú.

Con qué arranca un servidor nuevo#

El primer inicio importa 39 garajes, cada uno con su blip, zona y puntos de aparición, todos gratuitos y públicos:

Son garajes normales: mueve, renombra, restringe o elimina cualquiera de ellos en el creador. Vinewood West viene restringido a policía y ambulancia como ejemplo de acceso por trabajo.

Tipos de garaje y acceso#

Cada garaje tiene un tipo, que decide qué se puede aparcar en él, y un acceso, que decide quién puede usarlo.

Además de cualquiera de los accesos, un garaje puede limitarse a trabajos y bandas, cada uno con los rangos permitidos. Las bandas vienen de qs-gangs. Sin trabajo ni banda seleccionados, está abierto a todos.

Los blips muestran los garajes públicos, los garajes que posees y los depósitos. El garaje privado de otra persona no tiene blip. Para no superar el límite de blips de GTA, solo se dibujan los Config.MaxBlips (50) más cercanos; tus propios garajes y los depósitos se muestran siempre. Un garaje concreto puede quitarse del mapa para todos con Show map blip en el creador, y Config.DisableBlips = true oculta todos los blips de garajes a la vez.

El menú del garaje#

Al abrir un garaje, el jugador pasa a una copia privada del mundo, apoyado en la pared junto a un punto de exposición, con la cámara sobre el primer coche. El tiempo se despeja, suena música y el HUD se oculta. Cada coche guardado aparece con su velocidad máxima, aceleración, frenado, tracción, salud del motor y de la carrocería y combustible, el logotipo de su marca y su matrícula. Los favoritos van primero.

Las teclas de flecha recorren los coches y ESC sale, devolviendo al jugador a donde estaba. Oculta cualquier botón que no quieras; un Transfer oculto también lo rechaza el servidor:

Config.EnabledButtons = {
    ['favorite']  = true,
    ['tag']       = true,
    ['send']      = true,  -- to another garage
    ['transfer']  = true,  -- to another player
    ['bring']     = true,  -- fetch a car left outside
    ['insurance'] = true,
}

Guardar un vehículo#

Conduce hasta el marcador de un punto de aparición y pulsa E. El coche se acepta cuando te pertenece, eres el conductor, coincide con el tipo de garaje y el garaje tiene espacio. Un garaje con tarifa de almacenamiento la cobra aquí. El coche se desvanece y se guarda con sus daños, combustible y modificaciones exactos.

Coches compartidos con sus llaves#

Con Config.VehicleKeysGarageAccess = true y qs-vehiclekeys en ejecución, un jugador que tiene las llaves del coche de otra persona lo ve en el menú del garaje, marcado como Shared with you (keys), y puede sacarlo y volver a guardarlo, incluidos los garajes MLO. El coche sigue perteneciendo a su propietario, ocupa una de las plazas del propietario, y quien tiene la llave conserva las llaves al guardarlo. Favorito, etiqueta, envío, transferencia y seguro siguen siendo del propietario, y un coche compartido nunca aparece en un depósito: el propietario lo recoge y paga la tarifa.

Config.VehicleKeysGarageAccess = false -- true: key holders can take out and store the car (needs qs-vehiclekeys)

Grúas plataforma con coches encima#

Con Mechanic Creator (qs-mechanic-creator), una grúa plataforma puede guardarse con hasta cuatro coches cargados. Se guardan con la grúa, incluidos modificaciones, colores y daños, y vuelven cargados en la plataforma cuando se saca la grúa, tanto en garajes normales como de trabajo. Solo se conservan los coches que están realmente en la plataforma, así que una grúa nunca puede usarse para llevarse el coche de otra persona.

Una grúa de trabajo alquilada no tiene dónde guardar una carga, así que descárgala antes de guardarla. En versiones antiguas de qs-mechanic-creator sin esta función, una grúa cargada no puede guardarse en absoluto: descárgala primero y actualiza qs-mechanic-creator para transportar coches.

Colocar un garaje#

/garagecreator lista todos los garajes del servidor. Busca por nombre o id (#12), o por palabras como boat public o mlo police. Filtra por tipo, acceso, interior, restricción de trabajo, propiedad, predeterminado o personalizado, funciones y precio, ordena por distancia o precio y teletranspórtate a cualquiera de ellos. Pulsa Create Garage para empezar uno nuevo.

La zona y los puntos#

Location Settings → Zone Points → Select abre una cámara libre. Haz clic para colocar las esquinas del área del garaje, clic derecho para deshacer la última, sube o baja las paredes con Z / X y pulsa ENTER. El contorno necesita al menos cuatro puntos y un perímetro de Config.MinPointLength (70 m); se vuelve verde cuando es válido y no puede solaparse con otro garaje.

Después coloca el punto de menú y el punto de aparición dentro: un ped o coche fantasma sigue tu punto de mira, Z / X lo giran y un clic lo coloca. Add extra spawn añade más puntos de aparición para aparcamientos concurridos; se usa el primero libre. Guarda, y el garaje queda activo para todos.

El estudio de la cámara de vista previa#

De forma predeterminada, el menú del garaje filma el coche en una sala de exposición compartida. Preview Camera → Open studio crea la toma justo en este garaje, en cuatro pasos; E pasa al siguiente.

ENTER conserva la toma y BACKSPACE la descarta. La cámara se guarda con el garaje, así que guarda el garaje después.

Interiores#

En un garaje de coches o aviones también se puede entrar a pie, con los coches guardados expuestos dentro. El Interior Type decide qué es ese interior:

Dentro de un IPL o shell, al acercarte a un coche ves sus detalles; tus propios coches están desbloqueados y puedes simplemente salir conduciendo uno, lo que lo saca del garaje. E en la puerta te lleva de vuelta. Cada visita se ejecuta en una copia privada del mundo, así que dos jugadores nunca chocan. Config.EnablePublicInteriors permite a los jugadores entrar también en garajes públicos, no solo en los privados.

Garajes MLO#

Elige MLO en un garaje de vehículos, dibuja su zona y luego abre Parking Slots. Un coche fantasma sigue a la cámara; cada clic pinta una plaza numerada (P01, P02…) con una flecha que indica hacia dónde va el morro.

Las plazas deben estar sobre el suelo, dentro de la zona y separadas al menos MinSlotDistance (2 m). Todas las teclas, colores y velocidades están en Config.MloGarages.

En juego, los coches aparecen en sus plazas al acercarte (a menos de RenderDistance, 70 m). Acércate al tuyo, se resalta su contorno, y pulsa F para sacarlo de la plaza. Para aparcar, entra en una plaza libre hasta que se vuelva verde y pulsa E, o pulsa E en la entrada para ocupar la primera libre.

Garajes privados#

Un garaje privado con precio muestra Buy garage for: $price en su punto de menú. Una vez comprado pertenece a ese jugador, que lo gestiona con /garagemenu (o Management en el menú radial) estando dentro:

Decoración y muebles#

Dentro de un garaje privado, el propietario escribe /garagedecorate para amueblarlo. Se abre por estancias un catálogo de cocinas, baños, sofás, luces, plantas, televisores y más; elige una pieza, colócala y cómprala. Las piezas compradas se pueden volver a mover, guardar en el almacén o vender por un Config.SellObjectCommision (30%) menos.

Algunas piezas hacen algo: un alijo abre almacenamiento a través de tu inventario, un armario abre los conjuntos de tu script de ropa, y las luces iluminan de verdad la estancia. Solo una persona decora un garaje a la vez, y solo el propietario salvo que Config.DecorateOnlyAccessForOwner sea false.

Añadir tus propios muebles#

/garagefurniture (permiso de creador) añade props al catálogo desde el juego: categoría, modelo, nombre, descripción, precio, variantes de color, un tamaño de alijo o una marca de armario. La herramienta de capturas fotografía el prop sobre una pantalla verde (ENTER para capturar) y sube la imagen a FiveManage, así que pega antes tu token en config/fivemanage.lua. Las categorías nuevas se crean en la misma ventana.

Garajes de trabajo#

Las flotas de trabajos y bandas se definen en config/jobgarages.lua. Los miembros del trabajo, desde el rango mínimo hacia arriba, abren una lista de la flota, sacan un coche por el precio de alquiler y lo reciben con su livery, extras y tuning ya aplicados.

Config.JobGarages = {
    {
        job   = 'police',      -- or: gang = 'families' (qs-gangs)
        name  = 'police-1',    -- unique
        type  = 'vehicle',     -- 'vehicle' | 'plane' | 'boat'
        grade = 1,             -- minimum grade
        price = 100,           -- rental price, 0 = free
        coords = {
            menuCoords  = vec3(457.9, -1017.28, 28.28),
            spawnCoords = vec4(446.48, -1019.35, 27.55, 91.14),
        },
        vehicles = {
            `police`,
            `police2`,
            { model = `police3`, grade = 3 }, -- only grade 3 and up
        },
        liveries = { [`police`] = 1 },
        tuning   = { [`police`] = { modEngine = 3, modBrakes = 2, modArmor = true } },
        extras   = { [`police`] = { ['1'] = true, ['2'] = true } },
        vehicleCamera = { ... },  -- optional preview shot
    },
}

Un vehículo escrito como { model = `police3`, grade = 3 } necesita ese rango además del del garaje: los rangos inferiores no lo ven y el servidor se niega a entregarlo. El precio de alquiler y los rangos los comprueba el servidor. Las liveries, el tuning y los extras funcionan con modelos escritos de cualquiera de las dos formas, `police` o 'police'.

Los ejemplos de policía, policía aérea, ambulancia y mecánico vienen listos. Los miembros también pueden añadir un coche propio a la flota del trabajo con /addJobVehicle en el garaje, y retirar coches de la flota con /deleteJobVehicle. Un coche de trabajo dejado fuera vuelve a su garaje de trabajo en el siguiente reinicio.

El depósito y la recuperación#

La policía (Config.ImpoundJobs) escribe /impound junto a un coche. Un formulario pide el depósito, cuánto tiempo se retiene el coche, si el propietario puede pagar para liberarlo antes, la tarifa y una nota. El propietario lo encuentra entonces en ese depósito con el tiempo restante, la tarifa y la nota del agente, y paga para sacarlo conduciendo. Los coches embargados sin formulario cuestan Config.ImpoundPrice (500).

Los coches también llegan solos al depósito: destruidos o hundidos, perdidos tras un choque, dejados fuera en un reinicio, en un garaje privado que se vendió, o transferidos a otro jugador. Qué depósito se usa lo define Config.DefaultImpounds; false envía cada coche al depósito más cercano de su tipo.

¿Prefieres sin depósito automático? Configura Config.Impound.Enabled = false. Esos coches quedan entonces perdidos, y sus propietarios los recogen en un punto de recuperación. Los comandos de policía /impound, /mdv, /mdvall y el export impound siguen funcionando.

Config.Impound = {
    Enabled = true, -- false: lost cars go to the recovery point instead of the impound
}

Los puntos de recuperación (Config.Recovery) devuelven un coche que sigue fuera en algún lugar del mundo por $5000, o gratis con seguro. Vuelve al garaje del que salió por última vez, o a fallbackGarages, o al garaje público más cercano de su tipo.

Seguro de vehículos#

Desde el menú del garaje, un jugador asegura un coche con una prima semanal calculada a partir del precio del coche. Los precios vienen de los vehículos compartidos de QBCore / Qbox o de la tabla vehicles de ESX; cualquier otra tienda se conecta en server/custom/insurance.lua, y un coche desconocido cuenta como $50,000.

Cuando un coche asegurado se destruye, se avisa al propietario de que hay una reclamación abierta. La presenta desde la pestaña Claims en cualquier garaje del mismo tipo, y el coche llega allí reparado: al instante, o tras ClaimWaitMinutes cuando ClaimMode = 'wait'. Con el depósito automático desactivado, el coche destruido se reclama mientras está perdido, sin pasar por el depósito.

Cada semana completa asegurada sin reclamaciones sube el nivel sin siniestros del propietario, hasta un 50% de descuento; cada reclamación lo baja dos niveles. Las pólizas se renuevan solas mientras el propietario está conectado y puede pagar; un coche vendido pierde su cobertura.

Config.Insurance = {
    Enabled = true,
    MoneyType = 'bank',
    PolicyDays = 7,
    ClaimMode = 'instant',        -- or 'wait'
    ClaimWaitMinutes = 15,
    DefaultVehicleValue = 50000,
    NoClaimDiscounts = { 0, 10, 20, 30, 40, 50 },
    StepsLostPerClaim = 2,
    Tiers = { basic = { ... }, kasko = { ... }, premium = { ... } },
}

Vehículos persistentes y daños#

Con Config.PersistentVehicles activado, un coche dejado en la calle se queda allí, con su posición, daños y combustible, tras desconexiones y reinicios. Su guardado periódico solo actualiza posición, daños, salud, cierre y combustible, así que se conserva el tuning que otro script guarde mientras tanto, como un mecánico. Por eso también /dv no lo elimina: usa en su lugar /mdv (el coche más cercano al depósito) y /mdvall (todos los coches vacíos al depósito).

Los daños también son persistentes, abolladuras incluidas, mediante VehicleDeformation. Los coches se reparan con el ítem repairkit (Config.RepairKit, una reparación de 15 segundos en el capó), el comando /repairvehicle para administradores y mecánicos (Config.RepairVehicleCommand), los exports de reparación o una póliza Premium.

Todo el aspecto de un coche vuelve con él: sus modificaciones, sus colores con su acabado mate, metálico o cromado, y el xenón RGB personalizado configurado en el taller de tuning de qs-mechanic-creator, que los demás jugadores ven en el color del juego más parecido.

Ajustes que conviene conocer#

Los cambios en los archivos de configuración requieren reiniciar el recurso. Los garajes editados en /garagecreator no.