💎ROBERRY GRAPSEED

💎 Jewelry Store Robbery Script

A comprehensive FiveM script for ESX Legacy that allows players to rob a jewelry store with multiple interactive features including painting theft, glass cutting, jewel stealing, security NPCs, alarms, and police dispatch system.

---

✨ Features

🎯 Core Robbery System

• Multi-phase heist: Complete robbery with multiple stages including door forcing, painting theft, glass cutting, and jewel stealing

• Time limit: Configurable time limit for the entire robbery (default: 15 minutes)

• Cooldown system: Prevents repeated robberies with configurable cooldown timer

• Police requirement: Requires minimum number of police officers online before robbery can start

• Time restrictions: Optional time-based restrictions (can be limited to specific hours or night-only)

🖼️ Painting Theft

• 4 Paintings: Steal 4 randomly selected paintings from 10 available options

• Interactive animations: Realistic cutting animations with synchronized scenes

• Progressive system: Must cut all 4 corners of each painting before stealing

• Random selection: Paintings are randomly shuffled each robbery for variety

• Rewards: Receive configurable items and amounts for each painting stolen

🔪 Glass Cutting & Display Case

• Glass cutting minigame: Interactive glass cutting sequence with overheating mechanics

• Multiple rewards: Random selection from 4 different display case items

• Realistic animations: Synchronized animations with props and tools

• Visual effects: Particle effects during cutting process

💍 Jewel Stealing

• 20 Display Cases: Multiple jewelry display cases throughout the store

• Smash animations: Realistic glass breaking animations

• Random rewards: Each case gives random items from configurable reward pool

• Individual timers: Each case has its own respawn timer to prevent spam

• Visual feedback: Prop swapping system shows broken cases

🚗 Security NPCs

• Dynamic security: Security vehicle arrives when robbery starts

• Multiple NPCs: Configurable number of security guards (default: 4)

• Armed guards: Security NPCs spawn with weapons and attack players

• Vehicle system: Security arrives in configurable vehicle model

• Combat AI: Aggressive NPCs that pursue and attack players

• Customizable: Configure spawn location, destination, weapons, and behavior

🚨 Alarm System

• Audio alarm: Klaxon alarm sound plays during robbery

• Zone-based: Alarm activates within configurable radius

• Police interaction: Police officers can disable alarm at specific location

• Synchronized: Alarm state syncs across all players

• Distance-based: Alarm stops when players leave the area

📡 Police Dispatch System

• Automatic alerts: Police officers receive notifications when robbery starts

• Blip system: Pulsing blip appears on map for all police officers

• Configurable chance: Percentage chance to alert police

• Multiple jobs: Supports multiple police job names (police, sheriff, etc.)

• LSPD integration: Compatible with LSPD dispatch systems

💨 Smoke Effects

• Visual effects: Smoke particles spawn during robbery

• Configurable duration: Set how long smoke effects last

• Area coverage: Smoke covers the jewelry store area

• Toggle option: Can be enabled/disabled in configuration

🎬 Tutorial System

• Cinematic mode: Optional tutorial with camera transitions

• Cinema bars: Black bars appear during tutorial sequences

• Camera transitions: Smooth camera movements showing robbery locations

• Information display: Shows painting names and locations

🌍 Multi-language Support

• Translation system: Full translation support with easy language switching

• Available languages: English, French, Spanish (easily expandable)

• Dynamic loading: Language files loaded based on configuration

• Complete coverage: All notifications and UI elements translated

💰 Reward System

• Multiple reward types: Different items for paintings, jewels, and display case

• Random amounts: Configurable random amount ranges for each item type

• Multiple items: Support for multiple reward items with different amounts

• Flexible configuration: Easy to add new reward items and amounts

---

⚙️ Configuration

📋 Basic Settings

Config.Language = "en" -- Language: "en", "fr", "es"
Config.Cooldown = 120 -- Cooldown in minutes
Config.MinimumPoliceToRob = 1 -- Minimum police required
Config.JobsPolice = {"police", "sheriff"} -- Police job names
Config.TimeToRob = 60*15 -- Robbery time limit in seconds
Config.RobOnlyAtNight = false -- Restrict to night only
Config.StartHour = 05 -- Start hour for time restrictions
Config.EndHour = 23 -- End hour for time restrictions

🚨 Alarm Settings

Config.Alarm = true -- Enable alarm system
Config.AlarmZone = 150 -- Alarm radius in meters
Config.StopAlarmePolice = vec3(x, y, z) -- Police alarm stop location

