- Для версий
- 1.21.✘
- Документация
- https://ztextgenerator.groupez.dev/
Описание плагина zTextGenerator:
Преобразуйте обычные меню в увлекательный опыт, добавляя красивые динамичные тексты прямо внутрь ваших инвентарей.Будь то создание меню профиля, NPC в стиле RPG, интерактивных книг или магазинов и аукционных домов — с этим всё возможно.
Повышайте вовлечённость игроков, раскрывайте своё творчество и выделяйте свой сервер.
С zTextGenerator единственное ограничение — ваша фантазия.
Особенности плагина zTextGenerator:
МОЩНЫЕ ПЛЕЙСХОЛДЕРЫОтображайте текст где угодно с полной поддержкой плейсхолдеров.
СИСТЕМА КНИГ
Просто создавайте и управляйте текстами через интуитивный редактор в стиле книги.
СИСТЕМА АНИМИРОВАННОГО ТЕКСТА
Добавляйте плавные анимации текста, чтобы ваши меню и сообщения оживали.
ПОДДЕРЖКА MINIMESSAGE
Используйте полную мощность форматирования: цвета, градиенты и продвинутые стили.
Интеграция с ItemsAdder, Nexo & Oraxen
Полная совместимость с вашими любимыми плагинами ресурс-паков.
Интеграция с zMenu
Легко управляйте инвентарями и текстами благодаря zMenu.
Автоматический перевод текста
Тексты автоматически отображаются на языке каждого игрока. zTextGenerator адаптируется к локали игрока, делая ваши меню и сообщения доступными и увлекательными для всех, независимо от того, откуда они пришли.
Команды и права плагина zTextGenerator:
| Команда | Алиасы | Права | Описание |
|---|---|---|---|
| /text-generator | /text, /tg | ztextgenerator.use | — |
| /text-generator alphabet | — | ztextgenerator.test.alphabet | Тест выравнивания алфавита |
| /text-generator book <player> <book> <page> | — | ztextgenerator.book | Открыть книгу |
| /text-generator alphabet cancel <player> | — | ztextgenerator.test.alphabet | — |
| /text-generator alphabet letter <letter> <alphabet> [<letter by line>] [<max lines>] [<letter length>] [<inventory title>] [<inventory size>] | — | ztextgenerator.test.alphabet | — |
| /text-generator open <player> <text> [<animation>] [<speed>] | — | ztextgenerator.open | Открыть текст |
| /text-generator reload | /rl | ztextgenerator.reload | Перезагрузить конфигурационные файлы |
| /text-generator alphabet validation <alphabet> [<delay>] | — | ztextgenerator.test.alphabet | — |
Плэйсхолдеры плагина zTextGenerator:
| Плейсхолдер | Описание |
|---|---|
| %ztextgenerator_book_<book>_<page>% | Отображает содержимое конкретной страницы из вашей кастомной книги, созданной с помощью zTextGenerator. Аргументы: book → название книги, page → номер страницы. Пример: %ztextgenerator_book_tutorial_1% → отображает страницу 1 книги “tutorial”. |
| %ztextgenerator_center_<alphabet><height><text>% | Центрирует текст с использованием заданного алфавита. Идеально для заголовков, подзаголовков и ярлыков в инвентарях. Смещение будет восстановлено в исходное состояние, управлять отображением текста нужно самостоятельно. Аргументы: alphabet → набор алфавита, height → номер строки (начинается с 0), text → текст для центрирования. Пример: :offset_-48::generic_dark::offset_-168:<white>:offset_80:%ztextgenerator_center_normal_0_Hey how are you?%:offset_40:%ztextgenerator_center_normal_1_this is a centered placeholder% |
| %ztextgenerator_left_<alphabet><height><text>% | Выравнивает текст по левому краю с использованием заданного алфавита. Отлично подходит для структурированных или многострочных дизайнов. Смещение восстанавливается автоматически. Аргументы: alphabet, height, text. Пример: :offset_-48::generic_dark::offset_-168:<white>%ztextgenerator_left_normal_0_Hey how are you?%%ztextgenerator_left_normal_1_this is a left placeholder% |
| %ztextgenerator_length_<alphabet>_<text>% | Вычисляет визуальную длину текста на основе выбранного алфавита. Каждая буква может иметь индивидуальную ширину. Аргументы: alphabet, text. Пример: %ztextgenerator_length_default_Hello% → возвращает ширину слова “Hello” по умолчанию. |
| %ztextgenerator_right_<alphabet><height><text>% | Выравнивает текст по правому краю с использованием заданного алфавита. Смещение восстанавливается автоматически. Аргументы: alphabet, height, text. Пример: :offset_-48::generic_dark::offset_-8:<white>%ztextgenerator_right_normal_0_Hey how are you?%%ztextgenerator_right_normal_1_this is a right placeholder% |
| %ztextgenerator_text_<text>% | Отображает текст, автоматически адаптируясь к языку игрока. Если локализация отсутствует, показывается текст по умолчанию. Аргументы: text → ключ или идентификатор текста. Пример: %ztextgenerator_text_welcome_message% |
| %ztextgenerator_title_length_<title>% | Вычисляет ширину заголовка инвентаря. Полезно для центрирования и балансировки элементов GUI. Аргументы: title → текст заголовка. Пример: %ztextgenerator_title_length_Main_Menu% → возвращает ширину “Main Menu”. |
Установка плагина zTextGenerator:
Требования для работы:- Версия Java: 21 или новее
- Версия сервера: 1.21 – 1.21.8+
- Серверное ПО: Совместимо с Spigot, Paper и Folia (все форки на основе Paper работают)
- PlaceholderAPI: ОБЯЗАТЕЛЬНО (версия для Folia [здесь])
- ItemsAdder, Nexo или Oraxen: ОБЯЗАТЕЛЬНО
Шаги установки
- Скачайте zTextGenerator и все необходимые зависимости.
- Поместите файлы .jar в папку /plugins/.
- Запустите сервер.
- Настройте плагин.
- Установите текстур-пак.
- Перезапустите сервер — плагин готов к использованию!
- При загрузке плагина вы получите файл zTextGenerator-<версия плагина>.zip.
- Разместите файл zTextGenerator-<версия плагина>.zip в папке плагинов сервера.
- Распакуйте содержимое ZIP-файла. Это переместит и JAR-плагин, и файлы ресурспака в нужные папки.
- После распаковки перезапустите сервер.
- Сгенерируйте текстур-пак с помощью команд плагина.
Проблемы с Unicode-шрифтами
Если тексты отображаются некорректно, убедитесь, что опция Force Unicode Font в клиенте Minecraft выключена.