О Placeholder API Compat

Модификация представляет собой форк актуального релиза Text Placeholder API от Patbox, сохраняющий полную совместимость со всеми версиями Minecraft на Fabric начиная с 1.14.4.

Данный проект изначально разрабатывался для интеграции с моим мультиверсионным модом Discord-MC-Chat.

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

Для игроков

Поместите скачанный JAR-файл в папку mods своей игровой директории.

Важные моменты:

• Этот мод функционирует как библиотечная зависимость и начинает работу только при вызове другими модами
• Совместимый запуск с официальной версией Placeholder API от Patbox не вызывает конфликтов благодаря независимым библиотечным вызовам

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

Убедитесь, что ваш mainProject указывает на наиболее актуальную версию Minecraft.

Работайте исключительно с файлом common.gradle. Удалите зависимость eu.pb4:placeholder-api из соответствующего раздела.

Не добавляйте следующий код в build.gradle обёртки, так как это нарушит функциональность библиотеки для версий, отличных от указанной в mainProject:

repositories {
    maven {
        name = "Jitpack"
        url = "https://jitpack.io"
    }
}

dependencies {
    modCompileOnly("com.github.Xujiayao:TextPlaceholderAPI-Compat:2.6.1-compat.1")
}

Отредактируйте все существующие файлы fabric.mod.json:

{
    "depends": {
        "fabricloader": ">=0.16.10",
        "java": ">=21", 
        "placeholder-api-compat": "*"
    }
}

В заключение измените импортируемый пакет в вашем коде с eu.pb4.placeholders на com.xujiayao.placeholder_api_compat.

Техподдержка

При обнаружении ошибок или возникновении вопросов вы можете создать обращение на GitHub. Проблемы совместимости рассматриваются в этом репозитории, однако вопросы, касающиеся непосредственно Placeholder API, следует направлять в оригинальный репозиторий проекта.

Справка по Placeholder API

Placeholder API представляет собой компактную, способную к Jar-in-Jar встраиванию библиотеку для создания и обработки текстовых заполнителей в строках и Minecraft Text Components. Формат заполнителей использует простую схему %modid:type% или %modid:type data% (в версиях до 1.19 использовался формат %modid:type/data%).

Также включает упрощённые текстовые форматы для упрощения пользовательского ввода в конфигурациях, чатах и подобных элементах.

Проект находится под лицензией LGPL-3.0.