Back to mods
CourierAPI project artwork

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which CourierAPI release matches 26.1?

Updated 6 months ago
Best match for your filters CourierAPI 0.1-26.1
Game version 26.1
Loader Fabric

CourierAPI 0.1-26.1 targets 26.1 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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does CourierAPI 0.1-26.1 need?

CourierAPI 0.1-26.1 on 26.1. Every mod below is checked against that same setup.

No extra mods listed for this file

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 on 26.1. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use CourierAPI 0.1-26.1. It targets 26.1 with Fabric; another release may have different loader, side or dependency requirements.

  2. 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.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside CourierAPI 0.1-26.1. It opens that exact file at the source.

About this project

What does CourierAPI add?

CourierAPI Logo.

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 /courier command for operators
  • Auto-creates a sample couriernotifications.json on 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.

4 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

CourierAPI versions and loaders

1 of 4 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.