Skip to content

Home

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

Gitmatica

Gitmatica is a client-side Litematica addon that brings version control to Minecraft builds. It lets you save versions of a build, inspect changes, try ideas on branches, and return to an earlier state without using Git commands.

Warning

Gitmatica 0.1.0-alpha is in an early phase. Back up important worlds and schematics before invoking operations that change blocks or entities.

Install

  1. Install Fabric Loader for Minecraft 26.2.
  2. Install Litematica 0.28.3 and MaLiLib 0.29.2.
  3. Download Gitmatica from the latest release and place the JAR in your instance's mods folder.

Create your first project

Gitmatica creates a project from your current Litematica area selection. There are currently two supported ways to do this.

From an area selection

  1. In the Litematica menu, set Area Selection Mode to Simple for one selection box, or Normal for multiple sub-regions.
  2. Use Litematica's selection tool to set both corners of every area you want Gitmatica to track.
  3. Return to the Litematica menu and open Area Editor.
  4. Select Save Schematic, then Create Project.
  5. Enter a project name and select OK, or press Enter.

From an existing .litematic

  1. Paste the schematic into the world and keep its placement selected.
  2. In the Litematica menu, set Area Selection Mode to Normal.
  3. Open Area Selection browser and select From Placement to create a matching area selection.
  4. Open Area Editor, then select Save Schematic → Create Project.
  5. Enter a project name and select OK, or press Enter.

The Project Manager opens when Gitmatica has captured the first version and the project is ready. When converting a .litematic, keep its original placement loaded and selected until this screen appears; you can then unload it.

Continue building inside the tracked area and select Save Version when you want to record a change. You can reopen projects from Project Browser in the Litematica main menu.

Core features

  • Track one or more selected areas as a project.
  • Save named versions and browse their history.
  • Inspect changes to blocks, block states, inventories, and entities.
  • Load an older version as an overlay or restore it to the world.
  • Create and merge branches, or export a version as a .litematic file.

Important to know

  • Load the entire tracked area before saving or changing the world.
  • Singleplayer has full access to block and entity data. Multiplayer needs compatible Servux support for the same fidelity.
  • Some visible controls are not part of this alpha. See Alpha Notes for the current boundaries.

Learn more

Clone this wiki locally