Phones & inventory

Choose a phone model#

• Wolfden Phone is the everyday personal phone.
• Wolfden Phone Pro is the dual-SIM work phone, with more eSIMs and more app space.
• Wolfden Phone Secure is the burner phone, described below.

All three run NovaOS. Models are defined in config/devices.lua (the keys nova, nova_business and nova_secure), and their SIM limits in config/sims.lua. Only the names players see changed in 1.0.1: item names, model keys and config keys are the same as before, so a Wolfden Phone Pro is still the item nova_business_<colour>.

Colours#

Wolfden Phone and Wolfden Phone Pro are sold as one item per colour, and the phone on screen and in the player's hand always matches its item. There are eight finishes:

The item entries and images for all 17 phones are in Installation. Metadata cannot recolour a phone: to sell a different colour, sell its item.

Accent colours#

The accent colour tints buttons, switches and highlights. A new phone uses Match Phone: the accent of its finish from the table above, or the model's default (blue on Wolfden Phone, gold on Wolfden Phone Pro). Players can pick one of eleven accents during setup or in Settings → Display & Brightness. Wolfden Phone Secure always uses its lime accent.

Change which accent a finish uses with accent in Config.DeviceColors, and a model's default with defaultAccent in Config.PhoneModels, both in config/devices.lua. The colours themselves are in Config.AccentColors in config/themes.lua.

In the player's hand#

Each Wolfden Phone and Wolfden Phone Pro finish has its own phone model in the player's hand, and Wolfden Phone Secure has its own rugged model, set in Config.Prop.perModel (nova_secure = 'nova_secure'). All of them are included in the resource. The standard GTA phone in Config.Prop.default only shows if a model is missing.

Every Wolfden Phone and Wolfden Phone Pro in someone's hand with its screen on casts a soft glow on the holder's face, seen by players nearby. Wolfden Phone Secure does not glow, nor does a phone that is off or lying on a charging pad or the ground. Tune it in Config.PhoneLight in config/client.lua: color, brightness, distance and scanRadius, or enabled = false to turn it off.

To use your own prop for a model, set it in Config.Prop.perModel by model key, such as nova_secure = 'my_phone_prop'; it replaces that model's own props. The hand position is offset and rotation in Config.Prop.

Inventory items#

Wolfden Phone includes item files for both supported inventories, in migrations/:

The phones and SIM cards at the top are required. The groups below them are optional; add the ones you use:

The item names keep their original ids: novapods_white is a pair of NovaBuds, novapods_max_<colour> is Nova Studio, nova_business_<colour> is a Wolfden Phone Pro. Only the labels players see use the new names. If you are updating from 1.0.0, copy the labels from the item file into your inventory again; see Updating Wolfden Phone.

On qb-inventory, Wolfden Phone makes the items usable itself; there is nothing else to register. phoneadmin selftest report warns about any item that is missing.

The models players see in the world are included too: NovaBuds and Nova Studio when worn, the charging pad, the router, and the Nova Mini and Nova Boom speakers. Whatever sits on a charging pad shows as its own model: any phone (every finish, and the Secure), a power bank, the NovaBuds charging case in white or black, and a speaker as its prop.

Make phones available to players#

Phones and accessories are sold at the phone stores that come with Wolfden Phone. You can also sell the items in your inventory's own shops: add the phone items you want to sell, such as nova_phone_midnight or nova_business_pearl, and set your own prices.

From another resource, give a phone with:

-- ox_inventory
exports.ox_inventory:AddItem(source, 'nova_phone_ocean', 1)
-- qb-inventory
exports['qb-inventory']:AddItem(source, 'nova_phone_ocean', 1, nil, nil, 'purchase')

SIM carrier shops are defined separately in config/shops.lua; see SIMs & carriers.

Phone stores#

Phone stores sell phones in every finish, NovaBuds, Nova Studio, speakers, chargers, routers, blank SIMs and SD cards over the counter. Players walk up to the counter and open the storefront with ox_target, or an [E] prompt without it. They pick a finish and quantity, and pay by bank or cash.

Default prices:

The Stranger is a black-market dealer at a different spot every day, at night only; see Shade.

Configure the stores#

