Glypher

Glypher

Glypher — это клиентский мод для Fabric, который помогает выравнивать кастомные глифы заголовков меню прямо в настоящем предпросмотре GUI ванильного Minecraft. Авторы: LmVictor20 x ChatGPT

Для чего нужен Glypher

Glypher помогает расположить глиф заголовка для таких меню, как сундуки, наковальни, маяки, печи, воронки, кузнечные столы и другие. Вместо того чтобы угадывать смещения в JSON-файле, вы можете:

• выбрать тип ванильного меню;
• выбрать режим провайдера ресурспака;
• ввести глиф, используемый вашим ресурспаком;
• посмотреть предпросмотр заголовка в настоящем GUI;
• настроить X и Y;
• сохранить результат в небольшой файл экспорта. Цель Glypher — не заменить конфиг вашего плагина. Цель — упростить выравнивание, а затем экспортировать читаемый результат, чтобы вы понимали, какие значения должны попасть в ваш собственный пак или конфигурацию плагина.

Поддерживаемая конфигурация

• Minecraft 1.21.3
• Fabric Loader
• Fabric API

Установка

1. Поместите jar-файл мода Glypher в папку mods.
2. Включите ресурспак, содержащий ваши глифы меню.
3. Убедитесь, что в вашем паке есть корректный assets/minecraft/font/default.json.
4. Запустите Minecraft.
5. Выполните /glypher create.

Перед началом

Glypher ожидает, что глиф заголовка уже существует в вашем активном ресурспаке. Это значит:

• если вы используете Nexo/Oraxen, используйте глиф, уже сгенерированный паком этого плагина;
• если вы используете ItemsAdder, используйте глиф, уже сгенерированный паком этого плагина;
• если вы используете Plain, используйте сырой глиф, который есть в вашем собственном default.json. Для поля ввода Glypher глиф следует брать из сгенерированного ресурспака default.json. Иными словами, Glypher не придумывает глиф за вас. Он помогает выровнять глиф, который уже есть в вашем паке.

Как работает Glypher

Шаг 1: Выберите меню

Выполните:

/glypher create

Затем выберите тип ванильного инвентаря/меню, который хотите просмотреть.

Шаг 2: Выберите режим провайдера

Glypher поддерживает три режима вывода:

• Nexo/Oraxen
• ItemsAdder
• Plain Это меняет только то, как записывается итоговая экспортируемая строка Title.

Шаг 3: Введите глиф

Введите глиф, используемый вашим ресурспаком. Это должен быть настоящий глиф из вашего сгенерированного default.json, а не путь к текстуре, не имя-заглушка и не имя файла изображения.

Шаг 4: Предпросмотр и выравнивание

Glypher открывает настоящий предпросмотр меню и позволяет двигать заголовок:

• X offset управляет горизонтальным смещением;
• Y offset управляет визуальным вертикальным смещением в предпросмотре;
• Ascent — это значение, которое вы обычно переносите в конфиг шрифта.

Шаг 5: Сохранение

Когда заголовок выглядит правильно, нажмите Save. Glypher сохраняет:

• расположение в своём конфиге;

• текстовый файл экспорта с:

  • ID
  • Provider
  • Title
  • Ascent

Понимание режимов провайдеров

Nexo/Oraxen

Используйте этот режим, если итоговый заголовок меню будет обрабатываться через синтаксис Nexo или Oraxen. Формат экспорта:

<shift:(x)><glyph:menu_title>

Пример:

<shift:(-5)><glyph:menu_title>

Важно:

• Glypher внутренне обрабатывает визуальный X offset в предпросмотре;
• экспортируемый результат лишь показывает вам итоговую структуру смещения;
• сторона плагина должна использовать часть со смещением и разрешать глиф через свою собственную конфигурацию;
• фактическое имя глифа или привязка глифа всё ещё определяются вашей настройкой Nexo/Oraxen. Таким образом, в режиме провайдера Glypher помогает вам понять смещение и итоговую структуру, а ваш плагин остаётся ответственным за реальную привязку глифа.

ItemsAdder

Используйте этот режим, если итоговый заголовок меню будет обрабатываться через синтаксис ItemsAdder. Формат экспорта:

:offset_(x)::menu_title:

Пример:

:offset_(-5)::menu_title:

Важно:

