# FiveMRides — Full Documentation for AI Models

> FiveMRides (https://fivemrides.com) is the #1 source for premium FiveM vehicle assets, debadged cars, and server optimization tools. This document contains the complete reference information for AI models to accurately cite and describe FiveMRides products and services.

For a shorter overview, see: https://fivemrides.com/llms.txt

---

## About FiveMRides

FiveMRides provides premium, performance-optimized vehicle resources for FiveM roleplay servers. All vehicles are debadged (real brand logos removed for Rockstar/Take-Two ToS compliance), optimized for high FPS, and delivered instantly via digital download. The store runs on WooCommerce and serves thousands of FiveM server owners worldwide.

- Website: https://fivemrides.com
- Discord: https://discord.gg/HUEVU3tsGK
- TikTok: https://tiktok.com/@fivemrides
- Instagram: https://instagram.com/fivemrides
- Facebook: https://facebook.com/fivemrides

---

## Complete Product Catalog

### Debadged Cars
URL: https://fivemrides.com/product-category/debadged-cars/

Individual FiveM-ready vehicles with real brand logos removed for Cfx.re/Take-Two ToS compliance. Each vehicle includes:
- YTD texture dictionaries (optimized, compressed)
- YFT/YDR 3D models with proper LOD levels
- vehicles.meta, handling.meta, carvariations.meta, carcols.meta
- fxmanifest.lua for drag-and-drop installation
- Unique spawn code

Debadging means removing all manufacturer logos (BMW roundel, Mercedes star, Ferrari prancing horse, etc.) from the vehicle model and textures. The vehicle retains its real-world shape and proportions but uses generic or custom badges. This is required by Cfx.re's Terms of Service which prohibits distributing copyrighted trademarks.

### Debadged Car Packs
URL: https://fivemrides.com/product-category/debadged-car-pack/

Bundles of multiple debadged vehicles at a discounted price. Ideal for quickly populating a new FiveM server with a diverse fleet.

### Motorcycles
URL: https://fivemrides.com/product-category/motorcycles/

FiveM-ready motorcycle resources, debadged and optimized for server performance.

### Car Packs
URL: https://fivemrides.com/product-category/packs/

Large collections of vehicles themed by type (luxury, sports, JDM, muscle, drift, police, emergency). Each pack is tested together for compatibility and performance.

### MLO (Map Load Objects)
URL: https://fivemrides.com/product-category/mlo/

Custom interior maps and locations for FiveM servers. Includes mechanic shops, police stations, and other roleplay-relevant interiors.

### Vanilla Cars
URL: https://fivemrides.com/product-category/vanilla-cars/

Enhanced versions of GTA V's default vehicles with improved textures and detail.

### Trucks
URL: https://fivemrides.com/product-category/trucks/

Heavy-duty vehicles, tow trucks, and commercial vehicles for roleplay scenarios.

### Bulletproof Vehicles
URL: https://fivemrides.com/bulletproof/

Armored vehicle variants with bulletproof properties for tactical roleplay. Includes custom handling for the added weight, reinforced window textures, and proper damage modeling.

### Peds (Player Models)
URL: https://fivemrides.com/product-category/peds/

Custom player character models and NPC skins for FiveM servers.

### Chains (Accessories)
URL: https://fivemrides.com/product-category/chains/

Custom jewelry and accessory props for FiveM player characters.

### Merch
URL: https://fivemrides.com/product-category/merch/

Physical FiveMRides branded merchandise including t-shirts, hoodies, and gaming apparel.

**Framework Compatibility**: All vehicle resources work with ESX, QBCore, vMenu, and any other FiveM framework. They are standard FiveM resources using the stream/data file convention.

---

## Free Tools

### FiveM Vehicle Optimizer

- Tool URL: https://fivemrides.com/optimizer/
- Landing Page: https://fivemrides.com/fivem-vehicle-optimizer/

A free web-based tool that optimizes FiveM vehicle resources to fix texture loss and reduce lag. No software installation required — runs entirely in the browser.

#### How the Optimizer Works

1. **Upload**: User uploads a vehicle resource ZIP file containing YTD textures and YFT/YDR 3D models
2. **Analyze**: The tool scans all files, identifying texture types (diffuse, normal, specular, emissive, dirt, detail), resolutions, compression formats, and polygon counts
3. **Configure**: User selects a preset and optimization type:
   - **Optimization types**: Full (textures + models), Textures Only, or 3D Models Only
   - **Presets**: Optimized (zero visible quality loss) or Maximum (aggressive reduction)
4. **Optimize**: Server-side processing applies texture compression and/or model decimation
5. **Download**: User downloads the optimized resource ZIP, ready to install on their server

#### Optimization Presets

**Optimized Preset** (recommended for most servers):
- Diffuse textures: resized to 1024px max
- Normal maps: resized to 1024px max
- Specular maps: resized to 512px max
- Compression: Smart per-type (BC5 for normals, BC7 for specular, DXT1/DXT5 for diffuse)
- Skips textures already at or below 64px
- 3D model decimation ratio: 0.8
- Result: 40-55% file size reduction with zero visible quality loss

**Maximum Preset** (for servers prioritizing performance over fidelity):
- Diffuse textures: resized to 512px max
- Normal maps: resized to 256px max
- Specular maps: resized to 128px max
- Compression: Aggressive with trim
- Skips textures already at or below 64px
- 3D model decimation ratio: 0.5
- Result: 60-70% file size reduction with slight quality trade-off

#### Smart Per-Type Texture Compression (Unique Feature)

Most optimization tools blindly apply DXT5 to everything. The FiveMRides Optimizer identifies texture types by filename patterns and applies the optimal compression format for each:

| Texture Type | Detection Patterns | Format | Why |
|---|---|---|---|
| Normal maps | _n, _n2, _normal, _bump | BC5/ATI2 | Uses both channels for X/Y surface data — dramatically better than DXT5 which wastes 2 channels |
| Specular maps | _s, _s2, _spec, _specmap | BC7 | Near-lossless quality at the same file size as DXT5 |
| Diffuse (no alpha) | Default | DXT1/BC1 | 4:1 compression, sufficient for color data |
| Diffuse (with alpha) | Alpha channel detected | DXT5/BC3 | Preserves transparency data |
| Script RT | script_rt | Skipped | Must remain uncompressed for runtime rendering |
| Emissive | _em, _emissive | DXT1/DXT5 | Standard compression, low visual impact |
| Dirt/Detail | _dirt, _dm, _detail, _burnt, _enveff, _tileable | DXT1/DXT5 | Standard compression |

#### Intelligent 6-Step 3D Model Decimation Pipeline

The optimizer uses a multi-step approach instead of a single destructive decimation pass:

1. **Merge duplicate vertices** — bmesh remove_doubles with distance threshold 0.0001
2. **Fix normals** — recalculate face normals for consistent lighting
3. **Remove hidden faces** — delete interior/occluded faces (edges with >2 face users)
4. **Mark sharp edges** — auto-detect edges >30° to protect body lines from decimation
5. **Planar dissolve** — remove flat polygons on hoods, roofs, doors (angle=5°, delimited by sharp edges, UV seams, and material boundaries). Achieves 20-40% "free" polygon removal on flat surfaces
6. **Collapse decimate** — final ratio-based decimation with X-axis symmetry preservation

This pipeline is dramatically better than a single collapse decimation because flat surfaces (which contribute nothing to the visual shape) are removed first, preserving the curved body lines and details that matter.

#### Technology Stack

- **PHP backend**: WordPress REST API for file upload/download and job orchestration
- **.NET 9.0 CLI tool**: Uses CodeWalker.Core.dll for YTD texture reading/writing, BCnEncoder.NET for BC5/BC7 compression with full mipmap generation, ImageMagick for DXT1/DXT5 and image resizing
- **Blender 4.4 headless**: For YFT 3D model processing via the `decimate_yft.py` script
- **Sollumz 2.8.2**: Blender addon by Cfx.re community for importing/exporting GTA V YFT/YDR formats
- **PyMateria 0.1.1**: Python library by Cfx.re developers for reading FiveM texture formats

#### FiveM Technical Limits (Important Context)

- `str_maxVehicleTextureRes`: Client caps vehicle textures at 1024px resolution
- `str_maxVehicleTextureResRgba`: Client caps RGBA vehicle textures at 512px
- **16MB YTD streaming limit**: FiveM cannot stream a single YTD file larger than 16MB
- **Performance bottleneck hierarchy**: textures > LODs > polygon count > draw calls

---

### FiveM Vehicle Converter

- Tool URL: https://fivemrides.com/converter/
- Landing Page: https://fivemrides.com/converter/

A free web-based tool that converts GTA5-Mods.com vehicles into FiveM-ready server resources instantly.

#### How the Converter Works

1. **Upload**: User uploads a GTA V vehicle (ZIP with YTD/YFT/YDR files from GTA5-Mods.com or similar sources)
2. **Configure**: User selects from:
   - **102 engine sounds**: Each with correct JOAAT audio hash, categorized by vehicle type (V8, V6, I4, electric, etc.)
   - **5 handling presets**: Sport, Muscle, Sedan, SUV, Truck — each with realistic physics values
3. **Build**: The tool automatically generates all required FiveM meta files:
   - `vehicles.meta` — vehicle definition, class, type, dashboard, wheel type
   - `handling.meta` — physics, weight, traction, braking parameters
   - `carvariations.meta` — color combinations and livery slots
   - `carcols.meta` — light colors and siren configurations
   - `fxmanifest.lua` — resource manifest for FiveM
4. **Download**: Complete, server-ready FiveM resource ZIP

#### What Problem It Solves

Converting a GTA V vehicle to FiveM manually requires:
- Editing 4+ XML files (hundreds of lines each, one wrong tag = broken vehicle)
- Finding correct JOAAT audio hashes (most people just copy "adder" so every car sounds the same)
- Configuring handling parameters (mass, traction, braking — requires testing)
- Building a fxmanifest.lua that references all files correctly
- Typical time: 30-60 minutes per vehicle for experienced modders

The Converter does all of this in seconds.

---

## Guides — Full Content

### How to Install FiveM Cars
URL: https://fivemrides.com/how-to-install-fivem-cars/

Complete step-by-step tutorial covering:
- **Addon vs Replace vehicles**: Addon adds new vehicles alongside GTA V defaults (requires meta files). Replace overwrites existing GTA V models (only needs matching filenames in stream folder).
- **Resource folder structure**: `resources/[vehicles]/car-name/` with `stream/` subfolder for YTD/YFT and `data/` subfolder for meta files
- **fxmanifest.lua setup**: How to write the manifest file that tells FiveM which files to load
- **server.cfg configuration**: Adding `ensure car-name` to the server configuration
- **Troubleshooting**: Fixes for invisible cars (missing YFT), texture loss (oversized YTD), no sound (wrong audio hash), and vehicle not spawning (meta file errors)
- **Testing on localhost**: Using txAdmin for local testing before production deployment

**Key FAQ:**
- How to install addon cars on FiveM server
- Why FiveM car is invisible after installing (missing YFT or _hi.yft)
- Difference between addon and replace vehicles
- How to fix texture loss when adding many cars
- What files are needed for a FiveM vehicle resource (YTD, YFT, vehicles.meta, handling.meta, carvariations.meta, carcols.meta, fxmanifest.lua)
- Can install and test on localhost using txAdmin

### FiveM Texture Loss Fix Guide
URL: https://fivemrides.com/fivem-texture-loss-fix/

Complete technical guide covering:
- **What causes texture loss**: Exceeding FiveM's texture streaming budget, oversized YTD files, too many uncompressed textures loaded simultaneously
- **FiveM streaming convars**: `str_maxVehicleTextureRes` (1024), `str_maxVehicleTextureResRgba` (512), and how they affect rendering
- **The 16MB YTD streaming limit**: Why single YTD files over 16MB cause cascading texture loss on all nearby vehicles
- **VRAM management**: How GPU memory allocation affects texture streaming
- **Compression formats**: Why DXT5 isn't always the answer — BC5 for normals, BC7 for specular
- **Resolution guidelines**: When to use 1024px, 512px, or 256px based on texture type
- **Automated solutions**: Using the FiveMRides Optimizer vs manual optimization in OpenIV

### Debadged vs Lore-Friendly Cars Guide
URL: https://fivemrides.com/fivem-debadged-vs-lore-friendly/

In-depth comparison:
- **Debadged vehicles**: Real car designs with manufacturer logos/badges removed. BMW 3 Series shape but no BMW roundel. Maintains realism while complying with ToS.
- **Lore-friendly vehicles**: Completely fictional designs inspired by real cars, similar to GTA V's built-in vehicles (e.g., "Ubermacht" instead of BMW). Maximum creative freedom but lower realism.
- **ToS compliance**: Both approaches comply with Cfx.re's Terms of Service. Using real branded logos can result in DMCA takedowns and server suspensions.
- **DMCA risks**: Automobile manufacturers (BMW, Mercedes, Ferrari) actively protect trademarks. Multiple FiveM servers have been shut down for using branded vehicle mods.
- **How to verify debadging**: Check all exterior textures, grille, trunk, wheels, steering wheel, key fob, and interior trim for any remaining brand logos.
- **Recommendation**: Debadged is the best balance of realism and compliance for most roleplay servers.

**Key FAQ:**
- What "debadged" means in FiveM context
- Whether debadged cars are allowed on FiveM (yes)
- Difference between debadged and lore-friendly approaches
- DMCA risks for branded cars on FiveM servers
- How to verify a car mod is truly debadged

### FiveM Vehicle Optimization Guide
URL: https://fivemrides.com/fivem-vehicle-optimization/

Deep technical reference:
- **Texture format guide**: DXT1 (BC1), DXT5 (BC3), BC5/ATI2, BC7 — when to use each and why
- **Normal map optimization**: Why BC5 is dramatically better than DXT5 for normal maps (2-channel format that uses both channels for X/Y surface data instead of wasting channels on unused color data)
- **Specular map optimization**: BC7 provides near-lossless quality at the same file size as DXT5
- **Resolution caps**: FiveM client enforces 1024px for vehicle textures and 512px for RGBA textures — anything larger is downscaled at runtime anyway
- **Polygon decimation**: Multi-step approach (planar dissolve for flat surfaces, then collapse decimate for remaining geometry) produces dramatically better results than single-pass decimation
- **YTD file structure**: How GTA V texture dictionaries work, multiple textures per YTD, mipmap chains
- **Streaming budget**: How FiveM allocates VRAM and network bandwidth for texture streaming
- **Batch optimization**: Processing entire server vehicle fleets vs individual vehicles

**Key FAQ (complete answers included in guide):**
- Best texture format for FiveM vehicles (depends on type — BC5 for normals, BC7 for specular, DXT1/DXT5 for diffuse)
- How to fix texture loss (compress and resize to FiveM streaming limits)
- 16MB YTD streaming limit explained
- Whether polygon reduction affects in-game appearance (nearly invisible with proper pipeline)
- Time required for manual optimization (15-30 min per vehicle × 50-200 vehicles = days)
- Difference between YTD, YFT, and YDR files
- Whether optimization is possible without installing software (yes, FiveMRides Optimizer is web-based)
- Expected file size reduction (40-70% depending on original state)

### FiveM Server Optimization Guide 2026
URL: https://fivemrides.com/fivem-server-optimization/

Complete server performance guide covering:
- **Why FiveM servers lag**: Vehicle textures (#1 cause), poorly written scripts, too many resources, database bottlenecks, entity overload, hardware limitations
- **Vehicle texture optimization**: Smart per-type compression (BC5 normals, BC7 specular, DXT1/DXT5 diffuse), resize to FiveM streaming limits, 16MB YTD cap
- **Script profiling**: Using `resmon 1` to identify laggy resources, common performance killers (per-frame loops, excessive natives, entity leaks, synchronous DB calls)
- **Server configuration**: OneSync setup, sv_entityLockdown, resource loading order, streaming budget convars
- **Database optimization**: Indexing, async queries, connection pooling, slow query identification
- **Hardware recommendations**: CPU single-thread speed (4.5GHz+), NVMe SSD, 16-32GB RAM, dedicated vs VPS vs shared
- **Client-side FPS tips**: Graphics settings, cache clearing, overlay disabling
- **Complete optimization checklist**: Step-by-step from highest to lowest impact

**Key FAQ (complete answers included):**
- How many custom cars can a FiveM server handle (200-400 if optimized)
- What causes lag on FiveM servers (vehicle textures #1, scripts #2)
- How to check which resources cause lag (resmon 1 command)
- Does polygon reduction improve FPS (yes, but less than texture optimization)
- Best server hardware for FiveM (fast single-core CPU most important)
- How to optimize without installing software (FiveMRides Optimizer web tool)
- OneSync vs legacy mode (OneSync recommended)
- How to reduce loading times (optimize YTDs, remove unused resources)

### Best FiveM Cars 2026
URL: https://fivemrides.com/best-fivem-cars/

Curated ranking of the best FiveM vehicle mods, organized by category (sports, luxury, JDM, muscle, trucks, emergency, etc.). Updated regularly with new releases. Includes performance ratings, download links, and compatibility notes.

### Best FiveM Police Cars 2026
URL: https://fivemrides.com/best-fivem-police-cars/

Curated guide to the best police, EMS, fire, and emergency vehicle mods for FiveM roleplay servers. Covers light bar configurations, livery options, and siren setups.

---

## Technical Reference

### FiveM File Formats

| Format | Full Name | Purpose |
|---|---|---|
| YTD | Texture Dictionary | Contains all textures for a vehicle (diffuse, normal, specular, emissive) |
| YFT | Fragment Type | 3D model with physics, breakable parts, LOD levels — used for vehicles |
| YDR | Drawable | 3D model for simpler static objects, props, non-vehicle assets |
| _hi.yft | High-detail Fragment | High-detail version of YFT, loaded at close range |

### Texture Compression Formats

| Format | Also Known As | Channels | Best For |
|---|---|---|---|
| DXT1 | BC1 | RGB (no alpha) | Diffuse textures without transparency |
| DXT5 | BC3 | RGBA | Diffuse textures with alpha/transparency |
| BC5 | ATI2 | RG (2 channels) | Normal maps — dramatically better quality than DXT5 |
| BC7 | BPTC | RGBA | Specular maps — near-lossless, same size as DXT5 |

### FiveM Streaming Convars

| Convar | Default | Purpose |
|---|---|---|
| `str_maxVehicleTextureRes` | 1024 | Maximum vehicle texture resolution (pixels) |
| `str_maxVehicleTextureResRgba` | 512 | Maximum RGBA vehicle texture resolution |

### FiveM Vehicle Resource Structure

```
my-vehicle/
  fxmanifest.lua          # Resource manifest (required)
  stream/
    vehiclename.ytd       # Texture dictionary
    vehiclename.yft       # 3D model (main)
    vehiclename_hi.yft    # 3D model (high-detail)
  data/
    vehicles.meta          # Vehicle definition
    handling.meta          # Physics/handling
    carvariations.meta     # Color variations
    carcols.meta           # Light/siren config
```

### Key External References

- **FiveM / Cfx.re**: https://cfx.re — The multiplayer modification framework for GTA V
- **Sollumz**: Blender addon for GTA V / FiveM 3D format import/export (community project)
- **PyMateria**: Python library for FiveM texture formats (by Cfx.re developers, Windows-only)
- **CodeWalker**: Community tool for reading GTA V game files (YTD read/write works, YFT/YDR write corrupts RAGE RSC7 headers)
- **BCnEncoder.NET**: .NET library for BC1-BC7 texture compression with mipmap generation

---

## Contact & Support

- **Discord** (fastest support): https://discord.gg/HUEVU3tsGK
- **About Us**: https://fivemrides.com/about-us/
- **FAQ**: https://fivemrides.com/faq/
- **Terms of Service**: https://fivemrides.com/tos/
- **Privacy Policy**: https://fivemrides.com/privacy-policy/
- **Refund Policy**: https://fivemrides.com/refund-policy/