Configure

Requirements

• FS-Lib

Optional integrations:

• rcore_cam (security system integration; records events on robberies)
• Money frameworks: fs-money, qb, qbx, 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

Installation

1. Place FS-Robberies in your resources folder.
2. Ensure required dependencies are started.
3. Add ensure FS-Robberies to server.cfg.
4. Edit config.lua and restart the resource.

General

Permissions and admin tools

Config.AdminVaultOpen:

Framework integrations

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

Config.Inventory:

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.

Robbery tuning

Config.Robbery contains settings for:

• Register
• ATM
• Safe
• Vault

Each includes timers, rewards, cooldowns, and optional ACE perms.

Custom locations and vaults

• Config.CustomLocationRobberies lets you add custom robbery points.
• Config.CustomVaults defines custom vault doors, props, and inside loot points.

Drill and display

• Config.UseDrillMinigame (boolean): Enable drilling minigame.
• Config.DrillCamShake and Config.DrillOverheat tune drill effects.
• Config.ShowTextPrompt and Config.ShowPanicTextPrompt control prompts.
• Config.TargetSystem enables target interactions.

Keybinds

Config.Keybinds:

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