fivem-vehicle-validator

Validate FiveM vehicle resources for common issues before deploying to your server. Catches broken manifests, missing meta files, oversized textures, and structural problems.

  FiveM Vehicle Validator
  ==================================================
  Resource:  my-lambo
  Files:     8 (34.2MB)
  Stream:    5 files
  Meta:      3 files

  ERRORS (1)
  --------------------------------------------------
  ✘ [YTD_OVER_LIMIT] lambo.ytd is 18.3MB — exceeds FiveM's 16MB streaming limit
    → Fix: Compress textures. Use FiveMRides Optimizer: https://fivemrides.com/optimizer/

  WARNINGS (1)
  --------------------------------------------------
  ⚠ [HANDLING_SUSPICIOUS_VALUE] fMass = 80000 seems unusual (expected 100-50000 kg)

  YTD FILES
  --------------------------------------------------
  lambo.ytd                         18.3MB [████████████████████████░░] ✘ OVER LIMIT
  lambo+hi.ytd                       8.1MB [██████████░░░░░░░░░░] ✓

  --------------------------------------------------
  ✘ FAILED — 1 error(s) must be fixed

Install

npm install -g fivem-vehicle-validator

Or use without installing:

npx fivem-vehicle-validator ./my-vehicle

Usage

# Validate a resource
fivem-validate ./resources/my-car

# Show fix suggestions
fivem-validate ./resources/my-car --fix-hints

# JSON output (for CI/scripts)
fivem-validate ./resources/my-car --json

# Validate all resources in a folder
for dir in ./resources/*/; do fivem-validate "$dir"; done

What It Checks

Errors (must fix)

Code	Description
MANIFEST_MISSING	No fxmanifest.lua or __resource.lua
MANIFEST_NO_FILES	No files{} block in manifest
MANIFEST_NO_VEHICLES_META	vehicles.meta not in files{}
MANIFEST_NO_DATA_FILE	Missing data_file declaration for a meta file
MANIFEST_META_NOT_IN_FILES	Meta file exists but not listed in files{}
VEHICLES_META_MISSING	No vehicles.meta found
VEHICLES_META_INVALID_XML	vehicles.meta is not valid XML
VEHICLES_META_NO_ITEMS	No vehicle entries in vehicles.meta
VEHICLES_META_DUPLICATE_MODEL	Duplicate modelName (spawn conflicts)
VEHICLES_META_MISSING_FIELD	Missing required field (modelName, txdName, etc.)
YTD_OVER_LIMIT	YTD file exceeds 16MB streaming limit
STREAM_NO_FILES	No stream files (vehicle invisible)
STREAM_NO_YTD	Models found but no textures

Warnings (should fix)

Code	Description
MANIFEST_LEGACY	Using deprecated __resource.lua
MANIFEST_FX_VERSION	fx_version not set to cerulean
YTD_NEAR_LIMIT	YTD between 12-16MB (risky)
YFT_LARGE	Model file over 25MB (lag risk)
STREAM_TOTAL_LARGE	Total stream over 50MB
STREAM_HI_NO_BASE	_hi.yft without matching base .yft
HANDLING_SUSPICIOUS_VALUE	Physics value outside normal range
STRUCTURE_STREAM_IN_ROOT	Stream files not in stream/ folder
STRUCTURE_JUNK_FILES	Thumbs.db, .DS_Store, etc.
STRUCTURE_NESTED_RESOURCE	fxmanifest.lua in wrong directory

Programmatic API

const { validateResource } = require('fivem-vehicle-validator');

const result = await validateResource('./my-vehicle');

console.log(result.passed);     // true/false
console.log(result.errors);     // [{code, message, fix}]
console.log(result.warnings);   // [{code, message, fix}]
console.log(result.stats);      // {totalFiles, streamFiles, ytdFiles, ...}

Auto-Fix Tools

Found issues? Fix them automatically:

• Oversized YTD / unoptimized textures → FiveMRides Optimizer — Smart BC5/BC7 compression, reduces file sizes 40-70%
• Broken resource structure / missing meta → FiveMRides Converter — Rebuilds complete resource with fxmanifest, handling, and 102 engine sounds
• Need to convert from GTA5-Mods.com → FiveMRides Converter — Upload ZIP/RPF, get FiveM-ready resource in seconds

Why 16MB Matters

FiveM has a hard streaming limit: any single YTD file over 16MB will cause texture loss in-game. The textures simply won't load. This is the #1 cause of invisible/blurry vehicles on FiveM servers.

This validator checks every YTD file against this limit and warns you before you deploy a broken resource.

Read more: How to Fix FiveM Texture Loss

Contributing

Issues and PRs welcome. If you'd like to add new checks, each check is a separate module in src/checks/.

License

MIT — FiveMRides