Studios
Heist Editorhouse-3.jpg

Configuration

SoonHeist EditorQbox
PAGE 03 OF 06  ·  INSTALLATION → CONFIGURATION → EXAMPLESdocs.glitchstudios.dev
Browse docs

Everything is in config.lua, and the file is open (not escrowed). shared/tasklists.lua is open too. It holds default task list lines for Glitch Studios heists and does nothing for ids you do not run.

Main keys#

Key Default What it does
Config.Debug false Draws every heist target as a sphere and prints client warnings to the console
Config.Command 'heisteditor' Name of the editor command
Config.Restricted 'group.admin' Who may use the editor and /heistreset
Config.Tablet.enabled true Use glitch-criminaltablet for contracts and heist slots
Config.Tablet.resource 'glitch-criminaltablet' Tablet resource name
Config.Tablet.requireContract true A contract is needed to start a heist
Config.Standalone.account 'dirty' Account used by heists with no tablet job
Config.Standalone.playerCooldown 7200 Seconds between runs per player for those heists
Config.DirtyMoney { item = 'black_money', qbItem = 'markedbills' } Item names used for dirty money. Change these to match your inventory.
Config.PoliceJobs { 'police', 'sheriff', 'bcso', 'sasp' } Jobs that count as police
Config.StreamDistance 90.0 Metres from a site's centre at which its targets, props and guards are built
Config.HistoryMax 100 Changes kept in the editor history

Hacking alerts#

Config.HackFailAlert makes a lost hacking minigame on any heist step call the police. A step can opt out with failAlert = false.

Key Default
enabled true
maxPerkCut 0.30
skip StartDrilling, StartPlasmaDrilling and StartLockpickGame are not treated as hacks
information, notify, slipText The dispatch and player messages

XP#

Config.XP is used with glitch-xpSystem. Perks are read on the server.

Key Default
enabled true
category 'heisting'
failShare 0.25
maxTakeBonus 0.15
maxAlertCut 0.40
maxSpeedCut 0.24
maxChainBonus 0.10
maxSaveChance 0.30

Clock and testing mode#

  • Config.Clock = { stateBag = 'currentTime', field = 'hour', fallback = 'os' } decides where the hour for a heist's hours window comes from. The server reads it, never the client. Set stateBag to nil to use the host clock, and fallback to 'skip' to turn the window off when no clock is found.
  • Config.TestingModeBag = 'glitchTestingMode' is the GlobalState key that turns on global testing mode (cooldown and police bypass). Set it to nil to disable.

Allowed events#

A definition's event action, deliver rewards and run.hold can only fire server events that match Config.AllowedEvents:

Config.AllowedEvents = { prefixes = { 'glitch-', 'glitch_', 'ghe:' }, names = {} }

A name must start with one of the prefixes or appear in names. Add your own heist resources here.

Interactions#

Config.Interactions = { useRcInteractions = false } turns on rc-interactions dialogue before a start step.

Keybinds#

Steps done from a vehicle use a key prompt, because ox_target does not work from a seat. The keybind is ghe_vehicle_step (default E) and players can rebind it in the GTA settings. The editor gizmo has its own keybinds: T for move, R for rotate, L for local or world axes and left mouse to select.

Data files#

File Holds
data/state.json Enabled switches, cooldown overrides, random pools and the last changes
data/live/<heistId>.json The definition in play after an edit. Delete it to go back to the default.
data/profiles/<heistId>/<name>.json Saved profiles

At start the engine picks the definition in this order: a random profile if the pool is on, else the live file, else the default from the heist resource.