QBCore Frameworkqbcore.netCommunity docs
On this page

Independent community guide · Verified 2026-09-21 · Updated 2026-11-13 · 5 min read

Symptoms and Fixes

Matched locally in your browser. A matching guide is a starting point, not a confirmed cause.

Start with the first error after a clean server start, not the last resource reporting a nil value. A broken dependency can produce errors in otherwise working resources. Record the resource name, file, line, deployed commit and the last change before applying a fix.

These are source-reviewed diagnostic instructions, not a claim that every server configuration has been tested. Work on staging with a recoverable backup. Do not delete characters, invent missing columns or clear every cache as a first step.

Diagnose your issue

Choose a short guided check for resource startup, database errors or character loading. The complete written guides remain below; no account or server connection is required.

Choose a workflow or paste a short error excerpt. This is a source-linked diagnostic path, not an automatic fix. Text stays in this page, is never uploaded or executed, and is not saved to browser storage. Remove credentials and player data before pasting.

Interactive diagnosis needs JavaScript. The complete symptom-to-guide table and written checks below work without it.

Maximum 12,000 characters. An error pattern suggests a path; it does not establish a root cause.

For a resource with a manifest, locally run the Compatibility Analyzer to check selected fxmanifest.lua dependencies, literal Lua APIs, and explicit resource starts. It keeps the selected text in the browser; its findings identify review steps, not confirmed runtime failures. Check the installed version and first server-console error before making changes.

The diagnostic directory was expanded on 2026-11-13; individual guides retain their own source-review dates and version boundaries.

Choose a diagnostic path

SymptomGuideFirst distinction
No such export GetCoreObject, LoadInventory or another exportMissing-export referenceProvider startup, execution side or API mismatch
Missing resource or dependencyResource load orderMissing files versus a resource that failed to start
oxmysql missing, access denied or a SQL erroroxmysql troubleshootingPackage, connection or schema failure
attempt to index a nil valueLua nil valuesWhich expression on the reported line is nil?
Inventory will not open, or stopped working after an updateInventory updatesCaller API, shared items, UI or storage
Black screen or character selection stuckMulticharacter loadingBefore selection, after selection or only new characters
Vehicles missing after reconnectVehicle stateEntity existence versus persistent ownership
Voice indicator works but nobody hears youVoice chatProximity, radio and phone calls are separate tests
An update overwrote custom changesUpdate conflictsCompare the local customization with the incoming change

Server won't start

For Couldn't find resource qb-core, check that the active server data directory contains resources/[qb]/qb-core/fxmanifest.lua. A nested qb-core-main/qb-core/ folder is not the same resource path. Confirm that you edited the configuration used by the running txAdmin profile.

If the folder is correct, inspect errors before the missing-export messages. A syntax error in qb-core/shared/items.lua can prevent shared data from loading. Reordering ensure statements will not repair invalid Lua. Follow the worked script-installation case.

Players can't join

For Connection refused, first establish whether FXServer is running and listening on the intended interface and port. Compare a local connection with one from another network; a LAN-only success does not prove that public routing works. Continue with connection diagnostics.

FiveM Server Connection Issues

For Failed to connect to server, distinguish a transport failure from license authentication and from a failure after downloading resources. The example default listener is:

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Use your actual port. Check both the host firewall and provider/NAT rules for that port. Keep the license key private and follow the installation guide for current registration instructions. A working network connection followed by a black screen belongs in the loading guide, not in firewall troubleshooting.

Player Vehicles Table Not Found

For player_vehicles doesn't exist, do not paste an arbitrary CREATE TABLE statement. First confirm the selected database, then identify the resource owning the query and inspect its SQL at the same commit. In the referenced vehicle-shop source, that schema is in vehshop.sql.

Run read-only inspection in your database client:

SELECT DATABASE();
SHOW TABLES LIKE 'player_vehicles';

If the table exists, inspect SHOW CREATE TABLE player_vehicles; and compare it with the owning resource's migration. If it does not, restore or apply the appropriate schema on staging before scheduling a production change. CREATE TABLE IF NOT EXISTS does not update an existing incompatible table. See database ownership and oxmysql schema errors.

Player Login State Check

LocalPlayer.state.isLoggedIn is a client-side readiness signal, not a way to repair a failed login. Do not access client globals in a server script. Prefer the QBCore load/unload events and check for a loaded character when a resource starts after login.

For a temporary client diagnostic:

RegisterCommand('docs_login_state', function()
    print(('isLoggedIn=%s'):format(tostring(LocalPlayer.state.isLoggedIn)))
end, false)

Run docs_login_state in F8. A false/nil value during loading means you should inspect the character flow; do not force the flag to true. Remove diagnostic commands after testing. See player data.

NUI GetParentResourceName

GetParentResourceName() is available in FiveM's NUI browser JavaScript. It is not an ordinary browser API: opening your HTML at localhost or as a file does not provide the FiveM NUI bridge. In client Lua, use GetCurrentResourceName() when you need the current resource name.

This minimal request/response pair uses the same callback name on both sides:

-- client.lua, loaded by your resource's client_scripts entry
RegisterNUICallback('docsPing', function(_, cb)
    cb({ ok = true, resource = GetCurrentResourceName() })
end)
// Browser-side NUI JavaScript, loaded by your ui_page HTML
async function pingGame() {
  if (typeof GetParentResourceName !== 'function') {
    throw new Error('This test needs FiveM NUI; a normal browser preview has no game bridge.')
  }

  const response = await fetch(`https://${GetParentResourceName()}/docsPing`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json; charset=UTF-8' },
    body: JSON.stringify({}),
  })
  return response.json()
}

pingGame().then(console.log).catch(console.error)

Expected result inside FiveM NUI: an object with ok: true and the resource name. Every Lua callback path must call cb, including validation failures. A missing response can leave the UI waiting. Check the actual NUI console/network panel, callback spelling, loaded client.lua, manifest ui_page/files entries and the first JavaScript error.

For browser-only development, provide an explicitly labelled mock transport; never mistake its success for a working game callback. Continue with the complete NUI form guide.

Common Database Issues

A missing players table and a missing resource-specific table require different source files. Inspect the database selected by the running connection string and consult the core schema. Do not replace an existing player schema with a shortened example.

For Access denied, ECONNREFUSED, missing tables and unknown columns, use the oxmysql decision table. Keep backups outside the web root and redact passwords, license keys and personal player data from support logs.

Next Steps

Sources

Found an issue in this guide?

Send the page URL, the affected example, and a source or reproduction to the site maintainer. For a server or resource problem, use the support guide.

On this page