Fork it.

Three steps to your own jar

1. 1

   Fork

   Press Fork on the project's GitLab page, or clone it and keep it wherever you keep code. It is one repository: the mod, its tools, its tests and its pipeline.

   git clone https://gitlab.com/Ekoss/vantage.git
   cd vantage

2. 2

   Build

   Gradle has to run on JDK 25; there is no toolchain block, so it will not fetch one for you. The first line is what the pipeline runs; the second makes a jar in build/libs.

   ./gradlew compileJava test
   ./gradlew build -PnoVersionBump

   Keep the flag. Without it, any task that makes a jar raises the last number of mod_version in gradle.properties before anything compiles, which is right for a release and a nuisance every other time; git checkout -- gradle.properties puts it back. Add -Pminecraft_version=26.1.2 for the other target.

3. 3

   Make it yours

   Give it your own name, so nobody mistakes it for Vantage: id and name in src/main/resources/fabric.mod.json, maven_group and archives_base_name in gradle.properties, Vantage.NAME, the manifest's Implementation-Title in build.gradle, and Vantage.MOD_ID, which also names the config folder and the resource namespace: rename src/main/resources/assets/vantage to match, along with the few files that spell vantage out (font/ui.json, lang/en_us.json, the vet.key path).

   If you also move the package dev.cherishev.vantage, change it by hand wherever it is written as text: the two entry points in fabric.mod.json, the "package" of every vantage*.mixins.json, and FEATURE_INFO, FEATURE and PACKAGE in processor/…/FeatureIndexProcessor.java, which finds every feature by those names. The forking guide lists every one.

   After that it is yours to change. A feature is one class with an @FeatureInfo annotation, and the look is written down: docs/design/liquid-glass.md is the Obsidian Glass contract every screen is drawn against.

Point it at your own things

A few constants point at Vantage's own infrastructure. A fork that kept them would check Vantage's releases, read Vantage's announcements and talk to Vantage's service, under Vantage's name. These are the ones to change, as of 2.0.1; the Java files are under src/main/java/dev/cherishev/vantage/.

Two Minecraft versions come out of one tree. The few files that cannot be written against both live in src/main/java-mc26.2 and src/main/java-mc26.1.2, with each version's access widener in src/main/resources-mc<version>; -Pminecraft_version picks one.

What you get

• The mod

  428 features in 19 areas, each one class, on Minecraft 26.1.2 and 26.2, written from scratch in Java 25.

• The feature catalogue

  tools/tracker.py reads every @FeatureInfo into a tracker and a catalogue; tools/sitedocs.py writes the one this site's feature list and reference are built from.

• The UI toolkit

  Obsidian Glass, in core/ui: the screens, the widgets the menu is made of, the renderer that draws them and the theme they all read, with its contract written down.

• The smoke tests

  ./gradlew runUiSmokeTest opens every Vantage screen and writes a report; runPathSmokeTest builds an obstacle course and routes through it. A JUnit suite covers the parts that need no game.

• The pipeline

  .gitlab-ci.yml: compile and test on every merge request, a jar per pipeline, a check that the catalogue is current, and a release job that builds both jars from a tag.