Quasar Store Logo

Installation

Installation guide — please follow each step carefully and exactly as described to ensure the script works correctly on your server. Skipping or modifying steps may cause the system to not function properly, so follow it step by step.

Download Script

To download the assets needed for this script, you must access the official Cfx.re portal, where all assets purchased through Tebex are managed.

1

Access the Granted Assets Page

Open the Cfx.re granted assets page: https://portal.cfx.re/assets/granted-assets.

This page contains all assets linked to your Cfx.re purchases.

2

Log In with Your Cfx.re Account

Sign in using the same Cfx.re account you used when purchasing the asset.

If you use a different account, the assets will not appear.

3

Download the Housing Assets

In the granted assets list, locate and download:

Smartphone v3

These two packages are required to install the full housing system.

These files include the models, materials, and visual resources required for the proper operation of the housing system.





Download Dependencies

This script requires some mandatory dependencies to function correctly. Make sure to download and extract them inside your server’s main directory, keeping their original folder structure intact.

Releases · overextended/oxmysql

MySQL resource for FXServer. Contribute to overextended/oxmysql development by creating an account on GitHub.

GitHub
Releases · overextended/oxmysql


Releases · overextended/ox_lib

A FiveM resource and script library for Lua and JS. - overextended/ox_lib

GitHub
Releases · overextended/ox_lib


Releases · Xogy/xsound

Improved audio library for FiveM. Contribute to Xogy/xsound development by creating an account on GitHub.

GitHub
Releases · Xogy/xsound


Releases · AvarianKnight/pma-voice

An easy drag n' drop resource that gives you a wrapper to use FiveM's built-in mumble voice. - AvarianKnight/pma-voice

GitHub
Releases · AvarianKnight/pma-voice


Optional:

3D Sound – Advanced 3D Audio System for FiveM | Quasar Store

Advanced 3D audio system for FiveM with positional sound, car radio, CarPlay, boomboxes, and dynamic audio sources for immersive roleplay.

www.quasar-store.com
3D Sound – Advanced 3D Audio System for FiveM | Quasar Store






Remove Other Scripts

This script may cause conflicts or errors if you use other phone systems on your server. Common examples include qb-phone, esx_phone or other similar phone scripts.It’s strongly recommended to remove them completely before installation to prevent compatibility or functionality issues.







Server.cfg Placement

Always start your framework first (es_extended, qb-core or qbx_core). The inventory must be started directly below the framework, while the smartphone should be started below the inventory. Any scripts depending on them should be placed afterwards.

ensure es_extended ensure qs-inventory ensure [smartphone] ensure qs-shops ensure qs-dispatch

Never place the inventory or smartphone above your framework.





Database Setup

Avoid using tools like XAMPP or other non-optimized local servers, as they may cause connection errors.

This script includes an essential database required for its operation.You must import it before starting your server, preferably using HeidiSQL or any other manager compatible with MariaDB/MySQL.

ESX/QB





FiveManage API Setup

Want a discount on FiveManage? Use code QUASAR10 and save on your next purchase.

To use the camera, voice recorder and video recorder features, you must connect the smartphone with FiveManage:

Fivemanage | Manage games with Fivemanage: fast CDN and easy logging in just a few lines.

Manage games with Fivemanage: fast CDN and easy logging in just a few lines.

refer.fivemanage.com
Fivemanage | Manage games with Fivemanage: fast CDN and easy logging in just a few lines.


Create your account, generate an API token from the dashboard and place it inside:

qs-smartphone/server/webhook.lua

Replace the token value with your own API key:

_G.fivemanage = { -- If you want to use camera, voice recorder, and video recorder, you need to set a fivemanage token here. -- If you have custom server. You can edit the qs-smartphone/web/build/custom-upload.js file to use your own upload function. token = 'YOUR_API_TOKEN_HERE' }

After saving the changes, restart the smartphone resource or your server.





WebRTC / TURN Server Setup

Please choose only one of the following providers: Metered or Cloudflare. Do not use both at the same time. Select the option that best fits your server infrastructure and connectivity needs.

To improve compatibility and stability for video calls, live streaming and InstaPic Live, it is recommended to configure a TURN server inside the smartphone. All settings are configured inside:

qs-smartphone/config/main.lua



Metered TURN Setup

You can also use Metered as your TURN provider.

1

Create Your Metered Account

Create your account and generate TURN credentials from the Metered dashboard.

Press Show ICE Servers Array copy the generated ICE server configuration.

2

Configure Your Smartphone

Open qs-smartphone/config/main.lua and replace the Config.PhoneWebRTC section with your credentials:



Config.PhoneWebRTC = { iceServers = { { urls = 'stun:stun.relay.metered.ca:80' }, { urls = 'turn:global.relay.metered.ca:80', username = 'YOUR_USERNAME', credential = 'YOUR_PASSWORD' }, { urls = 'turn:global.relay.metered.ca:80?transport=tcp', username = 'YOUR_USERNAME', credential = 'YOUR_PASSWORD' }, { urls = 'turn:global.relay.metered.ca:443', username = 'YOUR_USERNAME', credential = 'YOUR_PASSWORD' }, { urls = 'turns:global.relay.metered.ca:443?transport=tcp', username = 'YOUR_USERNAME', credential = 'YOUR_PASSWORD' }, }, video = { captureFps = 30, minCaptureLongEdge = 720, maxBitrate = 2500000, minBitrate = 600000, maxFramerate = 30, }, }

Restart the smartphone resource or your server after applying the configuration.



Cloudflare TURN Setup

Quasar Smartphone supports Cloudflare TURN services for WebRTC connections.

1

Create A Cloudflare Account

Create an account on Cloudflare.

Navigate to Realtime → TURN Server and create a new TURN server and save your credentials.

2

Configure Your Smartphone

Open: qs-smartphone/config/main.lua.

Example configuration:

Config.PhoneWebRTC = { iceServers = { { urls = 'stun:stun.cloudflare.com:3478' }, { urls = 'turn:your-cloudflare-turn-url', username = 'YOUR_TOKEN_ID', credential = 'YOUR_API_TOKEN' }, }, video = { captureFps = 30, minCaptureLongEdge = 720, maxBitrate = 2500000, minBitrate = 600000, maxFramerate = 30, }, }

Restart the smartphone resource or your server after saving changes.