Home › Documentation › Configuration · origen_phone

Configuration · origen_phone

File	What it holds
`config/config.lua`	Gameplay settings: prices, limits, keys, app behaviour. Shared with clients
`config/bridge.lua`	Which external system to use for each category
`config/server.lua`	Server-only secrets (upload key). Never sent to clients
`config/apps.lua`	Home-screen app catalogue and API domain ownership
`config/widgets.lua`	Home-screen widget catalogue
`config/pescabichos*.lua`	Pescabichos game data: species, spawn zones, attacks, gyms, progression
`locales/*.json`	Translations

Most day-to-day settings (wallpapers, accents, battery, app access, prices, charging points, shops, valet) live in the admin panel (/telefonoadmin) and are stored in the database, so they change without a restart. The values in config/config.lua for those settings are only the defaults for a fresh installation.

config/config.lua is sent to every client. Never put secrets there: use config/server.lua or a convar.

config/bridge.lua

lua

BridgeConfig = {
    Framework = 'auto',
    Inventory = 'auto',
    Notify = 'auto',
    Banking = 'auto',
    Garage = 'auto',
    Housing = 'auto',
    Dispatch = 'auto',
    Business = 'auto',
    Uploader = 'auto',
    Weather = 'auto',
    Voice = 'auto',
    VehicleKeys = 'auto',
    Fuel = 'auto',
}

Value	Behaviour
`'auto'`	Picks the first started resource from the supported list
`'<resource>'`	Forces a specific resource by its exact folder name
`'custom'`	Uses your implementation in `custom/bridge/<category>/`
`'none'`	Disables the integration on purpose

See Dependencies for the supported resources of each category.

config/server.lua

lua

ServerConfig.Fivemanage = {
    ApiKey = GetConvar('ogphone_fivemanage_key', ''),
}

Option	Default	Description
`ServerConfig.Fivemanage.ApiKey`	convar `ogphone_fivemanage_key`	Fivemanage API key used by the default Uploader bridge. Prefer the convar over pasting the key in the file

General

Option	Default	Description
`Config.Debug`	convar `ogphone_debug`	Logs every RPC to the console. Keep off in production
`Config.EsxIdentifier`	`nil`	ESX only. xPlayer field holding the character identifier on multicharacter servers. Leave `nil` on single-character ESX
`Config.Carrier`	`'OGN MOVIL'`	Carrier name shown in the status bar
`Config.Currency`	`'$'`	Currency symbol used by invoices, fines and notifications

Item

Option	Default	Description
`Config.Item.Require`	`true`	The item is required to open the phone
`Config.Item.Unique`	`true`	Each phone is a separate item with its own metadata
`Config.Item.Name`	`'ognphone'`	Inventory item name
`Config.Item.MetaNumber`	`'ognPhoneNumber'`	Metadata key for the phone number
`Config.Item.MetaFormatted`	`'ognFormattedNumber'`	Metadata key for the formatted number
`Config.Item.MetaName`	`'ognPhoneName'`	Metadata key for the device name
`Config.Item.MetaId`	`'ognPhoneId'`	Metadata key for the phone record id. Tells which device showing a number is the real one. Written automatically to older items the first time they are opened
`Config.Item.Owner`	`'person'`	Who owns the data: `'person'` (the character) or `'item'` (the device). Controlled live from the admin panel; this is only the default

Phone numbers

Option	Default	Description
`Config.PhoneNumber.Format`	`'{2}-{4}'`	Display format. Numbers are stored as digits only
`Config.PhoneNumber.Length`	`4`	Digits after the prefix
`Config.PhoneNumber.Prefixes`	`{ '55', '60', '62', '68', '70' }`	Prefixes assigned to new numbers

Custom numbers

A VIP service: the player requests a number from Settings and an admin approves or denies it from the panel. Money is charged on approval, not on request.

Option	Default	Description
`Config.Numbers.Enabled`	`true`	Enables custom number requests
`Config.Numbers.Price`	`25000`	Price. `0` makes it free
`Config.Numbers.KeepPrefix`	`true`	The requested number must start with one of the configured prefixes
`Config.Numbers.Reserved`	see below	Numbers that cannot be requested

lua

Config.Numbers.Reserved = {
    '550000', '551111', '552222', '555555',
    '600000', '601111', '606060', '666666',
    '700000', '707070', '777777',
}

Opening

Option	Default	Description
`Config.Command`	`'ogphone'`	Command to open or close the phone. `false` disables it
`Config.Keybind`	`'F1'`	Default key. Players can rebind it in the FiveM key bindings
`Config.CloseOnDeath`	`true`	Closes the phone when the player dies
`Config.CloseWhenSwimming`	`true`	Closes the phone while swimming
`Config.AllowInVehicle`	`true`	Allows using the phone inside vehicles

Animation and prop

