Skip to content

Home

Jump to bottom
Liparakis edited this page Jul 12, 2026 · 6 revisions

Chunkis is a Minecraft Fabric mod that replaces vanilla chunk persistence with a Chunkis-managed storage pipeline.

It provides:

  • CIS-based chunk storage
  • Runtime mutation tracking
  • Snapshot-based persistence
  • Chunk restoration during world loading
  • Vanilla full-chunk delivery of restored state
  • CIS format migration
  • Vanilla MCA → CIS world migration
  • Storage inspection and debugging tools

Project Status

Chunkis is actively developed for Minecraft 1.21.11 using Java 21 and Fabric.

Current priorities include stabilizing CIS persistence, preserving chunk metadata and entities, improving MCA → CIS migration, and validating durability through automated and game tests.

Architecture

Chunkis is divided into four primary modules:

  • common — Shared models, codecs, compression, and debug structures
  • storage — CIS storage engine, region files, mappings, and inspection tools
  • migration — CIS version migrations and storage rewrites
  • fabric — Minecraft integration, mixins, tracking, restoration, networking, and runtime migration

Start with Architecture for the complete system structure.

Documentation

Development

./gradlew build
./gradlew test
./gradlew runGameTest

When changing persistence behavior, update the relevant architecture and format documentation alongside the code.

Repository

Chunkis on GitHub

Clone this wiki locally