⚙️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.

---

1

Downloading and adding the resource

1. Download the resource from the official Cfx.re portal.

2. Extract the downloaded package.

3. Move the entire folder: 17mov_Phone into your server’s: resources directory.

4. 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.

2

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:

qb-core

1. Go to your qb-core folder.

2. Open the file: /shared/items.lua

3. Scroll to the end of the file.

4. 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' },

DEFAULT ESX

ox_inventory

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.

3

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:

1. Copy all files from the installation/images folder.

2. 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.

4

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.

5

First launch of the phone

After a successful installation:

1. Join your server.

2. Give your character the required items: phone and simcard

3. Use the simcard item to install it inside the phone.

4. 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.

6

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