Option	Default	Description
`Config.Animation.Enabled`	`true`	Plays the phone animation
`Config.Animation.Prop`	`prop_amb_phone`	Prop model
`Config.Animation.PropBone`	`28422`	Bone the prop is attached to
`Config.Animation.PropOffset`	`vector3(0.0, 0.0, 0.0)`	Prop offset
`Config.Animation.PropRotation`	`vector3(0.0, 0.0, 0.0)`	Prop rotation

Notifications

What players see when something arrives with the phone closed. The phone peeks up from the bottom edge with its frame, wallpaper and clock. Content is hidden when the player disabled previews or is in streamer mode.

Option	Default	Description
`Config.Notifications.Outside`	`true`	Shows the peeking phone. `false` only plays a sound
`Config.Notifications.Side`	`'right'`	`'right'`, `'center'` or `'left'`
`Config.Notifications.Seconds`	`6`	Time on screen
`Config.Notifications.Max`	`3`	Notifications stacked at once
`Config.Notifications.AutoWake`	`true`	Turns the phone on invisibly when the player spawns carrying one, so calls and messages reach them before they open it
`Config.Notifications.WakeEvery`	`20`	Seconds between checks for a carried phone

Server notifications

origen_notify notifications can also appear on the phone. They are not stored in the notification center.

Option	Default	Description
`Config.ServerNotifications.Enabled`	`false`	Shows server notifications on the phone. The options below only apply when enabled
`Config.ServerNotifications.Replace`	`true`	`true` moves the notification to the phone; `false` shows it in both places
`Config.ServerNotifications.Sound`	`false`	Plays the phone alert tone
`Config.ServerNotifications.Types`	`nil`	Types to show. `nil` or empty shows all. Example: `{ error = true, primary = true }`
`Config.ServerNotifications.Cooldown`	`1500`	Identical text within this many milliseconds is not shown again

Logs

Sends phone activity to a Discord webhook. Message contents, photos and private data are never sent.

Option	Default	Description
`Config.Logs.Webhook`	`''`	Discord webhook URL. Empty disables logging
`Config.Logs.Name`	`'ORIGEN'`	Webhook sender name

lua

Config.Logs.What = {
    admin = true,        -- changes made from the admin panel
    numbers = true,      -- custom number requests and their outcome
    recovery = true,     -- recovered lines
    transfers = true,    -- money transfers
    blackmarket = true,  -- black market purchases
}

Storage

Option	Default	Description
`Config.Storage.Capacity`	`0`	Capacity in MB. `0` calculates it from `Config.Uploader.MaxPhotos` (recommended)
`Config.Storage.Slack`	`120`	Extra MB for non-photo content when capacity is auto-calculated

lua

Config.Storage.Weights = {
    photo   = 2400,
    video   = 18000,
    memo    = 900,
    note    = 4,
    message = 1,
}

Size counted per stored item, in kilobytes, when the real size is unknown.

Battery

Option	Default	Description
`Config.Battery.Enabled`	`false`	Enables battery drain
`Config.Battery.DrainSeconds`	`55`	Seconds per 1% with the phone open
`Config.Battery.DrainSecondsIdle`	`100`	Seconds per 1% with the phone closed
`Config.Battery.ChargePerTick`	`5`	Charge per tick
`Config.Battery.ChargeMinutes`	`20`	Minutes to fully charge at a charging point

Charging points are placed from the admin panel.

Line recovery and phone store

Option	Default	Description
`Config.Recovery.Enabled`	`true`	Enables line recovery at the carrier store
`Config.Recovery.Price`	`5000`	Recovery fee. `0` makes it free
`Config.Recovery.Range`	`3.0`	Distance from the counter, in meters
`Config.Shop.Enabled`	`true`	Enables the phone store
`Config.Shop.PhonePrice`	`1500`	Price of a new phone. `0` makes it free

Store locations are set from the admin panel under Map > Stores. Recovery uses the same counters.

lua

Config.Shop.Ped = {
    model = 's_m_m_highsec_01',
    heading = nil,
    scenario = 'WORLD_HUMAN_CLIPBOARD',
}
 
Config.Shop.Blip = {
    sprite = 606,
    color = 3,
    scale = 0.7,
}

Set Config.Shop.Ped or Config.Shop.Blip to false to disable the clerk or the blip.

Calls

Option	Default	Description
`Config.Calls.KeyAnswer`	`'RETURN'`	Default key to answer a ringing call
`Config.Calls.KeyHangup`	`'BACK'`	Default key to decline or hang up
`Config.Calls.RingTimeout`	`30`	Seconds it rings before counting as missed
`Config.Calls.MaxDuration`	`3600`	Safety cutoff, in seconds
`Config.Calls.AllowVideo`	`true`	Enables video calls
`Config.Calls.AllowRecording`	`true`	Enables call recording. The other party is recorded without being notified
`Config.Calls.AllowVoiceFilter`	`true`	Enables the voice changer. The filter runs on the listener's client
`Config.Calls.SpeakerRadius`	`3.0`	Meters within which nearby players join a speakerphone call
`Config.Calls.MaxParticipants`	`5`	Maximum people in a call, including the two who started it

