Everything is in config.lua, with a comment on each setting. Player text is in locales/en.json. To translate, copy en.json to your language code and set setr ox:locale "xx" in server.cfg.
Prices, timers and XP in config.lua were tuned on a live server, so check them against your own economy before you open.
Server profiles#
Put your changes in a profile file so updates never overwrite them. Any profile/shared/<name>.lua loads right after config.lua on the server and on clients. Any profile/server/<name>.lua loads before every other server script and is never sent to players. Each file only sets what it changes:
-- profile/shared/myserver.lua
Config.Corner.minPolice = 2
Config.Cousin.areaName = 'Grapeseed'
Config.Phone.spots[1].label = 'Pillbox Hill'
Config.PoliceJobs = { 'police', 'sheriff' }
Both folders are in escrow_ignore.
Corner selling (Config.Corner)#
| Setting | Default | What it does |
|---|---|---|
pitchCooldown |
10 |
Seconds between offers. |
refuseChance / minRefuse |
0.35 / 0.10 |
Chance a buyer is not interested, and the lowest it can drop to with perks and good-quality zones. |
refuseCallChance |
0.5 |
Chance a buyer who refuses calls the police. |
robChance |
0.08 |
Chance the buyer grabs the bag and runs. |
alertChance |
0.10 |
Police alert chance per sale. A drug in Config.Drugs can override it. |
walkAway |
5.0 |
Walk this far from the buyer and the deal is off. |
offerTimeout |
25 |
Seconds the player has to accept. |
refuseHeat |
80 |
Criminal tablet heat at which buyers will not deal. |
minPolice |
1 |
No drug sales at all with fewer on-duty police than this. The server enforces it. |
buyerRange |
4.0 |
Largest distance the server allows between seller and buyer. |
buyerReuse |
600 |
Seconds before the same ped can be pitched again. |
zoneStick |
75.0 |
Metres a player must move before the zone they sell in can change. |
zoneConfirm |
2 |
Characters who must report a zone in a square before the server trusts it there. |
lookoutRadius / lookoutMult |
25.0 / 0.7 |
An sd-phone group partner this close is a lookout, and the alert chance is multiplied by lookoutMult. |
Config.PoliceJobs (police, sheriff, bcso, sasp) sets who counts as police. Config.BlacklistPeds lists ped models that never get the "Offer drugs" option.
Drugs (Config.Drugs)#
Each entry is an ox_inventory item with a price range per unit, an amount range per sale and a kind (weed, coke, edible, crack):
['weed_amnesia'] = { price = { 176, 220 }, amount = { 1, 2 }, kind = 'weed', purity = true },
['crack_baggy'] = { price = { 143, 209 }, amount = { 1, 3 }, kind = 'crack', zones = { 'DAVIS', 'STRAW', 'CHAMH', 'RANCHO' },
area = { min = vec2(-550.0, -2500.0), max = vec2(900.0, -900.0) } },
purity = true prices the item by metadata.purity (40 pays the minimum, 99 the maximum, bags without it count as 70). zones limits a drug to those GTA zones, and area is the same place as a box that the server checks against the seller's real position. alertChance overrides the corner alert chance for that drug.
Config.Traits and Config.LandraceMult (1.10) read weed bag metadata from glitch-drugs. Bags without it sell normally.
Area pricing#
| Setting | Default | What it does |
|---|---|---|
Config.Saturation.dropPerSale |
0.03 |
Price knocked off per sale in a zone and in the seller's square. |
Config.Saturation.floor |
0.5 |
Lowest saturation multiplier. |
Config.Saturation.recoverMinutes |
40 |
Time for a zone to recover fully. |
Config.Saturation.cellSize |
150.0 |
Size of the squares the server saturates, in metres. |
Config.Quality.enabled |
true |
Zone quality reputation on or off. |
Config.Quality.days / neutral / perPoint |
7 / 60 / 0.0025 |
Days of sales that count, the quality that changes nothing, and the price change per quality point. |
Config.Quality.min / max |
0.92 / 1.10 |
Limits of the quality multiplier. |
Config.TurfBonus |
0.10 |
Extra price inside your crew's turf. Needs the criminal tablet. |
Config.TurfPressure.perSale |
4 |
Turf pressure added per sale in another crew's turf, plus 1 per unit. |
Undercover buyers and police alerts#
| Setting | Default | What it does |
|---|---|---|
Config.Undercover.enabled |
true |
Undercover buyers on or off. |
Config.Undercover.chance |
0.04 |
Base chance a corner buyer is a cop. |
Config.Undercover.perHeat / maxChance |
0.0006 / 0.15 |
Extra chance per point of tablet heat, and the cap. |
Config.Undercover.hintChance |
0.35 |
Chance of a warning that something is off, even without the Lookout perk. |
Config.AlertFallbackSeconds |
8 |
How long the server waits for the seller's ps-dispatch call before it files the call itself. |
Config.Alerts |
Table | The corner, stakeout, refused and sting calls: code, code name, icon, priority, blip and tablet heat. message and information are locale keys under alerts in locales/en.json. |
The Cousin (Config.Cousin)#
| Setting | Default | What it does |
|---|---|---|
item / blueItem |
'meth' / 'blue_meth' |
Items he buys. Blue crystal counts towards minBags. |
minBags |
25 |
Fewest bags he takes in one sale. |
price |
{ 90, 140 } |
Per bag, by purity (40% pays the minimum, 99% the maximum). |
blueMultiplier / signatureBonus |
1.5 / 0.05 |
Extra for blue crystal and for signed bags (metadata.signature). |
minRank |
3 |
Criminal tablet rank needed. Ignored without the tablet. |
askAtBase |
true |
Without the tablet, players ask him for a meet at his base. |
base / baseRange |
vec4(713.56, 4182.41, 40.70, 187.09) / 5.0 |
Where he sits, and how close players must stand to talk to him there. |
meets |
6 spots | Meet locations, one picked per meet. |
replySeconds / leadMinutes / meetMinutes |
{ 5, 12 } / { 5, 10 } / 15 |
How long he takes to answer, how soon he is at the spot, and how long he waits. |
cooldownMinutes / refuseCooldown |
60 / 15 |
Cooldown after a yes and after a no. |
busyChance / refuseHeat |
0.15 / 60 |
Chance he is busy, and the tablet heat at which he will not meet. |
noShowCooldown / noShowRep / noShowTrust |
180 / 150 / 5 |
What a no-show costs: minutes of cooldown, tablet REP and his trust. |
stakeoutChance |
0.15 |
Chance of a police alert at a bulk sale. |
areaName |
'the Alamo Sea' |
The place his hint messages send players to. |
logOver |
10000 |
Bulk sales of at least this much go to the tablet's event log. |
hintContacts |
Table | Tablet contacts who first tell a player about him (rank, botanist, cook). |
If you change minBags, also change the "twenty-five bags" text in locales/en.json (cousin.hint_cook) and in rc-interactions/glitch_cousin.json. Those lines do not read the setting.
Deals app (Config.Phone)#
| Setting | Default | What it does |
|---|---|---|
enabled |
true |
The app on or off. |
unlockPerk |
'deal_phone' |
glitch-xpSystem perk effect that unlocks the app. '' gives it to everyone, and so does running without glitch-xpSystem. |
starterCustomers / maxCustomers |
2 / 12 |
Regulars a new dealer starts with, and the most they can have. |
newCustomerChance |
0.12 |
Chance per corner sale that the buyer asks for your number. |
orderEvery |
{ 4, 9 } |
Minutes between orders while open. |
acceptMinutes / meetMinutes |
3 / 12 |
Time to answer an order, then time to reach the meet. |
amount |
{ 3, 8 } |
Units per order, plus a loyalty bonus. |
loyaltyStart / loyaltyDeal / loyaltyLate / loyaltyDecline |
40 / 6 / -12 / -3 |
Loyalty at the start and the change per completed, missed and declined order. |
priceBonus |
0.15 |
Extra on top of the street price at loyalty 100. |
undercoverMult / trustedLoyalty |
0.5 / 60 |
Undercover chance on phone deals (times the corner chance), and the loyalty at which a customer is never undercover. |
people |
60 names | Each name is always the same ped model. Use a female model for a female name. |
spots |
13 spots | Meet spots with a label players see, a GTA zone for quality reputation and coords. |
Config.SafeSpotRadius (40.0) moves a customer to the nearest walkable pavement within that many metres of the spot, and the server allows the hand-over anywhere in that radius.
THC gummies (Config.GummyAsk, Config.GummyStaffOnly)#
These read gummy metadata written by glitch-drugs. Without it, thc_gummy sells at its plain purity price.
| Setting | Default | What it does |
|---|---|---|
chance / flavourBonus |
0.35 / 0.25 |
Chance a buyer asks for a flavour, and the extra for a fresh match. |
shapeChance / shapeBonus |
0.15 / 0.15 |
Share of asks that want a shape instead, and the extra for a match. |
hotBonus / coldPenalty |
0.15 / 0.15 |
Daily hot and cold flavour, picked from trendFlavours. |
crownPay / crownMinFans / crownBonus |
5000 / 50 / 0.05 |
Weekly crown: dirty money paid to the top brand's owner, the fans needed, and the bonus for the week. |
bulkChance / bulkCooldown / bulkBonus |
0.08 / 1200 / 0.20 |
Bulk buyers who want 6 to 10 gummies of one flavour right now. |
maxBonus / maxMult |
0.35 / 1.6 |
Cap on all gummy bonuses together, and on the final price multiplier. |
loyaltyPer / loyaltyPct / loyaltyMax |
25 / 0.01 / 0.15 |
Brand loyalty: +1% per 25 sold, up to 15%. |
GummyStaffOnly.enabled |
false |
With it on, only players with an ACE in aces or a Discord role in discordRoles can sell gummies. |
XP, REP and perks#
| Setting | Default | What it does |
|---|---|---|
Config.XP.enabled |
true |
glitch-xpSystem XP on or off. |
Config.XP.perSale / bulk |
4 / { 50, 150 } |
XP per corner sale, and per Cousin sale. Both go to the dealing category. |
Config.XP.maxTakeBonus / maxAlertCut |
0.15 / 0.40 |
Caps on the price perks and on the alert cut perks. |
Config.Rep |
{ per = 25, dailyCap = 500 } |
Criminal tablet REP: 1 per $25 sold, up to 500 a day. |
Config.Kingpin |
radius = 50.0, notifyEvery = 300 |
A crewmate with the Kingpin perk this close lends the seller their price and alert perks. |
Config.Account / Config.DirtyMoney.item |
'dirty' / 'black_money' |
How sales are paid. |
The perks the resource reads from glitch-xpSystem are deal_street_price, deal_buyer_speed, deal_alert, deal_saturation, deal_bulk_price, deal_lookout, deal_meet_reveal, deal_big_orders, deal_kingpin and deal_phone.
Optional resources#
| Setting | Default | What it does |
|---|---|---|
Config.Tablet |
enabled = true, resource = 'glitch-criminaltablet' |
The criminal tablet, with the Cousin's contact id (cousin) and meet button (meet). |
Config.Interactions |
useRcInteractions = true |
rc-interactions flow names: Glitch Cousin, Glitch Deals Customer and Glitch Corner Buyer. |
Config.Integrations.mapLegend |
false |
Report blip names to a pause map legend through local events. |
Config.Integrations.maintenanceState / maintenanceKey |
nil / 'drugsales' |
A GlobalState key holding off[maintenanceKey] = true turns sales off. |
Config.Integrations.testingModeState |
nil |
A GlobalState key that turns every admin bypass on while it is true. |
Config.Integrations.crimeLedger |
nil |
Name of a resource with a LogCrime(src, data) export. |
Config.Integrations.discordRoles |
nil |
Name of a resource with a hasDiscordRole(src, roles) export, used by Config.GummyStaffOnly. |
Config.TestCommands |
false |
Registers /cousinmeet and /dealsorder. |
Config.Debug |
false |
Extra console output. |
A hook whose resource or key is missing is skipped.