nucleation
A high-performance Minecraft schematic engine, powered by a native Rust core. Parse, edit, diff, fingerprint, and generate schematics from Python.
Wheels are published for CPython 3.12+ (stable ABI) on Linux, macOS, and Windows.
Install
pip install nucleation
Quick start
import nucleation
schematic = nucleation.Schematic.create("demo")
schematic.set_block(1, 2, 3, "minecraft:stone")
print(schematic.get_block_name(1, 2, 3)) # "minecraft:stone"
schematic.save_to_file("demo.litematic")
loaded = nucleation.Schematic.load_from_file("demo.litematic")
Split disconnected builds
Keep every meaningful connected machine independent while attaching only tiny, nearby loose parts:
schematic = nucleation.Schematic.open("combined.schem")
pieces = schematic.split_connected_attach_nearby(
16, # components this large always remain standalone
3, # tiny parts may attach across at most three empty blocks
)
for index in range(pieces.len()):
pieces.piece(index).save(f"machine-{index + 1}.schem")
Attachment is lossless and non-transitive: fragments cannot form a chain that recombines otherwise independent builds. Whole-world extraction, including the Python control plane and remote Store worker, is documented in the world-segmentation guide.
What is included
The published wheel contains the core feature set: schematic editing, all schematic formats, world import and export (including streaming), the schematic builder, the procedural building tool, definition regions, diff and fingerprinting, autostack, NBT helpers, SDF sampling, and the in-memory/filesystem store.
Redstone simulation, mesh generation, GPU rendering, and embedded scripting require building the package from source with the extra cargo features enabled (a Rust toolchain is required):
git clone https://github.com/Schem-at/Nucleation
cd Nucleation
pip install ./bindings/python
The source build defaults to the full feature set (bridge-full). Set the
NUCLEATION_FEATURES environment variable to choose a different cargo feature list,
for example NUCLEATION_FEATURES=bridge,simulation.
Documentation
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nucleation-0.10.8.tar.gz.
File metadata
- Download URL: nucleation-0.10.8.tar.gz
- Upload date:
- Size: 2.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
549527e796350d70473bf9ec99f1094cfa4023b006a7c3c5a5694bb454530cad
|
|
| MD5 |
a02d7b37746c4d4db560c144d2212f22
|
|
| BLAKE2b-256 |
1498cda6fd357d96e5d1449085c6969dd8d19ac36b80c857cb84530af390c58a
|
File details
Details for the file nucleation-0.10.8-cp312-abi3-win_amd64.whl.
File metadata
- Download URL: nucleation-0.10.8-cp312-abi3-win_amd64.whl
- Upload date:
- Size: 11.6 MB
- Tags: CPython 3.12+, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
448798dafa253f024bd586deb1857a11ee0fda9919cc35d38e5a1c637203da97
|
|
| MD5 |
93aa741f058a4f31f7234bad4ce52d1d
|
|
| BLAKE2b-256 |
44794ace2aea96654718588486312b505236acbb306b747f5e9a4e6b0c774309
|
File details
Details for the file nucleation-0.10.8-cp312-abi3-manylinux_2_28_x86_64.whl.
File metadata
- Download URL: nucleation-0.10.8-cp312-abi3-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 16.7 MB
- Tags: CPython 3.12+, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e37a9022da2b3c13c0975e7ec32745e8e232f1d80f3342e861404a281ef86465
|
|
| MD5 |
bd888548674a83a185979bfec9698450
|
|
| BLAKE2b-256 |
42cfcfaf7cf68865d102b1fa4b424b45b4ed67057af2c3c4651b430112bd452a
|
File details
Details for the file nucleation-0.10.8-cp312-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: nucleation-0.10.8-cp312-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 13.7 MB
- Tags: CPython 3.12+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8f8d278c3e816c6364a3adb99e3bfd36ba9da2ec27d9cd35a3456f9895fde4a6
|
|
| MD5 |
bd8216a355547e990cb98adc6856229e
|
|
| BLAKE2b-256 |
f0f81ee7f65c96fabf7caeb31792bff4bb4e96c64306030026607e43f9278151
|
