In-game GTA V data browser for FiveM. Search it, preview it in the world, copy the code.

nCore Development · intelnpc.com · Resource: ncore_devkit · Version: see fxmanifest.lua

What it is#

nCore DevKit puts the game's data inside the game. You open it with F10, type a few letters, press Enter and the thing shows up in front of you. Then you copy a Lua snippet with the real name already filled in. I made it because I got tired of alt-tabbing to websites and text dumps every time I needed a prop name, an animation clip or a particle asset.

It's meant for developers and admins. A player only gets in with a permission you give: ACE, an identifier list, or on ESX, QBCore and QBox an admin group or job. The data comes from game build v3717.0 (Online 1.72): 46 categories with 103,097 entries, plus 269,414 animation clips, 81,206 speech lines and 33,912 world placements. The entries include 21,561 props, 921 vehicles, 1,109 peds, 184 weapons and 20,179 animation dictionaries. It's the base game only, so models your server streams itself (addon vehicles, MLO props) are not in the list.

Features#

The browser#

• A left column for browsing, a right column for details and activity, and a dock at the bottom. Open it with /gdb, /gdb <term>, /gdb find <term> or F10, close it with Esc. It needs the browse permission.
• 46 categories, grouped as Spawn, Motion, Effects, Looks, World, Audio and Reference. Each one can be switched off with Config.Categories.<key>, and it's then gone from the browser and the search.
• Results update on every key. Exact matches come first, then names that start with your text, then names where your text starts after a separator, then anything that contains it. Shorter names come first and the match is highlighted. Long lists render as you scroll. Display is capped at Config.Search.MaxResults (5000), and the count shows the real total.
• With an empty search you get a hand-picked "Start here" list of showcase entries and the total record count.
• The Categories tab has 7 collapsible groups with totals. Click a category to search only in it. Categories that need the elevated permission show a lock.
• The detail panel shows the category, the label and every data field of the selected entry. Animation dictionaries list their clips, speech voices their lines and location groups their placements as clickable chips (up to 300, with "N of total"). The chip you pick is what the preview and the snippet use.
• Clips can be added to the global search with Config.Search.IncludeClipsInGlobalSearch = true (off by default). It adds all 269,414 clip names to the main search and makes loading and typing slower.
• Up and Down move, PgUp and PgDn jump a page (Config.Search.PageSize), Enter previews, / jumps to the search box, Delete stops everything, Esc closes.
• The activity timeline keeps the last 60 events (previews, errors, stops, picks, favorites) with a live "time ago" label.

Snippets#

