Placeholder API NeoForge

Мод Placeholder API NeoForge для Minecraft 1.21.11

Placeholder API NeoForge — это неофициальная порция популярной библиотеки для работы с текстовыми плейсхолдерами, адаптированная под загрузчик NeoForge. Мод позволяет вставлять динамические данные в строки и компоненты текста Minecraft, используя простой формат %modid:type% или %modid:type/data%. Оригинальный проект был разработан Patbox и изначально поддерживал Fabric (Paper), а данный порт создан OffsetMonkey538 для использования в проектах на NeoForge.

О библиотеке и её назначении

Placeholder API NeoForge — это неофициальная порция популярной библиотеки для работы с текстовыми плейсхолдерами, адаптированная под загрузчик NeoForge. Оригинальный проект был разработан Patbox и изначально поддерживал Fabric (Paper), а данный порт создан OffsetMonkey538. Библиотека предоставляет простой и универсальный механизм подстановки данных в игровом тексте, позволяя создавать и парсить плейсхолдеры внутри строк и компонентов текста Minecraft. Это ключевой инструмент для администраторов серверов и разработчиков плагинов, которым нужно динамически заполнять сообщения, чаты и конфигурационные файлы данными игроков или сервера.

Формат плейсхолдеров и синтаксис

Основой работы библиотеки является формат, начинающийся с идентификатора мода, за которым следует двоеточие и тип данных. Например, %modid:type% используется для базовых значений, а %modid:type/data% — для доступа к дополнительным параметрам. Также в сборке реализован упрощённый формат для текстовых строк, который облегчает ввод настроек в конфигурационных файлах и чатах. Этот синтаксис делает интеграцию гибкой: разработчики могут легко встраивать переменные в любые текстовые сообщения без необходимости писать сложный код для их получения.

Интеграция в проекты для разработчиков

Для подключения библиотеки к собственным проектам необходимо добавить соответствующий репозиторий Maven и зависимость в скрипт сборки. Ниже приведён пример конфигурации для Gradle:

```groovy
repositories {
    // ... другие репозитории
    maven("https://maven.offsetmonkey538.top/releases") { name = "OffsetMonkey538" }
}

dependencies {
    // ... другие зависимости
    implementation "eu.pb4:placeholder-api-neoforge:[VERSION]"
}
```

После подключения библиотека позволяет использовать её API для генерации текста с плейсхолдерами. Важно помнить, что при использовании в качестве зависимости пользователи должны будут вручную скачать и установить сам мод-библиотеку в папку с сервером, так как она не распространяется автоматически через игровые загрузчики. Для JIJ-интеграции (интеграция на уровне игры) следует обратиться к документации NeoForge.