lua

Config.Calls.Emergency = {
    ['911'] = 'police',
    ['112'] = 'police',
    ['police'] = 'police',
    ['061'] = 'ambulance',
    ['ambulance'] = 'ambulance',
    ['mechanic'] = 'mechanic',
}

Short numbers that route a call to a service job.

Video (frame fallback)

Used only when the WebRTC direct connection is not available.

Option	Default	Description
`Config.Calls.Video.Fps`	`12`	Frame rate ceiling
`Config.Calls.Video.Width`	`240`	Image width, in pixels
`Config.Calls.Video.Quality`	`0.5`	Starting JPEG quality (0 to 1)
`Config.Calls.Video.KBPorSegundo`	`96`	Maximum upload per side over the game connection, in KB/s
`Config.Calls.Video.MaxConcurrent`	`8`	Video calls sending images at the same time. Beyond this, calls have audio only

Raising KBPorSegundo is the only risky setting in this block. Frames travel over the same connection as the game; too much upload gets players kicked for timeout.

Voicemail

Option	Default	Description
`Config.Voicemail.Window`	`120`	Seconds after an unanswered call during which a message can be left
`Config.Voicemail.MaxSeconds`	`30`	Maximum recording length

WebRTC

Option	Default	Description
`Config.WebRTC.Enabled`	`true`	Sends video peer-to-peer. When off or when the connection fails, it falls back to server-relayed frames
`Config.WebRTC.Turn`	`'cloudflare'`	`'cloudflare'` requests TURN credentials from Cloudflare Realtime (needs the `ogphone_turn_token_id` and `ogphone_turn_api_token` convars). `false` uses STUN only
`Config.WebRTC.TurnTtl`	`86400`	Lifetime of the requested credentials, in seconds
`Config.WebRTC.Timeout`	`6`	Seconds to wait for the direct connection before falling back
`Config.WebRTC.MaxKbit`	`1000`	Maximum upload bitrate for direct video, in kbit/s

lua

Config.WebRTC.IceServers = {
    { urls = 'stun:stun.l.google.com:19302' },
    { urls = 'stun:stun1.l.google.com:19302' },
    -- { urls = 'turn:my.server:3478', username = 'user', credential = 'password' },
}

Messages

Option	Default	Description
`Config.Messages.MaxLength`	`1000`	Characters per message
`Config.Messages.SystemNumber`	`'900100'`	Sender number for server messages without a sender
`Config.Messages.EditWindow`	`900`	Seconds during which a message can be edited
`Config.Messages.PageSize`	`30`	Messages per page when scrolling
`Config.Messages.MaxGroupMembers`	`32`	Members per group chat
`Config.Messages.AllowDelete`	`true`	Allows deleting messages for everyone
`Config.Messages.DeleteWindow`	`3600`	Seconds during which a message can be deleted for everyone

Stickers

