Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ryanhcode/sable/llms.txt

Use this file to discover all available pages before exploring further.

This page shows how to add Sable as a Maven dependency in your mod project. Sable is published to the RyanHCode Maven repository and provides separate artifacts for NeoForge, Fabric, and a platform-agnostic common module for Architectury multiplatform projects.

​
Add the dependency

Copy the relevant snippet into your build.gradle depending on your platform. Each snippet adds the exclusiveContent repository block and the correct dependency declaration. 
repositories {
    exclusiveContent { // Sable
        forRepository {
            maven {
                url = "https://maven.ryanhcode.dev/releases"
                name = "RyanHCode Maven"
            }
        }
        filter {
            includeGroup("dev.ryanhcode.sable")
            includeGroup("dev.ryanhcode.sable-companion")
        }
    }
}

dependencies {
    api("dev.ryanhcode.sable:sable-common-${project.minecraft_version}:${project.sable_version}")
}

​
Versions

The current release of Sable is 1.2.2 for Minecraft 1.21.1. To find the latest published version, browse the Maven repository directly: https://maven.ryanhcode.dev/releases/dev/ryanhcode/sable/
sable_version and minecraft_version are properties defined in your gradle.properties file. Add them there so they are available as project.sable_version and project.minecraft_version in your build script.
gradle.properties
sable_version=1.2.2
minecraft_version=1.21.1

​
Building Rust natives

Sable includes Rust-based physics code (the Rapier physics engine) that must be compiled before you can run the mod from source. This step requires Docker.
1

Install Docker

Download and install Docker from https://www.docker.com/get-started/ or from your system’s package manager. Docker is used to provide the cross-compilation toolchain for the Rust natives.
2

Build the Docker images

Run the following command once to build the images. You only need to repeat this step if the images change.
gradlew common:buildImages
3

Compile the Rust natives

Run the following command to compile the Rust source into native libraries:
gradlew common:buildRustNatives

Build docs developers (and LLMs) love

Get started for freeTalk to us