Text Placeholder API — мод на библиотеку подстановок в Майнкрафте
Text Placeholder API — небольшая служебная библиотека для создания и разбора подстановок внутри строк и игровых текстовых компонентов. Совместимый мод может оставить в шаблоне обозначение вроде переменной, а при выводе заменить его актуальным значением или переданными данными. Благодаря общему формату разные проекты настраиваются похожим образом и реже нуждаются в отдельных интеграциях друг с другом. Дополнительный упрощённый формат текста помогает задавать оформление в конфигурациях, чатах и других пользовательских строках без громоздкого JSON. В отличие от самостоятельных модов сообщений или интерфейса, библиотека предоставляет фундамент другим разработкам, но сама не определяет, где именно появится обработанный текст.
Последний релиз вышел 1 месяц назад — проект активно поддерживают, и под свежие версии игры сборки появляются быстро.
| Версия игры | Загрузчики | Сборка | Размер | Дата |
|---|---|---|---|---|
| 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, 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 справочник по зачарованиям: максимальный уровень, статус проклятия, доступность у жителей, подходящие предметы, описание и список взаимоисключающих чар. Между разделами можно переключаться кнопками внизу экрана.
Случайные находки из каталога — моды, шейдеры, текстуры и сборки с нашим разбором.
CoreCraft — умеренно лёгкая ванильно ориентированная сборка с классами, магией, навыками, новыми структурами и существами, удобствами, партиями и голосовым чатом.
Allure Emoji Pack заменяет односимвольные эмодзи шрифта Unifont собственными пиксельными рисунками, согласованными с визуальной сеткой Minecraft.
Quality Advancements добавляет 19 достижений за путешествия, добычу, рискованные трюки и обычные этапы развития.
The Plague of the Moon добавляет ночного монстра, который наблюдает за игроком, преследует его и при определённых условиях атакует.
VanillAqua Reflections сосредоточен на реалистичной воде и деликатных ванильных визуальных улучшениях.
Черепаший шлем превращается в маленькую живую черепаху с головой и короткими лапками. Набор меняет модель одного предмета экипировки, не добавляя новых существ или игровых механик.
Обе стороны указаны как необязательные, поэтому универсального требования нет. Место установки определяет использующий библиотеку мод: обработка серверного сообщения может происходить на сервере, а клиентского элемента — на клиенте. Следуйте инструкции конкретного проекта или сборки, а не устанавливайте файл автоматически везде.
Основной формат строится вокруг идентификатора мода и типа подстановки; при необходимости к ним добавляются данные. Однако фактический набор значений зависит от подключённых проектов и доступного списка подстановок. Нельзя считать, что любое придуманное обозначение автоматически вернёт имя игрока, время или другую информацию.
Он предназначен для читаемой записи оформленных строк там, где пользователю неудобно вручную составлять JSON: например, в конфигурации или вводимом тексте. Библиотека разбирает такую запись, а совместимый проект решает, где показать результат. Это средство представления, а не отдельный редактор с графическим интерфейсом.
Разработчики могут включать её внутрь собственного мода по схеме Jar-in-Jar. Тогда необходимый компонент уже поставляется вместе с проектом и отдельный файл обычно не нужен. Самостоятельная загрузка имеет смысл, если этого требует инструкция, сборка ожидает внешний экземпляр либо необходимо заменить встроенную редакцию более подходящей.