# Mako-RobContainer
# π¦ Premium Container Robbery System
A premium container robbery resource for FiveM.
Developed by **Bigchief**
**Mako Development**
**QBCore β’ Qbox β’ ESX Compatible**
---
Immersive container robberies with configurable loot, police integration, dispatch support, skill checks, anti-exploit protection, and full localization.
---
# Overview
**Mako-RobContainer** is a premium FiveM resource that allows players to rob shipping containers located around the map.
Players must locate a container, use a crowbar to break it open, complete a configurable skill check, enter the container, and search for valuable loot. Every aspect of the resource is fully configurable, making it suitable for both serious roleplay and economy-driven servers.
Built following the Mako Development standards, the resource focuses on clean code, high performance, security, and compatibility with multiple frameworks.
---
# Features
* Configurable container robbery locations
* Crowbar requirement
* Police requirement
* Configurable cooldown system
* Multiple loot tables
* Configurable reward chances
* Container interior support
* ox_target interactions
* ox_inventory support
* QBCore support
* Qbox support
* ESX support
* cd_dispatch support
* ps-dispatch support
* bl_ui minigame support
* ox_lib skill check fallback
* Discord webhook logging
* Anti-exploit protection
* Fully localized
* Easy configuration
* Optimized server performance
---
# Requirements
## Required Resources
* ox_lib
* ox_target
* ox_inventory
* oxmysql
## Supported Frameworks
Choose one of the following:
* QBCore
* Qbox
* ESX
## Optional Resources
* cd_dispatch
* ps-dispatch
* bl_ui
* Mako Levels
* Container Interior / Shell Resource
---
# Installation
## Step 1
Place the resource inside your server's resources folder.
```text
resources/
βββ [Mako]/
βββ Mako-RobContainer
```
---
## Step 2
Ensure the required dependencies start before the resource.
Example:
```cfg
ensure ox_lib
ensure ox_target
ensure ox_inventory
ensure oxmysql
ensure Mako-RobContainer
```
---
## Step 3
Open:
```text
shared/config.lua
```
Configure the resource to match your server.
You can configure:
* Framework
* Locale
* Police jobs
* Dispatch system
* Rewards
* Cooldowns
* Minigame
* Discord logging
* Required weapon
* Loot chances
* Container locations
---
# Framework Configuration
The framework can automatically detect your server.
```lua
Config.Framework = "auto"
```
Available options:
```lua
auto
qb
qbox
esx
```
---
# Language Support
Select your preferred language.
```lua
Config.Locale = "en"
```
Available languages:
```lua
en
nl
```
Adding new languages is as simple as creating another file inside:
```text
locales/
```
---
# Dispatch
Choose your preferred dispatch system.
```lua
Config.Dispatch = "cd"
```
Available options:
```lua
cd
ps
none
```
---
# Police Requirement
Configure how many police officers must be online before robberies can begin.
Example:
```lua
Config.MinPoliceRequired = 2
```
---
# Required Weapon
Players must possess the configured weapon before attempting to open a container.
Example:
```lua
Config.RequiredWeapon = "WEAPON_CROWBAR"
```
---
# Skill Check
Choose the preferred hacking or lockbreaking minigame.
```lua
Config.Minigame = "bl_ui"
```
Available options:
```lua
bl_ui
ox
none
```
---
# Rewards
Loot is completely configurable.
Example:
```lua
Config.Reward = {
{
item = "money",
chance = 100,
amount = math.random(100,200)
},
{
item = "bandage",
chance = 80,
amount = math.random(1,2)
},
{
item = "lockpick",
chance = 45,
amount = math.random(1,2)
},
{
item = "rolex",
chance = 25,
amount = math.random(1,2)
}
}
```
Create as many reward tables as you like.
---
# Discord Logging
Discord logging is built in and fully configurable.
Example:
```lua
Config.DiscordLogs = {
enabled = true,
webhook = "",
logRobberyStarted = true,
logReward = true,
logExploit = true
}
```
Logs include:
* Robbery started
* Rewards received
* Exploit attempts
* Invalid interactions
---
# Localization
Every visible message is translated through locale files.
```text
locales/
βββ en.lua
βββ nl.lua
```
No text is hardcoded, making it easy to create additional language packs.
---
# Security
Mako-RobContainer includes extensive server-side validation to prevent abuse.
Protected against:
* Triggering rewards without entering a container
* Invalid container IDs
* Distance exploits
* Event abuse
* Illegal reward spawning
* Runtime configuration abuse
Detected exploit attempts can automatically be logged to Discord.
---
# Database
This resource does not require a database.
No SQL installation is necessary.
If future versions introduce persistent player data, SQL files and automatic database installation will follow the Mako Development standard.
---
# Folder Structure
```text
Mako-RobContainer/
β
βββ client/
β βββ client.lua
β
βββ server/
β βββ server.lua
β
βββ shared/
β βββ config.lua
β
βββ locales/
β βββ en.lua
β βββ nl.lua
β
βββ fxmanifest.lua
βββ README.md
βββ CHANGELOG.md
```
---
# Customization
Almost every aspect of the resource can be customized, including:
* Container locations
* Loot tables
* Reward chances
* Cooldowns
* Police requirements
* Skill checks
* Dispatch systems
* Framework support
* Language files
* Discord logging
No source code modifications are required for normal configuration.
---
# Support
If you experience any issues or have suggestions for improvements, feel free to contact us through our Discord community.
**Discord**
https://discord.gg/CZF8k6m8WZ
**Website**
https://mako-development.nl
---
# Credits
**Developed by**
**Bigchief**
**Mako Development**
---
# License
This resource is licensed exclusively for use within your own FiveM community.
Redistribution, resale, sharing, leaking, or re-uploading this resource without permission from **Mako Development** is strictly prohibited.
Youtube: https://www.youtube.com/watch?v=TwD3WtsVLr0
Tiktok: https://www.tiktok.com/@bigchief_gaming_nl/video/7556357538040565025