Oxide Phone

oxide-phone is a smartphone your players carry as an inventory item: calls, texts, contacts, mail, a camera, everyday apps and a Store, with a full police investigation layer built in. It runs on QBCore, QBX and ESX through the o-link bridge.

Oxide Phone comes with three apps for it: the dating app Hookr (oxide-hookr), the photo and video sharing app Leakd (oxide-leakd) and the live streaming app Glitch (oxide-glitch). Each app is its own resource and its own download in your Cfx Portal assets, and runs inside the phone. The apps are optional: install the ones you want.

Every phone is an inventory item with its own device ID, and its number lives on a SIM card, so contacts, texts, mail, photos and the home screen stay with the handset when it changes hands while texts and mail follow the number. The phone ships with 12 built-in apps (Phone, Messages, Mail, Camera, Photos, Notes, Calculator, Clock, Maps, Wallet, Settings and Store), 2 more in its Store (Dark Chat and Feed), a Gigs app while the Oxide gig jobs run, and a Forensics app for police. Calls run through pma-voice; photos, videos and voice clips go to Fivemanage, S3-compatible storage or the owner's own service. Players carry the phone's own model in one of 4 colours, pick from 5 built-in wallpapers, 8 ringtones and 6 text tones, and can report a lost SIM or find, lock and erase a lost phone.

The phone is also evidence. Police seize, lodge, return and destroy phones with a full custody log, extract everything on a phone (recently deleted content included) under a search authorization, and read carrier records and traces, while players can erase or securely wipe a phone first. Other resources reach the phone through the o-link phone namespace: mail, texts, notifications, and hosted apps and widgets that use the phone's accounts, photos, camera, location, links, live streams and evidence. Server owners tune nearly everything in game with /phone settings.

Key Features

The Phone

• Every Phone Is Its Own Device — The first time a phone item is used it gets its own device ID. Contacts, texts, mail, photos and the home screen stay with that phone when it changes hands
• SIM Cards and Numbers — A phone's number lives on its SIM card. Registered SIMs carry the character's name at the carrier; burner SIMs carry nobody's. A new phone can come with a free registered SIM
• Passcode Lock — Players set a 4 to 6 digit passcode (you choose the lengths). Too many wrong guesses lock the phone for a while. Admins can remove a forgotten passcode
• Battery (Optional) — Phones drain while switched on, charge in a vehicle or at charging stations you place in game (nearby, or left on a pad), and can be topped up with a powerbank item. Off by default
• Signal — Draw no-signal areas (tunnels, basements) in the world, and optionally treat every interior as having no signal
• Held in Hand — While the phone is open the character holds the phone's own model, in Black, Silver, Burgundy or Glacier, and plays a texting animation. Players can keep walking
• Lost and Stolen Phones — Players report a lost SIM and get a replacement with the same number. Find Phone in Settings locates, locks (Lost Lock) or erases their phones from any phone they use

Communication

• Calls — Voice calls through pma-voice. Nearby players hear a phone ring. Missed calls, recents, busy and unreachable lines
• Messages — Direct and group texts, photos and shared locations. Texts to a phone that is off or out of signal wait on the server and arrive later
• Contacts — Saved on the phone, with favorites and sharing with a player standing next to you
• Mail — Each phone has its own inbox. Other resources send mail to players, even offline ones
• Emergency Numbers — 911 and 311 go to your dispatch system, from the Phone app or straight from the lock screen

Apps

• Built In — Phone, Messages, Mail, Camera, Photos, Notes, Calculator, Clock, Maps, Wallet, Settings and the Store
• From the Store — Dark Chat (anonymous chat rooms with photos) and Feed (public short posts with photos or video, hashtags and mentions, replies, quotes, reposts, likes, bookmarks, follows, search, trending and a Notifications tab), plus any app another resource adds. Getting an app downloads it over a few seconds, slower on weak signal
• Apps From Other Resources — Other resources can put their own apps and widgets on the phone, with app accounts, the phone's photos and camera, and live streams from the phone's camera
• Home Screen — Pages, a dock, widgets from other resources, five built-in wallpapers and your own wallpaper images
• Notifications — Banners, a notification list, app badges and a notification sound. Players choose Do Not Disturb, banners, sound, volume and which apps may notify them

Police and Evidence

• Forensics App — Police see who a phone belongs to without seeing what is on it, keep a custody log, lodge, return or destroy seized phones, and read extraction reports by kind (photos and videos, edited and unsent messages, mail, calls, voicemail, places), with every opening logged
• Search Authorizations — Issued in game by the jobs you choose, or decided by another system
• Extraction — An authorized extraction copies everything on a phone into a report, including recently deleted content
• Carrier Records and Traces — Call and text records per number, and a rough live location of a switched-on phone
• Counterplay — Players can erase their phone, or use a phone wiper item so nothing can ever be recovered

Server Management

• In-Game Settings Menu — Change almost every setting live with /phone settings
• Admin Commands — Look up a player's phone, remove a passcode, set a battery level, report a SIM lost or give a replacement, remove a forgotten app password, and list or end live streams
• Automatic Database Setup — Every table is created on first start
• Works With Other Scripts — Stock QBCore scripts that send qb-phone mail keep working, and an optional layer answers common LB-Phone exports

Included Apps

Each one is its own resource in the package. Players get them from the phone's Store. Each app works without the others.

Requirements

Required

Optional

See Integrations for what each optional resource adds, and what happens without it.

Supported Frameworks

Database

