-
Notifications
You must be signed in to change notification settings - Fork 2
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.
To create a project:
- Make a simple Litematica area selection around the build.
- Open Litematica's Save Schematic screen.
- Select Create Project, enter a name, and confirm.
To convert an existing .litematic, follow the
From an existing .litematic steps first.
Gitmatica captures the selection as the first version. Existing projects appear
in Project Browser and are stored in .minecraft/gitmatica-projects/.
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.
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.
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.
- 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.