В Minecraft многие моды используют плейсхолдеры для отображения динамической информации - здоровья игрока, координат, времени суток и так далее. Раньше каждый мод реализовывал свой формат, что создавало путаницу при совместном использовании. Text Placeholder API решает эту проблему, предлагая единый стандарт.

О Text Placeholder API

Это небольшая библиотека для Майнкрафт (Minecraft) с поддержкой Jar-in-Jar, которая позволяет создавать и парсить плейсхолдеры в строках и текстовых компонентах игры. Placeholder API использует простой формат %modid:type% или %modid:type data% (до версии 1.19 было %modid:type/data%). Также включает упрощённый текстовый формат (Simplified Text Format) для удобного ввода пользователем в конфигах, чате и других местах.

Для пользователей

Благодаря этой библиотеке вы можете настраивать несколько модов единообразно - без потери совместимости. Плейсхолдеры позволяют менять, какая информация и где отображается в совместимых модах. Simplified Text Format даёт возможность стилизовать текст читабельно без ручного написания JSON или использования генераторов.

• Использование плейсхолдеров
• Список стандартных плейсхолдеров
• Список плейсхолдеров модов
• QuickText
• Simplified Text Format

Моды, использующие эту API, обычно подключают её напрямую через Jar-in-Jar.

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

Использование Placeholder API - простой способ добиться хорошей совместимости модов без необходимости реализовывать несколько специфических API разных модов. Система парсинга плейсхолдеров также может использоваться для замены собственных статических или динамических плейсхолдеров в тексте, созданном игроком или прочитанном из конфига. В сочетании с Simplified Text Format это позволяет создать отличный опыт как для пользователей, так и для администраторов.

• Начало работы
• Добавление плейсхолдеров
• Парсинг плейсхолдеров
• TextNodes и NodeParsers
• Использование Simplified Text Format (TextParserV1)

*[JIJ]: Jar-in-Jar