⚙️Config

Vault Bank Robbery Configuration & Integration Guide

This document explains the configuration options available in the Vault Bank Robbery script and provides guidelines for setting it up on your FiveM server. The script includes framework detection, target support, dispatch integration, cooldowns, camera control, notification systems, Discord logging, and more.

---

1. Interaction Method

Choose how players will interact with the environment:

Config.Interaction = 'auto_detect' -- Options: 'qb-target', 'ox_target', 'qb-drawtext', 'HelpNotification'

Custom resource name:

Config.CustomTargetName = 'qb-target'

Incase you change the resource name of your target (only applies to qb-target)

---

2. General Settings

These are basic customizable options:

Config.RequiredPoliceCount = 0
Config.RequireGasMask = true
Config.RequireBag = false
Config.BagClothing = {44, 45}
Config.GasMasks = {38, 46}

Cooldown setting (in seconds):

Config.CoolDownRobbery = 2700

---

3. Required Items Display

Enable requirement preview using v-requireditems:

Config.ShowRequiredItems = true

Location and items:

Config.RequiredItems = {
    pos = vector3(241.53, -1091.94, 29.66),
    dist = 2.0,
    items = {
        {item = "thermite", amount = 3},
        {item = "explosive", amount = 3},
        {item = "tablet", amount = 1},
        {item = "gas_mask", amount = 1},
        {item = "duffle_bag", amount = 1},
    }
}

Required Items Preview: https://files.fivemerr.com/videos/de8f9cdd-3142-4fce-896d-15145e8e885a.mp4

---

4. Dispatch Configuration

Send alerts to police during robberies:

Config.DispatchJobs = {'police'}
Config.Dispatch = 'auto_detect' -- Options include: 'cd_dispatch', 'ps-dispatch', etc.

Custom dispatch settings are editable in server/police.lua. If you're using ps-dispatch you'll need to modify the ps-dispatch

Add to ps-dispatch > shared > config.lua

    ['thevaultbankrobbery'] = {
        radius = 0,
        sprite = 500,
        color = 1,
        scale = 1.5,
        length = 10,
        sound = 'robberysound',
        offset = false,
        flash = false
    },

Add to ps-dispatch > client > alerts.lua

local function TheVaultBankRobbery(camId)
    local coords = GetEntityCoords(cache.ped)

    local dispatchData = {
        message = 'The Vault Bank Robbery',
        codeName = 'thevaultbankrobbery',
        code = '10-90',
        icon = 'fas fa-vault',
        priority = 1,
        coords = coords,
        gender = GetPlayerGender(),
        street = GetStreetAndZone(coords),
        camId = camId,
        alertTime = nil,
        jobs = { 'leo' }
    }

    TriggerServerEvent('ps-dispatch:server:notify', dispatchData)
end
exports('TheVaultBankRobbery', TheVaultBankRobbery)

---

5. Notification System

Customize how notifications are shown:

Config.Notification = 'auto_detect' -- Options: 'qb', 'ox', 'okokNotify', 'gta', 'custom'

Modify or extend in the SendNotification() function.

---

6. Discord Webhooks

Send logs to Discord for specific events:

Config.DiscordLog = {
    ['webhook'] = 'YOUR_WEBHOOK_HERE',
    ['name'] = 'Vault Bank Robbery',
    ['image'] = 'https://media.istockphoto.com/id/849792602/vector/flat-icon-of-bank-building.jpg'
}

Events like give_item, start_heist, and ban_player .

---

7. Camera Control (Optional Visual Feature)

Enables dynamic camera angles during interactions:

Config.UseCamera = true
Config.Keybind = {
    key = 0, -- V
    text = 'Press ~INPUT_NEXT_CAMERA~ to toggle camera'
}

Define camera settings:

Config.Cameras = {
    {
        name = 'thermite',
        camOffset = vector3(0.8266, -0.4189, 0.36),
        camFov = 65.0,
        duration = 1500,
        rot = vector3(-8.8819, 0, -330.7087),
        useUI = true
    },
    {
        name = 'grabbingstacks',
        camOffset = vector3(0.7316, -0.4915, 0.3),
        camFov = 60.0,
        duration = 1000,
        rot = vector3(-6.2362, 0, -325.1653),
        useUI = true
    }
}

📽️ Camera Preview: https://files.fivemerr.com/videos/a1efc273-45bd-4a2a-a63e-d192f53dd40b.mp4

---

8. Command to Reset Bank

Use this command to manually reset the heist:

Config.ResetBankCommand = 'resetvaultbank'

---

9. Localization

Set the language to support translations:

Config.UseLanguage = 'en' -- Options: 'en', 'es', 'fr', 'de', 'it'

---

10. Advanced Robbery Interactions

Configure specific actions during the heist such as:

Door Unlocking

doors = {1, 2, 3}

Required Items

required_items =  {
    { item = 'thermite', amount = 1, remove_amount = 1, remove_chance = 100 }
}

Rewards

For example, with trolleys:

types = {
    {grab_type = 'gold', reward = 'goldbar', reward_amount = {10, 25}, chance = 33},
    {grab_type = 'diamond', reward = 'diamondbar', reward_amount = {25, 100}, chance = 33},
    {grab_type = 'cash', reward = 'money', reward_amount = {1, 3}, chance = 33},
}

---

Summary

This script offers a flexible and highly customizable vault heist experience. Every setting—from police requirements to minigames and camera effects—can be tailored to your server’s needs.

✅ Tip: Always test changes in a development environment before pushing them live.

Last Updated: August 2025