Installation

EmbersTextAPI is a client+server mod. Both the host and every player need it installed. Drop the jar in mods/ and you’re done.

Requirements

Minecraft	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

No other mods are required. Fabric API is not a dependency.

Install the mod

Modrinth

1. Open the EmbersTextAPI page on Modrinth.
2. Select your Minecraft version and loader in the version filter.
3. Download the jar and drop it in your mods/ folder.

CurseForge

1. Open the EmbersTextAPI page on CurseForge.
2. Select your Minecraft version and loader under Files.
3. Download the jar and drop it in your mods/ folder.

Manual / build from source

Download the jar that matches your loader and Minecraft version from either distribution platform above, or build from source:

# Fabric and NeoForge (all versions)
./gradlew assemble

# Forge 1.20.1
cd forge-1.20.1 && ./gradlew assemble

Jars land in each subproject’s build/libs/ directory.

First launch

On the first run ETA writes its config files into the config/ folder next to your mods/ folder. The exact filenames depend on your loader:

Loader	Client config	Server config
NeoForge / Forge	emberstextapi-client.toml	emberstextapi-server.toml
Fabric	emberstextapi-client.json	emberstextapi-server.json

Note

The defaults are sensible out of the box. You do not need to edit the config to use ETA. The server config controls who can use markup in chat, signs, and anvils; the client config has options for reducing motion and capping render quality.

Verify it loaded

Once you are in a world, op yourself (single-player pauses and grants op by default; on a server add yourself to ops.json or run /op <name> from the console). Then run:

/eta test 1

A plain white text message should appear on your HUD. If it does, ETA is working. IDs 1 through 33 each demonstrate a different effect; /eta test 26 shows inline item rendering as a good showcase of what the system can do.

Your First Effect Send a styled HUD message and rename an item using markup.

How ETA Works The two rendering paths and when each applies.