The stores, prices and the dealer's spots are in the server-only config/mobile_shops_server.lua, so players cannot read them. Keep your changes in a file in config/local/server/; see Configuration.

• Prices for every store are in catalogue. A product without a price is not sold. A store's own catalogue overrides a price, sets stock (a number of units until the next restart, or false for sold out), or removes a product with false.
• Each store has coords and heading (move every counter to fit your map), a shop assistant (ped), a blip, opening hours and an optional products list.
• Wolfden Phone Secure (nova_secure) is only sold where a store has secure = true. Shade cards and Racing USBs only where it has contraband = true.
• Job discounts: discounts = { police = 10 }, with discountOnDuty = true to apply them only on duty.
• Job-owned stores: owner = { job = 'digitalden', account = 'digitalden' } pays sales into that job's account, when your banking resource has shared accounts.
• Limits: accounts (how players may pay), maxQuantity (units per purchase, 5 by default) and cooldownMinutes (one purchase per character per that long).

Opening hours are checked by players' games. To have the server enforce them on every purchase too, give it the game hour with serverHour; the file's comments have examples.

Shared settings are in config/mobile_shops.lua: enabled, interaction ('auto', 'target' or 'prompt') and maxDistance, how close to the counter a purchase is accepted (3 metres). Another resource can add a store while the server runs with the AddMobileShop export; see Exports & integrations.

phoneadmin selftest report warns when a store sells an item your inventory does not have.

Give a test phone#

/giveitem <id> nova_phone_midnight 1
/giveitem <id> nova_business_ocean 1
/giveitem <id> nova_secure 1

Replace <id> with a player's server ID. A new item's first use sets the phone up and signs it automatically.

Wolfden Phone Secure#

Wolfden Phone Secure (item nova_secure) is a locked-down burner with its own graphite and lime-green interface. It is the burner phone: nothing on it can be traced back through an account.

• Fixed apps. Settings, Notifications, Phone, Messages, Contacts (the Phone app's Contacts tab), Camera, Gallery and Shade. There is no Nova Store, so nothing else can be installed. Add 'city' to its apps list in config/devices.lua to offer City.
• No Nova Account. It cannot sign in, so it never appears in Locate and cannot be backed up, transferred or erased remotely. Its data stays on the phone.
• Burner SIMs only. It has no SIM card slot and takes only Ghost Mobile eSIMs. Those are 777 numbers that expire after the time the player bought, and calls from them always hide the caller ID.
• Disappearing data. Its messages, call history, photos and contacts disappear on timers, starting at 24 hours for messages; see Disappearing data.
• Quiet lock screen. A new Wolfden Phone Secure hides what arrived on its lock screen.
• Burn Phone and Burn PIN. Players can erase everything at once, including what the phone sent, from Settings or by typing a second PIN on the lock screen.
• New numbers and rooms. Its eSIM can swap for a fresh 777 number, and players can meet in group chats joined with a code.
• Voice changer. Players can disguise their voice on calls with the Robot, Distorted, Radio or Muffled style, set in Settings → Phone & Messages or on the call screen.
• Locked down. Mobile data only (no Wi-Fi), no Bluetooth, NovaBuds or Nova Studio, no Face Unlock, no Control Center, and no theme, accent, wallpaper, widget or home-screen changes.

On-duty police can get past a seized Secure's PIN with a timed forensic unlock. Wolfden Phone Secure covers each feature and its settings in config/secure.lua.

The Ghost Mobile shop has no map blip by default, and only Back Room Electronics sells the phone itself. Players have to know where they are, or you can enable their blips in config/shops.lua and config/mobile_shops_server.lua.

Change names and appearance#

For inventory labels and descriptions, edit the item entries in your inventory. For model labels (label in Config.PhoneModels), colours and accents, edit config/devices.lua; for themes and wallpapers, config/themes.lua.

Keep item names matched across the inventory entries and the phone configuration. Renaming the resource or an item without updating the other side prevents the item from opening.

What moves with the phone?#

Without a Nova Account, the phone keeps the account data too. A number routes calls and messages, but history belongs to the account (or phone) that received it. Use Nova Account & recovery to move a phone's own data to another phone.