Skip to content

Home

Jump to bottom
Arnavpmr edited this page Jul 26, 2026 · 18 revisions

Gitmatica

Gitmatica is a client-side Litematica addon that brings Git-backed version control to Minecraft builds. A Gitmatica project stores a build as semantic chunk data and gives it familiar version control workflows without requiring you to work at the command line.

Warning

Gitmatica is currently alpha software. Back up important worlds before using operations that restore, discard, or clear blocks.

Features

  • Save named versions of a build with titles and descriptions.
  • Inspect commit history and compare blocks, block states, entities, and inventories.
  • Create, switch, rename, delete, and merge branches.
  • Restore an earlier version or load it as a schematic overlay only.
  • Export a version as a Litematica schematic.
  • Push to and pull from a remote Git repository.
  • Recover safely from interrupted project operations.
  • Work in singleplayer and on compatible Servux servers.

Requirements

The current source targets:

Dependency Version
Minecraft 26.2
Fabric Loader 0.19.3 or newer
Litematica 0.28.3
MaLiLib 0.29.2

Gitmatica is client-side. Litematica and MaLiLib must be installed alongside it.

Getting started

  1. Install Fabric Loader, Litematica, MaLiLib, and Gitmatica in the same Minecraft instance.
  2. Enter a world and create a simple Litematica area selection around the build you want to track.
  3. Open Litematica's schematic-save screen and choose Create Project.
  4. Name the project. Gitmatica captures the selected area as its first version and opens the Project Manager.
  5. Use Save Version after making changes. Add a concise title and an optional description.

The Litematica main menu includes a Project Browser button for reopening projects. Project repositories are stored under .minecraft/gitmatica-projects/.

Before restoring a version, switching branches, discarding changes, or clearing an area, make sure the entire tracked area is loaded. These operations can physically change blocks and entities in the world.

Building from source

Gitmatica requires JDK 25. From the repository root:

./gradlew build
./gradlew integrationTest

The installable JAR is produced in build/libs/. Development run configurations for VS Code prepare Fabric Loom and start Minecraft with Gitmatica, Litematica, and MaLiLib on the classpath.

Feedback and development

Gitmatica is licensed under the GNU Lesser General Public License v3.0.

Clone this wiki locally