Configuration
Which GKSPHONE config file to edit for what, and the guide for each area.
Which file do I edit?
| File | Runs on | What's in it |
|---|---|---|
config/config.lua | Shared | The main file — framework, inventory, items, keybinds, per-app settings. 27 sections; search rather than scroll. |
config/serverconfig.lua | Server | Media service and tokens, video calling, webhooks and logging. |
config/config.json | UI | App list (AppStore), storage quotas, upload caps, per-app toggles. |
config/locales/*.json | UI | Translations and currency format. 16 languages. |
config/charge/config.lua | Shared | Battery, powerbanks, charging stations. |
config/jobs/sh_jobs.lua | Shared | Job list, plus sh_tasks.lua for tasks. |
config/house/sh_house.lua | Shared | Housing adapter interface — see Custom housing. |
config/rentacar/*.lua | Shared + server | Rental fleet, pricing, damage charges. |
config/signal/config.lua | Shared | No-signal zones. |
config/camera/*.lua | Shared | Selfie poses and expressions. |
config/livestream.json | UI | Stream gifts, NPC viewers. |
config/functions.lua | Shared | Auto-detection. Don't edit. |
Restart gksphone after editing — a client reconnect is not enough. Your changes survive escrow but not an update, so keep a copy before upgrading.
Webhooks: public vs. admin
Two settings in serverconfig.lua are easily mixed up:
| Setting | Purpose | Channel |
|---|---|---|
Cfg.SquawkWebHook, Cfg.SnapgramWebHook, Cfg.TrendlyWebHook, Cfg.AdvertisingWebHook, Cfg.BlinkWebHook | Mirrors player posts to Discord | Public |
Cfg.DiscordWebHooks (with Cfg.LogService) | Admin audit log — bank, crypto, taxi, dispatch | Private |
Guides
Items and money
Custom inventory
Adapter for an unsupported inventory.
Unique phones
Bind a phone to its item so it can change hands with its data.
Currency
Currency symbol and number format, per language.
Apps and features
Apps
Remove, rename, reorder or job-restrict the built-in apps.
Services App
Add jobs to the service request list.
Restaurants
Open a restaurant, and how staff build its menu.
Mechanic
Roadside assistance — the job, the services, the price range.
Garage - Car key
Wire the Vale app to your garage and car key scripts.
Custom housing
Adapter so the House app works with an unsupported housing script.
Music & Tuneify
Music library and ringtone customization.
Charge
Battery drain, powerbanks, charging stations.
WebRTC
Video calling — ICE servers and Cloudflare TURN.
Controls and appearance
Commands and Keybinds
Every command, and how to rebind.
Custom Wallpapers
Add wallpapers to the default set.
Custom ringtones and notifications
Add your own sounds.
config.lua also covers areas with no guide page yet — billing, taxi, courier, Blink, SIM and operators, phone recovery, biometric unlock, screen damage, phone health, GKS Watch, clock, calendar, weather. Each is a labelled section with inline comments.