# Version Support


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


VoxelCore distinguishes a **runtime compatibility family** from an **exact version that is exercised in the real-server smoke matrix**. Do not treat every intermediate version in a family as individually smoke-tested.

| Minecraft runtime | Module / final JAR family | Java release | Runtime rendering/identity boundary | Exact live validation |
|---|---|---:|---|---|
| 1.12.x–1.13.x | `voxelcore-v1_12` / `mc1.12-1.13` | 8 | legacy NBT identity; explicit durability legacy rendering | 1.12.2, 1.13.2 |
| 1.14–1.19.3 | `voxelcore-v1_14` / `mc1.14-1.19.3` | 8 | PDC identity; numeric Custom Model Data | 1.14.4 |
| 1.19.4–1.20.4 | `voxelcore-v1_19_4` / `mc1.19.4-1.20.4` | 17 | PDC/CMD; display-entity-era capability boundary | 1.19.4 |
| 1.20.5–1.21.3 | `voxelcore-v1_20_5` / `mc1.20.5-1.21.3` | 21 | data-component era; scalar CMD compatibility | 1.20.5 |
| 1.21.4 | `voxelcore-v1_21_4` / `mc1.21.4` | 21 | item-model component + structured CMD | 1.21.4 |
| 26.2 | `voxelcore-v26_2` / `mc26.2` | 25 | modern item adapter; Paper 26.2 exact boundary | 26.2 |

The 1.21.4 and 26.2 providers are deliberately exact. A future Minecraft release must gain an explicit validated adapter instead of being accepted just because its API appears similar.

## Paper 26.2 notes

The 26.2 module compiles against Paper API `26.2.build.123-stable`. VoxelCore parses Paper's build-qualified version form such as `26.2.build.123-stable` as Minecraft version `26.2.0` for adapter selection. This is not a general licence to accept arbitrary 26.x releases; the provider matches `26.2.0` exactly.

## Resource-pack target support

Runtime families and pack profiles are related but not identical. Pack compilation deliberately exposes only exact validated targets; see [[Products/Voxel-Horizons/VoxelCore/Resource-Pack-Compiler]].