💰 FX-STORE ROBBERY

Advanced store robbery system for RedM with minigame, cooldown, job requirements, alerts, and fully synced robbery mechanics.

---

📦 Installation

ensure fx-storerobbery

• Place script into your resources folder • Add to server.cfg • Uses NUI system and synced robbery states

---

🧱 Required Item (SQL)

INSERT INTO `items` (`item`, `label`, `limit`, `can_remove`, `type`, `usable`, `metadata`, `desc`)
VALUES ('lockpick', 'Lockpick', 10, 1, 'item_standard', 1, '{}', 'Shovel');

• Required item for robbery system • Used for safe breaking and minigame

---

⚙️ Basic Settings

Config.Language = "en"

• Controls language system

---

🎮 Interaction System

Config.UseTarget = false

• false → prompt system • true → ox_target

---

Config.Prompts = {
  ["robbery"] = {
    Label = "Cash Register"
  }
}

• Hold-based robbery interaction • Fully customizable keys and distance

---

Config.Keybinds = {
  ["takemoney"] = 0x760A9C6F
}

• Key used to collect money

---

🏪 Register System

Config.CreateRegisterProp = {
  { id = "blackwater", model = "p_register01x" }
}

• Creates robbery targets dynamically • Each register is synced for all players • Uses custom placed registers instead of default ones

---

Config.DeleteDefaultProps = {
  "p_register01x"
}

• Removes existing map registers • Prevents duplicate interaction points

---

🎭 Animation System

Config.RobAnims = {
  Player = {},
  Entity = {},
  lockpick = {},
  success = {},
  fail = {}
}

• Full robbery animation flow • Includes lockpick, success, fail animations • Supports weapon / unarmed variations

---

🚨 Alert System

Config.AlertBlips = {
  blipname = "Store Robbery !",
  blipsprite = -2018361632
}

• Sends robbery alerts to players • Displays map blip • Automatically removed after time

---

🎮 Minigame System

Config.MinigameFunction = function(callback)

• Uses external minigame resource • Returns success or fail • Optional system (can be disabled)

---

🎯 Robbery System

Config.RobberyStores = {
  ["Blackwater"] = {}
}

• Each store is fully configurable • Supports unlimited store entries

---

📍 Store Settings

coord = vector3(...)
distance = 2.0
promptTitle = "Store Name"

• Defines robbery location • Controls interaction distance • UI display title

---

👮 Job Requirement

ActiveJobs = {
  ["sheriff"] = 1
}

• Requires active players from specific jobs • Prevents robbery if requirement not met

---

⏱️ Cooldown System

RobberyDelay = 60

• Cooldown between robberies (minutes) • Prevents spam robberies

---

RobberyTimeout = 5

• Max robbery duration • Cancels robbery if time exceeded

---

🎲 Minigame & Progress

MinigameActive = true
ProgressBar = 30

• Minigame toggle • Progress duration (seconds)

---

🧰 Required Items

requiredItems = {
  { item = "lockpick", count = 1 }
}

• Required to start robbery • Can remove item on success/fail

---

🕒 Time Restriction

RobberyTimeSettings = {
  allowed = false,
  open = 0,
  close = 6
}

• Restricts robbery to specific hours • Supports night-only robberies

---

🎁 Reward System

Rewards = {
  Cash = {10, 100},
  Items = {
    { item = "goldnugget", count = 1 }
  }
}

• Random cash reward • Optional item rewards • Fully configurable

---

RewardChance = 100

• Chance to receive reward • Can simulate empty safes

---

🔔 Notification System

Notify({
  text = "Message"
})

• Supports VORP / RSG • Server + client notifications

---

🌐 Server Config

SV_Config.Webhook = {
  url = ""
}

• Discord webhook system • Logs robbery events

---

⚠️ Important Notes

• Lockpick item must exist • Store IDs must be unique • Job names must match framework • Cooldown must be configured • Minigame resource must be installed if enabled

---

🚨 Common Issues

• Cannot rob → missing lockpick • Robbery not starting → job requirement not met • No reward → reward chance config • Store locked → cooldown active • Minigame not working → missing dependency

---

🏁 Summary

FX-STORE ROBBERY provides:

• Fully synced robbery system • Minigame integration • Job-based restrictions • Cooldown & anti-spam system • Reward system (cash + items) • Alert & police system • Multi-framework compatibility

---

© Fixitfy Development