Documentation

Get started with Roblox Asset Generator

Everything you need to install, configure, and start generating assets in minutes.

Installation & Setup

Prerequisites

Make sure you have Node.js 18+ and npm installed on your machine.

node --version npm --version

Clone the repository

Clone the Roblox Asset Generator from GitHub.

git clone https://github.com/icealys68654-tech/Roblox-Asset-Generator.git cd Roblox-Asset-Generator

Install dependencies

Install all required packages using npm.

npm install

Run the generator

You're ready to go. Run your first asset generation command.

npm start # or use the CLI directly npx rag --help

CLI Command Reference

All commands follow the pattern: rag <command> [options]

rag generate model

Generate a 3D mesh model and export as .rbxm

--name <string> Name of the asset --style <string> Visual style (e.g. sci-fi, medieval, modern) --poly-count <n> Target polygon count (default: 1000) --export <format> Output format: rbxm | obj | fbx

rag generate texture

Generate a seamless PBR texture or decal

--material <string> Material type (e.g. stone, wood, metal) --size <n> Texture resolution in px (default: 512) --type <string> Output type: pbr | decal | surface

rag generate script

Generate a Lua script for Roblox Studio

--type <string> Script type: tool | gui | server | module --behavior <string> Describe the behavior (e.g. sword, door, leaderboard) --output <path> Output file path

rag config

View or update your configuration

--set <key=value> Set a config value --get <key> Get a config value --reset Reset to defaults

Code Examples

Generate a sci-fi spaceship mesh ready for Roblox Studio.

# Generate a sci-fi spaceship rag generate model \ --name "SpaceShip" \ --style sci-fi \ --poly-count 1200 \ --export rbxm # Output: # ✓ Analyzing style parameters... # ✓ Generating mesh geometry (1,200 polygons) # ✓ Applying UV maps and normals # ✓ SpaceShip.rbxm saved to ./output/

Configuration Options

Customize the generator by editing rag.config.json in your project root.

{ "outputDir": "./output", "defaultStyle": "modern", "defaultPolyCount": 1000, "textureSize": 512, "exportFormat": "rbxm", "verbose": false, "autoOpen": false }

Key	Type	Default	Description
outputDir	string	./output	Directory where generated assets are saved.
defaultStyle	string	modern	Default visual style applied when --style is omitted.
defaultPolyCount	number	1000	Default polygon count for 3D model generation.
textureSize	number	512	Default texture resolution in pixels.
exportFormat	string	rbxm	Default export format for models: rbxm, obj, or fbx.
verbose	boolean	false	Enable verbose logging output.

Frequently Asked Questions

Troubleshooting

Command not found: rag

Make sure you've installed dependencies with npm install and are running the command from the project root. Try npx rag instead.

Output directory not found

The generator creates the output directory automatically. If it fails, check that you have write permissions in the project folder.

Generated model looks incorrect

Try being more specific with the --style and --name flags. For example, --name "MedievalCastle" --style "medieval stone fortress" gives better results than a generic name.

Node.js version error

Roblox Asset Generator requires Node.js 18 or higher. Run node --version to check, and visit nodejs.org to upgrade if needed.

Contribute on GitHub

Roblox Asset Generator is open source. Report bugs, request features, or submit a pull request.

View on GitHub Open an Issue