Initializing

Secure Protocol Active

Commands & Dashboard UI — MBT Elevator | MalibuTech

In-Game Dashboard & Commands

All individual elevator configurations are managed in real-time via the In-Game React Dashboard — no file editing or server restarts required.

Opening the Dashboard

/elevator_panel

You must have the command.elevator_admin ACE permission. See the Installation guide for details.

Press ESC at any time to close the dashboard.

Control Center (Overview)

The main screen shows a live summary of all elevators on the server.

Stat Card	Description
Total Systems	Total number of elevators registered in the database.
Operational	Elevators that have at least one floor configured and are not currently broken.
Faulty Nodes	Elevators that are currently broken and require maintenance.
System Drafts	Elevators that have been created but have no floors configured yet.

Click any stat card to filter the list by that category. Use the search bar to filter by ID, Label, or Type.

Click New Elevator to create a new elevator with a default configuration. It will be assigned an auto-incremented ID (e.g., Elevator_001).

Click any elevator card to open the Config Editor. The trash icon on a card deletes it immediately after confirmation.

Config Editor

Clicking an elevator opens a multi-tab modal editor. Changes are only applied to the server when you click "Apply Changes" in the footer. Applied changes are instantly synced to all connected players.

Clicking "Delete System" permanently removes the elevator from the database. This action cannot be undone.

Tab: General

Core identity settings for the elevator.

Field	Description
Unique System ID	A read-only identifier automatically assigned on creation (e.g., `Elevator_001`). Used internally to reference the elevator.
Elevator Animation Style	The visual theme and sound effects used during the ride. Options: `Industrial Metal`, `Classic Wood`, `Luxury Gold`.
Registry Identification (Label)	A human-readable display name shown in the dashboard list and elevator UI (e.g., `SKYCLUB_ELEVATOR_A`). Optional but recommended.
Default Reach Distance (m)	The default interaction distance in meters for all floors of this elevator, unless overridden per-floor in the Floors tab. Range: – . Default: .

Tab: Interaction

Controls security bypass and malfunction behavior for this specific elevator.

Unauthorized System Hacking

Field	Description
Toggle (Hackable)	When enabled, players can use the hacking item (defined in `config.lua > MBT.Hacking.Item`) to bypass floor-level job/item restrictions.
External Hacking Anchor (Optional)	A world coordinate where the hacking interaction takes place (e.g., an external keypad or terminal). Click 📍 to close the UI and aim at a world position, then press `[E]` to capture. If left at `0,0,0`, the hack is triggered from the elevator itself.

Integrity Failures (Maintenance)

This section is grayed out if MBT.Maintenance.Enabled = false in config.lua.

Field	Description
Toggle (Breakable)	When enabled, this elevator can randomly break down during use, becoming temporarily unusable until repaired.
Breakdown Chance (%)	The probability (0–100) of a breakdown occurring each time the elevator is used. Leave blank to use the global default defined in `config.lua > MBT.Maintenance.Chance`.

Tab: Floors

Defines the physical floors of the elevator — their positions in the world and individual access rules.

Click Add Floor to add a new floor entry. Each floor is represented by a card.

Floor Card Fields

Field	Description
Level ID	A numeric identifier for the floor (e.g., `0`, `1`, `2`). Used to order floors in the elevator UI.
Registry Label	The public-facing name shown to players in the elevator floor selector (e.g., `Ground Floor`, `Rooftop`).
Position (📍)	The world coordinates where the player is teleported when selecting this floor. Click 📍 to capture from the game world.

Click ⚙️ (Advanced Protocols) to open the floor's side panel with additional settings.

Floor Advanced Panel — Terminal Interfacing

Defines how players interact with this floor's elevator panel/terminal in-game.

Interaction Vector — Choose the interaction mode:

Volumetric Box — An invisible 3D box zone placed in the world.
Static Object — Targets a specific static map entity (prop) as the interaction point.

Volumetric Box settings:

Field	Description
Coordinate Calibration (📍)	The center position of the interaction box. Click 📍 to capture.
Volume Dimensions (W / D / H)	Width (X), Depth (Y), and Height (Z) of the interaction box in meters. Default: `1 / 1 / 1`.
Distance	How close the player must be to the box to trigger the interaction prompt. Default: `2.5`.
Rotation	The yaw rotation of the box in degrees (0–360). Use this to align the box with angled walls or panels.

Static Object settings:

Field	Description
Technical Signature (Model Hash)	The model hash of the target entity. Click 📍 to aim at the object in-game and capture its hash automatically.

Floor Advanced Panel — Access Protocols

Per-floor access restrictions. If no jobs or items are configured, the floor is accessible to everyone.

