Introduction

ARS Phone (Phone 17) is a comprehensive mobile phone system for FiveM servers featuring an iPhone-inspired interface, 30+ integrated applications, and full framework support. Built with React.js and Tailwind CSS, it provides players with a modern phone experience that enhances roleplay immersion through realistic communication, social media, and utility apps.

Features

Core Features

Phone System - Modern iPhone-style UI with 350px x 720px fixed interface, zoom scaling, and custom wallpapers
Voice & Video Calls - Full calling system with call history, anonymous calling, and optional FaceTime-style video calls
Multiple Messaging Platforms - SMS (Message), WhatsApp-style (WhatsUp), encrypted messaging (DarkChat), and rich media support
Contacts Management - Complete contact book with social media integration, favorites, and NameDrop proximity sharing
Signal System - Cell tower simulation affecting network operations based on player location
DataFlow System - Metered mobile data with purchase options and low data warnings

Twaddle - Twitter-like social media platform with tweets, likes, retweets, bookmarks, and notifications
Pixline - Instagram-style photo sharing with likes, comments, and followers
Lovy - Dating app with swipe-based matching and in-app messaging
Photos - Photo gallery with upload capabilities from in-game camera
Music - Music streaming with xsound integration, playlists, and NCS library
News - News feed with article creation and live streaming support

Productivity & Utility Apps

Emails - Email client with admin broadcast support and institution-sourced messages
Notes - Note-taking with folders and pinning
Reminders - Task management with priorities and due dates
Calculator - Simple calculator
Maps - GPS and mapping with favorites
Weather - Weather information display
Ads - Classified advertisements system

Services & Commerce Apps

Bank - Banking app with transaction history, transfers, and invoice payments
Crypto - Cryptocurrency trading with real-time prices, orders, and price alerts
Services - Service directory for Government, Police, EMS, Real Estate, Taxi, and businesses
YellowPage - Business directory listings
Taxi - Taxi calling system with driver dispatch
Food - Food delivery ordering
Delivery - Delivery job management for drivers
Dark Market - Underground marketplace for illicit goods
Garages - Vehicle garage management with valet
Houses - Real estate and property management

Integrations

Frameworks - QB Core, ESX, QBX (selectable in config)
Inventories - ox_inventory, qb-inventory, ak47_inventory, qs-inventory
Voice Systems - pma-voice, mumble-voip, saltychat
Photo Upload - Discord webhook or FiveManage API
Audio - xsound for music and ringtones

Requirements

oxmysql - Database operations for MySQL/MariaDB
ox_lib - Utility library for FiveM
xsound - Audio playback for music and ringtones
Framework - QB Core, ESX, or QBX
screenshot-basic - Required for camera/photo uploads (optional if camera is unused)

Commands

Player Commands

Command	Description
`/phone`	Open the phone UI (or use the configured keybind, default `M`)
`/stopmusic`	Stop music playback from the Music app

Admin Commands

Command	Description
`/mailbroadcast [subject] [message]`	Send broadcast email to all players (requires `group.admin`)
`/darkmarket-restock`	Restock dark market items (requires `group.admin`)

Database Tables

ARS Phone creates 53 database tables to store phone data, including:

phone_users - Player phone accounts with settings and metadata
phone_contacts - Contact book entries
phone_calls_histories - Call history logs
phone_conversations / phone_whatsup_conversations - Messaging
phone_darkchat_channels - DarkChat encrypted channels
phone_emails - Email messages
phone_tweets / phone_twaddle_users - Twaddle social data
phone_pixline_posts / phone_pixline_users - Pixline photo data
phone_lovy_profiles / phone_lovy_matches - Lovy dating data
phone_crypto_holdings / phone_crypto_orders - Crypto trading
phone_darkmarket_orders - Dark market purchase history
phone_music_playlists / phone_music_songs - Music library
phone_photos - Photo gallery uploads
phone_maps_favorites - Saved GPS locations
phone_food_orders / phone_service_messages - Service orders

See database.sql for the complete schema.

Localization

ARS Phone supports 10 languages: English, Spanish, French, German, Danish, Norwegian, Russian, Arabic (with RTL support), Polish, and Swedish. Set the default language with Config.Locale in config/config.lua. Translation files are in the locales/ folder.

Note: This guide is written by a third party. If you find any incorrect or outdated information, please contact us on Discord so we can update it for you.