🗑️WASH MACHINE

📖 Introduction

Wash Machine is an advanced FiveM script that allows players to launder their black money into clean money. The script features an interactive washing machine system with a modern user interface and animations.

🎯 What is this script for?

This script allows players to:

Launder black money : Convert black money into clean money with variable fees
Progressive tax system : The more money you launder, the lower the fees
Random location system : Washing machines appear at random locations for increased realism
Modern user interface : A smooth and intuitive HTML/CSS/JS interface
Multi-framework support : Compatible with ESX and QBCore

✨ Features

🎮 Game System

Interactive NPCs : Talk to NPCs to get information about washing machines
GPS system : A random waypoint is added to your GPS after talking to the NPC
Washing machines : Interact with machines at random locations
Animation : Automatic animation during laundering (DPEmote support)
Real-time timer : Display of remaining time during the laundering process

💰 Economic System

Progressive fees :
- Fee 1 : 30% for amounts < $500,000
- Fee 2 : 25% for amounts between $500,000 and $1,500,000
- Fee 3 : 20% for amounts > $1,500,000
Laundering time : Configurable (default 10 seconds)
Time restriction : Option to limit laundering to certain hours (18:30 - 04:00)

🎨 User Interface

Modern design : HTML/CSS interface with animations
Sounds : Washing machine and error sounds
Notifications : Built-in notification system (ESX/QBCore) or custom
Multi-language : All texts are configurable in the config

🚀 Installation

Prerequisites

FiveM server with ESX OR QBCore
Resource compatible with your framework

Installation Steps

Download the script from your purchase source
Place the washmachine folder in your resources folder
Add to your server.cfg :
```
ensure washmachine
```
Configure the framework in shared/config.lua (see Configuration section)
Restart your server

⚙️ Configuration

Framework Selection

The script supports ESX and QBCore. To change the framework, modify this line in shared/config.lua :

WashClient.Framework = "esx" -- Change to "qb" for QBCore

ESX Configuration

For ESX, no additional configuration is required. The script automatically uses:

The black_money account for black money
addMoney() to add clean money

QBCore Configuration

For QBCore, the script supports two black money systems:

Markedbills (recommended) : Uses the markedbills item with a worth metadata
Black Money : Uses the black_money item with a quantity

The script automatically detects the system used. If you use a custom system, modify the Framework.GetBlackMoney() and Framework.RemoveBlackMoney() functions in shared/framework.lua.

📝 Detailed Configuration

Basic Configuration

-- Laundering time in seconds
WashClient.Time = 10

-- Enable time restriction
WashClient.VeriftimeActivate = false

-- NPC models
WashClient.Ped1 = "a_m_y_smartcaspat_01"
WashClient.Ped2 = "a_m_y_smartcaspat_01"

NPC Positions

Add as many positions as you want for information NPCs:

WashClient.Config.pedPosition = {
    vector4(19.743, 337.902, 110.485, 154.953), -- x, y, z, heading
    vector4(x, y, z, heading), -- Add more positions here
}

Tax Configuration

WashClient.Config.configuration = {
    money1 = 500000,   -- Threshold 1 : < $500,000 = taxe1
    money2 = 1500000,  -- Threshold 2 : between 500k and 1.5M = taxe2, > 1.5M = taxe3
    taxe1 = 30,        -- 30% fee
    taxe2 = 25,        -- 25% fee
    taxe3 = 20,        -- 20% fee
}

Washing Machine Positions

The positions where machines can appear (random):

WashClient.Config.randomWashing = {
    vector4(-290.052, 2543.105, 74.415, 8.655),
    vector4(1591.427, 6575.425, 12.642, 213.186),
    -- Add more positions here
}

Text Customization

Modify all texts in WashClient.Translate and WashClient.TranslateNotif:

WashClient.Translate = {
    WashTitle = "Dirty money",
    WashText = "Clean your dirty money",
    -- ... other texts
}

Custom Notifications

To use your own notification system:

WashClient.Notifications = {
    useCustom = true, -- Enable custom notifications
    customNotificationClient = function(message)
        -- Your client notification code here
        TriggerEvent('your-custom-notification', message)
    end,
    customNotificationServer = function(source, message)
        -- Your server notification code here
        TriggerClientEvent('your-custom-notification', source, message)
    end,
}

Animations

WashClient.DPEmote = {
    Active = true,                    -- Use DPEmote
    Animation = "e makeitrain",        -- DPEmote command
    -- If DPEmote disabled :
    Dictionnary = "anim@mp_player_intupperraining_cash",
    Anim = "idle_a"
}

🎮 Usage

For Players

Find an NPC : Go to one of the configured NPC positions
Talk to the NPC : Press E to talk to the NPC
Get the location : The NPC will give you a random GPS waypoint
Go to the machine : Go to the indicated location
Interact : Press E on the washing machine
Launder : Select the amount to launder in the interface
Wait : The process takes a few seconds (configurable)
Collect : Click "Get the money back" once finished

Restrictions

One active machine : Only one player can use a washing machine at a time
No black money : If you don't have black money, you cannot use the machine
Time restriction : If enabled, laundering is limited to configured hours (18:30 - 04:00)

🔧 Troubleshooting

The script doesn't work

Check the framework : Make sure WashClient.Framework is correctly configured
Check dependencies : The script must be loaded after your framework
Check the console : Look for errors in the F8 console

Money is not being removed (QBCore)

Check the black money system : Make sure you're using markedbills or black_money
Modify the wrapper : If you use a different system, modify Framework.GetBlackMoney() in shared/framework.lua

NPCs don't appear

Check positions : Make sure coordinates are correct
Check models : Ped models must be valid

Enjoy the game ! 🚀

PreviousAFK SYSTEM NextVEHICLE RENTAL

Last updated 1 month ago