Text Placeholder API — мод на библиотеку подстановок в Майнкрафте
Text Placeholder API — небольшая служебная библиотека для создания и разбора подстановок внутри строк и игровых текстовых компонентов. Совместимый мод может оставить в шаблоне обозначение вроде переменной, а при выводе заменить его актуальным значением или переданными данными. Благодаря общему формату разные проекты настраиваются похожим образом и реже нуждаются в отдельных интеграциях друг с другом. Дополнительный упрощённый формат текста помогает задавать оформление в конфигурациях, чатах и других пользовательских строках без громоздкого JSON. В отличие от самостоятельных модов сообщений или интерфейса, библиотека предоставляет фундамент другим разработкам, но сама не определяет, где именно появится обработанный текст.
Последний релиз вышел 2 дня назад — проект активно поддерживают, и под свежие версии игры сборки появляются быстро.
| Версия игры | Загрузчики | Сборка | Размер | Дата |
|---|---|---|---|---|
| 1.20.1 | Fabric, Quilt | 2.1.4+1.20.1 | 143 КБ | 2025-01-27 |
| 1.21.1 | Fabric, Quilt | 2.4.2+1.21 | 226 КБ | 2025-01-27 |
| 1.20 | Fabric | 2.1.1+1.20 | 132 КБ | 2023-06-11 |
| 1.21 | Fabric, Quilt | 2.4.2+1.21 | 226 КБ | 2025-01-27 |
| 26.1.2 | Fabric | 3.0.0+26.1 | 248 КБ | 2026-04-11 |
| 26.2 | Fabric | 3.1.0-beta.1+26.2 | 248 КБ | 2026-05-27 |
Скачать 3.2.0+26.3 · 248 КБстраница автора на Modrinth
.jar в папку .minecraft/mods — создайте её, если её нет.| Сборка | Канал | Версии игры | Размер | Дата |
|---|---|---|---|---|
| 3.2.0+26.3 | релиз | 26.3-pre-3 | 248 КБ | 2026-09-09 |
| 3.1.0-beta.1+26.2 | релиз | 26.2, 26.2-pre-1 | 248 КБ | 2026-05-27 |
| 3.1.0-beta.1+26.2 | релиз | 26.2-pre-1 | 248 КБ | 2026-05-27 |
| 3.0.0+26.1 | релиз | 26.1, 26.1.1, 26.1.2 | 248 КБ | 2026-04-11 |
| 3.0.0-beta.2+26.1 | релиз | 26.1, 26.1-pre-3, 26.1.1, 26.1.2, 26w14a | 241 КБ | 2026-03-18 |
| 3.0.0-beta.1+26.1 | бета | 26.1-snapshot-7 | 236 КБ | 2026-02-14 |
Библиотека не добавляет интерфейсы, предметы, команды или готовую систему серверных сообщений сама по себе. Без совместимого проекта её установка почти ничего не изменит. Она не заменяет мод для чата, прав, локализации либо администрирования и не заставляет сторонние проекты понимать подстановки, если их авторы не реализовали соответствующую поддержку.
Если подстановка остаётся в сообщении без изменений, сначала проверьте, действительно ли мод, выводящий эту строку, поддерживает Text Placeholder API и правильно ли записано пространство имён, тип и необязательные данные. Ошибка в разделителях, лишний пробел или устаревший синтаксис могут помешать разбору шаблона. Когда не применяется цвет или другое оформление, полезно временно заменить сложную строку коротким примером и отдельно проверить упрощённый формат текста. Если библиотека установлена, но видимого эффекта нет, это не обязательно сбой: многие проекты включают её внутрь собственного файла и обращаются к ней только в определённых настройках. При диагностике сопоставьте документацию конкретного мода с перечнем доступных ему подстановок.
Рекомендуем Text Placeholder API разработчикам, авторам сборок и администраторам, которые настраивают моды с заявленной поддержкой шаблонов. Он полезен, когда несколько проектов должны одинаково обрабатывать переменные и оформленные строки. Обычному игроку устанавливать библиотеку «на всякий случай» не требуется: разумнее делать это по указанию совместимого мода или ради обновления уже встроенного компонента.
YACL предоставляет другим модам готовую основу для создания удобных экранов настроек. Самостоятельного контента библиотека не добавляет и обычно устанавливается как требуемая зависимость.
Fzzy Config обеспечивает другим модам хранение, проверку и синхронизацию настроек с автоматически создаваемыми экранами. Самостоятельного игрового контента библиотека не добавляет и устанавливается ради проектов, которым нужна её система конфигурации.
Игрок получает единый экран настроек для изменения конфигураций установленных модов прямо в игре. Можно искать параметры, просматривать допустимые значения, отменять правки и возвращать отдельные пункты или целые файлы к исходному состоянию.
WorldEdit — редактор мира, который работает прямо внутри Minecraft. Он выделяет области, копирует и вставляет постройки, сохраняет схемы, меняет большие объёмы блоков и помогает формировать рельеф кистями вместо долгой ручной укладки.
EMI Loot дополняет просмотрщик EMI сведениями о добыче из сундуков, блоков и существ. Возможные предметы группируются по вероятности, а условия вроде Шёлкового касания, ножниц, огня или чар добычи показываются отдельно.
EMI Enchanting добавляет в EMI справочник по зачарованиям: максимальный уровень, статус проклятия, доступность у жителей, подходящие предметы, описание и список взаимоисключающих чар. Между разделами можно переключаться кнопками внизу экрана.
Случайные находки из каталога — моды, шейдеры, текстуры и сборки с нашим разбором.
old sounds pack возвращает музыку и звуки эпохи Alpha и Beta, включая старые эффекты урона, дверей, стрел, снежков и зарядов ветра.
Alex Adventure Pro Max объединяет первобытные пещеры, драконов, космос, магию, Create, энергетические технологии, украшения и множество существ.
Create Big Cannons добавляет в Create многоблочные пушки и скорострельные автопушки разных материалов и уровней. Кинетические механизмы заряжают и наводят орудия, а набор снарядов и взрывателей определяет способ поражения цели.
Sodium Options API помогает собрать графические настройки и параметры дополнений в более удобном меню с категориями. Для разработчиков это единый программный интерфейс добавления страниц, групп и отдельных переключателей, а для игроков — вспомогательная библиотека, которая сама по себе почти не меняет игру.
![Изображение к проекту UK Signs [MTR 3/4]](/s/uk-signs-mtr.webp)
![Иконка UK Signs [MTR 3/4]](/i/uk-signs-mtr.webp)
UK Signs добавляет в Minecraft Transit Railway британские станционные знаки, логотип British Rail и табло отправлений. Оформление сочетает реалистичные модели, шрифты, GUI и локализованный транспортный декор.
Simple Brightness повышает яркость поверхности и делает её немного естественнее, улучшая вид игры.
Обе стороны указаны как необязательные, поэтому универсального требования нет. Место установки определяет использующий библиотеку мод: обработка серверного сообщения может происходить на сервере, а клиентского элемента — на клиенте. Следуйте инструкции конкретного проекта или сборки, а не устанавливайте файл автоматически везде.
Основной формат строится вокруг идентификатора мода и типа подстановки; при необходимости к ним добавляются данные. Однако фактический набор значений зависит от подключённых проектов и доступного списка подстановок. Нельзя считать, что любое придуманное обозначение автоматически вернёт имя игрока, время или другую информацию.
Он предназначен для читаемой записи оформленных строк там, где пользователю неудобно вручную составлять JSON: например, в конфигурации или вводимом тексте. Библиотека разбирает такую запись, а совместимый проект решает, где показать результат. Это средство представления, а не отдельный редактор с графическим интерфейсом.
Разработчики могут включать её внутрь собственного мода по схеме Jar-in-Jar. Тогда необходимый компонент уже поставляется вместе с проектом и отдельный файл обычно не нужен. Самостоятельная загрузка имеет смысл, если этого требует инструкция, сборка ожидает внешний экземпляр либо необходимо заменить встроенную редакцию более подходящей.