Installation

Dependencies:

• Only compatible with ox_inventory, qb-inventory, ps-inventory and lj-inventory.

• If you are using qb-inventory, lj/ps-inventory please make sure to follow this guide before using the script: https://docs.av-scripts.com/laptop-pack/av-laptop/installation/inventory

• Frameworks: ESX and QBCore.

• ox_lib

• ps-ui (for minigames)

Add Runs

• In config/_config.lua you will find the config for every drug available in runs, it only includes meth but you can add as many drugs as you want by just copy/paste and editing the fields:

• Item name: This is the name of the item and is used as table index, make sure it matches the item name from your inventory.

• vehicle: This is a table with a list of vehicle that will be spawned as job vehicle.

• moneyAccount: The account name used to pay the player after delivering the illegal packages.

• cooldown: Once the run is started, the mission will be turned off for everyone on server and added to a cooldown, make sure to keep this number higher than timeLimit.

• timeLimit: The time limit before the mission gets canceled and all vehicles/gang members wiped.

• minQty: This is the minimum quantity of packages the NPC will accept to start the mission, keep it interesting so not everyone farms this mission 24/7.

• maxQty: The max amount of drug bags a player can use for the run.

• stashWeight: If your bag weight is 1kg or more do the maths and modify this value so you can deposit the maxQty items.

• strainField: The script will read the metadata from every deposited bag and it will retrieve the strain name from this metadata field, if the bag doesn't have any metadata it will use the player identifier as strain name.

• basePrice: The price per bag, this value will be multiplied * the amount of bags deposited and the total will be divided in X boxes.

• zones: The amount of zones (and illegal packages) that will be created, depending of the amount of zones the total amount (basePrice * bags) will be divided and deposited on each package.

• deliveryReputation: For every package sold the strain will increase its reputation.

• reputationMoney: Depending on the strain reputation u can get a multiplier for each delivered package.

• canInteract: This is a function that needs to return booleand (true/false), it verifies who can talk to the NPC, by default cops can't interact with it.

NPC Config

• The NPC config is located server side to prevent people from dumping the resource and get the spawn coords, to modify it go to server/framework/_config.lua.

• On every server restart the script will pick a random location from the list for each NPC.

• Add a new NPC for every drug run and set the exact same name for both index key names (the one that says "meth_batch" is the exact same from Config.Drugs).

Mission Locations and Weapons

• There's currently 50 locations that are used randomly on every run making it pretty unique and preventing players from doing metagaming.

• When a mission is generated it picks a random group from the Config.PedGroups table, you can add your more groups.

• A random weapon from the Config.Weapons table is given to every gang member, feel free to add more or remove the ones you don't want to be used.