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

ak47_moneywash

The ultimate money laundering experience for FiveM servers. This script completely revamps black money processing with highly interactive laundry machines, dynamic props, realistic timers, and a secure access card system. Powered by ak47_lib, it features multi-framework support, custom tax rates, target interactions, and advanced timeout mechanics.


🔥 Key Features

Designed to improve roleplay immersion and economy balancing:

💳 Secure Access & Multi-Machine Limits

  • Laundry Cards: Players must possess and insert a specific "Laundry Card" item to interact with and unlock the machines.

  • Usage Limits: Prevent monopoly by limiting the maximum number of machines a single player can operate simultaneously.

⏱️ Dynamic Washing & Tax System

  • Time is Money: Wash times are dynamically calculated based on the exact amount of money deposited (e.g., 30 seconds per $10k).

  • Configurable Taxes: Control the economy by setting a custom tax percentage that the machine takes as a cut (e.g., player receives 80% of clean cash).

  • Metadata Support: Fully supports item metadata (like QB/QBX markedbills worth) alongside standard black money accounts.

🛑 Advanced Timeout & Cooldown Mechanics

  • Abandonment Penalties: If a player forgets to collect their washed money within a set time limit, the money is lost, and the machine goes into cooldown.

  • Machine Cooldowns: Machines require a configured resting period after a cycle finishes before they can be used again.

🎭 Immersive Visuals & Props

  • Dynamic Props: The physical washing machine props change based on their state (Idle, Spinning, Finished, Opened).

  • Audio & Visual Cues: Built-in audio cues alert nearby players when a wash is done. Owners get detailed 2D screen text overlays, while bystanders see localized 3D text.

🛠️ Technical Excellence

  • Multi-Framework & Target Support: Seamlessly works with ESX, QB, QBX and various target systems (ox_target, qb-target, qtarget).

  • Highly Secure: Built-in server-side exploit checks, including distance validation and trigger authentication, to prevent cheating or duping.


💻 Framework:

  • ESX, QB, QBX


⚙️ Dependencies:


⚙️ How To Install:

  1. Download ak47_moneywash from your cfx portal.

  2. Add the script in your resources folder.

  3. Add card item based on your framework instruction.

    • esx: import esx.sql in your server database.

    • qb: add items in qb-core/shared/items.lua .

    • qbx: add items in your inventory items.lua .

  4. Add item images into your inventory.

  5. Start the script in your server.cfg below framework files.

  6. Make sure you have all dependencies.

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