Studios
Drug Saleshouse-3.jpg

Configuration

SoonDrug SalesQbox
PAGE 03 OF 07  ·  INSTALLATION → CONFIGURATION → EXAMPLESdocs.glitchstudios.dev
Browse docs

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.