Getting started

Build one project first. The commands below use ViaBedrock as an example.

Requirements

Install Bun, Git, and the JDK for your project. The project list gives each JDK version. Install the GitHub CLI if you plan to work with upstream PRs.

Build ViaBedrock

1. Clone the patches repository and enter it.
2. Install the tooling dependencies.
3. Apply the pinned upstream source and patch series.
4. Build the project.

bun install --frozen-lockfile
bun run stack sync viabedrock
bun run build viabedrock

The source checkout lives in .worktrees/viabedrock. The JAR and its SHA-256 manifest go to dist/viabedrock/. A target build also builds the dependencies listed in targets.json.

Inspect a stack

bun run stack status viabedrock

The command shows the pinned upstream commit and patch order. Read patches/viabedrock/series.json to see which changes are for setup, upstream review, or deferred work.

Build the full set

bun run build all
bun run bundle

The bundle command creates a PrismLauncher instance ZIP with the Fabric mods. The Bedrock add-on embeds the StackAnvil ViaBedrock and CubeConverter JARs. See releases if you want prebuilt artifacts.

For local client and server tests, use the capture lab guide. Keep credentials, captures, and screenshots in ignored local paths.