> 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_moneywash.md).

# ak47\_moneywash

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

**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:

* ak47\_lib: <https://github.com/MenanAk47/ak47_lib/releases/latest>
* [ak47\_target](https://github.com/MenanAk47/ak47_target)/ox\_target/qb-target/qtarget

***

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

***

### 🔗 Links & Support:

* **🛒 Buy Now (Tebex):** <https://menanak47.tebex.io/package/5572011>
* **💬 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.
