Skip to main content

​
Overview

RoadPhone Pro ships a small set of commands: verification badges for the social apps, SIM cards, and a handful of repair and diagnostic tools.

​
Verification Commands

Manage verification badges for social platform accounts.

​
Connect Verification

Grant or revoke verification badges for Connect accounts.
​
boolean
required
Action to perform on the verification badge
  • true - Grant verification badge
  • false - Revoke verification badge
​
string
required
The username of the Connect account to verify/unverify
Verification badges are permanent until manually revoked. Ensure you have the correct username before executing this command.

​
Examples

​
Wave Verification

Grant or revoke verification badges for TweetWave accounts.
​
boolean
required
Action to perform on the verification badge
  • true - Grant verification badge
  • false - Revoke verification badge
​
string
required
The username of the TweetWave account to verify/unverify
Only administrators can execute verification commands. Unauthorized attempts will be logged.

​
Examples

​
Music Verify

Grant or revoke music approval permissions for players. Players with this permission can approve or reject songs that other players have submitted through the music app.
​
string
required
The server ID of the player to grant or revoke music approval permissions for
Behavior:
  • If the player does not have music approval permissions → Grants the permission
  • If the player already has music approval permissions → Revokes the permission
Only administrators can execute this command. Unauthorized attempts will be logged.

​
Examples

​
Phone Controls

Control the RoadPhone interface and its features.

​
Toggle Phone

Quick command to open or close the phone interface.
Behavior:
  • If phone is closed → Opens the phone interface
  • If phone is open → Closes the phone interface
You can also use keyboard shortcuts:
  • PC: default: F1

​
SIM Cards

Only available with the SIM Card DLC (Config.SimCardDLC + Config.UseMetadata).

​
Give SIM Card

Hands a player a SIM card with a specific number.
​
number
required
Server ID of the player who receives the SIM card
​
string
required
The phone number for this SIM — digits only, and not already in use
​
number
Starting balance. Defaults to SimCard.Credits.starting_credits
Requires the ace permission command.givesim; the server console is always allowed.
server.cfg

​
Examples

For scripted use — job phones, shops, confiscation — use the SIM Card exports instead of this command.

​
Admin & Diagnostics

​
Phone Admin Panel

Opens the in-game admin panel: config editing, addon settings, locale files and live phone data.
Everyone can run the command; the panel itself checks the ace permission roadphone.phoneadmin and tells the player how to grant it when they lack it.
server.cfg
See the Admin Menu guide for what each tab does.

​
Self Test

Checks a live phone end to end — framework, inventory, metadata support, the player’s phone item and its metadata — and prints the result to the server console.
Run this first whenever phone data behaves oddly after an install or an inventory change. It reports exactly which layer is misconfigured instead of leaving you guessing.

​
Loop Self Test

Console-only check of the Loop app: tables, config and account state.
Server console only — the command ignores in-game callers.

​
Reload Phone Data

Reloads every piece of phone data for the player who runs it and pushes it back to their phone.
The first thing to try when a player reports empty contacts, missing messages or a stale balance after a framework hiccup.

​
Remove Stuck Phone Prop

Deletes props still attached to the player’s ped — the fix for a phone that stays in hand after a crash or a script error.
This removes every object attached to the player, not just phones. It is a repair tool, not something to bind to a key.

​
Force-Close the Phone

Closes the phone UI and releases NUI focus.
Use it when the cursor stays captured after a UI error.

​
Ringtone Range Test

Rings your own phone exactly like an incoming call, so you can hear how far a ringtone carries.
​
number
How long to ring. Clamped to a minimum of 5 seconds and the configured maximum.
​
keyword
Leaves the ring at your current position instead of following you — walk away to find where the range ends.
Requires roadphone.phoneadmin. Works even with Config.HearableRingtone disabled, so you can preview the effect before switching it on.

​
Fold / Unfold

Run /roadphone_fold while a Fold phone is open, click the hinge button, or assign a key in the game’s key-binding settings. Config.FoldKey is unbound by default. The command has no effect on regular Pro phones or while the UI is closed. RoadPhone Fold is included with RoadPhone Pro. See Fold setup and controls.

​
Command Guidelines

Best Practices

  • Always double-check usernames before verification
  • Use lowercase for usernames to avoid case-sensitivity issues
  • Commands are not case-sensitive
  • Ensure proper spacing between parameters

Permissions

  • Verification commands require admin privileges
  • Phone controls are available to all users
  • All command usage is logged for security

​
Troubleshooting

Ensure you’re using the correct syntax with the forward slash (/) at the beginning.
  • Check if you have admin permissions
  • Verify the username exists on the platform
  • Ensure there are no extra spaces in the command
  • Check if RoadPhone is properly initialized
  • Try reloading the interface
  • Ensure no other UI elements are blocking the phone

Installation

Step-by-step guide to install and configure RoadPhone

FAQ

Common questions and troubleshooting tips