Configuration

App Store and home page

Config.Store and Config.HomeDefaults: which apps exist, which are installed on a new character, switching an app off, keeping it for some jobs, and the home page and dock.

Both tables are in config.lua.

#Config.Store

Setting Default What it does
Enabled true The App Store controls which apps a character has. false: every app counts as installed and nothing is blocked
GuardPreinstalled false true: a preinstalled app the player uninstalled is blocked too
Apps 29 entries Every app the book knows, see below

#An entry of Config.Store.Apps

lua{ id = 'borsa', name = 'Borsa Bulteni', category = 'finans', icon = 'chart-line', preinstalled = false, removable = true,
  short = 'Hisse senedi alin ve satin.',
  long = 'Demiryolu, maden, petrol ve banka hisselerinin fiyatlarini izleyin. ...' },
Field What it is
id The app id. Do not change it
name Name shown to players
category Store category: iletisim (Communication), finans (Finance), gunluk (Daily), is (Work), harita (Map), haber (News), eglence (Entertainment), arac (Tools), sistem (System)
icon Icon name
preinstalled Already on a new character's book
removable The player may uninstall it
short, long The texts in the store list and on the app page
enabled Optional. false switches the app off for the whole server
hidden Optional. true does the same as enabled = false
jobs Optional. Keeps the app for some jobs

The texts are shown to players. In the shipped file they are Turkish written without Turkish letters; translations are in apps/store/locales/.

Apps from other resources (custom-app SDK) also appear in the store by their own name. List them here only to give them a description or to preinstall them.

#Switching an app off

Add enabled = false (or hidden = true) to its line:

lua{ id = 'borsa', enabled = false, name = 'Borsa Bulteni', category = 'finans', ... },

It disappears from the App Store, home pages and docks, and its actions are refused. Turned back on, players install it again; preinstalled apps come back by themselves. Settings and App Store cannot be switched off.

Most apps also have Enabled in their own apps/<id>/config.lua.

#Keeping an app for some jobs

lua{ id = 'mdt', jobs = { 'sheriff', 'marshal' }, ... },      -- these jobs, any grade
{ id = 'mdt', jobs = { sheriff = 0, doctor = 2 }, ... },   -- doctor from grade 2 up

Other players do not see the app in the App Store and its actions are refused. Without jobs everybody can use it.

#Preinstalled apps

Preinstalled (true) Not preinstalled (false)
faq, settings, store, calculator, bank, notes, news, stables, telegram, atlas, kartlarim, pusula, hekim, cagri, pano, saat, almanak contacts, company, billing, darkchat, music, album, takvim, kartmasasi, eskiz, borsa, mdt, katalog

faq, settings and store have removable = false.

#Config.HomeDefaults

A new character's home page and dock (the bar at the bottom).

Setting Default What it does
Home { 'faq', 'settings', 'calculator', 'bank', 'notes', 'store' } Apps on the home page
Dock { 'news', 'stables', 'telegram', 'atlas' } Apps in the dock
DockMax 4 Most apps in the dock. 0 to 8

Players rearrange both by dragging. The layout is saved per character in fx_pocketbook_layout.