# VoxelCore


> **Documentation baseline:** VoxelCore `main` at `452b569` ยท 14 September 2026.  
> **Repository:** [https://github.com/VoxelHorizons/VoxelCore](https://github.com/VoxelHorizons/VoxelCore)


VoxelCore is the version-aware content foundation for Voxel Horizons. The current implemented milestone is the **custom item/content MVP**: deterministic content-pack loading, validated inheritance, immutable runtime snapshots, stable item identity, version-specific `ItemStack` creation, stable render allocation, deterministic Java resource-pack compilation and safe atomic reloads.

It is intentionally **not yet** the full historical HavenCore feature set. Placed blocks, furniture, vehicles, crops, GUI/menu presentation, Bedrock/Geyser mappings and the broader legacy migration remain later systems.

## Documentation map

### Operate VoxelCore

- [[Products/Voxel-Horizons/VoxelCore/Getting-Started]]
- [[Products/Voxel-Horizons/VoxelCore/Configuration]]
- [[Products/Voxel-Horizons/VoxelCore/Commands-and-Permissions]]
- [[Products/Voxel-Horizons/VoxelCore/Operations-and-Troubleshooting]]

### Author content

- [[Products/Voxel-Horizons/VoxelCore/Content-Packs]]
- [[Products/Voxel-Horizons/VoxelCore/Item-Authoring]]
- [[Products/Voxel-Horizons/VoxelCore/Inheritance]]
- [[Products/Voxel-Horizons/VoxelCore/Rendering-and-Models]]
- [[Products/Voxel-Horizons/VoxelCore/Resource-Pack-Compiler]]

### Develop VoxelCore

- [[Products/Voxel-Horizons/VoxelCore/Architecture]]
- [[Products/Voxel-Horizons/VoxelCore/Module-Reference]]
- [[Products/Voxel-Horizons/VoxelCore/Version-Support]]
- [[Products/Voxel-Horizons/VoxelCore/Runtime-and-Reloads]]
- [[Products/Voxel-Horizons/VoxelCore/Build-CI-and-Release]]
- [[Products/Voxel-Horizons/VoxelCore/Testing]]
- [[Products/Voxel-Horizons/VoxelCore/Source-Reference]]

### Status and future work

- [[Products/Voxel-Horizons/VoxelCore/Current-Status]]
- [[Products/Voxel-Horizons/VoxelCore/Roadmap-and-Scope]]

## Core invariant

A VoxelCore item is identified by its namespaced **ContentID**, not by its model path or Custom Model Data value. Rendering is version-specific presentation state layered over stable gameplay identity.
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9