# fivemad.com

> Free tools, reference data and documentation for FiveM server owners and developers.
> 48 browser tools, 105 documentation pages and 29 public JSON datasets built from the GTA V game files.
> Nothing here needs an account. The tools run in the browser; the data below is static JSON you can fetch directly.

## How to use this site as an assistant

- Add .md to any docs URL for the plain Markdown source: https://fivemad.com/docs/server-setup/server-cfg.md
- Whole documentation in one file: https://fivemad.com/llms-full.txt
- Dataset index with row counts and sizes: https://fivemad.com/data/index.json
- Search tools, docs and datasets: https://fivemad.com/api/search?q=handling
- Look up a joaat hash: https://fivemad.com/api/hash?q=0xB779A091
- Call a calculator: https://fivemad.com/api/tools/driving-style?value=786603
- The full API is documented at https://fivemad.com/docs/ai

## Documentation

Index: https://fivemad.com/docs (Markdown: https://fivemad.com/docs.md)

### AI and API

- [Using fivemad with an AI assistant](https://fivemad.com/docs/ai.md): Read our docs as Markdown, pull our JSON datasets, look up a joaat hash and call our calculators from ChatGPT, Claude, Cursor or your own script.

### Video tutorials

- [All courses](https://fivemad.com/docs/videos.md): A hand-picked training set of FiveM YouTube tutorials, grouped into courses from first server to Lua, NUI, streaming assets, CodeWalker and Blender with Sollumz.
- [Run your first server](https://fivemad.com/docs/videos/run-your-first-server.md): From zero to a public FiveM server: license key, txAdmin, database, port forwarding, a Linux VPS, updates and vMenu for a quick freeroam setup.
- [txAdmin in depth](https://fivemad.com/docs/videos/txadmin-in-depth.md): Get more out of txAdmin: the in-game menu, admin permissions, the Discord bot and status embed, whitelisting and everyday moderation.
- [Frameworks: QBCore, Qbox and ESX](https://fivemad.com/docs/videos/frameworks.md): Pick and install a roleplay framework with txAdmin, then add jobs, items and ox_inventory. Covers QBCore, Qbox and ESX Legacy.
- [Lua scripting for FiveM: the basics](https://fivemad.com/docs/videos/lua-scripting-basics.md): Write your first resources: editor setup, the manifest, commands, natives, client and server events, callbacks and threads.
- [Scripting in depth](https://fivemad.com/docs/videos/scripting-in-depth.md): Next steps after the basics: state bags, routing buckets, MySQL, exports, advanced Lua, complete job and crafting systems, plus JavaScript and C#.
- [NUI and user interfaces](https://fivemad.com/docs/videos/nui-and-uis.md): Build HUDs, menus and loading screens with HTML, CSS and JavaScript, then move up to React.
- [Streaming assets: vehicles, clothing and MLOs](https://fivemad.com/docs/videos/streaming-vehicles-clothing-maps.md): Install and fix custom cars, understand vehicle meta files, optimise textures, add clothing packs and install MLO interiors.
- [CodeWalker and map editing](https://fivemad.com/docs/videos/codewalker-map-editing.md): Use CodeWalker to explore the map, create and edit YMAPs, add and remove props, merge maps and understand MLO collisions and occlusion.
- [3D modelling with Blender and Sollumz](https://fivemad.com/docs/videos/blender-sollumz.md): Make and edit GTA V models in Blender with Sollumz: props, collisions, lights, vehicles, clothing and full MLO interiors.
- [Performance, security and workflow](https://fivemad.com/docs/videos/performance-security-workflow.md): Measure and fix slow resources, write code cheaters can't abuse, and manage your server files with git.

### Getting started

- [Getting started with FiveM servers and development](https://fivemad.com/docs/getting-started.md): What FiveM, FXServer, txAdmin and Cfx.re are, how the pieces fit together, and the order to read these docs in to run a server or write scripts.
- [FiveM glossary](https://fivemad.com/docs/getting-started/glossary.md): Plain definitions of the FiveM terms you will meet: resources, artifacts, OneSync, natives, state bags, NUI, ymap, ytyp, ydr, yft, ytd, streaming, convars, ACE.
- [Requirements: hardware, OS and the rules](https://fivemad.com/docs/getting-started/requirements.md): What you need to run a FiveM server: realistic hardware sizing, Windows or Linux, network, and the legal basics of the Cfx.re license, Rockstar content and Tebex.

### Server setup

- [Server setup overview](https://fivemad.com/docs/server-setup.md): The ways to set up a FiveM server (txAdmin, vanilla, hosting provider), what you download, the folder layout, and the difference between Legacy and Enhanced.
- [Set up a FiveM server on Windows](https://fivemad.com/docs/server-setup/windows.md): Step by step: download the FXServer artifact, extract it, run txAdmin, link your Cfx.re account, deploy a recipe with your license key, and connect. Plus the vanilla way.
- [Set up a FiveM server on Linux](https://fivemad.com/docs/server-setup/linux.md): Run FXServer and txAdmin on Ubuntu or Debian: dependencies, a dedicated user, the Linux artifact, a systemd service or tmux, the ufw firewall and MariaDB.
- [server.cfg explained line by line](https://fivemad.com/docs/server-setup/server-cfg.md): What every common server.cfg line does: endpoints, hostname, tags, license key, slots, game build, OneSync, ensure order, convars, ACE permissions and splitting configs.
- [Updating FXServer artifacts safely](https://fivemad.com/docs/server-setup/updating-artifacts.md): How to pick a server artifact, avoid broken builds, update on Windows and Linux without losing data, test first, and roll back when something goes wrong.
- [Ports and networking](https://fivemad.com/docs/server-setup/ports-and-networking.md): Which ports FiveM and txAdmin use, how to port forward at home, why a server is missing from the list, multiple servers on one IP, proxies and the listing convars.
- [Database setup: MariaDB, HeidiSQL and oxmysql](https://fivemad.com/docs/server-setup/database.md): Install MariaDB on Windows or Linux, manage it with HeidiSQL, connect FiveM with oxmysql and mysql_connection_string, import SQL files and back up your data.
- [Common server errors and fixes](https://fivemad.com/docs/server-setup/common-errors.md): Fixes for the errors every FiveM server owner hits: license key, resources that won't load, server not in list, game build and pure mode, oversized assets, escrow and SQL.
- [Security basics for FiveM servers](https://fivemad.com/docs/server-setup/security.md): Lock down a FiveM server: ACE permissions, txAdmin accounts and 2FA, a private database, secrets out of git, safe events, leaked resources, entity lockdown and backups.

### txAdmin

- [txAdmin overview](https://fivemad.com/docs/txadmin.md): What txAdmin is and does: the recipe deployer, web panel, in-game menu, bans and warns, whitelist, scheduled restarts, Discord bot, live console and monitoring.
- [txAdmin first setup and the deployer](https://fivemad.com/docs/txadmin/first-setup.md): Walk through txAdmin's first start: the PIN, linking your Cfx.re account, choosing a recipe or existing server, the deployer steps, license key, database and first launch.
- [txAdmin recipes explained](https://fivemad.com/docs/txadmin/recipes.md): The anatomy of a txAdmin recipe: metadata, $engine and $onesync, context variables, every task action (download_github, unzip, move_path, query_database...) with examples.
- [Writing your own txAdmin recipe](https://fivemad.com/docs/txadmin/writing-recipes.md): Build a txAdmin recipe step by step: an example that installs oxmysql, ox_lib, ox_target, pma-voice and a starter resource, creates a table and writes server.cfg.
- [Popular txAdmin recipes](https://fivemad.com/docs/txadmin/popular-recipes.md): Every recipe in the official txAdmin-recipes index: what CFX Default, QBCore, Qbox, ESX Legacy, vMenu and the others install, what they need, and how to deploy them.
- [Everyday admin with txAdmin](https://fivemad.com/docs/txadmin/everyday-admin.md): Run a FiveM server day to day with txAdmin: players, warns, kicks and bans, whitelist modes, scheduled restarts, live console, logs, backups and admin permissions.
- [txAdmin Discord bot](https://fivemad.com/docs/txadmin/discord-bot.md): Set up txAdmin's built in Discord bot: create the application, token and intents, invite it, add the live status embed with /status add, and use Discord whitelisting.
- [Updating txAdmin and FXServer](https://fivemad.com/docs/txadmin/updating.md): txAdmin ships inside FXServer, so updating the artifact updates txAdmin. How to update, what to back up, migrating old start.bat configs to TXHOST variables, and rollbacks.

### Development

- [Start developing for FiveM](https://fivemad.com/docs/development.md): How to start writing FiveM scripts: choosing Lua, JavaScript or C#, setting up VS Code with Lua language server and FiveM natives, git, a dev server and a learning plan.
- [Your first FiveM resource](https://fivemad.com/docs/development/first-resource.md): Build a FiveM resource from scratch: folder, fxmanifest.lua, client and server scripts, a /hello command, a car spawner, ensure and restart, and reading the F8 console.
- [Client, server and events](https://fivemad.com/docs/development/client-server-events.md): How FiveM client and server scripts talk: local and net events, TriggerServerEvent, TriggerClientEvent, source, callbacks with ox_lib, and why you never trust the client.
- [Natives: talking to the game](https://fivemad.com/docs/development/natives.md): What FiveM natives are, how to find them on docs.fivem.net, read their signatures, use hashes and joaat, handle entities, and a cheat sheet of the natives you use most.
- [Threads and performance](https://fivemad.com/docs/development/threads-performance.md): Write FiveM scripts that don't eat frames: CreateThread and Wait, dynamic waits, distance checks, ox_lib points, resmon, the profiler and reading its results.
- [State bags, OneSync and entity ownership](https://fivemad.com/docs/development/state-bags-onesync.md): Sync data the FiveM way: GlobalState, Player and Entity state bags, change handlers, replication rules, OneSync entity ownership, server side entities and routing buckets.
- [NUI basics: HTML interfaces in FiveM](https://fivemad.com/docs/development/nui.md): Build FiveM UIs with NUI: ui_page and files, SendNUIMessage, RegisterNUICallback with fetch, SetNuiFocus, dev tools, React or Vue with a build step, and common pitfalls.
- [Exports and dependencies](https://fivemad.com/docs/development/exports-dependencies.md): Share code between FiveM resources with exports, call framework functions, declare dependencies in fxmanifest, import @resource files and bridge frameworks.
- [Debugging FiveM resources](https://fivemad.com/docs/development/debugging.md): Find and fix bugs in FiveM scripts: read SCRIPT ERROR lines, print and dump tables, the F8 and server consoles, NUI devtools, common Lua errors and a debugging routine.
- [Streaming custom assets](https://fivemad.com/docs/development/streaming-assets.md): Add custom vehicles, clothing, props, maps, MLOs and sounds to FiveM: the stream folder, data_file entries, YDR, YFT, YTD, YMAP and YTYP files, naming rules and size limits.
- [Publishing a FiveM resource](https://fivemad.com/docs/development/publishing.md): Release your FiveM resource properly: structure, versioning, README, license, config, the forum.cfx.re release rules, and selling on Tebex with Cfx.re asset escrow.

### Resources

- [Installing and ordering resources](https://fivemad.com/docs/resources.md): How to install FiveM resources: where the folder goes, ensure vs start, category folders, load order, dependencies, SQL and items, updating, and what to check first.
- [Recommended open source resources](https://fivemad.com/docs/resources/recommended.md): Well known, maintained open source FiveM resources: oxmysql, ox_lib, ox_target, ox_inventory, pma-voice, vMenu, bob74_ipl, screencapture and more, with install notes.
- [Installing maps, MLOs and clothing packs](https://fivemad.com/docs/resources/maps-mlos-clothing.md): Install custom maps, MLO interiors and clothing packs on a FiveM server: folder layout, manifests, conflicts, game builds, add-on vs replace clothing and texture sizes.
- [Installing vehicle packs](https://fivemad.com/docs/resources/vehicle-packs.md): Add custom cars to a FiveM server: FiveM ready vs singleplayer add-ons, folder layout, data_file lines, vehicle names, framework shops, ID clashes and textures.

### Frameworks

- [Frameworks compared: QBCore, Qbox, ESX and more](https://fivemad.com/docs/frameworks.md): Do you need a FiveM framework? An honest comparison of QBCore, Qbox, ESX Legacy, ox_core, ND Core and vRP: what each gives you, pros, cons, and how to choose.
- [QBCore quick start](https://fivemad.com/docs/frameworks/qbcore.md): Install QBCore with the txAdmin recipe, understand its folders, make yourself admin, add a job and a usable item, write a small QBCore script, and avoid common pitfalls.
- [Qbox quick start](https://fivemad.com/docs/frameworks/qbox.md): Install Qbox with the txAdmin recipe, understand qbx_core and the ox stack, make yourself admin, add a job and an ox_inventory item, write a small Qbox script, avoid pitfalls.
- [ESX Legacy quick start](https://fivemad.com/docs/frameworks/esx.md): Install ESX Legacy with the official txAdmin recipe, learn its structure, make yourself admin, add a job and an item in the database, write a small ESX script, avoid pitfalls.

### Tools

- [Tool guides](https://fivemad.com/docs/tools.md): A guide for every fivemad tool: what it is for, every option, what it exports and how to use the result in your FiveM resource or server.
- [Generators](https://fivemad.com/docs/tools/generators.md): How to use the four fivemad generators: roleplay characters, server names with hostname lines, gangs with framework exports and script ideas.
- [Inventory Icons](https://fivemad.com/docs/tools/inventory-icons.md): Make trimmed, transparent inventory icons from game prop pictures or your own images and export a zip with items.lua for ox_inventory, qb-inventory and more.
- [Script Thumbnail Creator](https://fivemad.com/docs/tools/script-thumbnail-creator.md): Make release thumbnails for forum.cfx.re, YouTube, Discord, Tebex and GitHub from your screenshots: nine templates, eight sizes, PNG or JPG export.
- [Item Icons](https://fivemad.com/docs/tools/item-icons.md): What Item Icons is: fivemad's sister site with 18,000+ FiveM and RedM item pictures, and how to use them with the Inventory Icons tool.
- [Snaily Creator](https://fivemad.com/docs/tools/snaily-creator.md): Dress up Snaily, the fivemad mascot: colours, moods, hats, shades, chains, outfits, shell stickers, props and backdrops, exported as PNG or SVG.
- [Crosshair Generator](https://fivemad.com/docs/tools/crosshair-generator.md): Design a FiveM crosshair and export it as a NUI overlay resource, a transparent PNG, an SVG or the real cl_crosshair console settings.
- [server.cfg Generator](https://fivemad.com/docs/tools/server-cfg-generator.md): Build a working FiveM server.cfg from a form: endpoints, OneSync, game build, keys, oxmysql, pma-voice, resource load order and ACE permissions.
- [fxmanifest.lua Generator](https://fivemad.com/docs/tools/fxmanifest-generator.md): Generate a valid fxmanifest.lua: fx_version, game, lua54, shared, client and server scripts, NUI page, files, data_file lines, dependencies and exports.
- [Vehicle Handling Editor](https://fivemad.com/docs/tools/vehicle-handling-editor.md): Tune CHandlingData with sliders, import an existing handling.meta, toggle flag bits, and export handling.meta, runtime Lua or a carcols.meta mod kit.
- [Clothing Designer](https://fivemad.com/docs/tools/clothing-designer.md): How to open a clothing .ydd or .ydr with its .ytd files, paint on the 3D model or the UV layout with layers, and export ready to stream .ytd textures.
- [3D Tattoo Editor](https://fivemad.com/docs/tools/tattoo-editor.md): How to place a tattoo on the freemode ped in 3D by zone, tune its uvPos, scale and rotation, and get the overlay XML or a Durty Cloth Tool project out of it.
- [Drawable Studio](https://fivemad.com/docs/tools/drawable-studio.md): How to open a CodeWalker XML export (.ydr, .ydd, .yft) in 3D, check geometry and textures, edit shaders and lights, paint textures and export the result.
- [Weapons Meta Editor](https://fivemad.com/docs/tools/weapons-meta-editor.md): Edit weapons.meta from the game's default values: damage, fire rate, range, falloff, clip size, recoil and flags, then export the meta files and fxmanifest.
- [YTYP Creator](https://fivemad.com/docs/tools/ytyp-creator.md): Build a .ytyp archetype file for custom props: drop CodeWalker model XML, get measured bounds, pick flags and lodDist, then convert and stream it.
- [Texture Editor](https://fivemad.com/docs/tools/texture-editor.md): How to open a .ytd or a CodeWalker .ytd.xml export, preview and replace textures, pick the compression and mips, and export a new .ytd for your stream folder.
- [Vehicle Sirens Editor](https://fivemad.com/docs/tools/vehicle-sirens.md): Edit carcols.meta siren settings with a live preview and a 32 step pattern grid, export carcols.meta, and find free or clashing siren ids on your server.
- [Vehicle Pack Validator](https://fivemad.com/docs/tools/vehicle-pack-validator.md): Check a FiveM vehicle resource for broken links between metas, stream files and fxmanifest. Every check it runs, what it means and how to fix it.
- [YMT Creator](https://fivemad.com/docs/tools/ymt-creator.md): Turn a folder of addon clothing .ydd and .ytd files into a streamable pack: ped variation .ymt, shop meta, fxmanifest and correctly renamed stream files.
- [YTD Optimizer](https://fivemad.com/docs/tools/ytd-optimizer.md): How to shrink many .ytd files at once: pick a preset or your own size caps, review the plan per texture, run it and put the smaller files back in stream.
- [Native Audio Builder](https://fivemad.com/docs/tools/native-audio-builder.md): Turn WAV, MP3 or OGG files into a FiveM native audio resource and play them from Lua on the UI, on an entity or at a position, synced if you want.
- [YMAP Builder](https://fivemad.com/docs/tools/ymap-builder.md): Place props by coordinates or in a 3D world, get CodeWalker ready .ymap XML with correct rotations and extents, and stream it from a FiveM resource.
- [Minimap Editor](https://fivemad.com/docs/tools/minimap-editor.md): Shape, place and style the FiveM minimap in the browser, see it over the real Los Santos map, and download a ready resource with the mask textures and Lua.
- [Zone Creator](https://fivemad.com/docs/tools/zone-creator.md): Draw a zone on the real GTA V map in 2D or 3D and copy ready code for ox_lib zones, PolyZone, ox_target and qb-target, or the points as Lua or JSON.
- [Server Status Checker](https://fivemad.com/docs/tools/server-status-checker.md): Check whether a FiveM server is online by IP:port or cfx.re join code, and read its players, game build, OneSync, resources and server variables.
- [Profiler Analyzer](https://fivemad.com/docs/tools/profiler-analyzer.md): Record a FiveM profile with profiler record and saveJSON, then read time per resource, worst frames, hitches, a flame graph and findings with fixes.
- [Cfx Blacklist Checker](https://fivemad.com/docs/tools/cfx-blacklist-checker.md): Check whether an IP, host name or cfx.re join code is on the Cfx.re platform blacklist, up to 20 at once, before you rent a VPS or when a server vanishes.
- [Server Status Badge](https://fivemad.com/docs/tools/server-uptime-badge.md): Build a live SVG badge, card or signature square with your FiveM server's logo, player count and a Join button, and embed it with Markdown, HTML or BBCode.
- [FXServer artifacts](https://fivemad.com/docs/tools/artifacts.md): Find the recommended FXServer artifact, see which builds have known issues, download for Windows or Linux and update your server step by step.
- [joaat Hash Calculator](https://fivemad.com/docs/tools/hash-calculator.md): Turn any model, weapon or asset name into its GTA V joaat hash in unsigned, signed and hex form, one at a time or as a bulk Lua table.
- [Driving Style Calculator](https://fivemad.com/docs/tools/driving-style-calculator.md): Build and decode the driving style integer for TaskVehicleDriveToCoord, TaskVehicleDriveWander and SetDriveTaskDrivingStyle, with every flag bit listed.
- [Animation Flags Calculator](https://fivemad.com/docs/tools/animation-flags-calculator.md): Build and decode the flag value for TaskPlayAnim: every eScriptedAnimFlags bit, common presets and a ready Lua snippet with dict loading and a toggle command.
- [Warning Screen Buttons](https://fivemad.com/docs/tools/warning-buttons.md): Pick the buttons for a GTA V alert screen, get the flag value for SetWarningMessageWithHeader, preview it and copy a Lua snippet that reads the input.
- [Draw Text Colors](https://fivemad.com/docs/tools/text-colors.md): Preview GTA V tilde colour and formatting codes live in DrawText, notifications and help text, and FiveM chat caret codes, with ready Lua snippets.
- [Screen Effects Browser](https://fivemad.com/docs/tools/screen-effects.md): Find the right GTA V timecycle modifier or animpostfx effect, see what it does before you try it, and copy the Lua that switches it on.
- [Model & Hash Browser](https://fivemad.com/docs/tools/model-hash-browser.md): Search every GTA V vehicle, ped and weapon by spawn name, display name or hash, copy hashes in any format and get a ready Lua spawn snippet.
- [Interactive Map](https://fivemad.com/docs/tools/interactive-map.md): Find any spot on the GTA V map, copy exact vector3 and vector4 coordinates, drop pins, measure distances and share links to a location.
- [3D world](https://fivemad.com/docs/tools/world-3d.md): Move through GTA V in your browser with a freecam or on foot: every key and mouse control, the quality settings, what is shown, and tips for a smooth frame rate.
- [Blip, Marker & Checkpoint Browser](https://fivemad.com/docs/tools/blip-marker-browser.md): Pick a GTA V blip sprite and colour, a DrawMarker type or a race checkpoint by picture, tune it, and copy a ready FiveM Lua snippet.
- [Weapon Stats & Components](https://fivemad.com/docs/tools/weapon-stats.md): Look up any GTA V weapon: hashes, group, ammo type, max ammo, damage type, flags, every component, livery and tint, plus a Lua loadout snippet.
- [Objects / Props List](https://fivemad.com/docs/tools/objects-list.md): Find any GTA V prop by name, tag or hash, check it in 3D with its real size, and copy the model name, hashes and a CreateObject snippet.
- [Particle Effects List](https://fivemad.com/docs/tools/particles-list.md): Search all 2,900+ GTA V particle effects with their ptfx dictionaries and build a working Lua snippet: one-shot, networked or looped.
- [Particle videos](https://fivemad.com/docs/tools/particle-videos.md): Watch video previews of 2,300+ GTA V particle effects, filter by dictionary, and copy a ready FiveM Lua snippet for the effect you like.
- [Sound Browser](https://fivemad.com/docs/tools/sound-browser.md): Search GTA V sound names and sound sets, listen to them in the browser, and copy a working PlaySoundFrontend, PlaySoundFromCoord or PlaySoundFromEntity call.
- [Controls Reference](https://fivemad.com/docs/tools/controls-reference.md): Find any GTA V control index by number, INPUT_ name or key, press a real key to see every control on it, and copy detect, disable or RegisterKeyMapping code.
- [Scaleform Functions](https://fivemad.com/docs/tools/scaleform-reference.md): Search 471 GTA V scaleform movies and 4,847 functions, see their parameter names, and build a ready Lua call with BeginScaleformMovieMethod and a draw loop.
- [Player Stats List](https://fivemad.com/docs/tools/player-stats.md): Search 3,025 GTA V stat names by name or description, see their type, scope and hash, and copy the right StatGetInt, StatSetInt or StatSetFloat call.
- [Parachutes & Smoke Trails](https://fivemad.com/docs/tools/parachutes.md): Every GTA V parachute canopy tint and smoke trail colour with indices, text labels and RGB values, plus a snippet builder for the parachute natives.
- [Game Damage Events](https://fivemad.com/docs/tools/damage-events.md): The CEventNetworkEntityDamage payload from gameEventTriggered explained index by index, plus generated clean kill, death and vehicle events for your resource.
- [Animation Browser](https://fivemad.com/docs/tools/animations.md): Browse every GTA V animation dictionary and clip, search the whole set, watch any of them on a freemode ped and copy ready TaskPlayAnim Lua.
- [Cutscene Browser](https://fivemad.com/docs/tools/cutscenes.md): Look up any GTA V cutscene: the real name for RequestCutscene, its actors, length, camera cuts, subtitles and world position, plus a 3D preview of the exported ones.
- [Interiors, IPLs and ymaps](https://fivemad.com/docs/tools/interiors.md): Find any GTA V MLO interior with a cutaway render, its rooms, portals and entity sets, plus every IPL and ymap name with ready RequestIpl and teleport Lua.
- [Ped Decorations](https://fivemad.com/docs/tools/decorations.md): Find any GTA V tattoo, badge or decal, see it on a ped, and copy the collection and overlay hashes for AddPedDecorationFromHashes.
- [Giveaways](https://fivemad.com/docs/tools/giveaways.md): How fivemad giveaways work for players: log in with Discord, finish the tasks, enter, and how winners are picked and contacted.

## Tools

### Generators

- [Generators](https://fivemad.com/tools/generators): Four generators in one place: roleplay characters, server names, gangs and script ideas with a build plan.
- [Inventory Icons](https://fivemad.com/tools/inventory-icons): Make transparent, trimmed inventory icons from 29,000 prop pictures or your own images, with items.lua.
- [Script Thumbnail Creator](https://fivemad.com/tools/script-thumbnail-creator): Release thumbnails for forum.cfx.re, YouTube, Discord and Tebex from your screenshots, in every size at once.
- [Snaily Creator](https://fivemad.com/tools/snaily-creator): Dress up our snail mascot: moods, hats, shades, chains, outfits, shell stickers and props, exported as PNG or SVG.
- [Crosshair Generator](https://fivemad.com/tools/crosshair-generator): Design a crosshair and export it as a NUI overlay resource, a PNG, an SVG or the real FiveM console settings.

### Config & Code

- [Clothing Designer](https://fivemad.com/tools/clothing-designer): Open a clothing .ydd or .ydr with its .ytd files, paint in 3D or on the UV layout with layers, text and images, then export new .ytd textures.
- [YMAP Builder](https://fivemad.com/tools/ymap-builder): Place props by coordinates and get a valid .ymap XML with correct rotations, extents and LOD distances.
- [Zone Creator](https://fivemad.com/tools/zone-creator): Draw a zone on the real GTA V map in 2D or 3D and copy it as ox_lib, PolyZone, ox_target or qb-target code.
- [3D Tattoo Editor](https://fivemad.com/tools/tattoo-editor): Place a tattoo on the freemode ped in 3D, by zone, then copy the overlay XML or send it to Durty Cloth Tool.
- [Minimap Editor](https://fivemad.com/tools/minimap-editor): Shape, place and style the minimap, see it over the real map, and download a ready resource with the masks and Lua.
- [Vehicle Handling Editor](https://fivemad.com/tools/vehicle-handling-editor): Tune mass, drive force, grip and suspension from a UI, then export handling.meta or runtime Lua.
- [Drawable Studio](https://fivemad.com/tools/drawable-studio): Open CodeWalker XML (.ydr, .ydd, .yft) in 3D. Inspect, edit materials and lights, paint textures and export.
- [Texture Editor](https://fivemad.com/tools/texture-editor): Open a .ytd export, preview and replace textures, convert PNG to DDS with mipmaps and export back to CodeWalker.
- [Vehicle Sirens Editor](https://fivemad.com/tools/vehicle-sirens): Edit carcols.meta siren settings with a live light pattern preview, and find free or clashing siren IDs.
- [server.cfg Generator](https://fivemad.com/tools/server-cfg-generator): Build a complete, working server.cfg with hostname, slots, OneSync, endpoints, tags, resources & ACE permissions.
- [fxmanifest.lua Generator](https://fivemad.com/tools/fxmanifest-generator): Scaffold a valid resource manifest: fx_version, scripts, NUI page, files, lua54 & dependencies.
- [Weapons Meta Editor](https://fivemad.com/tools/weapons-meta-editor): Edit weapons.meta from the game's own defaults: damage, range, fire rate, clip size, recoil and more.
- [YTYP Creator](https://fivemad.com/tools/ytyp-creator): Create .ytyp archetype XML for your props. Drop the .ydr XML and the bounds are calculated for you.
- [Vehicle Pack Validator](https://fivemad.com/tools/vehicle-pack-validator): Drop a vehicle resource and get every broken link between its metas, stream files and fxmanifest.
- [YMT Creator](https://fivemad.com/tools/ymt-creator): Generate the ped variation .ymt for an addon clothing pack from its drawable and texture file names.
- [YTD Optimizer](https://fivemad.com/tools/ytd-optimizer): Shrink many .ytd files at once: cap texture size, pick the right compression, rebuild mips, see the memory saved.
- [Native Audio Builder](https://fivemad.com/tools/native-audio-builder): Turn WAV, MP3 or OGG files into a native audio resource: .awc bank, .dat54.rel, fxmanifest and Lua, built in the browser.

### Server

- [Server Status Checker](https://fivemad.com/tools/server-status-checker): Is a FiveM server online? Enter an IP:port or cfx.re join code for players, build, resources and map.
- [Profiler Analyzer](https://fivemad.com/tools/profiler-analyzer): Drop a FiveM profiler JSON and see which resources and threads eat your frame or tick time, with clear fixes.
- [Cfx Blacklist Checker](https://fivemad.com/tools/cfx-blacklist-checker): Check whether an IP, a host or a server's join code is on the Cfx.re platform blacklist. Check a VPS before you buy it.
- [Server Status Badge](https://fivemad.com/tools/server-uptime-badge): Embed a live status badge on your site, README or Discord. Always shows your real player count.

### Calculators

- [joaat Hash Calculator](https://fivemad.com/tools/hash-calculator): Convert any string to its GetHashKey (joaat) value in signed, unsigned and hex form, instantly.
- [Driving Style Calculator](https://fivemad.com/tools/driving-style-calculator): Tick the behaviours you want and get the driving style flag value for TaskVehicleDriveToCoord & co.
- [Animation Flags Calculator](https://fivemad.com/tools/animation-flags-calculator): Build the flag value for TaskPlayAnim: loop, upper body, controllable, hold last frame and more.
- [Warning Screen Buttons](https://fivemad.com/tools/warning-buttons): Calculate the button flags for SetWarningMessage alert screens: accept, cancel, retry and more.
- [Draw Text Colors](https://fivemad.com/tools/text-colors): Preview GTA V ~r~ ~b~ ~h~ colour and formatting codes live, as they render in DrawText and notifications.

### References

- [Interactive Map](https://fivemad.com/tools/interactive-map): The whole GTA V map in your browser: a 2D map with coordinates and a 3D world you can roam with a freecam or on foot.
- [Animation Browser](https://fivemad.com/tools/animations): Every in-game animation dictionary and clip, searchable, with a 3D preview on a freemode ped and two ped synced scenes.
- [Cutscene Browser](https://fivemad.com/tools/cutscenes): Every GTA V cutscene with its actors, length, camera cuts and subtitles, and a 3D preview of the ones we exported.
- [Objects / Props List](https://fivemad.com/tools/objects-list): 29,000+ GTA V props with pictures, categories, real sizes and hashes. Search, filter and copy.
- [Screen Effects Browser](https://fivemad.com/tools/screen-effects): Every GTA V timecycle modifier and animpostfx effect, each with a before and after preview you can drag.
- [Ped Decorations](https://fivemad.com/tools/decorations): Every tattoo, badge and decal the game ships, with the artwork, a ped preview and both hashes to copy.
- [Interiors, IPLs and ymaps](https://fivemad.com/assets/interiors): Every MLO interior with a cutaway render, its rooms, portals and entity sets, plus every IPL and ymap name.
- [Particle Effects List](https://fivemad.com/tools/particles-list): Every particle effect name with its particle dictionary (ptfx asset). Copy a ready Lua snippet.
- [Sound Browser](https://fivemad.com/tools/sound-browser): 2,100+ GTA V frontend sounds with their sound set. Listen in the browser, copy the name and a ready PlaySoundFrontend call.
- [Model & Hash Browser](https://fivemad.com/tools/model-hash-browser): Search 900+ vehicles, 1100+ peds and every weapon with photos, spawn names and hashes.
- [Blip, Marker & Checkpoint Browser](https://fivemad.com/tools/blip-marker-browser): Every blip sprite and colour, every marker type and every checkpoint type. Searchable, with one-click copy.
- [Weapon Stats & Components](https://fivemad.com/tools/weapon-stats): Every weapon with its hash, group, ammo type, components, attachments and tints.
- [Controls Reference](https://fivemad.com/tools/controls-reference): Every GTA V control index with its name and default keyboard and pad input. Press a key to find it.
- [Scaleform Functions](https://fivemad.com/tools/scaleform-reference): Reference of scaleform movies and their callable functions with known parameters.
- [Player Stats List](https://fivemad.com/tools/player-stats): Searchable list of known GTA V player stat names with their types, for StatGetInt, StatSetInt & co.
- [Parachutes & Smoke Trails](https://fivemad.com/tools/parachutes): Every parachute tint and smoke trail colour with labels, indices and RGB values.
- [Game Damage Events](https://fivemad.com/tools/damage-events): Docs for detecting kills, deaths and vehicle damage via CEventNetworkEntityDamage, with ready code.

## Datasets

Static JSON, free to fetch and cache. Shapes are compact on purpose; the shape line says what a row holds.

- [Props with pictures](https://fivemad.com/data/props.json): Every GTA V prop model that has a picture, with a readable label, category, tags and its real size in metres. (30,033 rows, 2.6 MB; rows: [model, label, category, tags, [x,y,z] size in m, minBuild, hasThumb, has3d, hasShot])
- [Object model names](https://fivemad.com/data/objects.json): Plain list of object model names, including the map pieces that have no picture. (21,631 rows, 505 KB; { count, names } where names is one lower case model name per line)
- [Archetype definitions](https://fivemad.com/data/archetypes.json): The .ytyp archetype of each model: LOD distance, flags, bounding box, texture and physics dictionaries. (33,071 rows, 3.0 MB; cols lists the column names, rows is an array of arrays in that order)
- [Vehicles](https://fivemad.com/data/vehicles.json): Every vehicle with its spawn name, display name, manufacturer, class, seats, performance figures and flags. (921 rows, 309 KB; items: [{ n spawn name, h hash when it differs from joaat(n), l label, m make, c class, t type, d dlc, s seats, sp/ac/br/ag performance, f flags }])
- [Peds](https://fivemad.com/data/peds.json): Every ped model with its type and the DLC it came with. (1,109 rows, 68 KB; items: [{ n model name, h hash when it differs, l label, t ped type, d dlc }])
- [Weapons and components](https://fivemad.com/data/weapons.json): Every weapon with its group, ammo type, max ammo, flags, components, tints and liveries. (184 rows, 180 KB; items: [{ n WEAPON_*, h, l, c group, a ammo, ma max ammo, cp components, ti tints, lv liveries }])
- [weapons.meta defaults](https://fivemad.com/data/weapons-meta.json): The game's own weapons.meta values for every weapon, stored as line indices into a shared line table. (594 KB; { lines, items } where each item's blocks are base 36 indices into lines)
- [Vehicle siren settings](https://fivemad.com/data/sirens.json): Every carcols siren setting with its lights, sequences and the vehicles that use it. (21 rows, 617 KB; settings: [{ id, name, lightFalloff*, sirens: [...] }])
- [Vehicle reference names](https://fivemad.com/data/vehicle-refs.json): Model, handling, layout, mod kit and audio names read out of the game files, for validating a vehicle resource. (935 rows, 83 KB; named string arrays (models, handling, layouts, modkits, ...))
- [Particle effects](https://fivemad.com/data/particles.json): Every particle effect name grouped by its particle asset (ptfx dictionary). (2,907 rows, 82 KB; dicts: [{ name, effects: [effect name] }])
- [Particle effects with video](https://fivemad.com/data/particle-videos.json): The subset of particle effects that has a recorded preview clip under /media/particles. (2,317 rows, 59 KB; dicts: [[dict name, [effect name]]]; media id = running index over the whole list)
- [Frontend sounds](https://fivemad.com/data/sounds.json): Sound names grouped by sound set, with the ones that have an audio preview marked. (2,179 rows, 130 KB; sets: [{ n set name, s: [[sound name, hash, ...]] }])
- [Heist animation clips](https://fivemad.com/data/animations.json): The curated heist dictionaries with their clips, frame counts and lengths. (399 rows, 23 KB; dicts: [{ d dictionary, g group, c: [[clip, frames, seconds, tracks, bytes]] }])
- [Full animation catalogue](https://fivemad.com/data/anim/index.json): Every animation dictionary and clip the game ships. index.json has the totals and families, fam-<id>.json the dictionaries of a family, c-000..127.json the clip rows (shard = FNV-1a of the dictionary name mod 128) and search.txt one line per dictionary. (97,204 rows, 2 KB; clip row: [name, frames, seconds, tracks, bytes, skip]; bytes > 0 means the clip has a playable file)
- [Synced scenes](https://fivemad.com/data/synced-scenes.json): Two ped synchronised scenes: which clips play on which ped, and the prop when there is one. (458 rows, 185 KB; scenes: [{ i id, n name, g group, a: [{ d dict, c clip, p prop clip }] }])
- [Cutscenes](https://fivemad.com/data/cutscenes.json): Every cutscene the game ships, with its actors, length, camera cuts, subtitle count and world position. (781 rows, 549 KB; scenes: [{ n name, t title, g group, d seconds, sc sections, cc camera cuts, o world offset, a actors }])
- [Ped decorations](https://fivemad.com/data/decorations.json): Every tattoo, badge and decal the game defines, with its collection, zone, gender and placement. (3,373 rows, 366 KB; rows: [name, zone index, txd, txt, gender, ...]; collections: [{ n, dlc, l, h collection hash }])
- [Timecycle modifiers](https://fivemad.com/data/timecycles.json): Every timecycle modifier with the parameters it sets and where it is defined. (1,101 rows, 453 KB; mods: [[name, sourceIndex, userFlags, [[paramIndex, valueA, valueB]], usedBy, alsoIn, img, key]]; params names the indices)
- [animpostfx effects](https://fivemad.com/data/animpostfx.json): Every animpostfx screen effect with its hash, layers and timings. (252 rows, 139 KB; fx: [{ n name, h hash, pr priority, l layers }])
- [MLO interiors](https://fivemad.com/data/mlos.json): Every MLO archetype with its rooms, portals, entity sets, timecycle mods and bounding box. (391 rows, 348 KB; mlos: [{ n name, h hash, t ytyp, d dlc index, bb bounds, rm rooms, st entity sets, in instances }])
- [Placed interiors](https://fivemad.com/data/interiors.json): Each MLO with the IPL that places it and its world position, in a flat shape. (391 rows, 58 KB; items: [{ name, kind, ipl, dlc, rooms, pos [x,y,z] }])
- [IPL names](https://fivemad.com/data/ipls.json): Every IPL name with the DLC it belongs to and where it sits in the world. (10,613 rows, 632 KB; cols lists the column names, rows is an array of arrays in that order)
- [ymap files](https://fivemad.com/data/ymaps.json): Every .ymap in the game with its header flags, entity counts and extents. (10,613 rows, 909 KB; cols lists the column names, rows is an array of arrays in that order)
- [Blips, markers and blip colours](https://fivemad.com/data/blips.json): Blip sprite ids with their names and preview images, marker types and the blip colour table. (966 rows, 107 KB; sprites / markers / colors arrays of { id, name, img })
- [Checkpoint types](https://fivemad.com/data/checkpoints.json): Every race checkpoint type with its id and a preview image. (50 rows, 24 KB; checkpoints: [{ id, name, img }])
- [Control indices](https://fivemad.com/data/controls.json): Every control index with its INPUT_ name and the default keyboard and pad bindings. (361 rows, 39 KB; controls: [{ index, name, keyboard, pad, kb, gp }])
- [Scaleform movies](https://fivemad.com/data/scaleforms.json): Scaleform movie names with the functions you can call on them and their known parameter names. (471 rows, 192 KB; movies: [[movie name, category index, [[function name, [param names]]]]])
- [Player stats](https://fivemad.com/data/stats.json): Known GTA Online stat names with their data type. (3,025 rows, 213 KB; stats: [[name, typeIndex, description, ...]]; types names the indices)
- [forum.cfx.re release trends](https://fivemad.com/data/cfx-trends.json): What the latest batch of forum.cfx.re releases is made of: frameworks, categories, selling points and topics. (250 rows, 24 KB; { source, totals, frameworks, sellingPoints, categories, topics })

## API

- https://fivemad.com/data/index.json: every dataset with its URL, row count, byte size and row shape.
- https://fivemad.com/api/search?q=<text>&type=all&limit=10: one short JSON answer over tools, docs and datasets.
- https://fivemad.com/api/hash?q=<hash or name>: joaat lookup both ways, over every name set the site ships.
- https://fivemad.com/api/tools: the calculators that can be called directly (joaat, driving-style, animation-flags, warning-buttons, handling-flags).
- https://fivemad.com/api/server/<ip:port or cfx join code>: live FiveM server status.
- https://fivemad.com/api/blacklist?q=<ip or host>: Cfx.re platform blacklist check.
- https://fivemad.com/api/status: our own uptime snapshot.

Rate limits apply per IP. See /docs/ai for the numbers and for request and response examples.

## Optional

- [Assets browser](https://fivemad.com/assets): every dataset above as a browsable page.
- [FXServer artifacts](https://fivemad.com/artifacts): recommended and broken FXServer builds.
- [Status](https://fivemad.com/status): whether the site, the forum and the media are up.