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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.menanak47.com/multi-framework/ak47_moneywash.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
