message-api

Универсальный API для работы с сообщениями на серверах Fabric. Обеспечивает поддержку локализуемых сообщений с возможностью использования подстановочных параметров через PlaceholderAPI, что позволяет легко настраивать текст конечными пользователями.

Основные возможности

• Поддержка подстановочных параметров через PlaceholderAPI
• Простая настройка внутриигровых сообщений
• Локализация для разных языков
• Легкая интеграция в существующие проекты

Использование

Подключение зависимости

Для использования message-api в вашем моде добавьте следующие строки в файл build.gradle:

repositories {
    maven { url "https://maven.nucleoid.xyz/" }
    maven { url "https://api.modrinth.com/maven" }
}

dependencies {
    include(modImplementation("maven.modrinth:message-api:[ТЕГ]"))
    include(modImplementation("eu.pb4:placeholder-api:[ТЕГ]"))
}

Добавление сообщений

Создайте папку messages в директории ресурсов. Создайте JSON файл с соответствующим языковым кодом, как в примере для тестового мода. Добавьте свои сообщения в файл, обязательно используя префикс мода в идентификаторах сообщений для избежания конфликтов.

Создание сообщений

Используйте любые из предоставленных методов в LocalizedMessage для получения текстовых экземпляров, которые работают так же, как обычные текстовые экземпляры из ванильной игры!

ServerPlayerEntity player;
player.sendMessageToClient(LocalizedMessage.localized("modid.some.message.id"));

Настройка пользователем

Для изменения сообщений отредактируйте JSON файл по пути ./config/<modid>/<languageid>.json. Это изменит языковой файл для указанного мода.

Благодарности

Отдельная благодарность PlaceholderAPI за предоставленную функциональность парсинга.