Packs bundled with the server, seeded into the database on startup by slug. URLs can be external or from the resource (nui://origen_phone/ui/...). Player packs are created from the gallery.

lua

Config.StickerPacks = {
    {
        slug = 'caras',
        title = 'Caras',
        cover = nil,
        stickers = {
            { emoji = '😀' }, { emoji = '😂' }, -- ...
        },
    },
    -- 'ciudad', 'reacciones'
}

Gallery and uploads

Option	Default	Description
`Config.Uploader.MaxPhotos`	`500`	Photos per phone
`Config.Uploader.TrashDays`	`30`	Days in the trash before permanent deletion

Contacts, alarms and mail

Option	Default	Description
`Config.Contacts.ShareRange`	`5.0`	Meters within which a number can be shared face to face
`Config.Alarms.Max`	`10`	Alarms per phone
`Config.Alarms.RingSeconds`	`30`	Seconds an alarm rings before stopping
`Config.Mail.Domain`	`'ogn.net'`	Domain of the server's email addresses
`Config.Mail.MaxLength`	`4000`	Characters per email
`Config.Mail.MaxRecipients`	`10`	Recipients per email
`Config.Mail.MaxAttachments`	`6`	Attachments per email (links, not files)

Option	Default	Description
`Config.OGN.Enabled`	`true`	Enables the social network
`Config.OGN.UsernamePattern`	`'^[%w%._]+$'`	Allowed username characters
`Config.OGN.UsernameMin`	`3`	Minimum username length
`Config.OGN.UsernameMax`	`20`	Maximum username length
`Config.OGN.MaxCaption`	`2200`	Characters per caption
`Config.OGN.MaxComment`	`500`	Characters per comment
`Config.OGN.MaxMediaPerPost`	`10`	Media per post
`Config.OGN.StoryHours`	`24`	Story lifetime
`Config.OGN.FeedPageSize`	`12`	Posts per feed page
`Config.OGN.CostToVerify`	`false`	Price for verification. `false` disables paid verification

Livestreams

Option	Default	Description
`Config.OGN.Live.Enabled`	`true`	Enables livestreams
`Config.OGN.Live.Fps`	`2`	Frames per second
`Config.OGN.Live.Width`	`320`	Longest side of the image, in pixels
`Config.OGN.Live.Quality`	`0.45`	JPEG quality (0 to 1)
`Config.OGN.Live.MaxConcurrent`	`3`	Concurrent streams across the server
`Config.OGN.Live.MaxViewers`	`20`	Viewers per stream. Lower this first if bandwidth is tight
`Config.OGN.Live.ChatLines`	`60`	Chat lines kept during the stream

OGN Fans

Pay-to-unlock photos. Non-buyers see the photo pixelated.

Option	Default	Description
`Config.Fans.Commission`	`0.20`	Server cut of each sale and tip (0 to 1)
`Config.Fans.MinPrice`	`0`	Minimum photo price. `0` is free
`Config.Fans.MaxPrice`	`50000`	Maximum photo price
`Config.Fans.MinTip`	`10`	Minimum tip
`Config.Fans.MaxTip`	`100000`	Maximum tip
`Config.Fans.PageSize`	`20`	Posts per page
`Config.Fans.ImageHosts`	`{ 'fivemanage.com', 'fmfile.com' }`	Hosts the server may download from to pixelate photos
`Config.Fans.MaxImageBytes`	`8388608`	Maximum size of the downloaded photo, in bytes

DarkChat

The "encryption" is roleplay only: messages are stored in the database and staff can read them.

Option	Default	Description
`Config.DarkChat.Enabled`	`true`	Enables DarkChat
`Config.DarkChat.CodeLength`	`6`	Room code length
`Config.DarkChat.MaxMembers`	`24`	Members per room
`Config.DarkChat.MaxRooms`	`8`	Rooms a player can have open
`Config.DarkChat.InviteRadius`	`3.0`	Meters within which someone can be added without the code
`Config.DarkChat.BurnOptions`	`{ 0, 5, 30, 60, 1440 }`	Self-destruct options, in minutes. `0` never deletes

Black market

Listings under an alias, delivered through dead drops.

Option	Default	Description
`Config.BlackMarket.Enabled`	`true`	Enables the black market
`Config.BlackMarket.Days`	`3`	Days a listing lasts
`Config.BlackMarket.MaxPerPhone`	`6`	Active listings per player
`Config.BlackMarket.MaxItems`	`6`	Distinct items per listing
`Config.BlackMarket.MaxStock`	`50`	Units per listing
`Config.BlackMarket.Commission`	`0.1`	Commission per sale
`Config.BlackMarket.DropRadius`	`5.0`	Pickup distance for a dead drop, in meters
`Config.BlackMarket.DropMinutes`	`60`	Minutes a package stays at the drop before the deal is cancelled and refunded

lua

Config.BlackMarket.Blocked = {
    'vehiclekey', 'vehicle_key', 'carkeys', 'keys',
    'vehicledocs', 'vehicle_papers', 'documentacion_vehiculo',
}

Ads and marketplace

Option	Default	Description
`Config.Ads.Days`	`7`	Days an ad lasts
`Config.Ads.MaxPerPhone`	`5`	Active ads per phone
`Config.Ads.Cost`	`0`	Cost to publish. `0` is free
`Config.Market.MaxItems`	`6`	Distinct items per listing
`Config.Market.MaxStock`	`50`	Units per listing
`Config.Market.Commission`	`0.05`	Platform commission per sale

lua

Config.Ads.Categories = {
    { id = 'venta',     label = 'Se vende' },
    { id = 'compra',    label = 'Se compra' },
    { id = 'servicios', label = 'Servicios' },
    { id = 'empleo',    label = 'Empleo' },
    { id = 'vivienda',  label = 'Vivienda' },
    { id = 'general',   label = 'General' },
}
 
Config.Market.Blocked = {
    'vehiclekey', 'vehicle_key', 'carkeys', 'keys',
    'vehicledocs', 'vehicle_papers', 'documentacion_vehiculo',
}

Sold items leave the seller's inventory and arrive in the buyer's, delivered by a Mandao courier.

Rides: Taxi and GO

Option	Default	Description
`Config.Rides.MinDistance`	`100`	Minimum ride distance, in meters
`Config.Rides.DriverCut`	`0.85`	Share kept by the driver. The rest leaves the economy
`Config.Rides.Timeout`	`5`	Minutes an unaccepted request waits
`Config.Rides.StuckMinutes`	`30`	Minutes after acceptance before the passenger can cancel once in the vehicle

lua

Config.Rides.Taxi = {
    label = 'Taxi',
    employer = {
        jobs = { 'taxi' },
        businesses = { 'taxi' },
    },
    base = 150,
    perKm = 45,
}
 
Config.Rides.Go = {
    label = 'GO',
    employer = false,
    base = 300,
    perKm = 90,
}

Field	Description
`employer`	Who can drive. `jobs` are framework jobs, `businesses` are business names or types from the Business bridge. Meeting either is enough. `false` lets anyone drive. Checked every time, not only at sign-up
`base`	Base fare
`perKm`	Fare per kilometer

NPC taxi fares

When there are free taxi drivers and few requests, fares from NPC passengers are generated. The server validates the driver's position at pickup and destination and rejects impossible arrival times.

Field	Default	Description
`enabled`	`true`	Enables NPC fares
`every`	`45`	Seconds between generation checks
`chance`	`0.6`	Chance of a fare on each check (0 to 1)
`perDriver`	`1`	Maximum pending NPC fares per free driver
`maxPending`	`4`	Maximum pending NPC fares in total
`nearDriver`	`2500`	Pickup within this distance of a free driver, in meters
`minTrip` / `maxTrip`	`600` / `4500`	Trip length range, in meters
`radius`	`80.0`	Radius around the point where the taxi must be
`maxSpeed`	`30`	Maximum plausible average speed, in m/s
`fareFactor`	`1.0`	NPC fare relative to the normal rate
`models`	list	Ped models used as passengers
`names`	list	Passenger display names
`notes`	list	Notes the passenger sends. Empty strings mean no note
`places`	list	Pickup and drop-off points `{ x, y, z, label }`. The passenger spawns on the nearest sidewalk

Mandao (deliveries)

Option	Default	Description
`Config.Delivery.Base`	`200`	Base delivery fare
`Config.Delivery.PerKm`	`60`	Fare per kilometer
`Config.Delivery.CourierCut`	`0.85`	Share kept by the courier
`Config.Delivery.Timeout`	`20`	Minutes an unaccepted job waits
`Config.Delivery.Deadline`	`10`	Minutes to deliver an accepted job. When it expires, goods are delivered anyway and the courier gets a strike
`Config.Delivery.StrikeBans`	`{ 10, 30, 60 }`	Ban minutes per strike. The last entry repeats
`Config.Delivery.StrikeReset`	`120`	Minutes without failures before strikes are forgotten
`Config.Delivery.MinDistance`	`150`	Minimum delivery distance, in meters
`Config.Delivery.Reach`	`8.0`	Distance required to pick up or deliver, in meters
`Config.Delivery.MaxItems`	`8`	Distinct items per player-to-player delivery
`Config.Delivery.Employer`	`false`	Who can deliver. Same format as `Config.Rides.Taxi.employer`
`Config.Delivery.HandleBusinessOrders`	`true`	Business orders wait for a courier instead of arriving automatically
`Config.Delivery.BusinessFee`	`450`	What the business pays the courier for delivering its order

lua

Config.Delivery.Depots = {
    { label = 'Almacen de mercancia · Muelle 1', x = 95.67,  y = -1746.8,  z = 28.7,  h = 140.88 },
    { label = 'Almacen de mercancia · Muelle 2', x = 99.68,  y = -1749.3,  z = 28.71, h = 139.86 },
    { label = 'Almacen de mercancia · Muelle 3', x = 103.73, y = -1751.94, z = 28.72, h = 139.62 },
}

Where business order goods are picked up. Empty means pickup at the business itself.

Beboteo (dating)

Option	Default	Description
`Config.Dating.DailyLikes`	`20`	Daily likes for non-VIP users
`Config.Dating.MaxPhotos`	`6`	Photos per profile
`Config.Dating.VipPrice`	`5000`	VIP price
`Config.Dating.VipDays`	`30`	VIP duration
`Config.Dating.VipLabel`	`'BEBOTEO VIP'`	VIP badge label

lua

Config.Dating.Genders = {
    hombre = 'dating_gender_male',
    mujer = 'dating_gender_female',
    otro = 'dating_gender_other',
}

The key is stored and compared; the value is the locale key shown.

Bank, invoices and fines

Option	Default	Description
`Config.Bank.MaxTransfer`	`500000`	Limit per transfer from the phone
`Config.Bank.MaxDaily`	`2000000`	Total that can be moved per day. `0` removes the limit
`Config.Bank.MaxWeekly`	`8000000`	Total that can be moved per week. `0` removes the limit
`Config.FineAccount`	`''`	Account that receives fine payments. Empty charges the player without depositing anywhere

Crypto

Disabled by default because it fetches live prices from the internet. To enable it, set Config.Crypto.Enabled = true, add { id = 'crypto', label = 'Monedas', slot = 27, default = true } to Apps and crypto = 'crypto' to AppDomains in config/apps.lua.

Option	Default	Description
`Config.Crypto.Enabled`	`false`	Enables crypto trading
`Config.Crypto.Api`	CoinGecko public endpoint	Price source. No API key needed
`Config.Crypto.Currency`	`'usd'`	Price currency
`Config.Crypto.Refresh`	`300`	Seconds between price fetches (shared by the whole server)
`Config.Crypto.Fee`	`0.02`	House fee per trade
`Config.Crypto.MaxPerTrade`	`500000`	Maximum amount per trade. `0` removes the limit

lua

Config.Crypto.Coins = {
    'bitcoin', 'ethereum', 'solana', 'dogecoin', 'cardano', 'litecoin',
}
 
Config.Crypto.Names = {
    bitcoin  = 'Bitoro',
    ethereum = 'Etherna',
    solana   = 'Solaris',
    dogecoin = 'Perrocoin',
    cardano  = 'Cardina',
    litecoin = 'Ligera',
}

If the price source does not respond, trading is disabled.

Browser

Opens only whitelisted sites. Domains are matched, so origen.net allows all its pages and subdomains.

Option	Default	Description
`Config.Browser.Enabled`	`true`	Enables the browser
`Config.Browser.Home`	`''`	Start page. Empty starts on the bookmarks
`Config.Browser.Sites`	`{}`	Allowed sites. Empty opens nothing
`Config.Browser.Bookmarks`	`{}`	Bookmarks defined by the server

Music

lua

Config.Music.Stations = {
    -- { id = 'ogn', name = 'Radio OGN', genre = 'Mixed', url = 'https://...' },
}
Config.Music.AllowCustomUrl = true

The URL must be a stream the browser can play (mp3, aac or audio m3u8). It only plays for the player who starts it.

News

lua

Config.News.Publishers = {
    businesses = { 'weazel', 'weazelnews', 'cnt' },
    jobs = { 'reporter', 'weazel', 'weazelnews', 'cnt' },
    error = 'err_news_need_job',
}
Config.News.MaxPerDay = 6

Who can write articles from the phone. Meeting one of businesses or jobs is enough. Set Publishers to false to publish only through the PublishNews export. MaxPerDay is the limit per phone; 0 removes it.

Emergency services

Alerts are sent to the Dispatch bridge with the caller's position.

lua

Config.Services.Cooldown = 60
Config.Services.List = {
    {
        id = 'police',
        label = 'Policia',
        description = 'Robos y peleas',
        icon = 'lucide:shield',
        job = 'police',
        alertTitle = 'Aviso ciudadano',
    },
    {
        id = 'ambulance',
        label = 'Emergencias medicas',
        description = 'Heridos y accidentes',
        icon = 'lucide:cross',
        job = 'ambulance',
        alertTitle = 'Aviso medico',
    },
}

Field	Description
`Cooldown`	Seconds between alerts from the same phone
`job`	Job that receives the alert
`alertTitle`	Title of the dispatch alert

Mechanics and tow trucks do not go here: with a business resource they appear as businesses in the app.

Moderation

Option	Default	Description
`Config.Filter.Enabled`	`true`	Enables the filters
`Config.Filter.Words`	`{}`	Words masked in everything a player writes. Matched inside words, case and accent insensitive. Ships empty
`Config.Filter.Mask`	`'***'`	Replacement text
`Config.Filter.ReservedNames`	see below	Names forbidden in usernames, aliases and profile names

lua

Config.Filter.ReservedNames = {
    'admin', 'administrador', 'staff', 'moderador', 'soporte', 'support',
    'police', 'policia', 'lspd', 'bcso', 'sheriff', 'ems', 'sama', 'emergencias',
    'origen', 'ogn', 'sistema', 'system', 'oficial', 'official',
}

Admin panel and app access

Option	Default	Description
`Config.Admin.Command`	`'telefonoadmin'`	Command that opens the panel
`Config.Admin.Ace`	`'ogphone.admin'`	ACE permission
`Config.Admin.Export`	`{ resource = 'origen_admin', method = 'IsAdmin' }`	Export that receives the source and returns `true` or `false`. Runs inside `pcall`
`Config.Admin.Licenses`	`{}`	Individual identifiers allowed
`Config.AppRules.Unemployed`	`'unemployed'`	Job name for players without a job
`Config.AppRules.NoGang`	`'none'`	Gang name for players not in a gang

App access rules (who gets which app) are set from the admin panel or with the SetAppRule export.

Appearance and sounds

These are defaults; once changed from the panel, the database values take over.

lua

Config.Wallpapers = {
    { id = 'default',  label = 'ORIGEN',             url = 'images/wallpapers/origen.jpg' },
    { id = 'gradient', label = 'wallpaper_gradient', url = 'images/wallpapers/default.svg' },
    { id = 'midnight', label = 'wallpaper_midnight', url = 'images/wallpapers/midnight.svg' },
    { id = 'sunset',   label = 'wallpaper_sunset',   url = 'images/wallpapers/sunset.svg' },
    { id = 'forest',   label = 'wallpaper_forest',   url = 'images/wallpapers/forest.svg' },
    { id = 'carbon',   label = 'wallpaper_carbon',   url = 'images/wallpapers/carbon.svg' },
    { id = 'light',    label = 'wallpaper_light',    url = 'images/wallpapers/light.svg', light = true },
}
 
Config.Accents = {
    { id = 'origen', label = 'ORIGEN',        acc = '#fc0259', rgb = '252, 2, 89',   soft = '#fc0259', pale = '#fd9bbd', deep = '#82173c' },
    { id = 'blue',   label = 'accent_blue',   acc = '#2f7dff', rgb = '47, 125, 255', soft = '#2f7dff', pale = '#a8c8ff', deep = '#173f82' },
    -- green, yellow, red, orange
}

url can be a file in ui/images/wallpapers or an external address. label can be a locale key or plain text.

lua

Config.Sounds.Ringtones = {
    { id = 'ring1', label = 'ringtone_1', file = 'Ringtone1.mp3' },
    -- ring2 ... ring6
}
 
Config.Sounds.Ringback = { sound = 'Remote_Ring', set = 'Phone_SoundSet_Michael', loops = true }
Config.Sounds.Hangup   = { sound = 'Hang_Up', set = 'Phone_SoundSet_Michael' }
 
Config.Sounds.Alerts = {
    { id = 'aviso1', label = 'alert_tone_1', file = 'Notificacion1.mp3' },
    -- aviso2 ... aviso5
    { id = 'silent', label = 'alert_tone_none', file = false },
}

Ringtones and alerts are files in ui/sounds/. The id is saved in each player's settings, so it must not change once published.

Languages

Option	Default	Description
`Config.DefaultLanguage`	`'es'`	Default phone language
`Config.Languages`	`{ 'es', 'en', 'fr', 'de', 'pt' }`	Available languages. With one, the language selector is hidden
`Config.DateLocales`	`es-ES`, `en-GB`, `fr-FR`, `de-DE`, `pt-PT`	Date and number formatting per language
`Config.DateLocale`	`'es-ES'`	Fallback for a language missing from `DateLocales`

To add a language, copy locales/en.json, translate it and add its code to Config.Languages and Config.DateLocales.

config/apps.lua

The server's source of truth for which apps exist. Editing the UI is not enough to get into an app.

Field	Description
`id`	App identifier
`label`	Display name
`slot`	Position on the home-screen grid (1 to 24 per page)
`dock`	Placed in the bottom dock instead of the grid
`default`	Installed by default
`fija`	Cannot be uninstalled from the app store

lua

Apps = {
    { id = 'phone',    label = 'Telefono', dock = 1, default = true, fija = true },
    { id = 'messages', label = 'Mensajes', dock = 2, default = true, fija = true },
    { id = 'ogn',      label = 'OGN',      dock = 3, default = true },
    { id = 'camera',   label = 'Camara',   dock = 4, default = true },
 
    { id = 'store',    label = 'Apps',       slot = 1, default = true, fija = true },
    { id = 'widgets',  label = 'Widgets',    slot = 2, default = true, fija = true },
    { id = 'gallery',  label = 'Galeria',    slot = 3, default = true },
    { id = 'settings', label = 'Ajustes',    slot = 4, default = true, fija = true },
    -- notes, calendar, map, weather, music, news, bank, ads, services, vehicles,
    -- mail, taxi, go, invoices, fines, clock, delivery, dating, calculator,
    -- properties, browser, voicememo, darkchat, blackmarket, fans, pescabichos
}

Remove an app from this list to disable it for everyone. To restrict it to some players (civilians, a gang, a job), use the admin panel instead.

AppDomains maps each server API domain to the app that owns it. When a player loses access to an app, its server methods stop answering them, so access is enforced server-side.

config/widgets.lua

lua

Widgets.Catalogo = {
    { id = 'servidor',    label = 'widget_name_server',     fuente = 'propio' },
    { id = 'weather',     label = 'widget_name_weather',    fuente = 'propio' },
    { id = 'bank',        label = 'widget_name_bank',       fuente = 'propio' },
    { id = 'trabajo',     label = 'widget_name_job',        fuente = 'fuera'  },
    { id = 'emergencias', label = 'widget_name_emergency',  fuente = 'propio' },
    { id = 'multas',      label = 'widget_name_bills',      fuente = 'propio' },
    { id = 'garaje',      label = 'widget_name_garage',     fuente = 'propio' },
    { id = 'negocio',     label = 'widget_name_business',   fuente = 'fuera'  },
    { id = 'facciones',   label = 'widget_name_factions',   fuente = 'propio' },
    { id = 'ruta',        label = 'widget_name_route',      fuente = 'propio' },
    { id = 'radio',       label = 'widget_name_radio',      fuente = 'fuera'  },
    { id = 'anuncios',    label = 'widget_name_ads',        fuente = 'propio' },
    { id = 'battery',     label = 'widget_name_battery',    fuente = 'propio' },
    { id = 'activity',    label = 'widget_name_activity',   fuente = 'propio' },
}

`fuente`	Meaning
`'propio'`	Filled by the phone itself
`'fuera'`	Filled by another resource with the `SetWidgetData` export

Widget permissions are managed in the admin panel.

Pescabichos

Game data for the creature-catching app. Names and texts are locale keys (pb_sp_12, pb_sp_12_desc, pb_atk_12_1); rename a creature by editing that key in each locales/*.json. A value that is not a key is shown as written.

File	What it holds
`config/pescabichos.lua`	Types, rarities, spawn zones and species 1 to 50
`config/pescabichos_especies2.lua` / `pescabichos_especies3.lua`	Species 51 onwards
`config/pescabichos_combate.lua`	Battles, type chart, moves per type, gyms, raids, evolution
`config/pescabichos_ataques.lua`	Attacks of each creature
`config/pescabichos_progreso.lua`	Player level, unlocks and shop

Species fields

Field	Description
`id`	Collection number (1 to 200). Also the image name: `ui/images/pescabichos/<id>.webp`
`nombre`	Locale key of the name
`tipos`	One or two of `asfalto`, `neon`, `marea`, `polvo`, `pino`, `chatarra`, `brasa`, `niebla`
`rareza`	`comun`, `poco`, `rara`, `epica` or `legendaria`
`zonas`	Where it spawns. Empty is anywhere on land. `'mar'` is real water
`peso`	Optional spawn weight. Defaults to its rarity's
`stock`	Optional maximum across the whole server
`red`	Optional special net required to catch it
`dificultad`	Optional catch difficulty (1 to 5)
`hora`	`nil` always, `'noche'` (21-6) or `'dia'` (7-20)
`familia` / `fase`	Evolution line and stage (1, 2 or 3)
`pc`	Minimum and maximum power it spawns with
`texto`	Locale key of its dex entry

Rarities

lua

Pescabichos.Rarezas = {
    comun      = { nombre = 'pb_rarity_comun',      peso = 100, captura = 0.55, huye = 0.08, xp = 100 },
    poco       = { nombre = 'pb_rarity_poco',       peso = 38,  captura = 0.35, huye = 0.12, xp = 200 },
    rara       = { nombre = 'pb_rarity_rara',       peso = 12,  captura = 0.20, huye = 0.18, xp = 500 },
    epica      = { nombre = 'pb_rarity_epica',      peso = 3,   captura = 0.09, huye = 0.25, xp = 1500 },
    legendaria = { nombre = 'pb_rarity_legendaria', peso = 1,   captura = 0.04, huye = 0.35, xp = 4000 },
}

Field	Description
`peso`	Spawn weight against the other rarities
`captura`	Base catch chance
`huye`	Chance it flees after a failed attempt
`xp`	XP granted for catching it

Zones

Land zones are map rectangles { min x, min y, max x, max y }, checked in order (small zones first). Outside all of them the zone is campo.

lua

Pescabichos.Zonas = {
    { id = 'alamo',      nombre = 'pb_area_1', caja = { 300, 3850, 2050, 4600 } },
    { id = 'industrial', nombre = 'pb_area_2', caja = { -350, -3450, 1500, -2350 } },
    -- ...
}

Progression

lua

P.NivelPescadorMax = 50
 
P.Progreso = {
    rareza = { comun = 1, poco = 1, rara = 5, epica = 12, legendaria = 20 },
    salvajes = { abajo = 8, arriba = 3, max = 35 },
    porEncima = { resta = 0.05, limite = 10 },
    topeBicho = 10,
    abre = { entrenar = 3, duelos = 5, equipo = 8, intercambios = 10, incursiones = 10 },
}

Field	Description
`rareza`	Player level from which each rarity spawns
`salvajes`	Wild creature levels relative to the player (`abajo`, `arriba`, `max`)
`porEncima`	Catch chance penalty per level above the player, and the level gap at which it cannot be caught
`topeBicho`	Creatures can level up to player level plus this
`abre`	Level at which each feature unlocks

Configuration · origen_phone

config/bridge.lua

config/server.lua

General

Item

Phone numbers

Custom numbers

Opening

Animation and prop

Notifications

Server notifications

Logs

Storage

Battery

Line recovery and phone store

Calls

Video (frame fallback)

Voicemail

WebRTC

Messages

Stickers

Gallery and uploads

Contacts, alarms and mail

OGN (social network)

Livestreams

OGN Fans

DarkChat

Black market

Ads and marketplace

Rides: Taxi and GO

NPC taxi fares

Mandao (deliveries)

Beboteo (dating)

Bank, invoices and fines

Crypto

Browser

Music

News

Emergency services

Moderation

Admin panel and app access

Appearance and sounds

Languages

config/apps.lua

config/widgets.lua

Pescabichos

Species fields

Rarities

Zones

Progression