obj2brz

a5 adaptation of textured-voxelizer by Suficio

Generates textured voxel models from OBJ, STL, glTF/GLB, and FBX files (FBX on desktop/CLI only; the browser build cannot run the C-based FBX parser).

Workspace layout

obj2brz is a Cargo workspace split into three crates so the conversion engine is usable independently of any UI:

• crates/obj2brz — the UI-agnostic core library. Build a ConvertOptions and call obj2brz::convert.
• crates/obj2brz-cli — a standalone command-line front-end (obj2brz).
• crates/obj2brz-gui — the eframe desktop application (obj2brz-gui), which also compiles to wasm32-unknown-unknown for a browser host.

The BRDB writer is tracked from upstream brickadia-community/brdb.

Building

cargo build --release                 # everything
cargo build --release -p obj2brz-cli  # just the CLI
cargo build --release -p obj2brz-gui  # just the GUI

The GUI can also be compiled for wasm32-unknown-unknown:

rustup target add wasm32-unknown-unknown
cargo build --release -p obj2brz-gui --target wasm32-unknown-unknown

The WebAssembly target is intended for a browser host; native file and folder pickers are deliberately unavailable there because browsers do not expose a writable filesystem path.

CLI usage

obj2brz model.obj -o builds -n my_save --scale 2 --simplify
obj2brz model.obj --material hologram --no-player-collision
obj2brz --help

Use --rampify to generate a slope-focused save with default ramps and wedges. Rampify runs directly from the converter's voxel octree, rather than building an intermediate save containing one 1×1 plate per voxel, and works for both BRZ and BRDB output.

Use --material to apply a Brickadia material such as plastic, glass, glow, metallic, hologram, or ghost to the whole export. Use --no-player-collision and/or --no-physics-collision for decorative models that should not block players or participate in physics/grid collisions.

Library usage

use obj2brz::{convert, ConvertOptions};

let opts = ConvertOptions {
    input_file_path: "model.obj".into(),
    output_directory: "builds".into(),
    save_name: "my_save".into(),
    ..ConvertOptions::default()
};
convert(&opts, false)?;

Output

Choose BRZ for a compact, ready-to-place Brickadia prefab, or BRDB for an editable Brickadia world directory. Generated bundles include prefab metadata and use the configured Brickadia owner for their bundle and bricks.