Amber

A cross-loader library for Minecraft mod development.

✨ About

Amber is a foundation library that provides unified APIs for common modding tasks across Fabric, Forge, and NeoForge. It aims to make multi-loader development feel consistent by abstracting platform differences behind a clean common API.

📦 What Amber Provides

• Registry helpers (deferred registration / suppliers)
• Event system (common + client events)
• Networking utilities (simple packet/channel helpers)
• Configuration utilities
• Commands + small gameplay/dev helpers (HUD, keybind utilities, etc.)

📚 Documentation

Docs live in this repo at docs/ and are published here:

• https://iamkaf.github.io/amber/

Repository Structure

Amber uses a Stonecutter-driven multiloader layout. The supported matrix is defined by versions/*/gradle.properties and exposed by just list-nodes.

amber/
├── common/           # shared code
├── fabric/           # Fabric implementation
├── forge/            # Forge implementation
├── neoforge/         # NeoForge implementation
├── versions/26.1.2/  # active Minecraft line metadata and overlays
└── docs/             # documentation site

Supported Versions

• 26.1.2: Fabric, Forge, NeoForge

🛠️ Building

Use just from the repo root as the command runner.

just list-nodes
just compile-all
just build 26.1.2-fabric
just boot-check 26.1.2-neoforge

Built jars will be in <loader>/versions/<version>/build/libs/.

💻 Development

Prerequisites

• Java 25 or higher
• Git
• just (install: https://github.com/casey/just)

Setup

git clone https://github.com/iamkaf/amber.git
cd amber
./gradlew projects

📝 License

MIT — see LICENSE.

🔗 Links

• Docs: https://iamkaf.github.io/amber/
• Issues: https://github.com/iamkaf/amber/issues
• Modrinth: https://modrinth.com/mod/amber