Common Errors

This section lists the most frequent issues users may encounter during installation or setup, along with their causes and quick solutions. Review each point carefully before opening a support ticket — most problems can be fixed easily by following these steps.

Phone Metadata Not Saving?

Always start the phone script directly below your inventory in server.cfg. Starting it before your inventory can prevent metadata from saving correctly.

If your phone isn’t saving metadata (like photos, contacts, or settings), it’s likely due to your inventory setup or load order.

The compatible inventories are:

If your inventory is not listed, you can edit config.lua and adjust: Config.UniquePhone and Config.Inventory.

You can also make extra edits in the folders client/custom and server/custom, which are open-source and safe to modify.

Video calls not working?

With RTC Server we can solve problems in video calls, depending on your country. Follow the document to learn how to manage it.

Configuration Overview

Create an account

Enter to https://www.metered.ca/stun-turn and create your account.

Go to TURN Server

Click here.

Credentials

Go down and find this.

Instructions

Click here.

iceServers

Copy the content and paste it into config.js in the specific config for this.

Result in our script

Mission completed, you are now ready.

Restart Phone Cache

If you update your asset or encounter issues with apps or downloads, you can reset the app cache using specific commands. This will not affect existing accounts but will restore default apps and clear cache-related issues.

Purpose:

  • Fix issues with app translations or modified settings not updating.

  • Resolve metadata problems without replacing the phone.

/deleteUsersPhone

Resets app cache and metadata for all players.

/deleteUserPhone [id]

Resets app cache and metadata for a specific player.

This process clears app caches and metadata while preserving accounts, making it a situational but useful tool for administrators.

Change default number

Customize how phone numbers appear on your server by adjusting the prefix and digit length in the config.lua file. Set your own format to match your region or server style, ensuring unique and consistent numbers for every player.

Config.Prefix

Specifies the prefix for phone numbers.

Config.Digits

Defines the number of digits following the prefix.

Config.NumberPrefix = '553' -- Prefix for the phone number
Config.NumberDigits = 6 -- Number of digits after the prefix

Adjust these settings to fit the desired phone number format for your server.

Streamer Mode?

The Smartphone PRO is optimized for streamers, offering features that enhance privacy and avoid issues like copyrighted content.

Music Blocking

Prevents copyrighted music playback via xsound or mx-surround.

Privacy Protection

Hides phone numbers in apps like Settings, Registration, and others to safeguard personal information during streams.

How to Enable

Streamer Mode can be activated directly from the Settings app on the phone. Streamer Mode settings are not saved persistently. You must enable it manually every time the server starts.

This mode ensures a safe and seamless experience for streamers while using Smartphone PRO.

PreviousInventory ItemsNextCommands & Exports