oxide-phone creates 67 tables of its own at first start, all prefixed oxide_phone_:

oxide_settings is the shared live-settings storage; phone rows use resource = 'oxide-phone'.

The phone ships sql/install.sql and sql/migrations/ for manual installs. Hookr, Leakd and Glitch create their own tables. See Installation → Database Setup.

Frontend

Vue 3 + Vite + Tailwind CSS (TypeScript) for the phone, the Forensics app, the settings editor and each of the three apps. The camera draws the game view through WebGL. The interface ships ready to use in web/dist. There is nothing to build.

Technical Details

• Device identity on the item's metadata: each phone gets a device ID on first use, a registered owner, and its own content; a fallback binds phones to characters where the inventory keeps no item data.
• Several phones per player: calls carry the device they reached and every call action is refused from another phone that is out; a call to a phone in the pocket rises beside the open one; notifications, live app updates and app badges are kept per phone and per app account.
• SIM cards as the number: registered SIMs carrying the character's name, burner SIMs, a configurable number format with prefixes, and a free registered SIM for a new phone (Config.Sim.autoIssue).
• Lost and stolen SIMs: owner reports from any phone kill the card where it sits, sign out the number's app accounts elsewhere and remove passwords set on them; a replacement with the same number keeps handles and accounts, priced by Config.Sim.replacementCost.
• Find Phone: locate (a rough area like a police trace), Lost Lock (lock, passcode, message and number on the lock screen) and Erase, queued until the phone is reachable and never applied while police hold it.
• Passcodes stored as salted PBKDF2 hashes, worked out across server ticks, with a lockout after wrong guesses and admin reset.
• Optional battery (drain, car charging, powerbank, Low Power, torch drain), drawn no-signal zones, optional no signal indoors, and Airplane Mode recorded in carrier records.
• Charging stations placed in game: phones charge nearby or on a pad where anyone (or only the owner) can take them; stations built with your own map tools can join.
• Phone props in four colours with a texting animation and walking with the phone open.
• Calls through pma-voice channels with a watchdog that removes any client joining a call it is not in; hold, waiting, swap, merge to five, DTMF, voicemail with greetings, blocking, hidden caller ID, Silence Unknown and Respond with Text.
• Messages with server-side delivery queues, receipts, typing, reactions, replies, edits with history, unsend, send later, voice, photos and videos, places and live locations, polls, contacts, drawings, backgrounds and group admin.
• Mail with SIM addresses, aliases, resource mailboxes, Inbox categories, attachments, drafts, undo, send later, Junk for blocked senders and offline delivery.
• Camera on the game texture through WebGL: photo, video (VP8 WebM with optional microphone), time-lapse and portrait, filters, exposure, zoom, flash seen by nearby players, timer, grids and level, with a key map players can rebind.
• Photos with library views, albums and shared albums, Places map, Hidden behind the passcode, Recently Deleted kept for the police recovery window, a WebGL editor with non-destructive edits, trim and Save as New Clip.
• Pluggable media storage: Fivemanage, S3-compatible signing (AWS, R2 and others) or a custom provider through SetMediaProvider, with a host allowlist for every media address.
• Wallet transfers between registered numbers through o-link money, written down before money moves, with idempotency keys, a per-player lock, daily limits, debit confirmation and refunds; payment requests in Messages.
• Store with simulated downloads kept on a server timeline per phone, job, gang and duty restrictions, preinstalled apps and an off switch.
• Dark Chat rooms by handle, and Feed with posts, media, hashtags and mentions parsed into safe tokens, replies, quotes, reposts, likes, bookmarks, follows, trending, edit history, a verified badge, reports, mutes and per-SIM rate limits.
• Gigs app reading the seven Oxide gig jobs live through their exports, with a widget and shift updates as notifications.
• Home screen with pages, dock, folders, widget stacks, All Apps, search, wallpapers from the wallpapers/ folder or URLs, Quick Controls, an app switcher, modes, notification banners and previews, side buttons and a torch.
• Nearby sharing within 3 metres for photos, contacts, notes, places and posts.
• Emergency calls to oxide-dispatch's civilian pipeline through o-link, or to the configured jobs with a blip, from a locked phone or one without a SIM.
• Evidence layer: evidence mode with the owner's consent, custody states and log, search authorizations issued in game or decided by another resource (SetAuthorizationCheck), extraction reports by kind with every opening logged, carrier records, traces, report destinations including oxide-police cases and RegisterEvidenceBackend.
• Counterplay: Erase All Content (recoverable for the recovery window) and the phone_wiper secure wipe.
• App platform for other resources: olink.phone mail, texts and notifications, hosted apps and widgets with one-time permission prompts, the Photos picker, Camera, uploads, the share sheet, app links, device info, location, one account model with passwords and signed-in phones, evidence records, and live streams relayed by the server with admission checks and kicks.
• Live streams with per-server limits on viewers, streams, bitrate, length and upload budget (Config.Streams), and /phone streams and /phone endstream.
• Compatibility: a qb-phone mail shim for stock QBCore scripts, and an optional LB-Phone export layer (oxide_phone_compat_lb).
• Admin commands under /phone: settings, device, resetpin, apppassword, battery, charger, calltest, streams, endstream, feedverify, simlost and simreplace, all gated on the o-link admin check.
• Live settings editor (/phone settings) backed by the database and validated on save.
• English locale file (locales/en.json).

Quick Start

ensure o-link
ensure oxide-phone
ensure oxide-hookr
ensure oxide-leakd
ensure oxide-glitch

Documentation