CourierAPI
No reviews yet
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.
Fabric is a mod loader for versions 1.14+ of Minecraft, particularly popular for client side and optimization mods.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
Modrinth
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
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.1Then 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 playersClient 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).
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).
Screenshots
Gallery
-
Notifications in action -
Up to 4 notifications
-
Notifications on Screen -
Notifications Animation
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers