<\/p>\n
**CourierAPI** is a Fabric mod library that lets any mod send animated HUD notification cards to players \u2014 via the Java API, JSON files, or in-game commands. Supports server-to-client broadcasting and client-side local display.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– Animated slide-in \/ slide-out cards in the top-right corner of the HUD
\n– Fully customizable colors \u2014 title, description, background, and border accent (ARGB)
\n– Configurable display duration per notification
\n– Up to 4 notifications visible at once; extras queue automatically
\n– Description wraps to a second line when text is too long
\n– **Server \u2192 Client** \u2014 send notifications via Java API or JSON files, no coding required
\n– **Client-only** \u2014 display notifications locally from another client mod without a server
\n– Drop-in `\/courier` command for operators
\n– Auto-creates a sample `couriernotifications.json` on first server start<\/p>\n
—<\/p>\n
## For Developers<\/p>\n
Add to your `gradle.properties`:<\/p>\n
“`properties
\ncourierapi_version=0.1
\n“`<\/p>\n
Then in `build.gradle`:<\/p>\n
“`gradle
\nrepositories {
\n maven {
\n name = “LunazStudios”
\n url = “https:\/\/maven.lunazstudios.com\/releases”
\n }
\n}<\/p>\n
dependencies {
\n modImplementation “com.lunazstudios:CourierAPI:${project.minecraft_version}-${project.courierapi_version}”
\n}
\n“`<\/p>\n
Full documentation and API usage examples are available on the GitHub repository.<\/p>\n
—<\/p>\n
## Server API<\/p>\n
“`java
\nNotification n = Notification.builder(“Event Started!”, “Head to the arena.”)
\n .durationSeconds(6)
\n .borderColor(0xFFFF4444)
\n .build();<\/p>\n
CourierAPI.send(player, n); \/\/ single player
\nCourierAPI.broadcast(server, n); \/\/ all online players
\n“`<\/p>\n
## Client API<\/p>\n
“`java
\n\/\/ Client-side only \u2014 do not call on a dedicated server
\nCourierClientAPI.showLocal(n);
\n“`<\/p>\n
—<\/p>\n
## JSON \u2014 No Coding Required<\/p>\n
Place `couriernotifications.json` in your server root to define reusable notifications:<\/p>\n
“`json
\n{
\n “restart_warning”: {
\n “title”: “Server Restart”,
\n “description”: “The server restarts in 5 minutes.”,
\n “duration”: 8,
\n “border_color”: “#FF5555”
\n }
\n}
\n“`<\/p>\n
Trigger them in-game with `\/courier send restart_warning`, or drop entries into
\n`couriernotifications_queue.json` to dispatch from external scripts or RCON \u2014 no restart needed.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | *Requires permission level 2 (operator).*<\/p>\n","protected":false},"excerpt":{"rendered":" CourierAPI is a Fabric mod library that lets any mod send animated HUD notification cards to players \u2014 via the Java API, JSON files, or in-game commands. Supports server-to-client broadcasting and client-side local display.<\/p>\n","protected":false},"featured_media":46652,"template":"","meta":{"_minecraft_slug":"courierapi","_minecraft_project_id":"JNFl3QKb","_minecraft_author":"LunazStudios","_minecraft_license":"MIT","_minecraft_downloads":18,"_minecraft_follows":0,"_minecraft_client_side":"required","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"courierapi.zip","_minecraft_size_bytes":114814,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T14:26:32.558698Z","_minecraft_date_created":"2026-04-30T22:43:23.590455Z","_minecraft_date_modified":"2026-04-25T14:25:12.932774Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/courierapi","_minecraft_icon_attachment_id":46652,"_minecraft_imported_at":"2026-06-02T10:07:10+00:00","_minecraft_import_hash":"b37fe0ad2baf4818577f663d155feca1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873,92],"mod_loader":[99],"minecraft_version":[41,83,167,163],"class_list":["post-46651","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-11","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|—|—|
\n| `\/courier send
\n| `\/courier reload` | Reload `couriernotifications.json` from disk |<\/p>\n