CurseForge · Minecraft mod
CourierAPI
CourierAPI is a Fabric mod library that lets any mod send animated HUD notification cards to players — via the Java API, JSON files, or in-game commands. Supports server-to-client broadcasting and client-side local display.
Quick answer
Which CourierAPI release should I use?
CourierAPI 0.1-26.1.2 targets 26.1.2 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is CourierAPI required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does CourierAPI 0.1-26.1.2 need?
CourierAPI 0.1-26.1.2. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add CourierAPI without breaking your instance.
Built for CourierAPI 0.1-26.1.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use CourierAPI 0.1-26.1.2. It targets 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside CourierAPI 0.1-26.1.2. It opens that exact file at the source.
About this project
What does CourierAPI add?

CourierAPI is a Fabric mod library that lets any mod send animated HUD notification cards to players — via the Java API, JSON files, or in-game commands. Supports server-to-client broadcasting and client-side local display.
Features
- Animated slide-in / slide-out cards in the top-right corner of the HUD
- Fully customizable colors — title, description, background, and border accent (ARGB)
- Configurable display duration per notification
- Up to 4 notifications visible at once; extras queue automatically
- Description wraps to a second line when text is too long
- Server → Client — send notifications via Java API or JSON files, no coding required
- Client-only — display notifications locally from another client mod without a server
- Drop-in
/couriercommand for operators - Auto-creates a sample
couriernotifications.jsonon first server start
For Developers
Add to your gradle.properties:
courierapi_version=0.1
Then in build.gradle:
repositories {
maven {
name = "LunazStudios"
url = "https://maven.lunazstudios.com/releases"
}
}
dependencies {
modImplementation "com.lunazstudios:CourierAPI:${project.minecraft_version}-${project.courierapi_version}"
}
Full documentation and API usage examples are available on the GitHub repository.
Server API
Notification n = Notification.builder("Event Started!", "Head to the arena.")
.durationSeconds(6)
.borderColor(0xFFFF4444)
.build();
CourierAPI.send(player, n); // single player
CourierAPI.broadcast(server, n); // all online players
Client API
// Client-side only — do not call on a dedicated server
CourierClientAPI.showLocal(n);
JSON — No Coding Required
Place couriernotifications.json in your server root to define reusable notifications:
{
"restart_warning": {
"title": "Server Restart",
"description": "The server restarts in 5 minutes.",
"duration": 8,
"border_color": "#FF5555"
}
}
Trigger them in-game with /courier send restart_warning, or drop entries into couriernotifications_queue.json to dispatch from external scripts or RCON — no restart needed.
Commands
| Command | Description |
|---|---|
/courier send <id> |
Broadcast a notification to all online players |
/courier reload |
Reload couriernotifications.json from disk |
Requires permission level 2 (operator).
Project description from CurseForge.
Pick your setup
CourierAPI by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.1.1
1 loader build26.1
1 loader build1.21.11
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
CourierAPI versions and loaders
CourierAPI 0.1-26.1.2
CourierAPI-26.1.2-0.1.jar
25 Apr 2026
CourierAPI 0.1-26.1.1
CourierAPI-26.1.1-0.1.jar
25 Apr 2026
CourierAPI 0.1-26.1
CourierAPI-26.1-0.1.jar
25 Apr 2026
CourierAPI 0.1-1.21.11
CourierAPI-1.21.11-0.1.jar
25 Apr 2026
Looking for an older file? The official CurseForge project page is in Resources.