swisser-convert

Convert GLB 3D models to FiveM-ready resources from your terminal.

 ┌  swisser-convert v1.0.0
 │
 ◇  File: my_car.glb (14.2 MB)
 │
 ◇  Upload complete
 │
 ◇  Conversion complete
 │
 ◇  Download complete
 │
 ▲  Saved to /home/user/my_car.zip
 │
 │  Size:       3.1 MB
 │  Artifacts:  GLB, YDR, YTD, YTYP, YBN, FXMANIFEST
 │
 └  Drop the extracted folder into your FiveM server resources/ directory

Quick Start

npx swisser-convert my_model.glb

That's it. No Blender, no Sollumz, no setup. Your GLB goes in, a FiveM resource ZIP comes out.

Install

If you use it regularly, install globally to skip the npx download:

npm install -g swisser-convert

Then just:

swisser-convert my_model.glb

Usage

# Basic conversion
swisser-convert vehicle.glb

# Custom output directory
swisser-convert vehicle.glb --output ./resources

# Custom resource name
swisser-convert vehicle.glb --name my_custom_car

Options

| Flag | Alias | Description | Default | |------|-------|-------------|---------| | --output <dir> | -o | Output directory for the ZIP | Current directory | | --name <name> | -n | FiveM resource name | Filename without .glb | | --help | -h | Show help | | | --version | | Show version | |

How It Works

1. Your .glb file is uploaded to the Swisser AI conversion API
2. The API runs it through Blender with the Sollumz addon to generate FiveM-native formats
3. You get back a ZIP containing a complete FiveM resource:
   • stream/*.ydr — Drawable model
   • stream/*.ytd — Texture dictionary
   • stream/*.ytyp — Archetype definition
   • stream/*.ybn — Collision mesh
   • fxmanifest.lua — Resource manifest

Extract the ZIP into your FiveM server's resources/ folder and add ensure <resource_name> to your server.cfg.

Limits

The public API allows 10 conversions per hour per IP address. Files up to 50 MB are supported.

Need more? Visit ai.swisser.dev for unlimited conversions.

Requirements

• Node.js 18 or later

License

MIT