Text Placeholder API

Библиотека создаёт и разбирает плейсхолдеры внутри строк и текстовых компонентов Minecraft. Плейсхолдеры записываются в формате %modid:type% или %modid:type data% и позволяют менять то, какая информация и в каком месте выводится в совместимых модах. За счёт общего механизма разные моды настраиваются похожим образом и не конфликтуют друг с другом.

Игрокам это даёт гибкую настройку текста в конфигах и чате: вместо ручного JSON можно использовать Simplified Text Format и оформлять подписи в читаемом виде. Разработчикам библиотека экономит время — не нужно делать отдельные API под каждый мод, достаточно подключить её и добавить свои плейсхолдеры. Систему разбора можно применять и для подстановки собственных значений в текст, который ввёл игрок или который прочитан из конфига.

Что внутри

• создание и разбор плейсхолдеров в строках и текстовых компонентах;
• Simplified Text Format (TextParserV1) для оформления без ручного JSON;
• QuickText — простой формат для ввода в конфигах и чате;
• TextNodes и NodeParsers для расширения разбора;
• стандартный список плейсхолдеров и списки от отдельных модов.

Моды обычно включают библиотеку напрямую через Jar-in-Jar, так что отдельная установка чаще всего не нужна. Проект работает на Fabric и Quilt, поддержка клиента и сервера — необязательная, лицензия — GNU Lesser General Public License v3.0 only. Поддерживаются версии игры начиная с 1.17.