Skip to content

Home

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

Gitmatica

Gitmatica is a drop-in replacement for Litematica that brings version control to Minecraft builds. It lets you save versions, 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 MaLiLib 0.29.2 or higher.
  3. Remove or disable Litematica. Gitmatica replaces it, so do not load both mods together.
  4. Download Gitmatica from the latest release and place the JAR in your instance's mods folder.

Gitmatica automatically uses your existing Litematica configuration, so no migration is needed.

Create your first project

Project creation starts from an active Litematica area selection. Define it using either method below, then follow the shared project steps.

Define the tracked area

Manually

  1. Set Area Selection Mode to Simple for one box, or Normal for defining multiple sub-regions.
  2. Use Litematica's selection tool to define the area(s) of your build you want tracked.
  3. If using Normal mode, ensure the finished selection is selected in Area Selection browser.

From an existing .litematic

  1. Paste the schematic into the world and keep its placement selected.
  2. Set Area Selection Mode to Normal.
  3. Open Area Selection browser and select From Placement. Leave the newly created selection selected.

Create the project from selection

  1. From the Litematica menu, open Area Editor.
  2. Select Save Schematic, then Create Project.
  3. Enter a project name and select OK, or press Enter.

The Project Manager opens when Gitmatica has captured the first version. When converting a .litematic, keep its original placement loaded and selected until the manager lists the first version, Created Project; 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.
  • Open Gitmatica's config page through Mods → Gitmatica → Configure, or select Gitmatica from MaLiLib's config switcher.

Learn more

Clone this wiki locally