God - Object Theft System | Open Source (BETA)

QB-Core | ESX | Qbox

Elevate your FiveM roleplay server with the God - Object Theft System a dynamic prop robbery and selling solution designed for immersive heist gameplay. Interact with designated props, steal valuable items, and convert them into cash rewards through an engaging drop-off mechanic.

⭐ Key Features

• Interactive Robbery: Engage with various props to trigger a realistic robbery sequence.
• Dynamic Rewards: Earn randomized cash rewards based on the item category.
• Configurable Requirements:
  • ATMs: Require a hackingdevice to initiate the robbery.
  • Other Props: Require a weapon_hammer for the robbery.
• Police Notification: Configurable chance to alert law enforcement during a robbery.
• Custom Animations: Enjoy immersive animations that enhance gameplay.
• Targeting & Interaction Support: Fully compatible with qb-target, ox_target, and interact for seamless interactions. Also supports NoPixel-style interaction for an enhanced gameplay experience.
• Drop-Off Mechanic: Deliver stolen items to a designated NPC for instant cash conversion.

ℹ️ Robbable Items & Categories

The system supports a variety of props organized into categories with preset names and prices:

• ATMs: ATM Machine 1, ATM Machine 2, ATM Machine 3
• Newspaper Mailboxes: Newspaper Mailbox 1, Newspaper Mailbox 2, Newspaper Mailbox 3, Newspaper Mailbox 4, Newspaper Mailbox 5, Newspaper Mailbox 6, Newspaper Mailbox 7
• Mailboxes: Mailbox 1, Mailbox 2, Mailbox 3, Mailbox 4
• Cash Registers: Cash Register
• Parking Meters: Parking Meter 1, Parking Meter 2
• Phone Booths: Phone Booth 1, Phone Booth 2, Phone Booth 3
• Electrical Boxes: Electrical Box 1, Electrical Box 2, Electrical Box 3, Electrical Box 4, Electrical Box 5
• Vending Machines: Soda, Coffee, and Water Vending Machines
• Miscellaneous: Gumball Machine, Ticket Machine, Generator

⚙️ How It Works

1. Initiate a Robbery:

   • Approach a designated prop (e.g., an ATM, Mailbox, or Vending Machine).
   • The system checks if you possess the required item (hackingdevice for ATMs, weapon_hammer for all others).
   • A word scramble minigame simulates a hacking challenge; on success, the prop is removed and the stolen item is attached to your character.
   • A random reward is calculated based on the item’s category, with a configurable chance of police notification.
     
     

2. Deliver the Stolen Item:

   • Take the stolen item to the drop-off NPC at the configured seller location.
   • Upon successful delivery, the item is removed from your inventory and you receive your cash reward.
   • A cooldown period (300 seconds) is enforced between robberies.

🚀 Customization & Integration

• Framework Compatibility: QBCore, ESX, Qbox
• Inventory Support: ox_inventory or qb-inventory
• Interaction Methods: ox_target or qb-target and interact system
  Detailed configuration options, including the item categories, required items, and seller NPC location, can be found in the system’s configuration file.
• Placeable Props: You can place item props anywhere, allowing full customization of robbery locations.
  
  

🔗 Additional Resources & Support

• Documentation: GitBook Guide
• How It Works: GitBook: How It Works
• Code Breakdown: GitBook: Code Breakdown
• Customization: GitBook: Customization
• YouTube: God Studios YouTube Channel
• Discord: Join our Discord

Bring a new level of immersion and excitement to your server with the God - Object Theft System. 
Where every robbery is a high-stakes adventure!