Documentation Index
Fetch the complete documentation index at: https://mintlify.com/rojo-rbx/rojo/llms.txt
Use this file to discover all available pages before exploring further.
rojo build reads your project file, resolves all referenced source files, and writes a single Roblox file. You can target any of the four Roblox file formats, or install the result directly into Roblox Studio’s local plugins folder.
Synopsis
--output or --plugin is required. They are mutually exclusive.
Arguments and flags
Path to the project file or to a directory containing a
default.project.json. Defaults to the current directory.Path for the output file. The file extension determines the format — Rojo accepts
.rbxl, .rbxlx, .rbxm, and .rbxmx. Cannot be used together with --plugin.Relative filename to install into Roblox Studio’s local plugins folder. Must end in
.rbxm or .rbxmx. The path must be relative, not absolute. Cannot be used together with --output.Rebuild automatically whenever any source file changes. Works with both
--output and --plugin.Global flags
Increase log verbosity. Pass multiple times (e.g.
-vv) for more detail.Control color output. Accepted values are
auto, always, and never.Output formats
| Extension | Format | Use for |
|---|---|---|
.rbxl | Binary place | Publishing a game |
.rbxlx | XML place | Version-control-friendly place files |
.rbxm | Binary model | Distributing assets |
.rbxmx | XML model | Version-control-friendly model files |
--plugin only accepts .rbxm or .rbxmx. Use --output if you need to produce a place file (.rbxl or .rbxlx).