Studios
Criminal Tablethouse-3.jpg

Configuration

SoonCriminal TabletQbox
PAGE 03 OF 08  ·  INSTALLATION → CONFIGURATION → EXAMPLESdocs.glitchstudios.dev
Browse docs

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.