#📦 INSTALLATION

bashensure fx-graverobbery

• Place the script inside resources/fx-graverobbery
• Add ensure fx-graverobbery to your server.cfg
• Restart your server

---

#📦 VORP ITEM INSTALL

sqlINSERT INTO items (...)
VALUES
('shovel', 'Shovel', ...)

• Required item for grave robbery
• Players must have shovel to start robbery
• Can be disabled from config

---

#⚙️ BASIC CONFIG

luaConfig.Language = "en"
Config.Webhook = ""

• Language → system language
• Webhook → logs robbery events

---

#🎮 KEY SYSTEM

luaConfig.Keybinds = {
    ["startrobbery"] = 0x760A9C6F,
    ["prayanim"] = 0x2CD5343E,
    ["exit"] = 0x156F7119,
}

• Defines player controls
• startrobbery → start digging
• prayanim → play animation
• exit → cancel action

---

#🧱 SHOVEL REQUIREMENT

luaConfig.ShovelItem = {item = "shovel", label = "Shovel"}

• Required item to rob graves
• Set to false to disable requirement

---

#⚙️ ROBBERY SETTINGS

luaConfig.RobberySetting = {
    RobberyDelay = 30,
    ActiveJobDistance = 300,
    ActiveJobs = {
        ["sheriff"] = 0,
    },
}

• RobberyDelay → cooldown per grave
• ActiveJobDistance → job proximity requirement
• ActiveJobs → required law presence

---

luaConfig.RobberySetting.TimeInterval = true
Config.RobberySetting.Start = 24
Config.RobberySetting.Finish = 5

• Restricts robbery to specific hours
• Example → only night robbery

---

luaConfig.RobberySetting.ProgressBarTime = 5

• Digging duration (seconds)

---

#🚨 LAW / ALERT SYSTEM

luaConfig.RobberySetting.NotifyChancePercentage = 100
Config.RobberySetting.NotifyRange = 200.0

• Chance to notify law enforcement
• NotifyRange → distance of alert

---

luaConfig.AlertBlips = {
    blipname = "Grave robbery !",
    blipsprite = -2018361632,
}

• Creates map alert for law
• Helps tracking robbery location

---

#🎁 REWARD SYSTEM

luaConfig.Rewards = {
    MaxRewardItemCount = 2,
    RewardChance = 100,
}

• MaxRewardItemCount → max item types
• RewardChance → chance to receive items

---

luaConfig.Rewards.Items = {
    [1] = {item = "water", count = 4, chance = 100},
    [5] = {item = "goldnugget", count = 1, chance = 10},
}

• Defines loot pool
• chance → drop probability

---

luaConfig.Rewards.MoneyChance = 50
Config.Rewards.Cash = math.random(10, 50)

• Chance to receive money
• Cash → reward amount

---

#🎨 VISUAL SYSTEM

luaConfig.DrawSetting = {
    DrawMarker = {distance = 2},
    DrawLight = {distance = 2},
    DrawTexture = {distance = 10},
}

• Controls visual indicators
• Marker → ground indicator
• Light → light effect
• Texture → UI marker

---

#🚫 BLACKLIST ZONE

luaConfig.BlacklistZone = {
    -- vector3(...)
}

• Prevents robbery in restricted areas
• Example → towns, churches

---

#⚰️ GRAVE SYSTEM

luaConfig.GraveProps = {
    "p_gravestone01x",
    "p_gravestone04x",
}

• Defines valid grave props
• Only these props can be robbed

---

#🔔 NOTIFY SYSTEM

luaNotify({
  text = "Grave Robbery Started",
  type = "success"
})

• Framework-based notification system
• Supports VORP / RSG / REDEMRP
• Fully customizable

---

#⚙️ SERVER CONFIG

luaSV_Config.Webhook = {
    url = "",
    logo = "",
    banner = "",
}

• Used for logging system
• Sends robbery logs to Discord

---

#⚠️ IMPORTANT NOTES

• Shovel item must exist in database
• ActiveJobs must match your job names
• TimeInterval must be configured properly
• Rewards must have valid items
• GraveProps must match map props

---

#🚨 COMMON MISTAKES

• Missing shovel item
• Wrong job names
• Invalid reward items
• Time restriction blocking robbery
• No graves detected

---

#🏁 SUMMARY

FX-GraveRobbery provides:

• Dynamic grave robbery system
• Law enforcement alert system
• Time-based gameplay
• Reward & loot system
• Full framework compatibility

---

© Fixitfy Development