Java API Setup

EmbersTextAPI publishes a jar for each loader and Minecraft version to a self-hosted Maven repository. Add the repository and the matching dependency to your mod’s build.gradle, and you can call the Java API directly from your own code.

Latest release 3.0.0-beta.1

repositories {
    maven { url 'https://maven.tysontheember.dev' }
}

dependencies {
    // pick the artifact matching your loader + Minecraft version:
    // emberstextapi-fabric-1.20.1, emberstextapi-fabric-1.21.1, emberstextapi-fabric-26.1, emberstextapi-forge-1.20.1, emberstextapi-neoforge-1.21.1, emberstextapi-neoforge-26.1
    implementation 'net.tysontheember.emberstextapi:emberstextapi-neoforge-1.21.1:3.0.0-beta.1'
}

Browse every artifact and version in the Maven index →

Requirements

Your Gradle toolchain must match the Java version used to compile ETA for the target you’re building against.

MC version	Loader	Java
1.20.1	Forge	17
1.20.1	Fabric	17
1.21.1	NeoForge	21
1.21.1	Fabric	21
26.1.x	NeoForge	25
26.1.x	Fabric	25

Add the Maven repository

build.gradle

repositories {
    maven { url = 'https://maven.tysontheember.dev' }
}

Add the dependency

Set eta_version in your gradle.properties to the version you want to pin to, then reference it in build.gradle.

gradle.properties

eta_version=3.0.0-beta.1

Fabric 1.20.1

build.gradle

dependencies {
    modImplementation "net.tysontheember.emberstextapi:emberstextapi-fabric-1.20.1:${eta_version}"
}

If you want ETA bundled inside your jar (so players don’t need to install it separately), add include alongside modImplementation:

include "net.tysontheember.emberstextapi:emberstextapi-fabric-1.20.1:${eta_version}"

Fabric 1.21.1

build.gradle

dependencies {
    modImplementation "net.tysontheember.emberstextapi:emberstextapi-fabric-1.21.1:${eta_version}"
}

Fabric 26.1

build.gradle

dependencies {
    implementation "net.tysontheember.emberstextapi:emberstextapi-fabric-26.1:${eta_version}"
}

Note

MC 26.1 is unobfuscated. Fabric Loom uses implementation rather than modImplementation for dependencies that don’t need remapping.

NeoForge 1.21.1

build.gradle

dependencies {
    implementation "net.tysontheember.emberstextapi:emberstextapi-neoforge-1.21.1:${eta_version}"
}

NeoForge artifacts use Mojang mappings natively, so no deobfuscation step is needed.

NeoForge 26.1

build.gradle

dependencies {
    implementation "net.tysontheember.emberstextapi:emberstextapi-neoforge-26.1:${eta_version}"
}

Forge 1.20.1

The published Forge jar is reobfuscated (SRG-mapped). Wrap it with fg.deobf() so ForgeGradle remaps it back to the names your code sees.

build.gradle

dependencies {
    implementation fg.deobf("net.tysontheember.emberstextapi:emberstextapi-forge-1.20.1:${eta_version}")
}

Older Loom versions

Building against the Fabric jar with an older Loom (for example an Architectury project capped at Loom 1.13.469)? Add this to your gradle.properties:

loom.ignoreDependencyLoomVersionValidation=true

Without it, Loom rejects the dependency because the jar was published with a newer Loom than your build uses.

Project layout

In a typical multi-loader project, ETA belongs in your loader-specific subprojects, not in your common module (which can’t resolve Minecraft-specific types at compile time).

• build.gradle (root)
• gradle.properties (eta_version goes here)
• Directorycommon-1.21.1/

  • Directorysrc/main/java/ (your shared logic, calls ETA via the API interface)

    • …
• Directoryfabric-1.21.1/

  • build.gradle (modImplementation for ETA here)
  • Directorysrc/main/java/

    • …
• Directoryneoforge-1.21.1/

  • build.gradle (implementation for ETA here)
  • Directorysrc/main/java/

    • …

Tip

If your common module compiles against ETA types, add ETA as a compileOnly dep in the common subproject so the types are available at compile time without bundling a second copy.

Verify the dependency resolved

After syncing your Gradle project, run the dependencies task for the subproject you added ETA to and grep for the artifact:

Fabric 1.21.1

./gradlew :fabric-1.21.1:dependencies | grep emberstextapi

Expected output (version will differ):

\--- net.tysontheember.emberstextapi:emberstextapi-fabric-1.21.1:3.0.0-beta.1

NeoForge 1.21.1

./gradlew :neoforge-1.21.1:dependencies | grep emberstextapi

Expected output:

\--- net.tysontheember.emberstextapi:emberstextapi-neoforge-1.21.1:3.0.0-beta.1

Forge 1.20.1

cd forge-1.20.1 && ./gradlew dependencies | grep emberstextapi

Expected output:

\--- net.tysontheember.emberstextapi:emberstextapi-forge-1.20.1:3.0.0-beta.1

Sending Messages Construct and send an ImmersiveMessage from Java.

Text Spans Build styled text with the span builder API.

Markup from Java Parse and apply ETA markup tags programmatically.

Custom Effects Register your own text and message effects.