Midnight Club - Time Trials with Wagers 
Overview
Welcome to Midnight Club Time Trials – bring the thrill of wager-based racing to your FiveM server! Challenge players to beat the clock, risk their cash, bank, or crypto, and unlock exclusive rewards! Fully compatible with QBCore, packed with customization, UI of your choice, and plenty of racing attitude.
Get started, get paid, get respect.
Features
Multiple Custom Races – Set up unique routes, vehicles, and challenges in config.lua.
Buy-ins & Payouts – Race for cash, bank, or crypto. The bigger the buy-in, the bigger the rewards!
Rewards & Required Items – Win items for completing race streaks and require special items for entry (e.g., VIP Race Pass).
Vehicle Restrictions & Blacklist – Limit races to certain vehicles or classes, block the fastest cars for fair play.
Dynamic UI – Vibrant, pulsing race info overlay; customizable and movable.
NPC & Vehicle Spawns – Each race can spawn a character and a display vehicle at the start point.
Proximity Taunts – Get hyped or roasted as you approach races!- Flexible Interaction – Supports both “Press E” prompts.
Cooldowns & Progress Tracking – Prevent spam, track your wins, and earn streak rewards.
Easy Commands – Admin commands for quick setup and cleanup (see below).
Easy Setup & Expansion – All configuration in one file, add races in minutes!
Setup
-
Dependencies:
- QBCore Framework
- ox_lib
- oxmysql
-
Installation:
- Place the folder in your
resourcesdirectory. - Add
ensure mnc-timetrialsto your server config. - Make sure dependencies start first!
- Place the folder in your
-
Configuration:
- Edit
config.luato set up races, buy-ins/buyouts, rewards, vehicles, NPCs, and more. - Customize proximity taunts, blip names, and cooldowns.
- Edit
Buy-ins, Payouts, Rewards & Required Items
Each race offers multiple wager tiers.
Players choose their buy-in (cash, bank, or crypto) and receive payouts plus progress toward item rewards!
Example Wager Tier (from config.lua):
wagers = {
{
amount = 2000, -- 💵 Buy-in
name = "Easy", -- Difficulty
timeModifier = 0, -- Time bonus
payout = 4000, -- 🤑 Payout
paymentType = "cash", -- Type: cash/bank/crypto
rewardItem = { name = "tunerchip", amount = 1 }, -- 🎁 Item reward
requiredItem = { name = "phone", amount = 1 }, -- 🛡️ Required to enter
requiredRaces = 3 -- ✨ Complete streak for item
},
-- ...more tiers!
}
- Required Items: Some races need special items (e.g. VIP Race Pass).
- Rewards: Win cash, crypto, or exclusive items after a set number of wins.
- Progress: Race completion tracked per player, per wager.
Vehicle Classes & Blacklist.
- Restrict races to certain vehicle classes (e.g. only Compacts).
- Automatically block the top 10 fastest cars in each class for balanced competition.
- Set a required vehicle model for themed races!
- Blacklist & Classes are fully customizable in
config.lua.
Commands & Usage
- Start a Race:
Drive to a race marker, press E or use the qb-target zone to open the UI. - Select Wager:
Choose your buy-in, see the time limit, and accept the challenge. - Complete the Race:
Beat the clock to win your payout and progress toward item rewards!
Customization
- Add Races: Copy/paste a race entry in
Config.Racesand set locations, vehicles, rewards, etc. - Change UI: Edit UI HTML/CSS for a custom look.
- Tweak Difficulty: Adjust time limits, payouts, required items, and vehicle restrictions.
- Edit Taunts: Make your server’s races as friendly or savage as you like!
- Original Ui
- basic-1
- basic-2
- basic-3
- basic-4
- simple-1
- simple-2
- simple-3
- simple-4
Credits
- Developed by Stan Leigh
- Inspired by classic street racing and time trial games
Support
Open a GitHub issue for help, suggestions, or bug reports!
Start your engines. Bet big. Race hard. Win respect.
