garages

Last updated on

Glowing markers where players fetch and park their own vehicles. On foot at a menu point or at the entry point, the key (E by default) opens the list of every vehicle filed under that garage. Sitting in one of your own vehicles at the entry point, the same key puts it away. A vehicle comes out at the first free exit of the location you stand at. Garages are written in config/garages.lua; nothing is placed in game.

• Without vehicles every request is refused.
• Without menu the list cannot open; /opx.garages.bring still works.
• Without prompts the markers still draw, only the key row is missing.
• With vehiclekeys, the owner is given a key on the way out when their bag holds none to that plate; a full bag is said to the player and does not stop the car coming out.

How a garage works

• A garage is a key (e.g. garage1). A vehicle's garage column holds that key, so a car stored at one location comes out at every location of the same garage.
• Each location has one MENU point (opens the list), one ENTRY point (takes the car you sit in) and an ordered list of EXITS.
• Exits are tried in the order written. An exit is taken when any vehicle in the same routing bucket is within EXIT_CLEARANCE metres (the car being fetched never blocks its own exit), or when it is promised to another bring-out still spawning: two players fetching at once get two exits, never one car inside the other. A promise lapses after 10 s. All taken: garages.noFreeExit.
• Put away or bring out is decided by the server from the host's seat assignment, never by the client. Sitting in someone else's car at the entry point is refused with garages.notYours ("Only your own vehicles go in here."), instead of bringing one of yours out beside you. On foot, the entry point opens the list and its prompt reads Open your garage; a player with two cars filed there picks one.
• The list shows each car as Villefort Cortes · 8XK2L0P: the same name as its key (OPX.Vehicle.DisplayName), the plate as the value.
• A refused bring-out is one toast that names the garage (no more three toasts and a platform notice).
• Toasts name the car as the list does: Brought out Archer Hella · AA111AA., Put away …, Recalled … here. for a car already out that was moved. The staff bring command uses the same words.
• A player who is down is refused (error.incapacitated). A refusal names back the garage key only when it is a known spot or garage.
• E is shared with doors, dealers, fitting rooms, lifts and teleports: the nearer spot acts, and only its prompt row is drawn; while the list is open, E closes it (rank OPEN). See One press, one owner.
• A car with passengers is not put away: garages.passengers until they get out.
• The nearest point is searched in the player's own bucket only, so an instanced copy on the same spot does not get in the way.
• A car of yours already out elsewhere is moved to the exit (see vehicles.Spawn); refused with vehicle.occupied if anyone sits in it.
• KIND = 'garage' brings out ground vehicles only; KIND = 'avpad' AVs only. An AV is created AV_LIFT metres above the exit. Which records are AVs is AV_PREFIXES in config/shared.lua.

Legacy table opx77_garages

• /opx.garages.add and /opx.garages.remove are gone.
• At every boot the server reads opx77_garages and adopts each row whose key is not in GARAGES as a garage of one location whose menu, entry and only exit are the captured point.
• Each adopted garage is printed to the server log as [garages] config line: ..., ready to paste into config/garages.lua, then a warning says how many exist only in the table.
• A config garage with the same key wins. Nothing writes to or drops the table.

Commands

command.opx.garages.* grants both. Names come from COMMANDS.

Configuration

config/garages.lua sets OPX.Config.MODULES.garages. Shared script.

Markers use the engine vocabulary: shape ring or cylinder; style interaction, objective, spawn or danger; RADIUS 0.1–50. A bad field falls back to the module default and is reported at boot.

GARAGES = {
    garage1 = {                        -- the key: 1-48 chars, never rename it
        LABEL = 'Watson Garage',       -- shown to players, not translated; defaults to the key
        KIND = 'garage',               -- 'garage' (ground vehicles) or 'avpad' (AVs)
        LOCATIONS = {
            {
                BUCKET = 0,            -- routing bucket of the whole location
                MENU  = { X = -1527.21, Y = -218.56, Z = 7.86 },
                ENTRY = { X = -1527.21, Y = -218.56, Z = 7.86, HEADING = 199.6 },
                EXITS = {
                    { X = -1527.21, Y = -218.56, Z = 7.86, HEADING = 199.6 },
                },
            },
        },
    },
}

• Every point follows the shared spot rules (spot helpers): X, Y, Z finite and within ±1,000,000; HEADING finite (default 0); BUCKET a whole number ≥ 0 (default 0). Only X and Y are measured against.
• A garage with any bad point, no location, or a location without exits is refused whole, with a boot warning naming it.
• To capture a point, stand on it facing the way a car should come out and run /opx.admin.self.pos; it copies position and heading to your clipboard.

Refusal codes

Each code is also a locale key. Codes from vehicles (vehicle.occupied, vehicle.busy, vehicle.spawnRefused, …) pass through unchanged.