> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_garbagejob.md).

# ak47\_garbagejob

{% embed url="<https://youtu.be/8BahU2KVXWU>" %}

**The ultimate multiplayer garbage job experience for FiveM servers.** This script completely revamps sanitation roleplay with seamless multiplayer crew lobbies, dynamic dual dumpster and ambient trash scanning, server-wide synchronized prop removal, an interactive 3D visual unloading bay, and a sleek dark glassmorphic React 18 + Tailwind CSS management UI. Powered by `ak47_lib`, it offers deep career progression, scalable economy balance, anti-leech security, and multi-framework support.

***

### 🔥 Key Features

Designed to maximize roleplay engagement, teamwork, and server economy balancing:

#### 👥 Multiplayer Sanitation Crews & Group Lobby

* **Crews of up to 6:** Work solo or form a sanitation crew with up to 6 players using the in-game UI or slash commands (`/garbage_invite`, `/garbage_kick`, `/garbage_leave`).
* **Teamwork Scaling:** Earn an extra +10% bonus pay and +15% bonus XP / Collection Points per additional crew member.
* **Shared Route Sync:** Live real-time synchronisation of vehicle keys, route waypoints, collected bag counts, and shift earnings across all crew members.

#### 🚛 Dual Scanning Engine & World Prop Cleanup

* **Dual Trash Scanner:** Proximity radar scans both large commercial dumpsters and ambient ground trash props (garbage bags, card piles, debris, wooden crates).
* **Server-Wide Cleanup Sync:** Picked up world trash props are physically hidden and removed across the entire server until restart via `CreateModelHide`.
* **Smooth Animations:** Custom digging animations, prop bone attachments, carrying locomotion, and throw animations into the truck's rear hopper.
* **Dumpster Loot System:** Chance to discover valuable scrap, repair tools, or rare items while searching commercial dumpsters.

#### 📦 3D Visual Unloading Bay & Capacity Shifts

* **Capacity-Based Shifts:** Shifts scale dynamically based on crew size with a minimum target requirement and maximum truck capacity.
* **Overtime & Spotless Bonuses:** Reach the minimum target to clock out early, or keep cleaning until 100% capacity for a +15% overtime pay bonus. 100% clearing an area triggers an instant Spotless Area Cash & XP bonus!
* **3D Visual Unloading Bay:** Drive the loaded truck into the illuminated 3D bounding bay behind the depot, align the heading, and watch the automated hydraulic unloading sequence.
* **Leader Route Switching:** The crew leader can easily cycle to the next dirty zone on the fly by pressing `[G]`.

#### ⭐ Career Progression & Sanitation Rewards Shop

* **6 Rank Tiers:** Level up from *Trainee Scavenger* to *Sanitation Chief*, earning permanent paycheck multipliers (up to +45%).
* **Collection Points:** Earn dedicated Collection Points alongside XP for every bag thrown and every route cleared.
* **Sanitation Rewards Shop:** Spend points directly in the NUI catalog to redeem essential tools, crafting materials, and maintenance kits.
* **Anti-Leech Security:** Built-in validation ensures players must actively load bags or drive the vehicle to receive their shift payout.

#### 👔 Supervisor Dialogue & Modern Glassmorphic UI

* **Interactive NPC Dialogue:** Multi-option dialogue tree with the Sanitation Supervisor to dispatch shifts, change into work attire, access the shop, or collect paychecks.
* **React 18 + Tailwind UI:** Dark glassmorphic interface with 4 dedicated tabs: Operations, Crew Management, Rewards Shop, and Career Hierarchy.
* **Dynamic Inventory Integration:** Automatically fetches item icons from all popular FiveM inventories (`ox_inventory`, `qb-inventory`, `ps-inventory`, `qs-inventory`, etc.).

***

### 💻 Framework:

* ESX, QB, QBX

***

### ⚙️ Dependencies:

* ak47\_lib: <https://github.com/MenanAk47/ak47_lib/releases/latest>

***

### ⚙️ How To Install:

* Download ak47\_garbagejob from your cfx portal.
* Add the script into your resources folder.
* Start the script in your `server.cfg` below framework files.
* Make sure you have all dependencies.
* Restart the server.

***

### 🔗 Links & Support:

* **📖 Documentation:** <https://docs.menanak47.com/multi-framework/ak47_garbagejob>
* **🛒 Buy Now (Tebex):** <https://menanak47.tebex.io/package/5089721>
* **💬 Discord Support:** <https://discord.gg/menanak47>

***

### 📝 Note:

* We don't support custom framework. Make sure you are using official framework update.
* Renaming the script is not allowed. It may break the functionalities.
* Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading.
