Nucleation is a high-performance Minecraft schematic engine written in Rust — with full support for Rust, WebAssembly/JavaScript, Python, and FFI-based integrations like PHP and C.

Built for performance, portability, and parity across ecosystems.

• ✅ Multi-format support: .schematic, .litematic, .nbt, etc.
• 🧠 Memory-safe Rust core with zero-copy deserialization
• 🌐 WASM module for browser + Node.js
• 🐍 Native Python bindings (pip install nucleation)
• ⚙️ C-compatible FFI for PHP, C, Go, etc.
• 🔄 Feature parity across all interfaces
• 📦 Binary builds for Linux, macOS, Windows (x86_64 + ARM64)
• 🧱 Seamless integration with Cubane

cargo add nucleation

npm install nucleation

pip install nucleation

Download prebuilt .so / .dylib / .dll from Releases or build locally using:

./build-ffi.sh

use nucleation::UniversalSchematic;

let bytes = std::fs::read("example.litematic")?;
let mut schematic = UniversalSchematic::new("my_schematic");
schematic.load_from_data(&bytes)?;
println!("{:?}", schematic.get_info());

📖 → More in examples/rust.md

import { SchematicParser } from "nucleation";

const bytes = await fetch("example.litematic").then(r => r.arrayBuffer());
const parser = new SchematicParser();
await parser.fromData(new Uint8Array(bytes));

console.log(parser.getDimensions());

📖 → More in examples/wasm.md

from nucleation import Schematic

with open("example.litematic", "rb") as f:
    data = f.read()

schem = Schematic("my_schematic")
schem.load_from_bytes(data)

print(schem.get_info())

📖 → More in examples/python.md

#include "nucleation.h"

SchematicHandle* handle = schematic_new("MySchem");
schematic_load_data(handle, data_ptr, data_len);

CSchematicInfo info;
schematic_get_info(handle, &info);
printf("Size: %dx%dx%d\n", info.width, info.height, info.depth);

schematic_free(handle);

📖 → More in examples/ffi.md

# Build the Rust core
cargo build --release

# Build WASM module
./build-wasm.sh

# Build Python bindings locally
maturin develop --features python

# Build FFI libs
./build-ffi.sh

• examples/rust.md

• examples/wasm.md

• examples/python.md

• examples/ffi.md

Licensed under the GNU AGPL-3.0-only. See LICENSE for full terms.

Made by @Nano112 with ❤️