Скачать Text Placeholder API

Описание Text API для подстановок

техническая библиотека Patbox для модов Minecraft на Fabric и Quilt. Ее задача не в том, чтобы добавить новый блок, предмет или отдельный интерфейс, а в том, чтобы дать другим модам единый способ подставлять значения в строки и текстовые компоненты Minecraft. Такой ресурс чаще всего оказывается в сборке как зависимость: игрок видит его в списке модов, но реальная польза раскрывается через проекты, которые используют общий формат подстановок. Библиотека работает с короткими токенами, которые можно хранить в конфигурациях, сообщениях, строках чата и пользовательских текстах. Мод передает строку на разбор, API находит знакомые выражения и заменяет их значениями: именем игрока, серверной информацией, данными другого совместимого мода или статичным текстом, который сам разработчик зарегистрировал заранее. Это упрощает настройку для пользователей и снижает количество частных, несовместимых решений. > Важно не путать этот проект с серверными расширениями для Bukkit-плагинов: здесь речь о библиотеке для Fabric/Quilt-модов и о работе с Minecraft Text Components, а не о самостоятельной системе для Paper-сервера. Сильная сторона ресурса — аккуратная инфраструктурная роль. Если несколько модов используют один и тот же способ чтения подстановок, администратору проще переносить формат между конфигами, а разработчику не нужно заново писать парсер для каждого проекта. В документации также описан упрощенный формат текста, который помогает оформлять пользовательские строки без ручного JSON и без громоздких генераторов. Поэтому библиотеку стоит воспринимать как слой совместимости: она не делает игру громче или сложнее, но помогает модам говорить на одном текстовом языке.

Что делает ресурс Библиотека решает две близкие задачи: разбирает подстановки в строках и помогает преобразовывать пользовательский текст в формат, понятный Minecraft. Для модов это удобный способ связать конфигурацию, чат, таблички, интерфейсы и динамические значения. Для игрока или администратора это означает, что в совместимом моде можно написать компактную строку, а игра подставит туда нужные данные во время выполнения. | Область | Что дает библиотека | Для кого полезно | | --- | --- | --- | | Строки конфигурации | Разбор токенов и замена на значения | Пользователи модов и администраторы сборок | | Text Components | Работа с текстом Minecraft без ручного JSON | Разработчики модов и авторы интерфейсов | | Совместимость | Единый формат между разными проектами | Модпаки с несколькими зависимыми модами | | Распространение | Возможность включать API внутрь мода через Jar-in-Jar | Авторы, которым нужна компактная зависимость | Официальный формат выглядит просто и читается даже без знания кода. Базовый вариант содержит идентификатор мода и тип значения, а расширенный вариант позволяет добавить данные после пробела: text %modid:type% %modid:type data% %server:tps% %player:name% До старых веток 1.19 в документации встречался вариант с разделителем через косую черту, но для современных описаний важно ориентироваться на формат с пробелом для дополнительного параметра. Конкретные имена зависят от мода, который регистрирует значение, поэтому универсального списка для всех сборок не существует. Общие и модовые списки лучше проверять в документации проекта или на странице мода, который требует эту библиотеку. Практическая ценность для разработчика заметна в нескольких местах:

• можно регистрировать собственные статичные и динамические значения;
• можно разбирать пользовательский текст из конфигов без отдельного самописного синтаксиса;
• можно отдавать результат как обычную строку или как текстовый компонент Minecraft;
• можно поддерживать совместимость с другими модами, которые уже используют тот же формат;
• можно подключать библиотеку как зависимость и при необходимости включать ее внутрь итогового jar;
• можно дать пользователям читаемую настройку цвета, стилей и значений через упрощенный текстовый формат;
• можно избежать ситуации, когда каждый мод из сборки придумывает собственные обозначения для одних и тех же данных.

