Phone - Apps

Phone app configuration, restrictions, and default settings

The phone app system manages which apps are available to players based on job, permissions, reputation, and phone type.

Overview

App Restrictions

Job, permission, and reputation gates

Phone Types

Android, burner, and custom types

Settings

Wallpaper, ringtone, volume, zoom

Permissions

Per-app permission system

---

Available Apps

App ID	Description	Restriction
phone	Phone dialer and call log	None
contacts	Contact management	None
messages	SMS messaging	None
email	Email inbox	None
gallery	Photo gallery	None
settings	Phone settings	None
bank	Banking app	None
crypto	Cryptocurrency wallet	None
garage	Vehicle management	None
twitter	Social media (Bleeter)	None
adverts	Classified advertisements	None
store	App store	None
documents	ID and documents	None
irc	IRC chat channels	None
labor	Labor/side jobs	None
loans	Loan management	None
pingem	Player pinging	None
casino	Casino app	None
homemanage	Property management	None
blueline	Police MDT	Job: police
leoassist	LEO assistance tools	Job: police
govt	Government management	Job: government
comanager	Company management	Job-based
redline	Street racing	Permission-based
lsunderground	Underground market	Reputation-based
trapphone	Burner phone messaging	Phone type: burner
dyn8	Real estate	Job: realestate

---

App Restriction Types

Apps can be restricted by multiple criteria:

Job Restriction

App is only available to players with a specific job.

{
    job = 'police',
    workplace = 'lspd',        -- Optional: specific workplace
    gradeLevel = 2             -- Optional: minimum grade
}

State Restriction

App requires a specific character state.

{
    state = 'onDuty'           -- Character must be on duty
}

Job Permission

App requires a specific job permission flag.

{
    jobPermission = 'mdt_access'
}

Phone Permission

App requires a phone-level permission.

{
    phonePermission = 'create'  -- e.g., redline race creation
}

Reputation

App requires minimum reputation level.

{
    reputation = 'underground',
    level = 5
}

---

Default Settings

New characters are created with these default phone settings:

{
    wallpaper = "wallpaper",       -- Default wallpaper
    ringtone = "ringtone1.ogg",    -- Default ringtone
    texttone = "text1.ogg",        -- Default text tone
    colors = {
        accent = "#1a7cc1"         -- UI accent color
    },
    zoom = 75,                     -- UI zoom level
    volume = 100,                  -- Volume (0-100)
    notifications = true,          -- Global notification toggle
    appNotifications = {}          -- Per-app notification overrides
}

---

Default Permissions

{
    redline = {
        create = false             -- Cannot create races by default
    }
}

---

Phone Character Data

The phone stores data in the character’s data under these keys:

Key	Type	Description
Apps	table	{ installed = {}, home = {}, dock = {} }
PhoneSettings	table	Wallpaper, ringtone, volume, etc.
PhonePermissions	table	Per-app permissions
PhoneType	string	"android", "burner", etc.
Alias	table	Per-app aliases { [appName] = {...} }

---

Text Tones

ID	Label
text	Text Tone 1
text2	Text Tone 2

---

Next Steps

Phone - Exports

Phone API methods

Phone - Events

Phone events

Jobs API

Job system for restrictions