elevators

Last updated on

Takes over lifts that already exist in the game world and gives them a floor list from config/elevators.lua. Each floor can be public or locked to jobs, a minimum grade and being on duty. The client finds configured lifts near the player and reports them; the server adopts and locks each lift, then moves the cabin only after re-checking the player's job, bucket and distance itself. Players ride with the key (E by default), which opens the floor list drawn with the menu module. Use it to keep a precinct's upper floors for police, or a corporate tower's offices for its staff.

• The key (KEY, opx.elevators.use) opens the floor list at the lift the player stands at. A strip row (prompts) names the key while within USE_RADIUS of a configured lift; without prompts the key still works. Away from any lift the key does nothing and says nothing (E is shared with other modules).
• A lift nobody rides for 10 minutes is released on the host as well as forgotten, so it can be adopted again. After a restart, the client re-reports a lift that is still managed but not bound (every 30 s) and the server claims it back.
• The server refuses a downed player (downed), not only the client panel.
• A rider who leaves mid-trip no longer recalls the cabin: it finishes the trip it was given. An empty cabin stays where it stops.
• With KEY.DEFAULT = false no key is declared and OpenPanel is the only way in. Adopted lifts are locked, so the game's own lift panel is refused either way.

Commands

Configuration

config/elevators.lua sets OPX.Config.MODULES.elevators. Shared. Distances are measured across the ground (X and Y) against the declared position, so a lift can be called from any floor of its shaft.

ncpd_watson = {
    LABEL = 'NCPD WATSON',
    X = -652.10, Y = 1394.55, Z = 12.40,
    BUCKET = 0,
    FLOOR_COUNT = 5,
    FLOORS = {
        { INDEX = 0, LABEL = 'Street' },
        { INDEX = 2, LABEL = 'Bullpen', JOBS = { ncpd = 0, maxtac = 0 }, REASON = 'NCPD only' },
        { INDEX = 3, LABEL = 'Holding', JOBS = { ncpd = 1, maxtac = 0 },
            ON_DUTY = true, REASON = 'NCPD Officer, on duty' },
    },
},

• key: the durable name of the elevator (the host's id changes each restart).
• LABEL: menu title. Never translated.
• X, Y, Z: declared position.
• BUCKET: routing bucket, default 0.
• ENTITY: optional engine hash, when two shafts share a lobby.
• FLOOR_COUNT: floors of the native lift. Overrides what the client reports.
• FLOORS: list of { INDEX, LABEL, JOBS?, ON_DUTY?, REASON? }. INDEX is the native floor index (0-based), not the list position.

The job gate

A floor's JOBS, ON_DUTY and REASON follow the shared job-gate format; see OPX.JobGate.Evaluate.

• JOBS: { [jobName] = minimumGradeLevel }, e.g. { ncpd = 1, maxtac = 0 }. Any one listed job at its grade passes. No JOBS = public.
• ON_DUTY: true also requires that job to be the worked job and on duty.
• REASON: text shown to a refused player instead of the generic sentence. Never translated.

Refusal codes