Join our Discord
# 🧺 Andre-Moneywash | Immersive Money Washing for QBCore
> A fully featured, server-authoritative money washing system with ownership, upgrades, utilities, a keyholder system, police raids, and a slick in-world tablet UI — all built for QBCore + Ox_Inventory.
---
## ✨ Features
-
🏠 **Claimable Wash Houses** — Players claim unclaimed locations and become the owner. Multiple configurable locations out of the box.
-
🫧 **Wash & Dry Cycle System** — Realistic two-stage process. Load washers, transfer to dryers via the tablet, then collect clean cash.
-
💊 **Multiple Dirty Money Types** — Configure any item as dirty money with its own washing fee, min/max amounts (e.g. dirty_money, robbery_cash, and more).
-
📱 **In-World Tablet UI** — A clean, immersive tablet opened at the in-world computer. Manage machines, utilities, upgrades, and keyholders — all from one place.
-
⚡ **Utility System** — Power and water bills deducted every 60 real minutes. If balance hits zero, machines go offline. Top up via the tablet.
-
🔑 **Keyholder System** — Owners can add/remove keyholders. Keyholders receive the key item automatically and can operate machines and top up utilities.
-
🛡️ **Upgrades System** — 6 upgrades, each with 3 levels:
- Alarm System (entry notifications)
- Security Cameras (reduces raid success chance)
- Machine Efficiency (reduces wash/dry times by up to 40%)
- Machine Capacity (increases cycle cap by up to 100%)
- Interior Lighting (cosmetic)
-
🚔 **Police Raid System** — Police can initiate raids with a minimum officer count required. Owner and keyholders receive an alarm notification. Configurable raid chance, max raids per day, and warning time.
-
🗄️ **Fully Server-Authoritative** — All timers stored as Unix timestamps in the database. No client-side cheating of cycles.
-
⚙️ **Highly Configurable** — Everything lives in a single `config.lua`: locations, wash/dry times, fees, police job, raid settings, utility intervals, and more.
---
## 📋 Requirements
| Dependency | Notes |
|---|---|
| `qb-core` | Core framework |
| `ox_inventory` | Inventory system |
| `ox_lib` | Notifications, callbacks, UI |
| `oxmysql` | Database |
⚠️ Shell interiors are **not included** — you will need your own shell/interior resource. Adjust `enterCoords` and `coords` in config to match your shell.
---
## 📦 Installation
1. Drop `andre-moneywash` into your `resources` folder
2. Add `ensure andre-moneywash` to your `server.cfg`
- Run
install.sql**or** just start the resource — tables are auto-created
4. Add the required items to your `ox_inventory` items file (see documentation)
5. Configure `shared/config.lua` to your liking
---
## 🗄️ Database Tables
| Table | Purpose |
|---|---|
| `moneywash_properties` | Ownership, upgrades, keyholders |
| `moneywash_utilities` | Power/water balances, usage counts |
| `moneywash_cycles` | Running and completed machine cycles |
| `moneywash_raids` | Raid log and outcomes |
---
## 💬 Support
Join our Discord for installation help and support: Click here > Discord
---
*Escrowed resource — source code is protected. Config file remains fully open for customisation.*