• The selected entry shows a Lua snippet with its real name and values filled in. Copy it with the button, C (when the search box isn't focused) or Alt+C.
• The templates are plain files in data/snippets/ with {{field}} placeholders, so you can change them. If an entry is missing a value the template needs, no broken code is shown and a warning goes to the F8 console.
• 42 categories have a template. Shaders, vehicle flags, weapon flags and apparel restriction tags don't. The vehicle mod kit and livery templates are general examples that don't use the entry you picked yet.

In-world preview#

Enter, a double-click or the Preview button. 41 of the 46 categories can be previewed. Starting a new preview stops the old one first. The 5 reference-only categories (scenario groups, shaders, vehicle flags, weapon flags, apparel restriction tags) say so instead of failing.

• Props and vehicles spawn in front of you on the ground, frozen, invincible and facing you. Props stand at Config.Preview.Distance (2.5 m), vehicles at Config.Preview.VehicleDistance (6 m), locked with the engine running. Only you see them.
• By default a ped preview makes you that ped (Config.Preview.PedsOnSelf = true), and other players see that model change. Your model, clothes, hair, health and armor are saved first and put back afterwards. Set PedsOnSelf = false to spawn the ped in front of you instead.
• Weapons, weapon components, ped damage packs, clothing, ped props and tattoos go on a frozen local mannequin, so your own character isn't touched. The mannequin model is Config.Preview.MannequinModel (mp_m_freemode_01).
• Pickups are spawned for you only.
• For an animation you pick a clip chip and preview it, and that exact clip loops. The preview checks that it really plays and tells you if the clip isn't in the dictionary.
• Scenarios start in place. Clipsets walk a mannequin forward with the walk and strafe style.
• A waypoint recording is drawn as a pink line in the world, with a map waypoint at the start.
• Particles loop, timecycle filters apply (your previous one comes back), screen effects loop and camera shakes play. Their strength is in Config.Effects.
• Explosions are elevated only. It's a real explosion at least 12 m in front of you. Other players see and hear it, and an anticheat that watches explosions will see it too. By default it does no damage (Config.Effects.ExplosionDamageScale, default 0.0). Raise it and it damages what's near it. You're made invincible while it plays and the fire is put out when it stops.
• Mod kits, liveries, paint, xenon and window tint go on a fresh vehicle. The handling preview puts you in the driver's seat of a local copy.
• IPLs toggle and are put back afterwards. Interiors, zones, garages and world placements teleport you there with a screen fade. If an interior belongs to a DLC that isn't loaded, it names the DLC. IPLs, interiors, static emitters and cutscenes are elevated only.
• World placements come in 34 groups (ATMs, gas pumps, vending machines, bus stops, jukeboxes, seats, payphones, CCTV, fire hydrants and more). Each group lists the nearest placements first with distance and zone, up to Config.Search.MaxPlaces (300). Pick one and preview it to go there.
• A teleport fades out, waits for the world to load (Config.Preview.LoadTimeout, 10 s) and fades in. If you're driving, your vehicle comes along. A landing more than 30 m off target is reported. Your starting point is remembered, except when /gdb waypoint moves you.
• Audio covers sounds, radio stations (sit in a vehicle first, your station comes back), music events, audio scenes, script, ambient and mission audio banks, police reports, mission-complete jingles and alarms.
• A speech line plays on a mannequin with that voice. A voice shows its first 300 lines as chips.
• A static emitter preview turns that world sound off so you can hear the difference, then back on. Cutscenes load and play.
• The dock buttons turn a spawned prop or vehicle 15 degrees left or right, and Closer and Further move it toward you or away from you, between Config.Preview.ZoomMin (1 m) and Config.Preview.ZoomMax (12 m).
• Esc leaves the preview running and tells you how to clear it (Config.Preview.KeepOnClose, default on). Your keys don't move your character while the browser is open unless you set Config.Preview.KeepInput = true.
• Every preview records what it spawned and loaded: entities, models, particles, animation dictionaries, clipsets, weapon assets, IPLs, interiors, audio banks, screen effects, timecycle and your own model. All of it is removed when you switch entries, stop, or the resource stops.

Stop all and teleport commands#

• The Stop all button, Delete in the browser or /gdb stopall ends every preview, effect, filter and the demo on your client. For an elevated user the stop goes to every player on the server, the server checks the permission first, and everyone gets a notice. The server console command gdbstopall does the same.
• /gdb waypoint takes you to your map waypoint on solid ground.
• /gdb back takes you back to where the first teleporting preview moved you from (/gdb waypoint doesn't count).

Picks and favorites#

• T, Alt+T or /gdb take adds the entry to your session picks and prints "category: name" to chat and the F8 console. The Picks tab shows them newest first, and you can remove one or clear them. Switches and limits are in Config.Picks (200 per session).
• F or Alt+F stars an entry. Favorites are saved on the server against your license in favorites.json in the resource folder, up to Config.Picks.MaxFavorites (500). No database.

Permissions#

• There are two levels. browse (ncore_devkit.browse) opens the browser. elevated (ncore_devkit.elevated) adds the gated categories and the server-wide Stop all. elevated does not include browse through ACE, so give both.
• ACE is the default. You can also put identifiers in Config.Permissions.Identifiers (browse) and Config.Permissions.ElevatedIdentifiers (elevated and browse), no ACE needed.
• On ESX the player's group, on QBCore and QBox the job name is compared with Config.Permissions.Groups (admin, superadmin). A match gives browse only, never elevated. Start ncore_devkit after your framework, the framework is detected once at start.
• Permissions are checked when the player joins, and again when ESX or QBCore reports the character as loaded. Any other change applies after a rejoin or a restart of the resource.
• The elevated gates are weapons, weapon components, explosions, IPLs, interiors, cutscenes and static emitters. Each gate can be turned off in Config.Elevated.
• Favorites, Stop all and report requests are each limited per player, 20 per 10 seconds (Config.RateLimit). Favorites are checked and capped on the server before they're saved.
• A player without access who presses F10 is told which ACE line an admin has to add.
• With Config.Dev.Enabled and Config.Dev.BypassPermissions both on, everyone has full access. That's for a dev server only, and the server prints a warning while it's on.

Tools for you#

• /gdb report writes reports/report_<time>_<id>.txt on the server with version, framework, permissions, the active preview, cleanup counters and recent log lines. Switch and size are in Config.Report.
• /gdb debug or /gdbdebug shows a debug overlay with index size, categories, your permissions, the active preview, cleanup counters and the last log lines. It only runs while it's visible. You can bind a key with Config.Keybind.Debug (unbound by default).
• /gdb demo previews a list of entries one after another, made for recording videos. /gdb demo <category> runs only that category's steps. The 8 default steps are in Config.Demo.Tour (category, name, hold in ms, optional clip and asset). Stop all ends it.
• With Config.Notify.Provider = 'auto' notifications try ncore_hud, then ox_lib, then GTA's own feed. A provider that fails is skipped from then on, and /gdb notifyreset tries it again. Other values: ncore_hud, ox_lib, builtin.
• The panel scales itself on tall screens or uses Config.Ui.Scale. Ten colors can be changed in Config.Ui.Theme. It respects reduced motion.
• Fonts and icons ship with the resource. The panel loads nothing from the internet.
• In-game messages, help and key descriptions come from locales/en.lua, with English as the fallback. The browser panel text is English.
• A setting missing from your config gets its default.
• Config.Debug = true prints extra lines to the console. Warnings always print.
• While the browser is open it sets LocalPlayer.state.lrNuiOwner, so other nCore panels (ncore_hud, ncore_vibehud) know it owns the mouse and keyboard.
• The data loads the first time you open the browser. While it's closed and nothing is previewed, no Lua thread runs.

For developers#

-- client or server
local hits = exports.ncore_devkit:Search('bench', { category = 'objects', limit = 5 })
for _, record in ipairs(hits) do print(record.name) end

local bench = exports.ncore_devkit:Lookup('objects', 'prop_bench_01a')
print(exports.ncore_devkit:GetSnippet(bench))

-- client only
exports.ncore_devkit:OpenBrowser('bench')

The exports work the same in the Escrow and the Full source edition.

Weapon component entries carry their attach bone, type and default flag. 155 of them are liveries for 13 weapons.

tools/ has offline Lua tools that add weapon bones and Mk II liveries to the index from a public dump pinned to one commit and checked by sha256. You don't need them to run the script. They need Lua 5.4 and curl or wget.

Requirements#

• OneSync.
• Optional: ncore_hud or ox_lib for notifications (GTA's own feed works without them). A chat resource that listens to chat:addMessage (the standard chat or ncore_chat) for the chat lines of picks and /gdb help.
• No framework, no database. ESX, QBCore or QBox are only used for the group or job check.
• The data is from game build 3717. On a server with a lower sv_enforceGameBuild, entries from newer DLCs can't be previewed, and the panel says the model isn't valid on this build.

Keys and commands#

The command name comes from Config.Command (gdb). Change it and every command above changes with it.

Where to configure#

Config.Framework (auto, esx, qb, qbox, standalone) only feeds the group check in Config.Permissions.Groups. Use ACE or the identifier lists for access.

A few settings the sections above don't name:

In the escrow edition these files stay readable and editable, and so does the browser panel in web/.

Troubleshooting#

Docs#

• INSTALLATION.md - setup step by step.
• CHANGELOG.md - what changed in each version, and how to update.

Editions#

Escrow and Full source have the same features and the same updates. In the escrow edition the Lua code is encrypted by Cfx.re and runs with your Cfx.re account's server key. Config, locale, bridge, snippet and tool files stay editable in both. Full source gives you all the code.

Support#

Support is on intelnpc.com and I reply within 72 hours. It covers installing, configuring and bugs in the script as shipped. Payments and refunds are handled by Tebex under their terms. Send your server build, the console error, the file from /gdb report if you can, and your Tebex transaction ID.

nCore DevKit is made by nCore Development. It is not approved, sponsored or endorsed by Rockstar Games.