✨ Effects Settings

Config.UseSmokeEffect = true -- Enable smoke effects
Config.TimeEffect = 50 -- Smoke duration in seconds
Config.TutorialRobbery = false -- Enable tutorial mode

💎 Reward Configuration

-- Painting rewards
Config.PaintingAmount = 1 -- Items per painting
Config.ItemPaint = 'water' -- Painting item name

-- Jewel rewards (supports multiple items)
Config.Rewards = {
    {
        item = "diamond",
        name = "Diamond",
        amount = {8, 11} -- Random between 8-11
    },
    {
        item = "water",
        name = "Water",
        amount = {5, 10} -- Random between 5-10
    }
}

📡 Police Alert Settings

Config.AlertPolice = {
    Enable = true,
    ChanceToAlertPolice = 100, -- Percentage (0-100)
    BlipSprite = 161,
    BlipColor = 1,
    BlipScale = 2.0
}

🚗 Security NPC Settings

Config.NPCSecurity = {
    Enable = true,
    PedName = "s_m_m_highsec_01",
    VehicleName = "granger",
    NumPeds = 4,
    Location = vec3(x, y, z), -- Spawn location
    LocationHeading = 0.0,
    LocationToGo = vec3(x, y, z), -- Destination
    LocationToGoHeading = 95.29,
    LocationIntoJewel = vec3(x, y, z), -- Final position
    NpcWithWeapon = true,
    WeaponName = "weapon_pistol"
}

📍 Location Configuration

Locations = {
    ['vangrob_start'] = vec3(x, y, z), -- Robbery start location
    ['vangrob_diamond'] = vec3(x, y, z) -- Glass cutting location
}

---

📦 Installation

1. Place the resource in your resources folder

2. Add ensure jewelgrapseed to your server.cfg

3. Configure the script in config/config.lua

4. Ensure all required items exist in your database

5. Restart your server

---

📋 Requirements

• ESX Legacy: Compatible with ESX Legacy framework

• Items: Create items in your database:

  • Items specified in Config.ItemPaint

  • Items specified in Config.Rewards

• Dependencies:

  • es_extended (ESX Legacy)

  • Optional: LSPD dispatch system (if using)

---

🎮 Usage

🚀 Starting a Robbery

1. Approach the jewelry store location

2. Ensure minimum police officers are online

3. Check cooldown timer (if active)

4. Press the interaction key to start robbery

5. Follow the on-screen prompts

🖼️ Stealing Paintings

1. Approach a painting location

2. Have a weapon equipped

3. Press interaction key to start cutting

4. Follow prompts to cut all 4 corners

5. Receive reward after completion

💍 Stealing Jewels

1. Approach a jewelry display case

2. Have a weapon equipped

3. Press interaction key to smash case

4. Receive random reward item

5. Case respawns after timer expires

🔪 Glass Cutting

1. Complete painting theft phase

2. Approach the glass display case

3. Follow the cutting sequence

4. Avoid overheating

5. Receive random display case item

👮 Police Response

• Police officers automatically receive alerts

• Blip appears on map showing robbery location

• Police can respond to the location

• Alarm can be disabled by police at designated location

---

🎨 Customization

➕ Adding New Reward Items

Add entries to Config.Rewards:

{
    item = "your_item_name",
    name = "Display Name",
    amount = {min, max}
}

🚗 Changing Security Behavior

Modify Config.NPCSecurity:

• Change vehicle model

• Adjust number of NPCs

• Modify spawn/destination locations

• Change weapons

• Configure combat behavior

📍 Adjusting Locations

Modify coordinates in:

• Locations table for main positions

• Config.Jewel for display case positions

• Config['ArtHeist']['painting'] for painting positions

• Config.Camera for tutorial camera positions

🌍 Language Customization

1. Edit translation files in locales/translations/

2. Add new language by creating new file (e.g., de.lua)

3. Set Config.Language to your language code

---

🔧 Technical Details

🔄 Synchronization

• Robbery state syncs across all players

• Painting theft state synchronized

• Alarm state synchronized

• Object states synchronized

⚡ Performance

• Optimized with proper wait times

• Efficient entity management

• Clean resource cleanup on stop

🔒 Security

• Server-side validation

• Player verification

• Cooldown enforcement

• Police count verification

---

📝 Notes

• All items must exist in your database before use

• Ensure police jobs match your server configuration

• Test all locations before production use

• Adjust timers based on server performance

• Monitor server performance with security NPCs enabled