XyraLScripts
Home/Documentation/XS-Robberies
Installation guide

XS-Robberies

A robbery creator, not a robbery script. Build the job in game as a chain of stages, and the script runs whatever you built.

01

Requirements

Short list:

  • ox_lib
  • oxmysql
  • Any one of ox_inventory, qb-inventory, qs-inventory, codem-inventory, core_inventory or ps-inventory

ox_target or qb-target are used when present. Without either, interaction falls back to a marker and a key prompt, so nothing breaks.

Dispatch is optional — XS-Dispatch, ps-dispatch, qs-dispatch, cd_dispatch and core_dispatch are all detected, and a plain notification is used when none are running.

02

Installation

  1. Drop the folder into your resources.
  2. Import sql/xs_robberies.sql.
  3. Add ensure XS-Robberies after ox_lib and oxmysql.
  4. Give yourself access: add_ace group.admin xs.robberies allow, or list your framework groups in Config.Admin.
  5. In game, run /robberies.
03

Building your first one

Everything is built in game. A robbery is a chain of stages, and each stage names what the player has to do and what happens when they do it — force a door, cut power, crack a safe, carry a bag out.

Nothing about a job lives in a config file. The builder writes it to the database, so a job you build survives an update.

04

Presets

Presets are starting points, not finished scripts. Load one, then change the stages, the timings, the rewards and the locations to suit your map.

They exist so you are not staring at an empty builder on a first run.

05

Guards, lasers and consequences

A stage can add guards, lasers and alarms. These are per-stage, so the same building can be quiet on the way in and loud on the way out.

Consequences are configured alongside them — what dispatch gets told, how long the heat lasts, and whether the job can be attempted again.

06

Before going live

  • Nothing ships pre-made beyond the presets. Build or load a job before players go looking for one.
  • Verify any prop or ped model you put in the builder — a guessed model fails quietly.
  • Test the whole chain start to finish yourself. A stage that cannot be completed blocks the job.
07

Troubleshooting

Nothing happens when I run /robberies

You do not have access. Add the ace (add_ace group.admin xs.robberies allow) or put your group in Config.Admin.

There is no prompt on the door

No target resource is running and the fallback marker is out of range. Walk closer, or install ox_target.

Police never get told

No supported dispatch resource was detected, so it falls back to a notification. Check the dispatch resource name against the supported list.

08

Updating

  1. Back up the database first.
  2. Keep a copy of your edited config.lua.
  3. Check recent commits for SQL changes before replacing files.
  4. Replace the resource folder, merge your config back, restart.
09

Support

Bugs and questions go to the Discord. Include your server's console output — the resource prints the reason when it refuses to do something, and that line is usually the whole answer.

XS-Robberies on GitHub