Field	Description
Authorized Departments (Jobs)	Add job entries. Each entry requires a Job Name (exactly as defined in your framework, e.g., `police`) and a minimum Grade (number). Players with that job at or above that grade can access this floor. Click `+ Add Job` to add.
Required Keycards / Items	Add item names that a player must have in their inventory to access this floor. Type the item name and press `Enter` or `+`. Multiple items are OR-checked (player needs at least one).

Tab: Permissions

Global access rules that apply to the entire elevator, regardless of the individual floor being selected.

Entry & Usage Permissions

Field	Description
Global Access Whitelist (Jobs)	If any jobs are listed here, only players with those jobs (at or above the specified grade) can open the elevator menu at all. Leave empty to allow anyone.
Global Required Keycards / Items	If any items are listed, players must have at least one of them in their inventory to use the elevator. Leave empty to allow anyone.

Time-Based Access

Field	Description
Operating Hours (Toggle)	When enabled, the elevator is only usable during the specified in-game server hours. Outside those hours, the elevator is locked.
Opening Hour (0–23)	The in-game server hour at which the elevator becomes accessible. Uses 24-hour format.
Closing Hour (0–23)	The in-game server hour at which the elevator locks again.

Example: Opening 8, Closing 20 means the elevator is only usable from 8:00 AM to 8:00 PM in-game time.

Tab: Appearance

Controls the visual GTA V marker drawn at the elevator interaction point. Only relevant when MBT.UseTarget = false in config.lua, or used in addition to a target zone.

Field	Description
Marker ID	The GTA V marker type to render. Click the list icon to see available presets (e.g., `23` = Horizontal Circle Thin, `1` = Vertical Cylinder).
Tactical Color Tuning	Opens an HSV color picker. Drag the gradient to set Hue/Saturation/Value. Use the sliders below for precise Hue and Alpha control. Also supports direct R/G/B/A input fields (0–255).
Marker Rotation (X, Y, Z)	Rotates the marker in 3D space. Most markers only respond to Z rotation.
Marker Scale (X, Y, Z)	Sets the size of the marker. Default is `1.0` on each axis. Increase to make it larger, decrease for a smaller footprint.

config.lua Reference

The config.lua file controls global, server-wide settings. Individual elevator settings (floors, access, appearance) are managed from the Dashboard.

General

MBT.Language  = 'en'
MBT.Debug     = false
MBT.UseTarget = true

Key	Description
`MBT.Language`	Language for all player-facing strings. Options: `'en'`, `'it'`, `'es'`. You can add your own language file in the `locales/` folder.
`MBT.Debug`	Enables verbose debug logging in the console and browser DevTools. Set to `false` in production.
`MBT`

MBT.AdminSettings

MBT.AdminSettings = {
    Command    = 'elevator_panel',
    DefaultKey = 'F12',
    Permission = 'command.elevator_admin',
}

Key	Description
`Command`	The chat command used to open the admin dashboard. Default: `elevator_panel`.
`DefaultKey`	The default keybind to open the dashboard. Players can remap it in their GTA V key settings. Default: `F12`.
`Permission`	The ACE permission required to open the dashboard. Default: `command.elevator_admin`. See Installation for how to grant it.

MBT.General

MBT.General = {
    InteractKey    = 'E',
    DetectDistance = 2.0,
    MarkerDistance = 3.0,
    HintDistance   = 1.5,
    DisplayHint    = true,
    TimezoneOffset = 0,
}

Key	Description
`InteractKey`	The keyboard key used to interact with elevators (default: `E`).
`DetectDistance`	Distance (meters) at which the script starts detecting a nearby elevator. Lower = better performance, higher = earlier detection.
`MarkerDistance`	Distance at which visual markers are rendered. Ignored if `UseTarget = true`.
`HintDistance`	Distance at which the "Press E to use" hint appears. Should be ≤ .

MBT.Seeding

MBT.Seeding = {
    SkyclubV3 = true,
    SkyclubV2 = false,
}

Key	Description
`SkyclubV3`	If `true`, seeds the database with pre-built Skyclub V3 elevators on first start.
`SkyclubV2`	If `true`, seeds with Skyclub V2 elevators instead.

Set both to false once the initial seed has run, or if you want to start from scratch.

MBT.ElevatorSettings

MBT.ElevatorSettings = {
    Watermark  = true,
    HideGaps   = false,
    Speed      = 1000,
    MaxPlayers = 0,
}

