# Configuration Reference

**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.