Configure

Requirements

FS-Lib

Optional integrations:

rcore_cam (security system integration; records events on robberies)
Money frameworks: fs-money, qb, qbox, esx, custom
CAD systems: sonorancad, imperialcad, night_shifts, nd_mdt, lb_tablet, dusa_dispatch, custom
Inventory: qb_inventory, ox_inventory, ps_inventory, tgiann_inventory, custom
Target: ox_target or qb_target
Progressbar: ox_lib or lation_ui
Notifications: default, ox_lib, lation_ui

Installation

Copy the FS-Robberies resource folder into your server's resources directory.

Start required dependencies before FS-Robberies in server.cfg:

ensure FS-Lib
ensure FS-Robberies

If you use optional inventory, target, progressbar, CAD, or notification integrations, start those resources before FS-Robberies too.

Open config.lua and configure robbery locations, rewards, cooldowns, alerts, and integrations.

Restart your server, or restart the FS-Robberies resource from the server console.

General

Prop

Type

Permissions and admin tools

Prop

Type

Vault Finder Models

Config.VAULT_MODELS is only used by /fs_find_closest_vault_door_coord. Add your vault door model hash here if the finder can't detect it.

Config.AdminVaultOpen:

Prop

Type

Framework integrations

Config.MoneyFramework, Config.CAD, Config.NotificationSystem, and Config.ProgressBar select integrations:

Prop

Type

Inventory

Config.Inventory:

Prop

Type

Config.Inventory.Requirements:

Prop

Type

Robbery models

Config.RobberyModels defines registers, ATMs, and safes with model hashes and offsets.

Default vaults

Config.EnableDefaultVaults toggles built-in vault doors by ID:

prompt_sandy_bank_vault_door
harmony_fleeca_bank_vault_door
chumash_fleeca_bank_vault_door
legion_square_fleeca_bank_vault_door
pacific_standard_vault_door

Robbery tuning

Timer vs Drill

ATM, Safe, and Vault timer values are only used when Config.UseDrillMinigame = false.

Config.Robbery.Register:

Prop

Type

Config.Robbery.ATM:

Prop

Type

Config.Robbery.Safe:

Prop

Type

Config.Robbery.Vault:

Prop

Type

Custom locations and vaults

Config.CustomLocationRobberies lets you add custom robbery points.
Config.CustomVaults defines custom vault doors, props, and inside loot points.
See Create a Vault for a full walkthrough.

Drill and effects

Config.UseDrillMinigame, Config.DrillCamShake, Config.DrillDifficulty, and Config.DrillOverheat:

Prop

Type

Display and target

Config.ShowTextPrompt, Config.ShowPanicTextPrompt, and Config.TargetSystem:

Prop

Type

Panic button

Config.PanicButton and Config.PanicCooldown:

Prop

Type

Keybinds

Config.Keybinds:

Prop

Type

Commands

Admin:

/openvault opens the nearest vault (ACE gated).
/closevault closes the nearest vault.

Tools:

/fs_poly_start, /fs_poly_cancel, /fs_poly_finish for polygon builder.
/fs_find_closest_vault_door_coord prints the closest vault door coord.

Exports

See Exports for server exports.

Tips

If you enable target mode, set Config.TargetSystem.Enabled = true and disable text prompts.
If you enable inventory requirements, make sure item names match your inventory system.
rcore_cam is optional. If you have it, FS-Robberies can record events through the security system. rcore_cam