# VoxelCore Current Status


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


## Snapshot

This documentation was reconciled against the repository tree, merged pull requests and implementation on **14 September 2026**. The baseline commit is **`452b569`**, which is the merge of PR #16, *Hide unbound definitions from the item list*.

The two newest merged changes materially affect the public contract:

- **PR #16 — unbound list filtering:** `/voxelcore admin item list` now includes only definitions whose compiled `bound` value is `true`. Unbound base/inheritance definitions remain in the registry and can still be inspected/referenced; they are simply omitted from that user-facing list.
- **PR #15 — Minecraft/Paper 26.2:** VoxelCore now has a dedicated `voxelcore-v26_2` distribution, exact 26.2 platform adapter, Java 25 compile target, `mc-26.2` resource-pack target with format `88.0`, modern range metadata, and a seventh live-server smoke row.

## MVP acceptance surface

Implemented and tested now:

```text
content packs + assets
        ↓
deterministic discovery + bounded YAML parsing
        ↓
strict schema validation
        ↓
single-parent inheritance + compilation
        ↓
immutable ItemDefinitionRegistry
        ↓
stable render-allocation reconciliation
        ↓
platform preflight validation
        ↓
atomic ContentSnapshot publication
        ↓
ItemManager + version adapter
        ↓
ItemStack with persistent ContentID

same definitions + allocation authority
        ↓
deterministic Java resource-pack compiler
```

## Validated live-server matrix

The smoke matrix now covers **seven** exact versions: 1.12.2, 1.13.2, 1.14.4, 1.19.4, 1.20.5, 1.21.4 and 26.2. See [[Products/Voxel-Horizons/VoxelCore/Version-Support]].

## Documentation discrepancy to be aware of

At this snapshot, the repository `README.md` was synchronised by PR #14 **before** PR #15 added 26.2. Its version-family and resource-pack-target tables therefore stop at 1.21.4. The code, Maven reactor, CI changes and merged PR #15 establish 26.2 support; this wiki reflects that newer state.

## Not implemented as part of this MVP

- placed custom-block lifecycle;
- furniture/display placement lifecycle;
- vehicles;
- crops;
- GUI/menu framework and Bedrock-specific presentation;
- Geyser/Floodgate item mappings;
- true Minecraft combat `AttributeModifier` authoring;
- richer typed metadata for potions, skulls, books, maps and fireworks;
- generic low-level post-1.20.5 component escape hatches;
- HavenCore compatibility/import aliases.

These belong to [[Products/Voxel-Horizons/VoxelCore/Roadmap-and-Scope]], not the current supported contract.
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