SCS Grave Robbery System
A comprehensive grave robbery script for RedM servers using the RSG framework. This script provides a realistic grave robbery experience with lawman alerts, shovel durability, and dynamic location detection.
๐ฏ Features
Core Functionality
- Grave Digging System - Use shovels to dig up graves and search for valuables
- Durability System - Shovels degrade with use and display quality bars in inventory
- Lawman Alert System - Configurable alerts with chance-based triggering
- Dynamic Location Detection - Automatically detects cemetery areas and map regions
- Grave Ped Spawning - Chance-based spawning of hostile undead entities
- Cooldown System - Prevents spam with configurable cooldowns
Advanced Features
- Visual Alert System - ย target blips with pulsing effects
- GPS Route Integration - GPS routes leading lawmen to grave locations
- Smart Cleanup - Automatic blip and route cleanup when players arrive
- Resource Management - Proper cleanup on resource stop
- Event-Driven Architecture - Efficient job monitoring without polling
๐ฎ Usage
For Players
Digging Graves
- Equip a shovel (
grave_shovel) in your inventory - Approach any grave in the cemetery areas
- Use the shovel to start digging
- Complete the progress bar to dig up the grave
- Rummage through the dirt to find valuables
Shovel Durability
- Quality Bar - Shows shovel condition in inventory (green/yellow/red)
- Degradation - Shovels lose 25% quality per grave dig
- Replacement - Broken shovels (0% quality) cannot be used
- Visual Feedback - Durability bars update in real-time
For Lawmen
Alert System
- Automatic Alerts - Receive alerts when graves are robbed
- Visual Indicators - Red bounty target blips with pulsing effect
- GPS Routes - Purple GPS routes leading to grave locations
- Location Info - Dynamic location names in alert messages
- Smart Cleanup - Alerts disappear when you arrive or after timeout
๐ Grave Locations
The script includes 33 pre-configured grave locations in the Rhodes cemetery area
Key Systems
Durability System
- Universal Application - All items get quality tracking
- Visual Display - Color-coded durability bars (green/yellow/red)
- Real-time Updates - UI updates immediately when quality changes
- Shovel-Specific - Special handling for grave shovels
Lawman Alert System
- Chance-Based - Configurable percentage chance to trigger
- Cooldown Protection - Prevents alert spam
- Dynamic Locations - Automatically detects cemetery vs. general areas
- Visual Feedback - Red blips with pulsing effects
- GPS Integration - Purple routes for easy navigation
Event-Driven Architecture
- Job Monitoring - Real-time lawmen count updates
- Efficient Processing - No polling, only event-based updates
- Resource Cleanup - Proper cleanup on resource stop
๐ Debugging
Debug Mode
Enable debug mode in the config to see detailed logging:
Config.debug = true
Common Debug Messages
[DEBUG] Shovel used from slot: X, quality: Y%- Shovel usage tracking[DEBUG] Lawman alert roll: X/100 (chance: Y%) - ALERT/NO ALERT- Alert chance rolls[DEBUG] Alert blip created successfully with ID: X- Blip creation confirmation[DEBUG] Distance to alert: X units- Lawman proximity tracking
๐ Permissions
Job Requirements
- Grave Robbing - No special job required (anyone can rob graves)
- Lawman Alerts - Only players with
leojob type receive alerts (configurable)
Item Requirements
- Shovel - Requires
grave_shovelitem to dig graves - Durability - Shovel must have quality > 0% to be usable
๐จ Troubleshooting
Common Issues
Blips Not Showing
- Check if
Config.lawmanAlerts.enabled = true - Verify lawman job type matches
Config.lawmen.jobType - Ensure player is actually a lawman with correct job type
Shovel Not Working
- Check if shovel has quality > 0%
- Verify shovel is in the correct inventory slot
- Ensure shovel name matches
Config.models.requiredItem
Alerts Not Triggering
- Check
Config.lawmanAlerts.chance(0-100) - Verify cooldown isn't active
- Ensure lawmen are online
Performance Optimization
- Debug Mode - Disable in production (
Config.debug = false) - Blip Cleanup - Automatic cleanup prevents memory leaks
- Event-Driven - Efficient job monitoring without polling
๐ค Support
For support, bug reports, or feature requests, please join the discord
๐ License
PROPRIETARY SOFTWARE - ALL RIGHTS RESERVED
Copyright (c) 2025 ScytheCode. This software is proprietary and confidential.
โ ๏ธ IMPORTANT RESTRICTIONS
NO REDISTRIBUTION ALLOWED:
- โ NO SHARING - Do not share this script with others
- โ NO UPLOADING - Do not upload to GitHub, GitLab, forums, or Discord
- โ NO RESELLING - Do not sell or transfer to third parties
- โ NO MODIFICATION - Do not modify or create derivative works
- โ NO COMMERCIAL USE - Commercial use requires separate license
- โ SINGLE SERVER ONLY - Licensed for ONE server only
โ PERMITTED USES
- โ Personal Use - Use on your own RedM/FiveM server
- โ Configuration - Modify config files for your needs
- โ Backup - Create backup copies for your own use
โ๏ธ LEGAL NOTICE
Violation of these terms will result in immediate license termination and may result in legal action. This software is provided "AS IS" without warranty.
For licensing questions or commercial use inquiries, contact ScytheCode directly.
Happy Grave Robbing! ๐ฆดโฐ๏ธ