Every file in config/ is commented and stays open in the escrow, as do locales/*.json, client/bridge.lua, server/bridge.lua, install/* and rc-interactions/*. Most notifications and refusals are in locales/en.json (ox_lib locales: add locales/<code>.json and set setr ox:locale "<code>"). Contact dialogue, contact intros and the Black Market texts are in the config files. The labels of the tablet screens are in html/js.
| File | What it holds |
|---|---|
config/general.lua |
Feature switches, tablet item and command, animation, identity, notifications, crew sizes, car picture URL |
config/jobs.lua |
Ranks, job categories, every job (kind, tier, contact, crew size, police, payout, REP, cooldown, prerequisites) and titles |
config/gameplay.lua |
REP scale, heat, clean-run streaks, heist rules, double-REP events, offline completion |
config/contracts.lua |
Contract system (expiry, hot bonus, rotation, guests), contact NPCs and contact discovery |
config/economy.lua |
Payout account, laundering spots and fees, the Fence's buy and sell lists, saturation, trust, the pawn counter |
config/turf.lua |
Turf mode, claim rules, bonuses, lookouts, gang tie, the tablet map image |
config/crews.lua |
Roles and permissions, tiers, colours, stash access, gang fund provider |
config/police.lua |
Police job type, heat per dispatch code, arrest penalty and seized items, tablet seizure |
config/missions.lua |
Boost classes, break-in, tracker, plates, drop-offs, seasons; courier routes and packages; hostile NPCs |
config/blackmarket.lua |
The Black Market van, its stock and the dealer's phone |
config/washnetwork.lua |
The money man, keycard, wash machines and standing rates |
config/xp.lua, config/extras.lua, config/crewspots.lua |
XP amounts, loot traps (dye packs, trackers), the most wanted board, crew places |
config/server.lua |
Server only: admin aces, tablet sessions, the action log channel, the anticheat counter and the crew talkie |
config/intel.lua, config/places.lua, config/onboarding.lua, config/adminnpcs.lua, config/blackmarket_spots.lua |
Server only: the Board, the upgraded tablet's places and faces, the first contract and tutorial, the Admin NPC list, the van's spots |
config/general.lua#
| Key | Default | What it does |
|---|---|---|
Config.Debug |
false |
Debug output on server and client |
Config.BackgroundBlur |
false |
true lightly dims the game behind the tablet |
Config.Features |
see below | Per-feature switches |
Config.AdminBypass |
true |
Tablet admins can switch off REP and police requirements for themselves (Admin tab, Testing) |
Config.AdminBypassShareCrew |
true |
An admin's bypasses also cover their crew while the admin is online |
Config.IdentifierType |
'citizenid' |
Per character. 'license' shares progress across all characters on an account |
Config.CommandName |
'tablet' |
Chat command that toggles the tablet ('' or nil disables it) |
Config.CommandRequiresItem |
true |
The command only works while carrying Config.ItemName, checked on the server |
Config.ItemName |
'glitch_tablet' |
The tablet item |
Config.BurnerPhoneItem |
'' |
An item the player must also carry (empty means no check) |
Config.TabletAnimation |
enabled | Emote and prop while the tablet is open |
Config.InviteTimeoutSeconds |
120 |
How long a crew invite stays open |
Config.SeedUsernameFromCharacter |
false |
New players get a random alias such as Ghost-4821 instead of their character name |
Config.NotificationSystem |
'auto' |
'auto' or 'ox' use ox_lib notify; 'internal' uses only the tablet's own toasts |
Config.NotificationPosition |
'top-right' |
Where notifications appear |
Config.VehicleImageUrl |
'https://cdn.glitchstudios.dev/vehicles/%s.webp' |
Car pictures on the Boosting tab. %s is the lower-case model name. Point it at your own host if you want |
Config.DBTable |
'glitch_criminaltablet_players' |
Player table name |
Config.MaxJobLogEntries / Config.MaxRepLogEntries / Config.MaxChatHistory |
20 / 40 / 50 |
History kept |
Config.MaxGroupName |
32 |
Longest crew name |
Config.MaxCrewSize / Config.MaxCrewSizeVerified |
6 / 10 |
Members in an unverified crew and in a verified crew (turf approved) |
Config.CancelJobOnBelowMinCrew |
true |
Kicking a member cancels the running job if the crew falls below the job's minCrew |
Config.LeaderboardLimit |
10 |
Rows on the leaderboards |
Config.PeriodicCheckInterval |
30 |
Seconds between job timeout checks |
Config.Features switches whole systems. A feature turned off disappears from the tablet and the server refuses its actions.
| Feature | Default |
|---|---|
market |
true |
laundering |
true |
turf |
true |
crewBank |
false |
crewStash |
false |
missions |
true |
seizure |
true |
disguise |
true |
If you turn laundering off while payouts are dirty money, nobody can clean it. Set Config.Economy.payoutAccount to 'cash' or 'bank' too.
config/server.lua#
| Key | Default | What it does |
|---|---|---|
Config.AdminAces |
{ 'founder', 'admin', 'command.criminaltabletadmin' } |
Any of these aces gives the Admin tab |
Config.AdminPanelPermission |
'panel_tablet' |
With glitch-admin, a role holding this panel permission is a tablet admin too ('' means aces only) |
Config.TabletSessionCheck |
true |
Tablet-only actions are refused unless the server opened the tablet for that player |
Config.NetEventGuard |
false |
Optional anticheat counter (see below) |
Config.ActionLogChannel |
'criminal' |
glitch-admin webhook name for the action log ('' means Logs tab only) |
Config.WebhookChannel |
'' |
glitch-admin webhook name for rank-ups, high-tier jobs and admin changes |
Config.WebhookEvents |
all true |
Which of rankUp, highTierComplete and adminAction are posted |
Config.CrewVoice |
enabled = 'auto' |
Crew talkie check. Needs glitch-bridge and glitch-admin |
Config.NetEventGuard counts every net event players send to the tablet and reports the counts once a second to your anticheat with a server event (the format is in server/guard.lua). Nothing is blocked and no code is loaded from the anticheat. It only runs while the named resource is started. Turn it on in the file or from server.cfg:
set glitch_criminaltablet_netguard_resource "my-anticheat"
set glitch_criminaltablet_netguard_event "my-anticheat:netcount"
The crew talkie can also be set from convars so the file stays server-neutral:
set criminaltablet_voice_staff_category "your-discord-category-id"
set criminaltablet_voice_bypass_roles "Role One,Role Two"
config/jobs.lua#
Config.Ranks has nine ranks, indexed from 0. REP needed: Street Rat 0, Small Timer 1,000, Hustler 3,400, Operator 8,000, Professional 16,000, Syndicate 56,000, Kingpin 107,000, Untouchable 192,000, Legend 312,000. Each rank names the job it unlocks.
Each entry in Config.Jobs has these fields:
| Field | What it does |
|---|---|
id, name, label, desc |
Identity and text |
enabled |
false switches the job off everywhere |
kind |
'mission' (the tablet runs it) or 'external' (another script runs it and reports back) |
script |
For external jobs: the resource that runs it, or a list where any one will do. While none is started the job is hidden and cannot be claimed |
lineup |
External jobs: the crew presses Start and picks who takes part before the job script may begin |
category |
Map pin style from Config.JobCategories (courier, vehicle, robbery, heist, shipment) |
tier |
1 to 5. Drives turf influence, webhooks (tier 3 and up) and the restart window |
contact |
Which contact in config/contracts.lua offers it |
minRep, minTrust |
REP and contact trust needed (trust 20 Known, 50 Trusted, 80 Inner circle) |
minCrew, maxCrew, minPolice |
Crew size and on-duty police needed |
payout, repEarn |
{ min, max } crew pot and REP for each person |
cooldown, duration |
Seconds |
requires |
Finished jobs needed first: { jobId = 'x', minCompletions = n } or { jobIds = { ... }, minCompletions = n } |
requiresItem |
A chain item the starter must carry; it is used up on start |
The package ships these jobs (mission jobs in bold): courier, boost, chop, house_rob, house_rob_apt, house_rob_mid, house_rob_high, store_rob, liquor_rob, gas_rob, atm_rob, datatheft, art_gallery, jewelry, bank, paleto_bank, pacific_standard, armored_truck, humane_labs, cargo_train, union_depository, yacht, casino_heist, shipment_t1, shipment_t2 and shipment_t3. The script field names the resource that runs each external job. Contact names, place names and coordinates in the shipped config are set for the standard GTA map, so review them before you go live.
config/contracts.lua#
| Key | Default | What it does |
|---|---|---|
Config.ContractSystem.enabled |
true |
Contract board on or off |
requireContract |
true |
A crew must hold the contract before a job starts or a reported robbery pays |
expiryMinutes |
30 |
A claimed but unfinished contract goes back on the board after this |
hotContractBonus |
0.30 |
+30% payout and REP on the hot contract |
hotRotateMinutes |
90 |
Minutes between picking new hot contracts (0 is off) |
maxConcurrent |
1 |
Contracts a crew holds at once |
tempGuestDurationMinutes |
60 |
How long a contract guest stays |
guestInviteWindowMinutes |
5 |
How long a guest invite stays open |
staticContracts |
two courier pickups | Always on the board; each waits respawnMinutes after a finish |
dynamicPool |
casino, jewelry and courier sites | Rotating sites; higher weight is picked more often |
Config.Contacts holds 14 contacts: the Fixer, the Handler, the Mechanic, Silvia (cargo), the Broker (data), the Chemist, the Botanist, the Cartel, the Cousin, the Collector, the Forger, Dodge (houses), the Fence and the Quartermaster (Black Market). Each has a role (fixer, dealer, fence or blackmarket), a model, coordinates, a blip, the jobTypes it offers, an opening line and an interaction method. Config.ContactDiscovery.revealTrust is the trust at which a contact's location shows on the tablet.
Coordinates are set for the standard GTA map. Stand on each spot in game and adjust if a ped floats or a pin is off.
config/economy.lua#
| Key | Default | What it does |
|---|---|---|
Config.Economy.payoutAccount |
'dirty' |
'dirty', 'cash' or 'bank' |
Config.Economy.dirtyItem |
'black_money' |
ox_inventory item used as dirty money (1 item is $1) |
Config.Laundering.feeRange |
{ 30, 38 } |
Fee in percent, rolled once each server restart |
Config.Laundering.minFeePct |
10 |
The fee never drops below this |
Config.Laundering.minBatch / maxBatch |
500 / 0 |
Batch limits (0 is no maximum) |
Config.Laundering.processMinutes |
15 |
Wait before the clean money can be collected |
Config.Laundering.depositTo |
'cash' |
'bank' or 'cash' |
Config.Laundering.cancelLossPct |
5 |
Lost when a load is cancelled |
Config.Laundering.alert |
over $3,000, 10% | Chance of a police alert on big loads |
Config.Laundering.npc |
enabled | The public washer NPC |
Config.Market.restockMinutes |
60 |
Fence restock interval |
Config.Market.priceDriftPct |
15 |
Each price moves by up to this on restock |
Config.Market.trustDiscountPct |
10 |
Buy discount and sell bonus at maximum trust |
Config.Market.saturation |
enabled | The Fence pays less for an item once a lot of it sold that day, server-wide |
Config.Pawn.rate |
0.40 |
Share of the Fence's dirty price paid in clean cash at the pawn counter |
Config.Trust |
max 100 | Trust per contract (5) and per trade (1), plus tier labels |
config/turf.lua#
| Key | Default | What it does |
|---|---|---|
Config.Turf.mode |
'drawn' |
'drawn' or 'influence' |
requireAdminApproval |
true |
A crew can only hold turf once an admin enables it for the crew |
gangTie.enabled |
true |
Approving turf puts crew members in a Qbox gang |
gangTie.allowCustom |
true |
A new gang name typed in admin is created in Qbox (writes qbx_core/shared/gangs.lua) |
protectionIncome |
false |
Owned turf pays protection money into the crew bank |
ownerPayoutBonus |
0.10 |
+10% on contracts inside your own turf |
drawn.minPoints / maxPoints |
3 / 24 |
Corners per territory |
drawn.minArea |
10000 |
Smallest territory in square metres |
drawn.claimCost |
0 |
Dirty money taken from the crew bank to claim |
drawn.redrawCooldownMinutes |
30 |
Between claims, per crew |
Config.Turf.alerts |
enabled | Lookout alerts to the owners when outsiders work their turf |
Config.Turf.homeBonus |
see file | Extra crew REP and drug sale perks for owners |
Config.TabletMap |
img/gtav-satellite.webp |
The map picture and its world bounds ('' draws a schematic) |
config/crews.lua#
Config.Crews.soloJobs (true) lets someone with no crew claim and start jobs through a hidden crew of one. Roles are leader (Boss), lieutenant and member (Soldier), each with permissions invite, kick, promote, claim, start, withdraw, stash, guests and turf. Tiers come from crew REP: Street Crew (0), Outfit (45,000), Syndicate (150,000) and Cartel (360,000), each with stash slots, stash weight, maximum turf area and how many crew places (wardrobe, stash, garage) work. stashAccess is 'turf' (only inside the crew's own turf) or 'anywhere'. fundProvider is 'omes_banking' or false.
config/police.lua#
| Key | Default | What it does |
|---|---|---|
Config.Police.jobType |
'leo' |
Qbox job type counted as police for each job's minPolice |
dispatchHeat |
per ps-dispatch code | Heat added to the player whose game raised an alert |
knownSuspect.enabled |
false |
A second call that names a known suspect at high heat |
arrest.repLossPct / minRepLoss |
5 / 100 |
REP lost on arrest |
arrest.cancelActiveJob / failContracts |
true / true |
The crew's running mission is cancelled and its claimed contracts fail |
arrest.seizeItems |
drugs, chain items, keycard | Items police seize on jail |
seizure.enabled |
true |
On-duty police can read a seized upgraded tablet |
seizure.evidenceEntries |
10 |
Recent entries police can read |
seizure.wipeCooldownMinutes |
60 |
Between history wipes |
An arrest is counted when the qbx metadata injail goes above 0, or when another resource calls the Arrested export.
config/gameplay.lua#
| Key | Default | What it does |
|---|---|---|
Config.RepScale |
0.4 |
Multiplier on REP earned from jobs |
Config.CrewRepBonus |
0.05 |
+5% REP for each crew member above a job's minimum |
Config.EvidenceBonusPercent |
20 |
+20% REP for a job finished without leaving evidence |
Config.TimeoutPayoutFraction |
0.0 |
Keep at 0 |
Config.AllowOfflineJobComplete |
true |
A reported robbery also rewards members who went offline |
Config.OfflinePayoutPenaltyPercent |
25 |
Less pay for each offline member |
Config.HeatSystem.enabled |
false |
Heat per job, decay (decayPerHour = 10), payout cut (payoutPenaltyPct = 0.25, at most 30) |
Config.StreakBonus, Config.DoubleRepEvents, Config.HeistRules |
see file | Clean-run streaks, scheduled double-REP events, heist rules |
config/missions.lua#
Config.Missions.failure takes repLoss = 60 REP and trustLoss = 5 trust from everyone on a failed mission. turfToll.pct = 10 is the share of the payout a rival crew takes when you cross its turf. boost holds the car classes (D, C, B, A, S and SP, shown as S+) with weight, minimum boosting level, minimum police, buy-in, pay range, guards, alarm chance, tracker hacks and car models, plus break-in, plate and drop-off settings. courier holds the item (contraband_package), drop settings and the weighted package types.
config/blackmarket.lua and config/washnetwork.lua#
Config.BlackMarket (enabled = true, minRep = 8000) sets the van model, dealer, crates and stock; his possible spots are in the server-only config/blackmarket_spots.lua. Config.WashNetwork (enabled = 'auto') sets the money man (introRep = 8000, introJobs = 15), the keycard trade and the machines. It needs the G&N Illegal Maps and Warehouses MLOs (maps lists their resource names).
Locales#
locales/en.json holds notifications and refusals. To add a language, copy it to locales/<code>.json and set setr ox:locale "<code>". English is the fallback.