drug sales
Requirements, install steps, the drugs it sells out of the box and first start for drug sales, a FiveM script where players sell drugs to locals in zones, with prices that follow police on duty, purity and reputation.
drug sales (lation_selling) lets players sell drugs to locals inside the zones you set. Walking up to a local opens a menu with what that buyer will pay for each drug the player carries. The buyer pays, turns the player down and calls the police, or runs off with the drugs. Prices rise with the police on duty and the seller's reputation level, and items that carry a purity, like those from coke processing, meth crafting and lation weed, sell by it. Everything is set in config.lua, with players' text in strings.lua and logging in logs.lua.
Works on Qbox, QBCore and ESX.
Requirements
| Resource | Needed | What for |
|---|---|---|
oxmysql | Required | Each player's level, reputation and lifetime totals |
ox_lib | Required | Zones, callbacks, and the default menu, notifications and prompt |
qbx_core, qb-core or es_extended | Required | Players, jobs and money |
ox_inventory, qb-inventory, qs-inventory, ps-inventory, origen_inventory, codem-inventory, tgiann-inventory or jaksam_inventory | Required | Reading what a player carries, its purity, and taking and giving items |
ox_target, qb-target or qtarget | Optional | A Sell drugs option on locals, in place of the E prompt. lation interact answers to all three names. |
lation_ui | Optional | The menu, notifications and prompt in the lation ui look. Each is ox_lib until you pick it. |
cd_dispatch, ps-dispatch, qs-dispatch, core_dispatch, rcore_dispatch, aty_dispatch, op-dispatch, origen_police or emergencydispatch | Optional | Police alerts. Without one, no alert is sent. |
okokNotify, wasabi_notify or sd-notify | Optional | Other notification systems |
jg-textui or okokTextUI | Optional | Other prompt systems |
fmsdk or fm-logs | Optional | Logging to Fivemanage or Fivemerr |
oxmysql and ox_lib are loaded by fxmanifest.lua. The framework, the inventory and the logging resource are looked for once, when drug sales starts, so start them first.
Install
Follow the install guide, then:
Keep the folder name lation_selling. A renamed folder prints an error on start and again every 15 minutes.
Keep the install folder. drug sales runs install/lation_selling.sql on every start to create its table when it's missing, and prints an error every 10 seconds if the file is gone. There is no SQL to import by hand.
Check that the drugs it sells exist on your server. drug sales ships no items of its own: it buys the ones your other scripts make. The default list is in the drugs below. If you don't run those scripts, put your own items in each zone's drugs; see drugs.
Open config.lua and pick your systems under Config.Setup: target, notify, menu and dispatch. Dispatch starts as custom, which sends nothing until you pick yours or write your own call. See setup.
Ensure it after your framework, your inventory and anything you picked in the config. If you run lation ui, it goes first, above ox_lib, because the lation ox_lib fork looks for it when ox_lib starts.
ensure lation_ui # optional
ensure oxmysql
ensure ox_lib
ensure qbx_core # or qb-core / es_extended
ensure ox_target # optional: or lation_interact / qb-target / qtarget
ensure ox_inventory # your inventory
ensure ps-dispatch # optional: your dispatch
ensure lation_sellingRestart the server.
What it pays
Sales pay black_money by default. On ESX that's the black money account. On QBCore and Qbox it is given as an inventory item, so it has to exist in your items; on QBCore you can pay markedbills instead, as one bag that holds its worth. Each zone picks its own; see money.
The drugs
Every zone buys the same nine items out of the box, one per buyer, and every one of them is priced by its purity:
| Item | Label | Made by |
|---|---|---|
ls_og_kush_bag | OG Kush Weed | lation weed |
ls_banana_kush_bag | Banana Kush Weed | lation weed |
ls_blue_dream_bag | Blue Dream Weed | lation weed |
ls_purple_haze_bag | Purple Haze Weed | lation weed |
ls_orange_crush_bag | Orange Crush Weed | lation weed |
ls_cosmic_kush_bag | Cosmic Kush Weed | lation weed |
ls_meth | Crystal Meth | meth crafting |
ls_cocaine_bag | Cocaine | coke processing |
ls_crack_bag | Crack | coke processing |
A purity of 50 sells for $125 and 100 for $350, before the police and reputation bonuses. An item with no purity, such as one spawned by an admin, sells for $2, and F8 prints a warning that starts Your item "ls_meth" is listed in the Config.Metadata section. See prices.
lation weed's bags only carry a purity once Buds carry metadata and Bags carry metadata are on in /weedadmin > Config > Setup > Item metadata. Both are off by default. Turn them on, or remove the six bags from Config.Metadata so they sell at each zone's price range.
Database
One table, lation_selling, with a row per character:
| Column | Holds |
|---|---|
identifier | The ESX identifier, or the citizenid on Qbox and QBCore |
level | Reputation level, from 1 |
rep | Reputation earned since the last level up |
total_sales | Drugs sold, all time |
total_earned | Money made, all time |
Players' records are kept in memory while they play and written to the table when they leave, when the resource stops and when txAdmin shuts the server down.
First start
Six zones appear on the map as red circles with a Drug Selling Zone blip: Vinewood, South Los Santos, Del Perro Pier, Vespucci, Los Santos International Airport and Rockford Hills. See zones.
Walk into Vinewood carrying one of the drugs. Near a local, Sell Drugs with E - Open Menu appears (or a Sell drugs option on your target).
Press E to open the menu and pick a drug. See selling.
Changes to config.lua, strings.lua and logs.lua apply when the resource starts again.
Upgrading from an earlier version 2
The table and player records carry over. If your config.lua is older than 2.3.0, start from the new one: Config.LationCoke, Config.LationMeth and Config.LationWeed became one Config.Metadata table, and 2.4.0 removed legacySelling. Copy your zones across. If you edited server/functions.lua, compare it with the new one: price calculation moved into it as CreateSaleQuote in 2.4.0.
Troubleshooting
Drugs sell for $2
The item has no purity, and it's listed in Config.Metadata. Spawned items have none, and lation weed's bags have none until its item metadata is on (see the drugs). Either give the items a purity, or remove them from Config.Metadata so they sell at the zone's price range.
No Sell Drugs prompt appears
The prompt only shows inside a zone, to a player whose job isn't in blacklistJobs (police and ambulance by default), whose level reaches the zone's, and who carries a drug that zone buys at their level. The local has to be on foot, alive, in sight, a person rather than an animal, and not one another script spawned. A local who has already dealt, refused or been sent away won't show it again.
Police get no alerts
Config.Setup.dispatch is custom by default, which sends nothing. Set it to your dispatch, or write your call in PoliceDispatch in client/functions.lua. See dispatch.
The console says to rename the folder
The resource folder isn't named lation_selling. Rename it back and restart; the message repeats every 15 minutes until you do.
The console says install folder or .sql files missing
install/lation_selling.sql was deleted. Put the install folder back from the download and restart.
The console says Unable to fetch version information from API
The update check couldn't reach the version server. It changes nothing in game. Set Config.Setup.versionCheck to false to skip it.
Still stuck? Ask in our Discord: the people who write the scripts answer.
Last updated