Introduction

Welcome to the MBT Minigames documentation!

MBT Minigames is a standalone collection of four cyberpunk-themed interactive minigames built for FiveM. It is used as a dependency by other MBT scripts (such as MBT Elevator) and is available via a simple export API for any resource on your server.

Each minigame runs in a custom React NUI with smooth animations, difficulty scaling, and full locale customization — all without any database or external dependency.

Minigames

Hacking — Terminal Node Decryption

An 8×8 grid of hex codes is displayed on screen. A target sequence of 4 to 8 codes must be clicked in the exact order before time or mistakes run out. The player uses a laptop prop with a matching animation sequence.

• Mechanic: Click the correct codes in sequence
• Fails on: Wrong click or time expiry
• Props: Laptop + shoulder bag

Wire Fix — Neural Link Restoration

A dynamic pipe puzzle displayed on a grid (5–7 columns × 4–5 rows). The player rotates tiles to route a power signal from the left edge to the right edge at the target row. Tiles periodically shuffle based on difficulty, increasing pressure.

• Mechanic: Rotate pipe tiles to complete the circuit
• Fails on: Exceeding max mistakes or time expiry
• Props: Welding torch + welding mask + electrical particle effect

Bolt Turn — Pressure Control System

3 to 5 bolts must each be tensioned into a sweet spot on a gauge by holding a key. Too much tension causes the bolt to overheat and fail. The player must manage multiple bolts simultaneously, watching temperature indicators.

• Mechanic: Hold key to build tension, release before overheating
• Fails on: Critical overheat or time expiry
• Props: Drill prop

Code Match — Data Stream Sync

A vertical stream of 4-character hex codes scrolls down the screen. The player must press Space precisely when the correct code aligns with a scanner line. 6 to 10 codes must be matched to win.

• Mechanic: Press Space in time with the scrolling code
• Fails on: Exceeding max mistakes or time expiry
• Props: Tablet prop

Key Features

Four Distinct Mechanics

Every minigame uses a completely different interaction model — sequence memory, spatial puzzle, physics tension, and rhythm timing. No two feel alike.

Difficulty System

Every minigame has three built-in difficulties — Easy, Medium, and Hard — with independent time limits, error tolerances, and challenge parameters. All values are overridable per call.

Animation Sequences

Each minigame plays a multi-stage animation: enter → loop → exit, with synced props and particle effects. Animations can be overridden or disabled via the export API.

Simple Export API

Two exports cover all use cases — startHackingSession and startRepairSession. Both return a boolean and support optional callbacks, making integration a few lines of code.

No Dependencies

No SQL, no framework requirement, no external scripts. Works standalone out of the box.

Fully Customizable Text

All UI strings (titles, instructions, win/lose messages, log entries) are defined in config.lua and can be freely edited.

Used By

MBT Minigames is the minigame engine behind:

• MBT Elevator — hacking restricted floors and repairing faulty elevators
• Any custom script on your server via the export API