Overview
What ships in the package, what your server needs, and the full app list.
GKSPHONE V2 is a phone, tablet and smartwatch system for FiveM roleplay servers. One license covers the phone, the tablet, GKS Watch, and the Real App companion for iOS and Android.
Getting it running: Installation.
At a glance
| Resource version | 2.8.0 |
| Frameworks | ESX · QBCore · QBox · Standalone — auto-detected |
| Inventories | ox · qb · qs · tgiann · core — auto-detected, or bring your own |
| Dependency | oxmysql |
| Apps | 45 — 17 system apps, 28 installable from the App Gallery |
| Languages | 16 shipped |
| UI themes | iOS and Android, switchable on the same phone |
| Client cost | ~0.0 ms idle · ~0.07 ms open · ~5.5 MiB |
| Support | Discord |
Requirements
- oxmysql — the only dependency. Must start before
gksphone. - MySQL or MariaDB — tables are created on first start (
Config.DatabaseAutoSetup). - A phone item —
phoneopens the Android theme,iphoneopens iOS. Definitions per inventory are in Installation. SetConfig.ItemRequire = falseto run without items.
What ships in the package
Phone
45 apps, iOS and Android themes, calls, messaging, banking, jobs.
Tablet
gks-tablet, in the same download. MDT, dispatch, cloud sync.
Watch
Worn on the wrist. 5 cases, 4 faces, 9 apps, health rings, crash and fall SOS.
Real App
Companion app on the App Store and Google Play. Off by default — Config.RealApplication.
Compatibility
Config.Framework and Config.Inventory default to auto and detect at startup. The full support matrix is at the bottom of this page.
Apps
45 apps, split by the show flag in AppStore: system apps are always on the device, the rest are installed by players from the App Gallery. Two more are added at runtime — MDT for police, QBit on QBCore with qb-crypto.
To remove, rename or job-restrict any of them, see Apps.
System apps (17)
| App | What it does |
|---|---|
| Phone | Calls and contacts |
| Messages | Player-to-player messaging |
| In-city email | |
| SIM | Numbers and packages |
| Info | Personal information and documents |
| Camera | Photo and video |
| Gallery | Photo and media library |
| Voice Memos | Record and share voice memos |
| Bank | Balances, transfers, bills |
| Services | Service requests for jobs |
| Settings | Wallpaper, ringtone, language, PIN |
| App Gallery | Browse and install the other 28 |
| Calculator | Calculator |
| Weather | Los Santos weather and forecast |
| Clock | Alarms, stopwatch, timer |
| Calendar | Events, reminders, birthdays |
| Custom App | Reserved slot for apps you build. Hidden until you register one — Custom App |
App Gallery apps (28)
| App | What it does |
|---|---|
| Squawk | City-wide feed — posts, polls, hashtags, audio |
| SnapGram | Photo and video sharing with DMs |
| Trendly | Short-form video |
| Blink | Snaps that disappear |
| Flare | Meet new people |
| Giggles | Memes |
| LiveStream | Live broadcasts with chat and donations |
| Dark Chat | Anonymous public and private rooms |
| News | City news — text, images, video |
| Advertising | Product and service ads |
| Notes | Notes, with image support |
| Music | Server music library, solo or over speakers |
| Tuneify | Custom ringtones, notification sounds, wallpapers |
| GPS | Map and location markers |
| Vale | Valet — view and summon your vehicles |
| Rent A Car | Vehicle rental |
| Car Seller | List and sell vehicles |
| Mechanic | Call a mechanic to your location |
| Taxi | Order a taxi |
| Taxi Driver | The driver's side of Taxi |
| Courier | Deliver parcels for pay |
| Food | Order food to your location |
| House | Property keys, transfers, management |
| Job Center | Single and group job listings |
| Stock Market | Stocks and crypto assets |
| Snake | Game — eat, grow, don't bite yourself |
| Brickz | Game — clear every brick |
| Tilez | Game — slide and merge tiles |
Languages
16 locales ship in gksphone/config/locales/: Afrikaans, Arabic, Czech, German, English, Spanish, French, Indonesian, Dutch, Portuguese (PT), Romanian, Swedish, Thai, Turkish, Ukrainian, and Chinese (Traditional).
Set the server default with Config.DefaultLocale, and limit what players can pick with Config.Locales. Players change their own language in Settings.
Works with
Every resource below is supported out of the box — nothing to write. Framework, inventory and housing are auto-detected; voice and target are a config flag; the rest are picked up at runtime from whatever is started.
| Framework | Inventory | Housing | Voice | Garages | Vehicle keys | Target |
|---|---|---|---|---|---|---|
| ESX | ox_inventory | loaf_housing | pma-voice | esx_garage | qb-vehiclekeys | ox_target |
| QBCore | qb-inventory | bcs_housing | mumble-voip | qb-garages | qs-vehiclekeys | qb-target |
| QBox | qs-inventory | qs-housing | SaltyChat | cd_garage | cd_garage | |
| Standalone | core_inventory | vms_housing | Yaca | jg-advancedgarages | wasabi_carlock | |
| tgiann-inventory | ps-housing | loaf_garage | jaksam-vehicles-keys | |||
| your own | rtx_housing | qs-advancedgarages | mk_vehiclekeys | |||
| qb-houses | Renewed-Vehiclekeys | |||||
| esx_property |
Fuel — LegacyFuel, ps-fuel, Renewed-Fuel, cdn-fuel, lc_fuel, ox_fuel, qs-fuelstations
Society banking — qb-banking, Renewed-Banking, esx_addonaccount
Dispatch — ps-dispatch, cd_dispatch, or the generic dispatch:server:notify event
Running something not listed? Every one of these is an if GetResourceState(...) chain in an editable file, so you add a branch for yours:
| What | Where | |
|---|---|---|
| Inventory | client/inventory/, server/inventory/ | guide |
| Housing | client/apps/house/ | guide |
| Garages, vehicle keys | server/framework/, client/settings.lua | guide |
| Fuel, dispatch | client/settings.lua | |
| Society banking | server/framework/ |
These ship outside escrow so they are yours to edit — but an update overwrites them. Keep a copy before upgrading.
Where to go next
Installation
Files, items, database, framework, and server.cfg — start here.
Configuration
Apps, currency, keybinds, WebRTC, wallpapers, and the rest of config.lua.
Exports and events
Client and server exports for wiring the phone into your own scripts.
Common Issues
Cursor stuck, microphone access, SearchPhoneItems errors, vehicle names.