CourierAPI

CourierAPI — это библиотека-мод для Fabric, позволяющая любому моду отправлять игрокам анимированные HUD-уведомления — через Java API, JSON-файлы или игровые команды. Поддерживает рассылку с сервера на клиент и локальный показ на стороне клиента.

Возможности

• Анимированные карточки с выездом и уездом в правом верхнем углу HUD
• Полностью настраиваемые цвета — заголовок, описание, фон и акцентная рамка (ARGB)
• Настраиваемая длительность показа для каждого уведомления
• До 4 уведомлений одновременно; остальные встают в очередь автоматически
• Описание переносится на вторую строку, если текст слишком длинный
• Сервер → Клиент — отправляйте уведомления через Java API или JSON-файлы, программировать не нужно
• Только клиент — показывайте уведомления локально из другого клиентского мода без сервера
• Готовая команда /courier для операторов
• Автоматически создаёт пример couriernotifications.json при первом запуске сервера

Для разработчиков

Добавьте в ваш gradle.properties:

courierapi_version=0.1

Затем в build.gradle:

repositories {
    maven {
        name = "LunazStudios"
        url  = "https://maven.lunazstudios.com/releases"
    }
}

dependencies {
    modImplementation "com.lunazstudios:CourierAPI:${project.minecraft_version}-${project.courierapi_version}"
}

Полная документация и примеры использования API доступны в репозитории на GitHub.

Серверный 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

Клиентский API

// Client-side only — do not call on a dedicated server
CourierClientAPI.showLocal(n);

JSON — без программирования

Поместите couriernotifications.json в корень сервера, чтобы задать переиспользуемые уведомления:

{
  "restart_warning": {
    "title": "Server Restart",
    "description": "The server restarts in 5 minutes.",
    "duration": 8,
    "border_color": "#FF5555"
  }
}

Запускайте их в игре командой /courier send restart_warning или добавляйте записи в couriernotifications_queue.json, чтобы отправлять их из внешних скриптов или RCON — перезапуск не нужен.

Команды

Требуется уровень прав 2 (оператор).