en-garages

GTA's traffic and parked cars are switched off on an EndCore server, so every vehicle in the world comes from en-garages. It leaves abandoned vehicles at roadsides, out of players' sight. They are damaged, low on fuel and often locked. You break in or hotwire one (see en-vehiclekeys), drive it to a garage lot and pay cash to claim it. You then get a key item and the vehicle becomes yours for good.

Owned vehicles stay exactly where you parked them, even across restarts. They only exist in the world while a player is nearby. You can store and retrieve them at garages, recall one from wherever it is, or recover it after a wreck. Dealers sell a few working vehicles for cash. The resource also handles fuel (burned while driving, refilled from jerry cans, cans filled at the rare working pump) and repair kits.

#At a glance

#How it works

#Abandoned vehicles

On each spawn pass the server asks a nearby player's client for roadside points. It checks the distance, requires 6 m of clearance, and spawns the vehicle server-side with a random plate. It then rolls random fuel, engine and body health and dirt, plus a chance of flat tyres and broken windows. The vehicle is locked with probability lockedChance. An unclaimed vehicle despawns after despawnAfter seconds with nobody within despawnDistance.

#Claiming

To claim a vehicle you must:

• sit in the driver seat, inside the radius of a garage with claim = true
• use a vehicle nobody owns yet
• have hotwired it, or have key access to it
• own fewer than maxPerCharacter vehicles
• pay claimCost cash

The plate is kept if it's free, otherwise a new one is issued (ABC 123 format). You receive a vehicle_key item, and the vehicle's trunk and glovebox inventories (trunk:<plate> and glovebox:<plate>) become persistent. With groupClaims on, group leaders and ranks with the invite permission can register vehicles to their group instead.

#Persistence

Owned vehicles that are out spawn when a player comes within 350 m. They despawn, with the position saved, after 45 s with nobody within 450 m and nobody inside. Positions, fuel and damage are batch-saved every 30 s. Appearance is saved when the driver gets out.

A vehicle whose engine health drops to -3900 or lower is marked wrecked.

#Retrieving

#Fuel

The driving client burns fuel based on revs, vehicle class and Config.fuel.usage. To refuel, target any vehicle while carrying a jerrycan (8 s). A can's fill level is stored in its metadata.durability (0–100). Fuel pump props can fill cans for pricePerCan cash (6 s), but whether a pump works is rolled per pump on every restart (25% by default).

#Repair

Target a vehicle's engine or bonnet with a repair_kit. The repair skill bonus cuts the duration by up to 50%, and the engine and body health restored are multiplied by 1 + repair bonus. Each repair awards mechanics XP. See en-skills.

#Configuration

#config/shared.lua

#config/server.lua

Valid vehicle types are automobile, bike, boat, heli and plane.

#Adding garages, dealers and scavenged models

-- config/shared.lua
Config.garages[#Config.garages + 1] = {
    id = 'grapeseed', label = 'Grapeseed Barn',
    coords = vec3(2447.1, 4971.2, 46.8), radius = 20.0, claim = true,
    spawns = { vec4(2440.3, 4975.0, 46.2, 45.0), vec4(2436.8, 4970.9, 46.2, 45.0) },
}

-- inside Config.dealers[1].stock
{ model = 'sandking', label = 'Vapid Sandking', price = 6800, type = 'automobile' },

-- config/server.lua, inside ServerConfig.world.pools
{ model = 'dune', type = 'automobile', weight = 2 },

#Exports

All exports are server-side. There are no client exports.

The Builder* exports are used by en-admin's in-game builder; see Content registry.

#Commands

All commands are restricted to group.admin.

#Events

Server-local events, fired with TriggerEvent:

The client event en-garages:client:repaired (netId, engine, body) is sent to the entity owner after a repair.

#State bags

Entity state bags on vehicles:

#Database

encore_vehicles: id (primary key), plate (unique, VARCHAR 12), citizenid, group_id, model, type, label, props (JSON), fuel, engine, body, state (stored, out or wrecked), garage, position (JSON {x,y,z,heading}), created_at, updated_at.

#Examples

Give a vehicle as a quest or event reward:

-- server
local id = exports['en-garages']:GiveVehicle(source, 'bodhi2', 'Canis Bodhi', 'sandy', 'automobile')

if not id then
    print(('Could not give a vehicle to %s'):format(source))
end

Top up the fuel of whatever a player is driving:

-- server
local vehicle = GetVehiclePedIsIn(GetPlayerPed(source), false)

if vehicle ~= 0 and exports['en-garages']:IsOwnedVehicle(vehicle) then
    local fuel = exports['en-garages']:GetFuel(vehicle) or 0
    exports['en-garages']:SetFuel(vehicle, fuel + 25)
end

Log every claim:

AddEventHandler('en-garages:server:claimed', function(source, vehicleId, isGroup)
    print(('%s claimed vehicle %d%s'):format(GetPlayerName(source), vehicleId, isGroup and ' for their group' or ''))
end)

#Related

• en-vehiclekeys
• en-admin
• en-skills
• Groups