About this project

hyperchunk is a high-performance reimplementation of the Minecraft Java Edition (version 26.2) overworld generation pipeline. Written in C11 with a dependency only on libc, it reproduces the vanilla noise, surface rules, carvers, features, and lighting with bit-exact parity. Key technical features include: - Performance: Benchmarks indicate generation speeds up to 13.3x faster than the vanilla dedicated server and 3.77x faster than C2ME on specific hardware (AMD EPYC Zen5). - Architecture: Utilizes an arena allocator, SoA (Structure of Arrays) block storage, and a flattened density function IR with AVX2 and AVX-512 backends. - Determinism: Ensures canonical-identical output across multiple threads, avoiding the scheduler-dependent decoration order issues found in vanilla and C2ME. - Design Constraints: Strictly prohibits FMA (Fused Multiply-Add) contraction to maintain bit-exact parity and uses a region-granularity FFI boundary to minimize overhead. The project currently supports the overworld only. While structures are placed, jigsaw assembly is not yet implemented. It is designed as a pure compute library, making it viable for integration via CLI, Java FFM (planned), or Rust FFI.