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.lua is sent to every player's game. API keys, webhooks and tokens go in server.cfg with set or in server/logs_config.lua. The KLIPY key is the only exception.

How to read the file

  • enabled = false turns a feature off.
  • 1000 ms = 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 "..."). With provider = '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, set storage.resource to it and add add_filesystem_permission suty-phone write <that resource> to server.cfg. Behind an HTTPS proxy you can serve them directly with set 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.

Merry Christmas.

From Suty.