Особенности Ресурс относится к категории библиотек, поэтому его качество измеряется не количеством видимого контента, а предсказуемостью для других проектов. Он маленький по роли, но находится в центре многих текстовых сценариев: уведомления, строки интерфейса, подсказки, чатовые сообщения, статусные панели, команды и элементы конфигурации. Если мод уже использует эту библиотеку, пользователю обычно не нужно изучать Java-код; достаточно понять общий синтаксис и список доступных значений. Отдельно полезен упрощенный формат текста. В Minecraft сложное оформление часто требует JSON-компонентов, а это неудобно для обычного редактирования конфигов. Здесь авторы могут предложить более читаемую запись, которую легче хранить, проверять и объяснять пользователям. Это не отменяет возможностей Text Components, но делает путь к ним короче. С точки зрения модпака библиотека хороша тем, что не навязывает один конкретный интерфейс. Она может быть незаметной зависимостью внутри другого мода, а может лежать отдельным файлом в папке mods, если сборке нужна обновленная версия. На Modrinth ресурс указан для Fabric и Quilt, а стороны клиента и сервера отмечены как optional: фактическая необходимость зависит от того, где установлен мод, который вызывает API. Пример того, как это может выглядеть в конфиге совместимого мода: text welcome_line: <green>Привет, %player:name% status_line: TPS сервера: %server:tps% footer_line: <gray>Значения обновляются модом, который их зарегистрировал Эта запись иллюстративна: имена значений и поддержка строк зависят от конкретного проекта. Но она показывает идею — вместо длинного JSON и ручной склейки текста пользователь получает компактную строку, которую проще читать и менять.

Совместимость и установка На странице Modrinth библиотека опубликована как мод для Fabric и Quilt с поддержкой широкого набора версий Minecraft, включая ветки 1.17, 1.18, 1.19, 1.20, 1.21 и более новые обозначения версий. На CurseForge ресурс также указан для Fabric и Quilt, а публичный репозиторий автора содержит исходный код, документацию и релизы. Устанавливать нужно файл под ту версию Minecraft и тот загрузчик, которые использует ваша сборка. Для игрока порядок действий обычный:

1. Проверьте, какой мод требует эту библиотеку, и какую версию Minecraft использует профиль.
2. Скачайте файл с Modrinth или другого официального зеркала проекта.
3. Выберите вариант для Fabric или Quilt, совпадающий с вашей сборкой.
4. Положите jar в папку mods, если зависимый мод не включает библиотеку сам.
5. Запустите игру и проверьте лог только при ошибке зависимости или несовпадении версии.
6. Не добавляйте ресурс на Bukkit/Paper-сервер как плагин: это другой тип экосистемы. Разработчикам важнее смотреть документацию: там есть разделы для начала работы, добавления значений, разбора строк, TextNodes/NodeParsers и упрощенного формата текста. Если библиотека подключается через Jar-in-Jar, пользователь может даже не видеть отдельный файл; если же сборке нужна обновленная версия, ее можно поставить как обычную зависимость в mods. При обновлении не стоит автоматически брать самый новый jar для старой сборки. У текстовых API меняются сигнатуры, поддерживаемые версии Minecraft и поведение парсера, поэтому зависимый мод может ожидать конкретную ветку. Лучший ориентир — страница версии на Modrinth, сообщение загрузчика и требования мода, который использует библиотеку.

Техническая сводка

• Тип: мод
• Название: Text API для подстановок
• Автор: Patbox
• Популярность: 40 032 334 загрузок по данным каталога
• Клиент / сервер: клиент: опционально, сервер: опционально
• Последнее обновление: 2026-04-11T07:52:54.914Z

Примечание MineMods: перед установкой Text API для подстановок сверяйте версию Minecraft, загрузчик, зависимости и сторону запуска. Если мод входит в большую сборку, сначала протестируйте его на отдельном профиле.

Вопросы и ответы

Это самостоятельный игровой мод?

Нет. Это библиотека для других Fabric/Quilt-модов. Она не добавляет измерения, мобов или предметы, а предоставляет код для разбора текстовых подстановок и работы с компонентами текста.

Нужно ли ставить ее на клиент и сервер?

Стороны на Modrinth отмечены как optional, потому что все зависит от зависимого мода. Если мод работает только на сервере, библиотека может понадобиться серверу; если он меняет клиентский интерфейс, она может понадобиться клиенту. Следуйте требованиям конкретного файла.

Чем этот ресурс отличается от Bukkit-систем для серверов?

Он предназначен для Fabric/Quilt-модов и Java-кода Minecraft, а не для установки в папку plugins Paper или Spigot. Его формат похож по идее на подстановки значений, но экосистема, загрузчики и способ подключения другие.

Можно ли писать свои значения?

Да, для разработчиков предусмотрена регистрация собственных значений и разбор строк. Пользователь же может применять только те имена, которые уже предоставлены библиотекой или модами в его сборке.

Почему в конфиге значение не заменяется?

Чаще всего причина в том, что конкретный мод не поддерживает этот участок текста, имя значения написано неверно или нужный мод не зарегистрировал данные. Проверьте документацию совместимого мода и список доступных значений для вашей версии.