Key	Description
`Watermark`	Shows or hides the MalibuTech branding watermark in the elevator UI.
`HideGaps`	If `true`, the elevator panel only shows buttons for configured floors, hiding any floor numbers in between. Useful for sparse floor setups (e.g., floors 0, 5, 12). Default: `false`.
`Speed`	Controls the floor-change animation duration in milliseconds. `100` = very fast, `2500` = very slow. Default: .

MBT.Technical

MBT.Technical = {
    BucketRange = { 1, 800 },
    InviteTimeout = 10000,
    SyncDelays = {
        BeforeTeleport = 300,
        AfterTeleport = 150,
        UIClose = 800
    },
    Maintenance = {
        ParticleDistance = 100.0,
        RepairDistance = 3.0,
    }
}

Key	Description
`BucketRange`	The min/max range for server-side routing buckets used during teleportation. `{1, 800}` means a random bucket between 1 and 800 is used per ride.
`InviteTimeout`	How long (ms) a co-op elevator invite remains valid before it auto-expires.
`SyncDelays.BeforeTeleport`	Milliseconds to wait after bucket assignment before setting the player's coordinates. Allows the server to sync.
`SyncDelays.AfterTeleport`	Milliseconds to wait after teleport before unfreezing the player. Allows collision and world to load.

MBT.Hacking

MBT.Hacking = {
    HackingCooldown = 66,
    AlarmChance     = 80,
    Item            = "laptop",
    KeepItem        = false,
    SendAlarm       = function(coords) ... end,
}

Key	Description
`HackingCooldown`	How long (seconds) the elevator stays unlocked after a successful hack. After this, the floor locks again.
`AlarmChance`	Probability (0–100) that the alarm/dispatch callback fires when a hack fails. Default: `80`.
`Item`	The inventory item name required to start a hack. Must be a valid item in your inventory system. Default: `"laptop"`.
`KeepItem`	If , the hacking item is consumed on a successful hack. Default: .

The TimeLimit parameter (commented out by default) overrides the minigame time limit from mbt_minigames.

MBT.Maintenance

MBT.Maintenance = {
    ["Enabled"] = true,
    ["Chance"] = 10,
    ["RepairAccess"] = {
        ["jobs"] = { ["mechanic"] = 0 },
    },
    ["RepairRules"] = {
        ["mechanic"] = { ConsumeItem = false, MinigameDifficulty = "easy", InspectionDuration = 1500 },
        ["default"]  = { ConsumeItem = true,  MinigameDifficulty = "hard", InspectionDuration = 5000 },
    },
    ["Faults"] = { ... }
}

Key	Description
`Enabled`	Master switch for the malfunction system. If `false`, no elevator can ever break down regardless of per-elevator settings.
`Chance`	Default breakdown probability (%). Used when a breakable elevator has no per-elevator `BreakChance` set in the Dashboard.
`RepairAccess.jobs`	Job(s) and minimum grade required to attempt a repair. e.g., `["mechanic"] = 0` allows all mechanic grades.

Faults — Each fault type (e.g., Electrical, Mechanical, Software) defines:

Sub-key	Description
`Item`	The item required to fix this fault type.
`Minigame`	The minigame ID from `mbt_minigames` to trigger.
`Label` / `Description`	Display text shown in the repair prompt.
`Particle`	Visual particle effect spawned on the broken elevator (`Dict`, , , ).

MBT.CustomHint

MBT.CustomHint = {
    ["Enabled"] = true,
    ["Looped"] = true,
    ["Show"] = function(label) ... end,
    ["Hide"] = function() ... end,
}

Key	Description
`Enabled`	Whether to show the proximity "Press E" hint at all.
`Looped`	If `true`, the hint is shown every frame (needed for native GTA hints). Set to `false` for one-shot UI elements like `ox_lib:showTextUI`.
`Show`	Function called to display the hint. Preset uses native GTA text. Uncomment the `ox_lib` preset for a cleaner look.

MBT.Notification

MBT.Notification = function(data)
    exports.ox_lib:notify({ ... })
end

Customize which notification system is used. The data object contains: title, description, type, icon, duration. Presets are provided for ox_lib, GTA native, ESX, QBCore, and okokNotify.

MBT.Locale

All text strings displayed to players are defined here. Edit any value to translate or customize messages. The table keys must remain unchanged. Notification entries (like ["not_allowed"]) support layout properties (position, icon, iconcolor, bgcolor, duration) that are passed directly to MBT.Notification.

NUI-only keys:

Key	Description
`nui_wait`	Text shown on the elevator panel while the ride is in progress.
`nui_open`	Text shown on the elevator panel call button.
`nui_nearby`	Label for the nearby players section in the elevator UI.
`nui_no_players`	Text shown when no other players are nearby.

DetectDistance

Name