Metadata-Version: 2.4
Name: structura-core
Version: 0.1.0
Summary: Validated Minecraft Structure NBT, voxel geometry and worldgen tooling
Project-URL: Repository, https://github.com/kirimba1024/structura-core
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: amulet-nbt<3,>=2.1
Requires-Dist: numpy<3,>=1.26
Requires-Dist: scipy<2,>=1.13
Provides-Extra: legacy
Requires-Dist: amulet-core<2,>=1.9; extra == "legacy"

# structura-core

Reusable Minecraft Java 1.21.1 structure-processing core. It owns:

- validated Java Structure NBT I/O;
- legacy schematic conversion and numeric analysis;
- NumPy/SciPy envelope, terrain-pod and foundation geometry;
- loot, template-pool and worldgen JSON generators.

The library targets Minecraft Java 1.21.1 by default. Version constants live
in `structura_core.version`; callers can still pass an explicit Amulet
translation target to the legacy converter.

```bash
pip install -e '.[legacy]'
structura-analyze path/to/structure.nbt --json
```

The `legacy` extra is only needed for `.schematic` conversion and Sponge
`.schem` export. Normal Structure NBT processing stays independent of
`amulet-core`.

Generated additions may replace explicit air, but never overwrite source
solid blocks. Every saved position is bounds-checked.
