Volver a las guías
Guía4 min read

A phone script for Qbox: what qbx_core servers need

How a phone script finds qbx_core, why ox_inventory decides where the items go, which Qbox resources it reads, and what changes from a QBCore install.

Por GKSHOP Team/Última actualización

A phone script for Qbox: what qbx_core servers need cover image

Qbox started as a fork of QBCore, and most phone scripts list it as "QBCore compatible" and stop there. That is half an answer. A Qbox server runs qbx_core instead of qb-core and is usually built around ox_inventory, so a phone that only looks for qb-core will not find the character, and one that only knows qb-inventory will not find the phone item.

Finding qbx_core

Config.Framework defaults to "auto". At start GKSPHONE checks for es_extended, then qbx_core, then qb-core, and falls back to standalone. On a Qbox server it finds qbx_core and runs the same adapter as QBCore (server/framework/qb.lua), with its own branches where qbx_core behaves differently. Set Config.Framework by hand only if you renamed the framework resource.

The items go where your inventory is

The phone uses two items: phone opens the Android theme and iphone opens iOS. On Qbox they belong in ox_inventory's own item list, not in qb-core/shared/items.lua, which a Qbox server does not use. Config.Inventory is detected separately from the framework, so ox_inventory is picked up automatically. If you would rather not require an item at all, set Config.ItemRequire = false.

SystemDetected
Frameworkqbx_core
Inventoryox_inventory, qb-inventory, qs-inventory, tgiann-inventory, codem-inventory, core_inventory
BankingRenewed-Banking, qb-banking, okokBanking, fd_banking, ps-banking
Garagejg-advancedgarages, qb-garages, cd_garage, loaf_garage, qs-advancedgarages
Housingps-housing, qb-houses, qs-housing, loaf_housing, bcs_housing, vms_housing, rtx_housing
Voicepma-voice, mumble-voip, saltychat, yaca-voice
What GKSPHONE reads on a Qbox server

Each row is a setting in gksphone/config/config.lua that defaults to "auto", so the phone uses whichever resource is running. Inventory, banking, garage and licences also take a "custom" option for a resource that is not listed.

What stays the same as QBCore

  • oxmysql is the only hard dependency, and it starts before the phone.
  • The phone builds its own tables on first start; the tablet's install.sql is imported by hand.
  • Media upload tokens go in gksphone/config/serverconfig.lua, or the camera takes no photos.
  • The phone starts last in server.cfg, after qbx_core, ox_inventory, your voice resource and anything else it reads.
  • config/, client/ and server/ are outside the escrow, so if your Qbox build changed an export you can see how the phone calls it and change it.

Preguntas frecuentes

Does GKSPHONE support Qbox?

Yes. It detects qbx_core at start and uses the QBCore adapter with Qbox-specific branches. No setting needs to change.

Where do I add the phone items on Qbox?

In ox_inventory's item list, or in whichever supported inventory you run. Add both phone (Android) and iphone (iOS), or set Config.ItemRequire = false to open the phone without an item.

Is the tablet supported on Qbox?

Yes. The GKS Tablet ships with the same license and supports Qbox. Its inventory support is ox_inventory or none.

Do I need qb-core installed alongside qbx_core?

No. The phone looks for qbx_core before qb-core, so a Qbox server without qb-core is detected as Qbox.