Turn a secret offshore laundry into a neon money wash for your QBCore server.
Players convert dirty money items into clean cash with a configurable fee, while server-side checks, cooldowns and optional Discord logs keep everything safe and transparent.ββ
π₯ Main Features
-
QBCore money-as-item support
Usesmarkedbills(or any item you set) as dirty money and converts it into clean cash with a configurable percentage fee.ββ -
Neon wash locations
Preconfigured row of washing machines in an offshore-style interior, with configurable locations, radius and neon green 3D interaction text.β -
Clean NUI wash panel
Press E at a machine to open a custom UI where players enter the amount to wash and see minimum amount + fee before confirming.ββ -
Server-side validation before emote
A QBCore callback checks if the player has enough dirty money and meets the minimum requirement before any animation or progressbar starts, sending an instant notification if not.β -
Progressbar & animation
QBCore progressbar with configurable duration and animation; player is rotated toward the machine and movement/combat are disabled while washing.β -
Cooldown, logging & Discord webhook
Optional per-player cooldown, console logging and an optional Discord webhook so you can track every wash (name, citizenid, dirty amount, clean payout).β
βοΈ Configuration
Everything is handled from a single open config.lua:
-
Config.DirtyItemβ dirty money item name (e.g.markedbills,dirtymoney).β -
Config.MinAmountβ minimum amount that can be washed.β -
Config.FeePercentβ fee percentage taken on each wash.β -
Config.WashLocationsβ vector3 positions of each washing machine.β -
Config.WashRadius,Config.KeyWash,Config.HelpTextβ interaction radius, key (E) and 3D text label.β -
Config.ProgressTime,Config.Anim,Config.Progressbar.labelβ wash duration, animation and progressbar text.β -
Config.Cooldownβ per-player cooldown between washes.β -
Config.EnableLogging,Config.LogToConsole,Config.Webhookβ enable/disable logs and optional Discord webhook URL.β -
Config.NotifyType+Config.Messagesβ notification system and all messages in one place for easy translation/branding.β
π Asset Escrow
This resource is delivered as a CFX Asset Escrow script.β
Open (editable) files:
-
config.lua - All UI files (
html/index.html,html/style.css,html/script.js)
Client and server logic are protected to prevent leaks, while configuration and UI remain fully accessible to server owners.β
π¦ Requirements
-
qb-core(QBCore framework)β -
qb-inventoryor compatible inventory supporting money-as-itemβ -
qb-progressbar(or a compatible progressbar replacement)β
π§ Installation
- Drop the
og-moneywashfolder into yourresourcesdirectory.β - Add to your
server.cfg:
ensure og-moneywash - Make sure the dirty money item from
Config.DirtyItem(defaultmarkedbills) exists inqb-core/shared/items.lua.β - Configure
config.lua(dirty item, fee, minimum amount, locations, cooldown, logging and Discord webhook).ββ
π οΈ Support
Support via Discord: https://discord.gg/aSc68qzPHj
When opening a ticket, please include:
- Your FiveM build and QBCore version
- Any server/client console errors
- Your
config.luachanges (or screenshots)