How to install
Step 0 – First Steps
- Download Resources: Download your resource from FiveM’s Keymaster and
is_lib
from GitHub. - Unzip Files: Unzip the
is_selldrugs
andis_lib
folders and place them in your server’s resource folder. - Add to Server Config: Add the resource to your server start config (
server.cfg
). It is best to place these scripts above all scripts that may use them.plaintext
ensure is_lib
ensure qb-core
ensure is_selldrugs
Step 1 – Configure Resource
Read and configure all options in the is_selldrugs/config.lua
and is_lib/config.lua
files to suit your server’s needs.
Step 2 – Adding Items
Adding a Phone Item
To use the Trap Phone and receive wholesale orders, you first need to add the phone to your engine (QBCore/ESX). The item name for the Trap Phone should match the one specified in config.lua
(default trap_phone
). You can download the image for the Trap Phone from here.
Adding a Trap Phone to ESX Framework
- Access the Database: Log in to your server’s database management tool (like phpMyAdmin).
- Navigate to the
items
Table: Find theitems
table where all game items are defined. - Insert New Item: Add a new entry for the
trap_phone
. You can do this manually using the tool’s interface or run the following SQL command:sql
INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
('trap_phone', 'Trap Phone', 1, 0, 1);
name
: ‘trap_phone’ (This is the identifier used in your script)label
: ‘Trap Phone’ (The display name for the item)weight
: 1 (The weight of the item)rare
: 0 (Indicates the rarity, 0 for common)can_remove
: 1 (Whether the item can be removed from inventory)
Adding a Trap Phone to QB-Core Framework
- Edit the QB-Core Shared File: Navigate to the
qb-core
folder and open theshared/items.lua
file. - Add New Item: Add a line for the new item in the items list:
lua
['trap_phone'] = {['name'] = 'trap_phone', ['label'] = 'Trap Phone', ['weight'] = 500, ['type'] = 'item', ['image'] = 'trapPhone.png', ['unique'] = true, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Maybe you will find more serious clients to talk to here.'},
This line defines the item’s properties like name, label, weight, and image file.
- Add Image to QB-Inventory: Place the image for the item in the appropriate directory (usually in
qb-inventory/html/img
). Ensure the image file name matches the one specified in the shared file (e.g.,trapPhone.png
).
Adding a Drugs Item
In the config.lua
file, configure the list of items that players can sell. Provide data such as the item name, wholesale price, and retail price. Obtain the item image (.png), name it the same as the drug name, and move it to is_selldrugs/html/img/inventory
.
Step 3 – SQL Database
Integrate the script with your database by adding the following SQL commands or import the provided SQL file:
sql
CREATE TABLE `selldrugs_players` (
`player` varchar(255) DEFAULT NULL,
`respect` int(11) NOT NULL DEFAULT 0,
`sale_skill` int(11) NOT NULL DEFAULT 0,
`mole` varchar(1000) DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8mb3_general_ci;
CREATE TABLE `selldrugs_phone` (`player` varchar(255) NOT NULL,
`settings` varchar(255) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8mb3_general_ci;
Step 4 – Install Dependencies
To use the script, the following resources are required:
is_lib
and resources compatible with this library, such as framework, inventory, targetoxmysql
Using a Trigger Instead of a Command
In config.lua
, set the value in the cfg.commands.status
table to nil
to disable the command. Once done, use a Trigger to activate/deactivate retail sales.
Client-Side Trigger
lua
TriggerServerEvent("is_selldrugs:changeRetailStatus")
Server-Side Trigger
To add to the Radial Menu, some scripts (like qb-radialmenu
) require sending information about a table in the argument instead of the arguments or player ID we send. This can be solved by adding the following code to config.lua
:
lua
RegisterNetEvent("is_selldrugs:radialMenu", function()
TriggerServerEvent("is_selldrugs:changeRetailStatus")
end)
Follow these steps to properly install and configure the is_selldrugs
resource for your FiveM server.
Reviews
There are no reviews yet.