Apps

Every built-in app is an entry in AppStore in gksphone/config/config.json. Restart gksphone after editing. For apps you write, see Custom App.

Remove an app

Set show to false on its entry. What else you need depends on where it sits:

The app is…	Set
In the App Gallery (`show: true`)	`show: false`
On the home screen (`startapp: true`)	`show: false`, `startapp: false`
In the bottom dock (`startbottom: true`)	`show: false`, `startapp: false`, `startbottom: false`

{ "name": "Squawk", "url": "/squawk", "show": false, "startapp": false, "startbottom": false }

It disappears from the App Gallery and from every player who had installed it. Set show: true to bring it back.

For the dock apps — Phone, Messages, Mail, Camera — write false explicitly. Deleting the lines leaves the app in the dock.

Nothing is deleted server-side: tables, commands and settings stay put and cause no errors.

MDT and QBit aren't in AppStore — the server adds them at runtime. Switch them in config.lua with Config.MDTApp and Config.Qbit. (Config.StockMarket is different: it disables the price simulation, not the app.)

Restrict an app to a job

"allowjob":    { "police": "police", "sheriff": "sheriff" },
"blockedjobs": { "mechanic": "mechanic" }

allowjob — one entry is enough to hide the app from everyone except the jobs listed.
blockedjobs — hides it from the jobs listed only.

Values are matched against the player's job; keys are yours to name.

Rename an app

"name": "Vale",
"labelLangs": { "tr": "Vale", "de": "Parkservice", "fr": "Voiturier" }

Players see their phone language's entry, falling back to name.

Move an app to the Games tab

"category": "game"

Any other value, or none, files it under Apps. Missing categories are read as "app" so a pre-2.8 config.json still works.

Change an icon

Replace the file in gksphone/html/img/icons, or point icons at a new .png.

Field reference

Field	What it does
`name`	Internal name, and the fallback label.
`labelLangs`	Display name per language code.
`description`	Line under the app in the App Gallery. Searchable.
`icons`	Icon path.
`url`	Route the app opens. Don't change it.
`show`	`true` = listed in the App Gallery and removable by players. `false` = system app.
`startapp`	Place on the home screen at setup.
`startbottom`	Place in the bottom dock. Four maximum.
`category`	`"game"` files it under the Games tab.
`blockedjobs`	Jobs that cannot see it.
`allowjob`	Restrict to these jobs.