📔Installation

On this page you will find installation instructions for the GKSPHONE V2 version.

If you are transferring files using FTP transfer your files using winscp program. Filezilla transfers files as corrupted.

If you are switching from v1 to v2, you need to remove the gksphone_* tables in the database.

Step 1: File Location

• Create a [phone] folder inside the main source file and extract the files in the zip to this folder.

Step 2: Items

qb_inventory

Activate unique and useable in qb-core/shared/items.lua

hone = { name = 'phone', label = 'Phone', weight = 700, type = 'item', image = 'phone.png', unique = true, useable = true, shouldClose = true, combinable = nil, description = 'Neat phone ya got there' },
iphone = { name = 'iphone', label = 'iPhone', weight = 1000, type = 'item', image = 'iphone.png', unique = true, useable = true, shouldClose = true, combinable = nil, description = 'Very expensive phone' },


---- For Powerbank item
powerbank = {
	name = 'powerbank', 
	label = 'Powerbank', 
	weight = 200, 
	type = 'item', 
	image = 'powerbank.png', 
	unique = true, 
	useable = true, 
	shouldClose = true, 
	combinable = nil, 
	description = 'To charge the phone'
},

ox_inventory

Add the following to ox_inventory/data/items.lua. If you already have an item called "phone" and "iphone", replace the data.

["phone"] = {
	label = "Phone",
	weight = 190,
	stack = false,
	consume = 0,
	client = {
		export = "gksphone.UsePhoneItem",
		remove = function()
			TriggerEvent("gksphone:client:ItemRemoved", "phone")
		end
	}
},
["iphone"] = {
	label = "iPhone",
	weight = 190,
	stack = false,
	consume = 0,
	client = {
		export = "gksphone.UsePhoneItem",
		remove = function()
			TriggerEvent("gksphone:client:ItemRemoved", "iphone")
		end
	}
},
---- For Powerbank item
["powerbank"] = {
	label = "Powerbank",
	weight = 190,
	stack = false,
	consume = 1,
	client = {
                event = "gksphone:client:powerbank"
	}
},

esx_addoninventory

The default ESX has a phone item, an additional iPhone item must be added

INSERT INTO `items` (`name`, `label`) VALUES ('iphone', 'iphone');

Step 3: Insert SQL Query

Before running the SQL file, make sure to delete all tables starting with gksphone_ in your database.

• Run the gksphone/gksphonev2.sql file into your database.

Step 4: Framework

Correct "Config.Framework" to esx or qb depending on the framework you are using

Supports ESX, QB, Qbox There is a standalone file, you can customize it according to your own framework.

gksphone/config/config.lua

Step 5: Serverconfig.lua Configuration

• You can use any media service you want. The media upload systems we recommend are GKS Media, Fivemerr and Fivemanage.

serverconfig.lua

-- Options: "gksmedia", "fivemanage", "fivemerr", "discord", "customMedia"
Cfg.MediaService = "gksmedia"  

-- Fill in these fields according to the service you selected:
Cfg.AuthTokenImage = ""    -- Token/API/webhook for image sharing
Cfg.AuthTokenAudio = ""    -- Token/API/webhook for audio sharing
Cfg.AuthTokenVideo = ""    -- Token/API/webhook for video sharing

Music and Playtube App Configuration

You must write your gksphone purchase tbx-id in Cfg.TebexTransactionID in serverconfig.lua file. If you don't know tbx-id, check your tebex purchase history.

gksphone/config/serverconfig.lua

If you lose your Tebex ID, we will not be able to help you find it.

Log Configuration of Applications

For Discord webhook, you only need to enter the Discord webhooks of the applications you want to log in this section of the serverconfig.lua file. For Fivemanage it is enough to have fmsdk installed

gksphone/config/serverconfig.lua

Step 6: Add to server.cfg

Just start the phone file is enough.

-- First we will start the framework, never below
ensure pma-voice
ensure oxmysql
ensure es_extended or qb-core

-- These resources must be started before the phone
ensure your_eyetarget
ensure your_banking
ensure your_inventory
ensure your_housing
ensure your_garages

-- the other scripts don't matter - they can be started before or after no difference

-- The phone system
ensure [phone]