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. Choose the path that matches your build.

From an area selection

  1. Make a simple Litematica area selection around the build.
  2. Open Save Schematic and select Create Project.
  3. Enter a project name and confirm.

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.

Keep the original placement loaded and selected until the Project Manager opens. Once it does, the project is ready and you can unload the original .litematic.

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