• Glypher визуально показывает смещение внутри предпросмотра;
• экспортируемая строка — вспомогательный вывод для вашего рабочего процесса настройки ItemsAdder;
• смещение — это то, что Glypher на самом деле помогает найти;
• сам глиф должен уже происходить из ресурспака/конфига, сгенерированного ItemsAdder.

Plain

Используйте этот режим, если вы работаете напрямую с обычными провайдерами шрифтов и хотите, чтобы мод сам составлял видимую строку заголовка. В режиме Plain Glypher работает по-старому:

• он строит заголовок с помощью внутренних глифов смещения;
• он составляет итоговую строку напрямую;
• экспортируемый Title — это буквальная строка для использования;
• предпросмотр использует точный составленный текст заголовка. Это лучший вариант, если вы не используете систему провайдеров на стороне плагина и хотите полный прямой контроль над сырым выводом шрифта.

Очень важное различие между режимами провайдеров и Plain

Для Nexo/Oraxen и ItemsAdder:

• Glypher следует в основном рассматривать как помощник для выравнивания;
• система плагина/провайдера всё ещё отвечает за разрешение итогового глифа из своего собственного конфига;
• вывод Glypher существует, чтобы сделать смещение и структуру понятнее. Для Plain:
• вывод Glypher — это фактическая итоговая строка заголовка, которую можно использовать напрямую.

Подготовка ресурспака

Ваш активный ресурспак должен содержать:

assets/minecraft/font/default.json

Если файл уже существует, вливайте новые провайдеры в него, а не заменяйте его вслепую. Минимальная структура:

MyPack/
  pack.mcmeta
  assets/
    minecraft/
      font/
        default.json
    mynamespace/
      textures/
        gui/
          title_example.png

Пример bitmap-провайдера

Это тот тип провайдера, который обычно определяет видимый глиф заголовка меню:

{
  "type": "bitmap",
  "file": "mynamespace:gui/title_example.png",
  "ascent": 24,
  "height": 256,
  "chars": [
    "\uE120"
  ]
}

Символ в chars — это глиф, который следует скопировать в поле ввода Glypher.

Откуда берётся входной глиф

При использовании Glypher глиф, который вы вводите в поле ввода, должен происходить из сгенерированного default.json внутри ресурспака, используемого вашим плагином или вашей обычной настройкой. Это значит:

• откройте ваш сгенерированный пак;
• найдите assets/minecraft/font/default.json;
• найдите провайдер для вашего глифа заголовка;
• скопируйте настоящий символ из chars;
• используйте этот символ в Glypher.

Как работает смещение по X

В режиме Plain

Glypher использует внутреннюю композицию сдвинутых глифов и сам собирает итоговую строку заголовка.

В режиме Nexo/Oraxen и ItemsAdder

Glypher по-прежнему позволяет визуально настроить заголовок, но экспортируемый результат — это синтаксис в стиле провайдера. Это значит, что перемещение в предпросмотре внутреннее, а сохранённый результат — чистая строка заголовка, ориентированная на провайдера.

Как работает смещение по Y / Ascent

Glypher визуально показывает вертикальное перемещение в предпросмотре, а затем экспортирует значение Ascent, которое можно использовать в вашем провайдере шрифта. Обычно именно это число вы вставляете в соответствующий bitmap-провайдер внутри default.json. Пример:

{
  "type": "bitmap",
  "file": "mynamespace:gui/title_example.png",
  "ascent": 24,
  "height": 256,
  "chars": [
    "\uE120"
  ]
}

Типичный порядок работы

1. Сгенерируйте или подготовьте свой ресурспак.
2. Найдите глиф заголовка в assets/minecraft/font/default.json.
3. Запустите Minecraft с включённым паком.
4. Выполните /glypher create.
5. Выберите тип меню.
6. Выберите режим провайдера.
7. Вставьте или введите глиф из default.json.
8. Настройте X и Y в предпросмотре.
9. Сохраните макет.
10. Откройте экспортированный текстовый файл.
11. Перенесите Title и Ascent в свой пак или конфиг плагина.

Команды

• /glypher create — создать новый макет заголовка
• /glypher list — открыть сохранённые макеты

Сохранённые файлы

Glypher хранит:

• данные макетов в config/glypher/layouts.json
• файлы экспорта в config/glypher/exports/ LmVictor20 x ChatGPT