Using Gitmatica

Using Gitmatica

This page covers the main alpha workflows. Open Project Browser from Litematica's main menu, then select a project to open its Project Manager.

Create or open a project

To create a project, define the tracked area manually or from an existing .litematic, then create the project from that active selection.

Gitmatica captures the selection as the first version. Existing projects appear in Project Browser and are stored in .minecraft/gitmatica-projects/.

Save and inspect versions

Select Save Version after changing the build. Give the version a short title and an optional description.

The Project Manager lists versions newest first. Select one to read its details. Use View Changes to inspect changed blocks, block states, inventories, and entities in the tracked area.

Load or restore a version

Select a version in the history, then:

• Select Load Version to restore its tracked blocks and entities to the world.
• Hold Left Shift while selecting Load Version to load only its schematic overlay.

Restoring changes the world. Load the complete tracked area first and save any work you want to keep.

Work with branches

Use the branch dropdown to switch branches. Hold Left Shift while choosing a branch to load its overlay without restoring the world.

Right-click the branch dropdown to create, rename, delete, or merge branches. Save or discard current changes before switching or merging.

Update, export, or clean up a project

• Project Editor changes the placement origin and tracked sub-regions.
• Update Areas replaces the tracked regions with the current Litematica selection.
• Export writes the selected version to Litematica's schematics folder.
• Discard Changes restores the tracked area to the active version.
• Clear Area removes tracked blocks and entities from the world.

Discarding, clearing, and restoring are destructive. Keep world backups while testing the alpha.

Back to Home · Alpha Notes