CanX Money Laundry System

A comprehensive Money Laundry / Black Money Cleaning system for FiveM servers.
This script allows players to exchange illegal money or valuable items (like gold or diamonds) with dealers and convert them into legal cash, while integrating smoothly with various frameworks (ESX, QBCore, or standalone).

---

⚡ Features

• Works with multiple frameworks: oldESX, newESX, oldQBCore, newQBCore, standalone
• Fully configurable Markers & Blips for money laundering locations
• Supports multiple items: dirty money, gold, diamonds, etc.
• Configurable dealer cars for pickups
• Customizable UI text and notifications
• Framework-independent server functions for money handling
• Easy integration with your roleplay server

---

📥 Installation

1. Download or clone this resource into your server's resources folder:

resources/canx_moneylaundry

2. Add the resource to your server.cfg:

ensure canx_moneylaundry

3. Configure config.lua according to your server setup (see Configuration Reference below).

4. Start your server. The money laundry system will be ready to use.

---

🕹️ Usage

1. Go to any Money Laundry Marker on the map.
2. Press INPUT_CONTEXT (usually E) to open the menu.
3. Select the type and amount of illegal money or items you want to clean.
4. The system will show dealer locations on the map.
5. Reach the dealer within 20 minutes and complete the deal.
6. You’ll receive your cleaned money minus the dealer’s profit percentage.

⚠️ Be careful! Make sure the police aren’t following you during the transaction.

---

⚙️ Configuration Reference

Framework Selection

Config.Framework = 'oldesx' 

Supported frameworks:

• oldesx – old ESX
• newesx – latest ESX
• oldqb – old QBCore
• newqb – latest QBCore
• standalone – no framework

---

Markers

NPCs where players can launder money:

Config.Marker = {
  {
    pedname = 'g_m_y_salvagoon_01',
    coord = vector3(-178.59, -1341.20, 30.30),
    heading = 94.0,
    Theme = 'random', -- purple / blue / orange / random
    label = 'Presse ~INPUT_CONTEXT~ To Open Menu',
    FacingTheBot = vector3(-179.56, -1341.29, 30.30),
    FBHeading = -90.0,
  },
  -- Add more markers as needed
}

---

Blips

Display Blips on the map for money laundry locations:

Config.Blips = {
  {
    coord = vector3(-178.59, -1341.20, 30.30),
    Sprite = 78,
    Text = 'Money Laundry',
    Colour = 1,
    Scale = 0.9,
  },
}

---

Dealer Car Blip

Blip for dealer car pickup locations:

Config.DealerCarBlip = {
  Sprite = 272,
  Text = 'Dealer',
  Colour = 2,
  RouteColour = 81,
  Scale = 1.1,
}

---

Items

Configurable items that players can launder:

Config.Items = {
  {
    name = 'dirtymoney',
    label = 'Black Money',
    typ = 'item', -- or 'money'
    dealersprofit = 20, -- % profit for dealer
    value = 1000, -- 1 unit = $1000
  },
  {
    name = 'gold',
    label = 'Gold',
    typ = 'item',
    dealersprofit = 20,
    value = 1000,
  },
  {
    name = 'diamond',
    label = 'Diamond',
    typ = 'item',
    dealersprofit = 20,
    value = 1000,
  },
}

💡 Note: For QBCore, it is recommended to use items for black money.

---

Dealer Cars

Vehicles used by dealers to deliver or pickup money:

Config.DealerCars = {
  {
    coord = vector3(-1293.57, -1288.06, 3.87),
    heading = 288.4,
    pickup = vector3(-1295.98, -1288.91, 3.23),
    car = 'kuruma2',
    label = 'Presse ~INPUT_CONTEXT~ To PickUp Money',
  },
}

---

UI & Props

Config.ServerName = 'Canx RolePlay'
Config.WelcomeText = 'With CanX money laundry system you can make deals with mafia or gangsters to launder your money or jewelry...'
Config.WhoWeAre = 'We’re here to connect you with mafia or gangsters...'
Config.MoneyProp = 'prop_cash_case_01'

---

Notifications

Config.Notification = {
  ['getmoney'] = 'I sent the location of the dealer. Be quick and go get your clean money.',
  ['erorr'] = 'You can’t clean this amount of money.',
  ['done'] = 'You got clean money now!',
  ['ColdDown'] = 'We are busy now',
}

---

Server Functions

• SendNotifctionCL(txt) – sends notification to client
• SendNotifction(playerId, txt) – sends notification to a specific player
• AddPlayerReward(source, count) – add cleaned money to player
• RemovePlayerDirtyMoney(source, count, isItem, item) – remove black money
• GetPlayerDirtyMoney(source, isItem, itemname) – get black money amount
• GetFrameworkObject() – returns framework object according to selected framework

---

🧪 Example Calculation

If a player laundered 10 units of dirtymoney at $1000 each, with a 20% dealer profit:

Total Value: 10 * 1000 = 10000$
Dealer Profit: 20% = 2000$
Player Reward: 8000$

---

📜 Credits

• Developed by CanX RolePlay
• Compatible with ESX & QBCore frameworks
• Customizable for any RP server

---

✅ Notes

• Add as many markers, blips, and dealer cars as needed.
• Adjust dealersprofit per item for fair gameplay.
• Ensure proper framework integration in config.lua for money handling.