Configuration Reference

Customizing Your Experience

Configuration Reference

All settings are in config.lua.

Core

• Config.TargetSystem – Which target system to use (ox_target or qb-target).

• Config.InventorySystem – Inventory backend (kept as ox_inventory).

• Config.MenuSystem – UI helper (ox_lib).

• Config.DatabaseTable – Database table name for safes.

• Config.DebugLogs – Enable/disable debug prints.

• Config.RunMigrationsOnStart – Runs the table creation query on start if true.

Placement

• Config.PlacementDistance – Max distance for placement preview raycast.

• Config.PlacementZOffsets – Per‑tier Z adjustment to fix safes floating/sinking.

Notifications

• Config.NotifyType – Notification style (ox or qb).

Storage

• Config.StashDefaults – Fallback stash slots/weight if a tier doesn’t define them.

Locking

• Config.RelockItem – Item required to relock after a breach.

• Config.RelockConsumesItem – If true, consumes the relock item.

• Config.AutoRelockSeconds – Auto‑lock time after a code unlock (0 = off).

Sounds

• Config.SoundRadius – Range for lock/unlock sounds.

• Config.SoundVolume – Volume for lock/unlock sounds.

Minigames

• Config.Minigames.UseMhacking – Use mhacking for hacking attempts (false = fallback).

Drill Duration

• Config.BreachTools.drill.drillTime – How long drilling takes (in seconds).

Animations

• Config.HackingAnim – Dict/clip/flag for hacking animation.

• Config.DrillAnim – Dict/clip/flag + prop position/rotation for drilling.

Safe Keys

• Config.SafeKeys.Enabled – Turns key system on/off.

• Config.SafeKeys.CraftItem – Item used to craft a key.

• Config.SafeKeys.KeyItem – The key item name.

Storage Upgrades

• Config.StorageUpgrades.Enabled – Turns upgrades on/off.

• Config.StorageUpgrades[tier] – Per‑tier upgrade item, added slots/weight, max upgrades.

Vault Seal

• Config.VaultSeal.Enabled – Enable vault seal upgrade.

• Config.VaultSeal.Item – Item used to apply the seal.

• Config.VaultSeal.DurationSeconds – How long hacking is blocked.

• Config.VaultSeal.ConsumeItem – Consume item on use.

Anti‑Drill

• Config.AntiDrill.Enabled – Enable anti‑drill upgrade.

• Config.AntiDrill.Item – Item used to apply anti‑drill.

• Config.AntiDrill.ConsumeItem – Consume item on use.

Alarm

• Config.SafeAlarm.Enabled – Enable alarm upgrade.

• Config.SafeAlarm.Item – Item used to install alarm.

• Config.SafeAlarm.ConsumeItem – Consume item on install.

• Config.SafeAlarm.ReturnItemOnRemove – Give item back when removed.

• Config.SafeAlarm.DurationSeconds – How long the alarm runs.

• Config.SafeAlarm.RepeatSeconds – How often sound repeats.

• Config.SafeAlarm.Sound – Sound file name (without extension).

• Config.SafeAlarm.Volume / MinVolume – Max/min alarm volume.

• Config.SafeAlarm.Radius – Max distance for alarm audio.

• Config.SafeAlarm.SoundLengthSeconds – Length of the sound file.

• Config.SafeAlarm.NoOverlap – Prevent overlapping plays.

• Config.SafeAlarm.FalloffExponent – How fast volume drops with distance.

• Config.SafeAlarm.VolumeUpdateMs – How often volume is updated.

• Config.SafeAlarm.Light – Blinking red light settings.

• Config.SafeAlarm.Light.PerTierOffsets – Per‑tier light offsets.

Safe Models

• Config.SafeModels – Default model per tier if not overridden.

Safe Tiers

• Config.SafeTiers[tier] – Name, price, model, slots, weight, breach limits, cooldowns, minigame difficulty.

Breach Tools

• Config.BreachTools – Items used for hacking/drilling and their success rates.