Suty Phone
Configuration
Configuration
| File | What's in it | Encrypted |
|---|---|---|
config.lua |
Everything the phone does, in 11 chapters | No |
config_nubeos.lua |
The phone's system versions (updates) | No |
server/logs_config.lua |
Discord webhooks (only the server reads it) | No |
Restart suty-phone after changing them.
⚠️
config.luais sent to every player's game. API keys, webhooks and tokens go inserver.cfgwithsetor inserver/logs_config.lua. The KLIPY key is the only exception.
How to read the file
enabled = falseturns a feature off.1000ms = 1 second. Distances are in metres.64 * 1024 * 1024= 64 MB.rate = { count = 10, window = 10000 }= 10 actions per player every 10 seconds (anti-spam).- Every key can be changed by each player in GTA Settings › Key Bindings › FiveM.
''= no key. - Search
[5]in the file to jump to chapter 5.
General
Config.Brand = { city = 'Los Santos', bank = 'Fleeca Bank', card = 'fleeca', logo = 'suty' }
Config.Language = 'es'
Config.LanguageChoice = true
Config.Debug = false
Config.Framework = 'auto'
Config.Inventory = 'auto'
Config.BankSystem = 'auto'
Config.BillingSystem = 'auto'
Config.GarageSystem = 'auto'
| Option | What it does |
|---|---|
Config.Brand.city |
City name in the apps. GTA's "Los Santos" in street and zone names becomes this too |
Config.Brand.bank |
Bank name on the card, the account and money messages |
Config.Language |
'es' (Spanish) or 'en' (English). Language of everything the server says (notifications, errors, command names and help, Discord logs), of the Klaro tablet and the Klaro NPC (her voice and subtitles), and the language a new phone starts in |
Config.LanguageChoice |
true = each player can still switch their own phone's language. false = every phone uses Config.Language and the language picker is hidden (English-only servers) |
Config.Debug |
Extra lines in F8 and the server console. Leave it false on a live server |
Config.Framework |
'auto', 'qbx', 'qb' or 'esx' |
Config.Inventory |
'auto' or the inventory's name (Compatibility) |
Config.BankSystem |
History and card: 'auto', 'renewed', 'okok', 'qb', 'ps', 'tgg', 'fd' or 'none'. Balances always use the framework's bank money |
Config.BillingSystem |
Invoices: 'auto', 'bossmenu', 'okok', 'esx' or 'none' |
Config.GarageSystem |
The Garajes app: 'auto' or a garage script (Compatibility) |
Config.GarageVehicleImage |
Picture of a car, %s = model. false = none |
Config.Compat |
One switch per other phone whose scripts reach this one (Compatibility) |
[1] Keys & commands
| Option | Default | |
|---|---|---|
Config.Command / Config.Key |
sphone / F1 |
Take out and put away |
Config.ScreenshotCommand / Config.ScreenshotKey |
sphonecaptura / none |
Screenshot of the phone, saved in Photos |
Config.FocusCommand / Config.FocusKey |
sphoneraton / LMENU |
Free the mouse to walk and drive with the phone out. Left ALT is also used by ox_target and the pma-voice radio |
The other keys (throw, peek, answer, hang up) are in their own chapters. All of them: Commands.
With Config.Language = 'en' the default command names switch to English by themselves (/sphonescreenshot, /sphonemouse...). A name you change in config.lua is used as written.
English texts
The English texts are in suty-phone/locale/en/lua.lua (not encrypted). Edit a line there to change a wording; keep the Spanish key on the left exactly as it is. A text missing there shows in Spanish.
[2] Phones & hardware
Phones
Config.Phones = {
{ item = 'phone_air_skyblue', model = 'suty_phone_air_skyblue', frame = '#809AB2' },
{ item = 'phone_duo_blancoperla', model = 'suty_duo_blancoperla', frame = '#E9E6DF', fold = true },
-- ...
}
item = inventory item, model = prop, frame = colour of the frame on screen, fold = true = the foldable Duo. A new phone also goes in Config.Hardware.items, Config.Magsafe.phoneModels and, if it has a box, Config.Unbox.
Hardware profiles
Each phone item is air or premium:
| Air | Premium | |
|---|---|---|
| Storage shown | 128 GB | 512 GB |
Photo space (quotaBytes) |
64 MB | 256 MB |
| Battery | 3200 mAh | 5400 mAh, drains at 55 % |
| Camera zoom | 3x | 10x |
| Photo size | 900 px | 1280 px |
| Privacy display | No | Yes |
| Water | wet in 4 s, dead in 15 s | wet in 20 s, dead in 60 s |
Numbers, battery and boxes
| Option | What it does |
|---|---|
Config.PhoneNumber.prefixes |
Area codes a new number starts with, e.g. { '555' }. The rest are 7 random digits |
Config.NewPhoneBattery |
Battery of a new phone (0-100) |
Config.Unbox.boxes |
Box item → phone item it gives. allowInVehicle, canCancel, cinematic |
Config.Prop, Config.Anim, Config.Duo |
Advanced: the phone in the hand and its animations. One of Config.Anim.variants is picked each time the phone comes out |
[3] Accounts & cloud
| Option | What it does |
|---|---|
Config.Account |
NubeID username length (min, max) and reserved names nobody can take |
Config.Lanube |
iNube passwords: shortest password, wrong tries before locking, lock times. reset = "forgot my password" codes by text message |
Config.LanubeBackup |
Backups of contacts, photos and settings (never money, items or messages): space per account, backups kept, automatic backups every autoHours |
Config.Recovery |
A new phone can take back a number its character lost; the old phone shows "No SIM". cooldownMinutes, price (0 = free) and sources = other phone scripts to read old numbers from ('auto', false or a list) |
[4] Battery, damage & repair
Battery
Config.Battery = {
enabled = true,
screen = 70.0, -- % per real hour with the phone out
standby = 60.0, -- in the pocket
idle = 0.5, -- stored phones, owner offline
call = 30.0, -- extra during a call
apps = { camera = 40.0, maps = 30.0 }, -- extra while these apps are open
}
Percent lost per real hour. Premium phones drain less. A dead phone serves no app data until it's charged.
| Option | What it does |
|---|---|
Config.Magsafe |
The MagSafe battery item: total charge, speed, whether it sticks to the phone while charging, and its position on each model |
Config.BatteryCommands |
Staff /bateria and /cargartel (Commands) |
Water
Config.Water: in water the phone gets wet (the screen glitches), then damaged (it won't turn on). It dries by itself after dryMinutes, faster in rice (rice.minutes). The repair kit fixes both. resist sets the seconds per class.
Throwing the phone
Config.Smash: E throws the phone. The screen breaks (taps on a crack may do nothing or land off), anyone can pick it up, and after destroyAfter throws it won't turn on. The repair kit fixes it.
Repair shop
Config.RepairShop = {
enabled = true,
npc = true, -- true = the Klaro NPC repairs, false = a worker you place with /puntoreparacion
minutes = 20, -- the phone is ready after this
price = 1300, -- 0 = free
}
[5] Klaro & Store
Plans
Every number needs a Klaro plan. Plan time only counts while the player is online with that phone. Without a plan there are no calls, messages or internet, but emergency calls (emergencyJobs) always work.
Config.Carrier = {
minutes = { short = 90, long = 210 }, -- played minutes of each plan length
starterPlan = 'basic', -- the first plan, free
emergencyJobs = { 'police', 'ambulance' },
autoRenew = false, -- pay the next plan from the bank by itself
plans = {
{ id = 'basic', name = 'Básico', short = 650, long = 1290, features = { 'calls', 'messages' }, network = '3G', bars = 2, lagMs = 3500, mediaMs = 5000, downloadX = 8 },
{ id = 'plus', name = 'Plus', short = 2400, long = 4750, popular = true, features = { 'calls', 'messages', 'data', 'cloud' }, network = '5G', bars = 3, lagMs = 1000, mediaMs = 2200, downloadX = 2.3 },
{ id = 'max', name = 'Ilimitado', short = 6200, long = 12300, features = { 'calls', 'messages', 'data', 'cloud', 'video', 'live' }, network = '5G+', bars = 4, lagMs = 0, mediaMs = 0, downloadX = 1 },
},
}
| Plan field | What it does |
|---|---|
short / long |
Price of each length |
features |
calls, messages, data (internet apps), cloud (iNube), video (video calls), live (Fotogram lives) |
network, bars |
What the status bar shows |
lagMs, mediaMs |
How slow apps and pictures load on that plan |
downloadX |
How much slower Store downloads are |
callSignal makes the voice cut and sound robotic with fewer bars.
Klaro stores
Config.Carrier.store: new lines are activated at a Klaro store.
| Option | What it does |
|---|---|
item |
The employee's tablet (klaro_tablet) |
jobs |
Jobs that can use it. false = anyone with the tablet |
card |
Bank card item the customer taps to pay. false = no card needed |
goldFee, replaceFee |
Extra for nice numbers, and for putting a lost number on a new phone |
migrateMinutes |
How long numbers from before the stores keep working |
npc |
The Klaro NPC that serves when no employee is on duty: coords, name, and citizenid = characters it can look like (needs illenium-appearance). Staff add more with /ponerklaro |
npc.model |
false = she looks like a citizenid character. A GTA V ped name (e.g. 'a_f_y_business_01', 's_f_y_shop_mid') = that ped instead, no character needed. Her voice is a woman's, so pick a female ped (a_f_*, s_f_*). A name that doesn't exist falls back to the default |
Store
Config.Store = { prices = { tappay = 50 } } -- appId = price, the rest are free
A paid app is bought once per phone number, from the bank.
Your own app names
Rename any app, built-in, from the Store or custom. The new name shows under the icon, in the Store, notifications, Settings, the app switcher, the title of Messages, Photos, Calendar and Clock, and the logs.
Config.AppNames = {
tuitel = 'Pío', -- same name in both languages
aigi = { es = 'Fotito', en = 'Snapit' }, -- or one per language
wasap = 'Chateo',
}
Up to 24 characters. The app ids are listed above the table in config.lua. Logos drawn inside an app (like the social apps' headers) keep their design.
Custom apps
Config.CustomApps = {
enabled = true,
max = 40,
apps = {
['my-app'] = { price = 500, jobs = { 'police' }, preinstalled = true, hidden = false },
},
}
What you set here wins over what the app's resource asks for. See Custom apps.
[6] Screen & notifications
Screen
Config.Display:
| Option | What it does |
|---|---|
enabled |
false = classic overlay only |
ownScreen |
Players can show the screen on the phone in their hand (they pick it in Settings) |
defaultMode |
'overlay', 'prop' or 'auto' until the player picks one |
resolution |
Size of the screen drawn on the prop. Bigger = sharper but heavier |
walkOnly |
The player can only walk while looking at the phone on the prop |
callAnims |
Phone at the ear during calls, one picked at random |
mirror |
Nearby players see your screen on your phone: distance, fps, and privateApps = apps others never see, e.g. { 'wallet', 'bellakeo' }. Passcodes are never shown |
Peek
Config.Peek: in first person, hold G while looking at another player's phone to zoom in on it.
Notifications
Config.Notifications = {
keep = 50, -- kept per phone (max 100)
maxAgeDays = 14, -- 0 = never delete
whileClosed = 'peek', -- phone put away: 'peek' (it rises a bit), 'toast' (ox_lib) or 'none'
sound = 'phone', -- 'phone', false, or a GTA sound { name = ..., set = ... }
}
Config.Prompts: yes / no questions other resources show on a player's phone (Exports).
[7] Calls
Config.Calls:
| Option | What it does |
|---|---|
ringSeconds |
Then it's a missed call |
peek, autoOpen |
An incoming call with the phone away rises from the bottom of the screen, or takes the phone out |
keys |
Answer (Enter) and hang up (Backspace) with the phone put away |
channelBase |
pma-voice call channels start here. Don't overlap other scripts' channels |
ringtoneRange |
Metres others hear the ringtone |
maxParticipants |
People in a group call (2-8) |
speaker |
People near the phone hear the call; with pickup the call hears them too |
cardPhoto |
Show the photo of the caller's own card when you saved none |
video |
Video calls: transport = 'webrtc' (smooth, direct) or 'relay' (through the server, low fps), size, fps, bitrate. ice = STUN servers. A TURN server in server.cfg hides IPs (Installation) |
[8] Everyday apps
| Section | What you can set |
|---|---|
Config.Contacts |
Contacts per phone, name length |
Config.Messages |
Characters per message, conversations per phone, minutes to unsend (deleteWindow), typing bubble timeout |
Config.Wasap |
Message length, group size, minutes to delete for everyone, space for photos and voice notes per chat |
Config.Gifs |
KLIPY key (key, or setr suty_phone_klipy_key), contentFilter, result country per language. No key = no GIF button |
Config.Weather |
'F' or 'C', sunrise and sunset hours, city name, and the temperature range of each GTA weather (GTA has no temperature) |
Config.Maps |
Saved places per phone, postal codes (postal, needs suty-postal), and places = public places. Admins edit them in game; after the first edit the database list is used |
Config.Friends |
How often and how precisely friends' positions update, per Klaro plan |
Config.Notes |
Notes and folders per phone, lengths, trash days |
Config.Classifieds |
Days a listing lasts, listings per phone, photos per listing, photo space |
Config.Calendar |
Events per phone, lengths, how far back and ahead |
Config.Bank |
Largest transfer, transfers per minute, invoice prefix, bank PIN tries and locks |
Config.Cripto |
Coin name and ticker, launch price, fee, and how the market moves (market) |
Config.Business |
Negocios: categories, businesses, pictures, how many phones ring when a business is called. A business shows OPEN while someone of its job is on duty |
[9] Photos, camera & sharing
Photos and videos
Config.Media = {
provider = 'auto', -- 'auto', 'fivemanage' or 'local'
quota = 64 * 1024 * 1024,
trashDays = 30,
storage = { resource = 'suty-phone', folder = 'media' },
}
- Fivemanage (recommended): put the key in
server.cfg(set suty_phone_fivemanage_key "..."). Withprovider = 'auto'and a key, photos go there. - Local: without a key, photos are saved in
suty-phone/media. Never delete that folder. To keep them in a resource of their own, setstorage.resourceto it and addadd_filesystem_permission suty-phone write <that resource>toserver.cfg. Behind an HTTPS proxy you can serve them directly withset suty_phone_media_url "https://..."; otherwise they're relayed through the game (delivery = 'auto').
Camera
Config.Camera: photo size and quality, shutter sound and range, flash (light, range, white flash on the screen), videos (maxSeconds, and nearbyVoices = record the voices of players around), the back camera on foot and in vehicles, the selfie camera and its framing controls, and mirror.poses = poses for mirror photos.
Sharing
| Section | What it does |
|---|---|
Config.Nearby |
Send photos and contacts to a player nearby. default = who can send to a new phone: 'everyone', 'contacts' or 'off' |
Config.NameDrop |
Two players bring their phones together to swap contacts |
[10] Social apps
Profiles belong to the iNube account, not to the phone.
| Section | What you can set |
|---|---|
Config.Tuitel |
Post length, photos per post, photo space, verified usernames, staffAce (can delete posts and verify) |
Config.Aigi |
Fotogram: caption and comment lengths, photos per post, photo space, stories (hours, archive), songs on stories (music), verified, staffAce |
Config.Lives |
Fotogram lives: guests, viewers with smooth video, longest live, pma-voice channels |
Config.Bellakeo |
Dating app: minAge (never below 18), photos, interests players can pick |
Config.VerifyCommands |
/verificar and /desverificar. licenses = only these players can use them |
Songs on Fotogram stories from YouTube need Python, yt-dlp and Node.js on the server, plus the Fivemanage key.
[11] Discord logs
Webhooks go in server/logs_config.lua (or set suty_phone_logs_default in server.cfg), never in config.lua.
Config.Logs:
| Option | What it does |
|---|---|
Enabled |
All logs on or off |
messageText, coords, identifiers, images, avatar |
What a log shows. avatar needs suty_phone_logs_bot_token |
mentions |
Mention the player's Discord; ping = true also notifies them |
hideFields, hideIds |
Fields never shown |
Categories |
false = never log that category |
Actions |
Turn single actions on or off. Private ones (Fotogram DMs, story replies) are off by default |
NubeOS updates
config_nubeos.lua lists the phone's system versions, newest first. When you upload a new version of suty-phone, add an entry at the top and restart: every phone that's behind shows "Update available" in Settings until its player installs it. A phone that skipped versions goes straight to the newest. Brand new phones come with the newest.
Config.NubeOS = {
downloadSeconds = 40, -- the phone stays usable while it downloads
installSeconds = 20, -- logo and progress bar, the phone counts as off
minBattery = 20, -- battery needed to install (or the phone charging)
versions = {
{
version = '1.9',
date = '2026-12-01',
size = '850 MB',
notes = { es = { 'Mejoras de rendimiento.' }, en = { 'Performance improvements.' } },
apps = { 'garajes' }, -- apps this version brings (optional)
-- features = { 'voicenotes' }, requires = { 'aigi' } (see the comments in the file)
},
-- older versions below
},
}
An app a version brings is locked on older phones: a Store app shows "Requires NubeOS x.y" with an Update button, a built-in app is hidden until the update. Don't rename an existing entry: add a new one on top.
