#💰 FX-STORE ROBBERY

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

---

#📦 Installation

bashensure fx-storerobbery

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

---

#🧱 Required Item (SQL)

sqlINSERT 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

luaConfig.Language = "en"

• Controls language system

---

#🎮 Interaction System

luaConfig.UseTarget = false

• false → prompt system
• true → ox_target

---

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

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

---

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

• Key used to collect money

---

#🏪 Register System

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

---

luaConfig.DeleteDefaultProps = {
  "p_register01x"
}

• Removes existing map registers
• Prevents duplicate interaction points

---

#🎭 Animation System

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

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

---

#🚨 Alert System

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

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

---

#🎮 Minigame System

luaConfig.MinigameFunction = function(callback)

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

---

#🎯 Robbery System

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

• Each store is fully configurable
• Supports unlimited store entries

---

#📍 Store Settings

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

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

---

#👮 Job Requirement

luaActiveJobs = {
  ["sheriff"] = 1
}

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

---

#⏱️ Cooldown System

luaRobberyDelay = 60

• Cooldown between robberies (minutes)
• Prevents spam robberies

---

luaRobberyTimeout = 5

• Max robbery duration
• Cancels robbery if time exceeded

---

#🎲 Minigame & Progress

luaMinigameActive = true
ProgressBar = 30

• Minigame toggle
• Progress duration (seconds)

---

#🧰 Required Items

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

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

---

#🕒 Time Restriction

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

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

---

#🎁 Reward System

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

• Random cash reward
• Optional item rewards
• Fully configurable

---

luaRewardChance = 100

• Chance to receive reward
• Can simulate empty safes

---

#🔔 Notification System

luaNotify({
  text = "Message"
})

• Supports VORP / RSG
• Server + client notifications

---

#🌐 Server Config

luaSV_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