⚙️Installation

This guide describes the full installation process and the initial setup of the 17mov_Phone resource. The script is designed to require as few manual steps as possible - most configuration tasks are handled automatically.

Downloading and adding the resource

Download the resource from the official Cfx.re portal.
Extract the downloaded package.
Move the entire folder: 17mov_Phone into your server’s: resources directory.
Add the following line to your server.cfg to start the resource: ensure 17mov_Phone. This guarantees the script will load automatically on every server restart.

Add Inventory Items

The next step is to add the required items: simcard, phone, and broken_phone.

Follow the guides below for your specific framework or inventory system:

Go to your qb-core folder.
Open the file: /shared/items.lua
Scroll to the end of the file.
Before the closing } add the following code:

    phone                        = { name = 'phone', label = 'Phone', weight = 700, type = 'item', image = 'phone.png', unique = true, useable = true, shouldClose = false, description = 'Phone' },
    simcard                      = { name = 'simcard', label = 'SIM Card', weight = 1, type = 'item', image = 'simcard.png', unique = true, useable = true, shouldClose = false,  description = 'Use to install in your phone' },
    broken_phone                 = { name = 'broken_phone', label = 'broken_phone', weight = 700, type = 'item', image = 'broken_phone.png', unique = true, useable = false, shouldClose = false, description = 'Broken Phone' },

Run this SQL query in your database:

    INSERT IGNORE INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
        ('phone', 'Phone', 1, 0, 1),
        ('simcard', 'Sim card', 1, 0, 1),
        ('broken_phone', 'Broken Phone', 1, 0, 1),
    ;

Go to your ox_inventory folder.
Open modules/items/client.lua

Find and remove this code: (Usually around 132 line)

Item('phone', function(data, slot)
	local success, result = pcall(function()
		return exports.npwd:isPhoneVisible()
	end)
	
	if success then
		exports.npwd:setPhoneVisible(not result)
	end
end)

Go back to main ox_inventory folder and open the file: /data/items.lua
Scroll to the end of the file.
Before the closing } add the following code:

    ['phone'] = {
        label = 'Phone',
        weight = 150,
        client = {
            image = 'phone.png',
        },
        server = {
            export = '17mov_Phone.phone'
        },
        consume = 0,
        stack = false
    },

    ['simcard'] = {
        label = 'Sim Card',
        weight = 150,
        client = {
            image = 'simcard.png',
        },
        server = {
            export = '17mov_Phone.simcard'
        },
        consume = 0,
        stack = false
    },

    ['broken_phone'] = {
        label = 'Broken Phone',
        weight = 150,
        client = {
            image = 'broken_phone.png',
        },
        consume = 0,
        stack = false
    },

IMPORTANT: Before adding items, ensure that the "phone" item didn't previously exist in your framework. In QB-Core, ox_inventory, and many other popular inventories, it is already defined. Before adding ours, first remove your current phone; otherwise, the script likely won't work at all.

Installing images into your inventory system

Inside the resource you will find: installation/images This folder contains example icons meant for integration with the inventory system used on your server (e.g., qb-inventory, ox_inventory, etc.).

Steps:

Copy all files from the installation/images folder.
Paste them into the assets folder of your inventory system, for example:

qb-inventory

ox_inventory

ps-inventory

esx_inventory

/html/images

/web/images

/html/images

/html/img/items

You can use your own custom icons if you want to keep your server’s unique visual style.

Database installation

The database structure is created automatically on the first start of the script. If the script detects that required tables do not exist, it will create them automatically.

First launch of the phone

After a successful installation:

Join your server.
Give your character the required items: phone and simcard
Use the simcard item to install it inside the phone.
You can open the phone in two ways:

From your inventory:

Use the phone item directly inside your inventory.

Using a keybind:

Default key: tilde. This key opens the last used phone assigned to the player.

Done! 🎉

After completing all steps, the script is fully operational and ready to use on your FiveM server.

Migrating data from your previous phone system

If you previously used a different phone script, it is possible to transfer selected data (such as contacts, messages, photos, SIM numbers, etc.) into the new 17mov_Phone system.

Migration options and supported formats are described in next page

Last updated 2 hours ago