📔Installation

This comprehensive guide will walk you through the installation process of GKSPHONE V2. Follow each step carefully to ensure a successful installation.

Critical Prerequisites:

Use WinSCP for FTP file transfers. FileZilla may corrupt files during transfer.
If upgrading from v1 to v2, you must remove all gksphone_* tables from your database before proceeding.

Step 1: File Structure Setup

Create the proper directory structure for GKSPHONE V2:

Navigate to your server's resources folder
Create a [phone] folder inside the resources directory
Extract all files from the downloaded zip into this [phone] folder

Expected Directory Structure:

resources/
└── [phone]/
    └── gksphone/
        ├── config/
        ├── client/
        ├── server/
        └── ...

Step 2: Item Configuration

Configure phone items based on your inventory system:

Add these items to your qb-core/shared/items.lua file:

-- Phone Items
phone = {
    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'
},

-- Powerbank Item (Optional)
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'
},

Add the following to ox_inventory/data/items.lua. If you already have phone or iphone items, replace them with this data.

["phone"] = {
    label = "Phone",
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        export = "gksphone.UsePhoneItem",
        remove = function()
            TriggerEvent("gksphone:client:ItemRemoved", "phone")
        end,
        add = function()
            TriggerEvent("gksphone:client:ItemAdded", "phone")
        end
    }
},

["iphone"] = {
    label = "iPhone",
    weight = 190,
    stack = false,
    consume = 0,
    client = {
        export = "gksphone.UsePhoneItem",
        remove = function()
            TriggerEvent("gksphone:client:ItemRemoved", "iphone")
        end,
        add = function()
            TriggerEvent("gksphone:client:ItemAdded", "iphone")
        end
    }
},

-- Powerbank Item (Optional)
["powerbank"] = {
    label = "Powerbank",
    weight = 190,
    stack = false,
    consume = 0,
    server = {
        export = "gksphone.powerbank"
    }
},

Add the following to tgiann-iventory/items/items.lua. If you already have phone or iphone items, replace them with this data.

["phone"] = {
    name = "phone",
    type = "item", 
    label = "Phone",
    weight = 190,
    consume = 0,
    useable = true,
    unique = true,
    shouldClose = true, 
    client = {
        export = "gksphone.UsePhoneItem"
    }
},

["iphone"] = {
    name = "iphone",
    type = "item", 
    label = "iPhone",
    weight = 190,
    consume = 0,
    useable = true,
    unique = true,
    shouldClose = true, 
    client = {
        export = "gksphone.UsePhoneItem"
    }
},

-- Powerbank Item (Optional)
["powerbank"] = {
    name = "powerbank",
    label = "Powerbank",
    weight = 190,
    stack = false,
    consume = 1,
    client = {
        event = "gksphone:client:powerbank"
    }
},

Add iphone and phone to tgiann-inventory/configs/configMaxStack.lua for stack

config.maxStacks = {
    iphone = 1,
    phone = 1
}

Step 3: Database Setup

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

Automatic Setup Available: If you enable Config.DatabaseAutoSetup in gksphone/config/config.lua, the system will automatically create the required database tables. You can skip the manual SQL step.

Manual Database Setup

Important: Delete all existing gksphone_* tables from your database
Run the gksphone/gksphonev2.sql file in your database management tool

Step 4: Framework Configuration

Supported Frameworks: ESX, QB-Core, Qbox There is also a standalone file that you can customize for your own framework.

If you haven't changed your framework's source file name, you can leave this as "auto" for automatic detection.

Open gksphone/config/config.lua
Set Config.Framework to match your server framework:
- "esx" for ESX
- "qb" for QB-Core
- "qbx" for Qbox
- "auto" for automatic detection

Step 5: Server Configuration

Configure your server settings in gksphone/config/serverconfig.lua:

Media Service Setup

You can use any media service you prefer. We recommend GKS Media, Fivemerr, or Fivemanage.

If you are having trouble taking a photo, you may have filled out the fields below incorrectly.

serverconfig.lua

-- Available options: "fivemanage", "fivemerr", "gksmedia", "customMedia" 
Cfg.MediaService = ""

-- Authentication tokens for your chosen service
Cfg.AuthTokenImage = ""    -- Image upload token/API key
Cfg.AuthTokenAudio = ""    -- Audio upload token/API key
Cfg.AuthTokenVideo = ""    -- Video upload token/API key

Music and PlayTube App Configuration

You must enter your GKSPHONE purchase transaction ID in Cfg.TebexTransactionID in the serverconfig.lua file. If you don't know your transaction ID, check your Tebex purchase history.

Important: Keep your Tebex ID secure. Support cannot help recover lost transaction IDs.

Application Logging Configuration

Discord Webhooks: Enter Discord webhook URLs for applications you want to log in the serverconfig.lua file.

Fivemanage Logs: Ensure fmsdk is installed for Fivemanage logging support.

Step 6: Server Startup Configuration

Add GKSPHONE to your server.cfg file. Order is important - ensure dependencies start before the phone system:

# Core Framework (Required first)
ensure pma-voice
ensure oxmysql
ensure es_extended  # or qb-core

# Dependencies (Must start before phone)
ensure your_eyetarget
ensure your_banking
ensure your_inventory
ensure your_housing
ensure your_garages

# Other scripts can start before or after phone
ensure other_scripts

# Phone System (Start last)
ensure [phone]

Installation Complete! After completing all steps, restart your server. The GKSPHONE V2 system should now be active and ready for use.

🔄 Updating GKSPHONE V2

Follow the steps below to safely update your GKSPHONE resource:

📦Backup Your Current Installation

Before updating, create a backup of your current gksphone folder. We recommend compressing it into a .zip file for safe storage.

🗑️ Remove the Old Version

Delete the existing gksphone folder from your server's [phone] directory.

⬇️ Download the Latest Version

Download the latest version of GKSPHONE V2 from the portal cfx page.

⚙️ Reapply Your Configurations

If you've made custom changes to the following files:

gksphone/config/config.lua
gksphone/config/serverconfig.lua

Make sure to reapply your edits after updating.

💡 Tip: Keep a copy of your edited config files before deleting the old version, so you can easily compare and merge changes.

📱 Migrating from Other Phones

This guide explains how to migrate data from other popular phone systems to GKSPhone. Currently, migration is only supported for LB-Phone. Support for other phones will be added in future updates.

🔄 What Data is Transferred

When migrating from LB-Phone, the following data will be transferred to GKSPhone:

📞 Call History
👤 Contacts
🖼️ Photos
🗒️ Notes
📰 Advertisement Posts
🕶️ DarkChat
📸 Instagram
🐦 Twitter
💬 Messages

All these data types are automatically converted and imported into the GKSPhone database.

⚙️ Requirements

Before running the migration process:

Make sure your GKSPhone database is clean (no existing data).
Ensure no players are online on your server during the transfer.

🚀 Migration Process

Once you meet the above requirements:

Open your server console.
Run the following command:
```
migratephone
```
Wait until the process completes. Do not restart or stop the server during this process.

After completion, all eligible player data from LB-Phone will be migrated to GKSPhone automatically.

🧩 Future Support

Migration tools for other popular phone systems will be added in future updates. Stay tuned for announcements in our Discord or documentation.

PreviousFiveM Asset Escrow System NextDocumentation

Last updated 18 days ago