Install Instructions

Automatic SQL Injection

You'll notice in your lation_laundering/install directory a file named lation_laundering.sql - you do not need to import this manually into your database. Upon starting your server (or just the resource) it will automatically create and setup the necessary database table for you if it doesn't exist already.

Step 1 - Install Dependencies

There are three dependencies (other resources) required to get Advanced Money Laundering installed properly & working: oxmysql, ox_lib and bob74_ipl. You may already have these installed, but please double check & ensure you have the latest version of each.

Important Notice

It is vitally important to ensure you start each resource in the correct order in your server.cfg. To begin, "oxmysql" should be one of, if not, the first resource started, followed by "ox_lib" - both of these should be started even before your framework (qb-core or es_extended). After those are started (and your framework core) the next should be bob74_ipl.

Step 2 - Add Items

Next up, simply navigate to lation_laundering/install/items directory (or look below this message) and find your respective inventory resource. Open the text file (or expand the drop-down menu) and copy and paste the items into your inventory resource's item directory.

Where do I add items in my inventory?

If you are unsure exactly where and how to add items into your inventory, just expand the drop down menu for your inventory and at the top will tell you where you need to copy the items too!

ox_inventory
-- Add items into ox_inventory/data/items.lua
['warehouse_key'] = {
	label = 'Warehouse Key',
	weight = 25,
},

['uncounted_money'] = {
	label = 'Uncounted Money',
},
qb-inventory
-- Add items into [qb]/qb-core/shared/items.lua
uncounted_money = { name = 'uncounted_money', label = 'Uncounted Money', weight = 1, type = 'item', image = 'uncounted_money.png', unique = false, useable = false, shouldClose = true, combinable = nil, description = nil },
warehouse_key = { name = 'warehouse_key', label = 'Warehouse Key', weight = 20, type = 'item', image = 'warehouse_key.png', unique = false, useable = false, shouldClose = true, combinable = nil, description = nil },
qs-inventory
-- Add items into [qb]/qb-core/shared/items.lua if on QBCore
-- Add items into qs-inventory/shared/items.lua if on ESX
['uncounted_money'] = {
    ['name'] = 'uncounted_money',
    ['label'] = 'Uncounted Money',
    ['weight'] = 1,
    ['type'] = 'item',
    ['image'] = 'uncounted_money.png',
    ['unique'] = false,
    ['useable'] = false,
    ['shouldClose'] = true,
    ['combinable'] = nil,
    ['description'] = nil
},
['warehouse_key'] = {
    ['name'] = 'warehouse_key',
    ['label'] = 'Warehouse Key',
    ['weight'] = 20,
    ['type'] = 'item',
    ['image'] = 'warehouse_key.png',
    ['unique'] = false,
    ['useable'] = false,
    ['shouldClose'] = true,
    ['combinable'] = nil,
    ['description'] = nil
},

Step 3 - Add Images

Very similar to step one, except this time we will be adding the images for each item we added above into our respective inventory directories for images. Navigate to lation_laundering/install/images to find all the images or download the ZIP file attached below then follow the instructions below for your inventory system.

ox_inventory

Drag and drop the images into ox_inventory/web/images folder.

qb-inventory

Drag and drop the images into [qb]/qb-inventory/html/images folder.

qs-inventory

Drag and drop the images into qs-inventory/html/images folder.

Step 4 - Setup Config

The second to last step to get everything working for your unique server is to open the config.lua file and assign a proper value to Config.Target, as seen below:

-- Target system - options are: 'ox_target', 'qb-target', 'qtarget', 'custom' & 'none'
-- 'custom' needs to be added to client/functions.lua
-- If 'none' then TextUI is used instead of targeting
Config.Target = 'none'

By default, the Config.Target value will be set to 'none' which means no target system will be used and instead TextUI interactions will be used. If you wish to use a targeting system instead, you must specify which target system you use from the available options listed.

Furthermore, there are countless other configurations that can be made in the config file to customize the script to your liking and fit your server's specific needs! Every option in the config is detailed with comments explaining the use & effects of each option - so please read diligently and carefully.

Step 5 - Ensure Resource

The final step is simple - drag and drop the lation_laundering resource into your main resources directory or even a sub-folder. Open your server.cfg and add "ensure lation_laundering" to the bottom. As mentioned above, resource start order is vitally important and you must ensure that lation_laundering is started after all dependencies (and your framework).

Lastly - save, restart your server & enjoy the most advanced money washing script on FiveM!

Upgrading to version 2+

If you're already an owner of the Advanced Money Laundering resource, you are in the right place. Expand the drop down menu below to learn how to properly upgrade to version 2.0.0+. If this is your first time installing Advanced Money Laundering, this section is not for you!

Important

Please read the instructions below BEFORE running version 2.0.0+ of the Money Laundering in your server! If you do, it's okay, but will require an extra step to undo a certain action. Please open a support ticket in our Discord if you are stuck!

Get started upgrading to version 2+

First and foremost, upgrading to version 2.0.0+ or later from version 1.0.0+ will NOT incur any loss of data. All your current data will remain, as we only have one simple step to complete.

Before launching your server for the first time with the new version, you must complete one simple step. Inside your lation_laundering/install folder you'll find an SQL file, named "rename_table.sql". That query can also be found here:

RENAME TABLE money_washing TO lation_laundering;

All you have to do is execute that query in your database! This will simply change the name of your current Money Laundering database table from "money_washing" to "lation_laundering" & that is it!

If you failed to do this step before launching your server for the first time with version 2, it's okay. You will just need to delete the "lation_laundering" table now found in your database, execute the query from rename_table.sql and now you are all set! This will again, simply change the name of your current table that stores all the current player data "money_washing" to the new naming scheme.

That's all! This step is done simply to maintain uniformity and ease-of-use when interacting with Lation Script's resources and the database.

Lastly, if you were using exports from the Money Laundering resource previously, you may have to update them as the exports have changed. Please visit Exports to learn more.

Quick note from Lation: I'd like to thank every one of you who are current owner's of this resource for being a customer! It's through all your suggestions, support & more that brought version 2 to life! I truly hope you are excited about this update and hope your players enjoy it even more!

Last updated