Scripts/Free script
VehicleMinigames
Stealing a car in two steps, both done by hand: pick the wafer lock in the door one wafer at a time, then find, strip and twist the right wires under the steering column. No progress bars and no skill-check circles.
Gameplay
What players do, in the order they do it
01Pick the door lock
At the driver's door of a locked car the camera moves in close and a pick goes into the keyway. The lock is a wafer lock with 8 positions, each wafer cut to one of 4 depths. Hold light tension with one mouse button, move along the wafers and lift with the other.
02Feel for the wafer that binds
With tension on, one wafer binds at a time. Free ones feel light and springy; the binding one is stiff. Lift it slowly until it clicks and stays up, and the next one binds. Lifted too far it jams the lock until the tension is let off. Forced, the pick bends: three bends and it snaps, and the alarm goes off.
03Take the cover off
In the driver's seat of a car without keys, the camera drops under the steering column. Each screw comes out by circling the mouse counter-clockwise. Too fast and the screwdriver slips.
04Find the wires
A test light tells the wires apart: steady is battery, pulsing is ignition, flickering is the starter. The rest are dim or dead, and which colour is which is different on every attempt.
05Strip them
Grab a wire end with the strippers and pull down slowly. Pulling too fast nicks the copper, and that is a strike.
06Twist and crank
Drag the bare battery wire onto the ignition wire to twist them together, then hold the starter wire against the twist and let go inside the green part of the meter. Three strikes and the alarm goes off.
07Seen by everyone nearby
Players near the car see the props and the sparks and hear the sounds, quieter the further away they stand.
Items
What players carry
Lishi pick
Picks a door lock. Lost when it snaps.
Wire strippers
Needed to hotwire. Can break on a failed attempt.
Configuration
What you set, and what the server keeps in hand
The server decides
Which wire is which, which wafers a lock has and the order they bind in are held on the server, and every step is checked there. A modified client can't skip the puzzle or pick faster than a person could.
Fitted to every car
The door lock comes fitted to 525 car models. One command fits it to every other car on your server, addon and escrowed ones included, with nobody at the keyboard.
Harder cars
How many wafers a lock has, how much it forgives and how stiff it is depend on the vehicle class. Some classes have an alarm that goes off when the door opens.
Keys are yours to decide
Picking a lock only opens the door, and by default a hotwired car only starts: no keys, and once its engine is off it has to be wired again. One setting hands out keys instead.
Events for police and logs
Server events fire when a pick snaps, when an alarmed car is opened and when a lock is picked, for your dispatch, logs, XP or stress scripts.
Each one on its own switch
Lockpicking and hotwiring each have their own config, where either can be turned off, and their items changed or dropped. All text is in one locale file.
Open source
Free under the GPL-3.0 licence. Every file is readable, and yours to change.
Works with
Found when the server starts
Framework
ESX Legacy
QBCore
Qbox
Inventory
- ox_inventory
- qb-inventory
Target
- ox_target
- qb-target
Vehicle keys
- zyke_vehiclekeys
- qbx_vehiclekeys
- qb-vehiclekeys
- wasabi_carlock
- MrNewbVehicleKeys
- Renewed-Vehiclekeys
Install
4 steps
- 01
Download
Get tr_core and tr_minigames from GitHub and put both in your resources folder.
- 02
Start them
In server.cfg, below your framework and inventory:
ensure tr_core ensure tr_minigames
- 03
Add the items
Copy the two entries from install/ox_inventory or install/qb-inventory into your inventory, and the images from install/images.
- 04
Restart the server
After a later update, players need a full reconnect to load new props.
Changelog
- 1.0.0
First release: lockpicking and hotwiring.
- Lockpicking: a wafer lock in the driver's door, picked one wafer at a time with a Lishi-style pick.
- Hotwiring: the cover, the test light, the strippers, the twist and the starter, under the steering column.
- Players nearby see the props and sparks and hear the sounds.
- The door lock is fitted to 525 car models, with a command that fits the rest.
Something missing or unclear? Ask in the Discord.
Free
Vehicle Minigames