For the complete documentation index, see llms.txt. This page is also available as Markdown.

ak47_garbagejob

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:


⚙️ 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.



📝 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.

Last updated