FiveM phone as an inventory item: damage and repairs
What it means for a FiveM phone to be an item rather than a keybind: which item opens which device, the inventories it works with, how screens break, and why repairs are a job on your server.
Yazan: GKSHOP Team/Son güncelleme
On a roleplay server the phone is evidence, loot and a thing that can be lost. That only works if the phone is an item the character carries. A phone that opens from a keybind no matter what cannot be taken off a suspect, dropped in a river or sold to a pawn shop. So the first question about any FiveM phone script is whether the device is tied to the inventory, and what follows from that.
Which item opens which device
GKSPHONE uses two items. phone opens the Android theme and iphone opens iOS, and the frame and status bar in the character's hand change with it. Both themes are complete; Android is not a fallback. If your items are named differently, rename them in Config.ItemName. If you would rather not gate the phone behind an item at all, set Config.ItemRequire = false and it opens without one.
| Framework | Default inventory | Also detected |
|---|---|---|
| QBCore / QBox | qb-inventory | ox_inventory, qs-inventory, tgiann-inventory, codem-inventory, core_inventory |
| ESX | ESX's own | ox_inventory, qs-inventory, tgiann-inventory, codem-inventory, core_inventory |
Config.Inventory defaults to "auto" and is detected separately from the framework, so qb-core with ox_inventory works the same as ESX with ox_inventory. Add the two items in your inventory's own format; the QBCore and ESX installation guides show both.
A phone that can break
Screens crack from vehicle crashes, falls, water and player death, and the server sets the odds and the severity for each. The crack is drawn over every screen the player opens, not shown once as a notification. Water exposure is tracked on its own, and battery condition can affect how fast the phone drains.
What a cracked phone can still do is also yours to decide. Out of the box apps keep opening on a damaged screen; restricting them is opt-in through the screen damage Restrictions setting. Since v2.8.4 the phone is blocked by default while the character is dead or cuffed, with calls, invites and notifications held back until the restriction lifts.
Repairs are a job, not a menu option
Screen and battery condition stay recorded on the phone, and players can read them on the Phone Health page: screen condition, battery health, charging cycles and water damage. Only a repair clears the damage, and the bill scales with how bad it is, so a repair shop has real work. A repair also clears saved water damage.
Phone Recovery adds the other side. A locked phone can be taken to a legal repair shop or to a black-market NPC, and the price, the risk and the chance of success are all configured by the server.
What to check in any phone script
- Can the phone be required as an item, and can that be turned off?
- Does it work with the inventory you already run, without a custom adapter?
- Can a different item open a different device or theme?
- Does damage persist on the phone, or reset when the player reopens it?
- Is the repair something another player does, or a button anyone can press?
- Is blocking the phone when dead or cuffed a setting, and what is the default?
Sıkça sorulan sorular
Does GKSPHONE work with ox_inventory?
Yes, on ESX, QBCore and QBox. The inventory is detected automatically, alongside qs-inventory, tgiann-inventory, codem-inventory, core_inventory and each framework's own inventory.
Can the phone open without an item?
Yes. Set Config.ItemRequire = false and the phone opens without one.
How do players get an iPhone instead of an Android phone?
Give them the iphone item. The phone item opens the Android theme and iphone opens iOS; both names can be changed in Config.ItemName.
Does a cracked screen stop apps from opening?
Not by default. Restricting what a damaged phone can do is opt-in through the screen damage Restrictions setting.
Who repairs a broken phone?
A repair shop on your server. Damage stays recorded until a repair clears it, and the price scales with the damage.