MCTOOLBOX
MC ToolboxMC TOOLBOX

Творческий

Генератор JSON шрифта Minecraft

Создайте bitmap-провайдер шрифта для Java resource pack. Поместите соответствующий PNG в assets/<namespace>/textures/font, а JSON - в assets/<namespace>/font.

Bitmap-провайдер

Сгенерировано custom.json

{
  "providers": [
    {
      "type": "bitmap",
      "file": "minecraft:font/custom.png",
      "ascent": 7,
      "height": 8,
      "chars": [
        "ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "abcdefghijklmnopqrstuvwxyz",
        "0123456789!?.,:;+-*/"
      ]
    }
  ]
}

Как работает bitmap-провайдер шрифта Minecraft

Resource pack для Java Edition может сопоставлять символы с ячейками в PNG-спрайте. Этот генератор создаёт JSON bitmap-провайдера, который связывает расположение текстуры, строки символов, высоту глифа и положение базовой линии. Он не создаёт и не изменяет PNG, поэтому введённая здесь сетка символов должна совпадать с изображением, которое вы поместите в пак.

Каждая строка в поле Character grid представляет один горизонтальный ряд ячеек одинакового размера в текстуре. Читайте каждую строку слева направо и сохраняйте одинаковую длину всех строк. Если в JSON символ указан в неправильной ячейке, Minecraft отобразит соседний глиф.

Расположение ресурса текстуры

Используйте namespaced resource location, например my_pack:font/custom.png. Соответствующее изображение должно находиться в assets/my_pack/textures/font/custom.png. Namespace и путь чувствительны к регистру и должны содержать строчные символы.

Height и ascent

Height управляет высотой отображаемого глифа в пикселях. Ascent перемещает глиф относительно базовой линии текста. Начните с ascent на один пиксель ниже height, проверьте пак в Minecraft и отрегулируйте, если буквы сидят слишком высоко или низко рядом со стандартным шрифтом.

Куда сохранить JSON

Скачайте custom.json и поместите его в assets/<namespace>/font. Имя файла становится идентификатором ресурса шрифта. Файл, сохранённый как assets/my_pack/font/custom.json, можно указывать как my_pack:custom в текстовых компонентах, поддерживающих поле font.

Что проверяет этот генератор

Инструмент сохраняет корректную структуру провайдера и преобразует каждую текстовую строку в строку символов. Он не может проверить внешний PNG, размеры ячеек, обнаружить повторяющиеся символы или подтвердить, что сервер отправляет resource pack игрокам.

Создайте и протестируйте собственный шрифт Minecraft

  1. Подготовьте прозрачный PNG, глифы которого расположены в регулярной сетке.
  2. Введите расположение ресурса PNG и скопируйте точный порядок символов, одна строка изображения на текстовую строку.
  3. Установите height и ascent, затем скачайте custom.json.
  4. Поместите JSON и PNG в соответствующие папки resource pack и перезагрузите ресурсы в Minecraft.
  5. Проверьте каждый символ, который собираетесь использовать, затем отрегулируйте PNG или ascent, если интервалы неправильные.

Вопросы о JSON шрифта Minecraft

Создаёт ли этот инструмент PNG шрифта?

Нет. Он генерирует только JSON bitmap-провайдера. Создайте прозрачный спрайт-лист отдельно и убедитесь, что порядок ячеек точно совпадает с сеткой символов.

Почему Minecraft отображает неправильный символ?

Обычная причина - несоответствие порядка ячеек PNG и строк chars. Проверьте длину строк, пустые ячейки, переносы строк, namespace, путь к файлу и фактические размеры изображения.

Может ли это заменить стандартный шрифт Minecraft?

Resource pack может определять провайдеров в файле стандартного шрифта, но замена ванильных символов влияет на все интерфейсы, использующие этот шрифт. Отдельный namespaced шрифт безопаснее, когда только отдельные текстовые компоненты нуждаются в собственных глифах.

Почему шрифт невидим после перезагрузки пака?

Убедитесь, что пак загружается без ошибок ресурсов, JSON находится в assets/<namespace>/font, PNG - в assets/<namespace>/textures, а поле file указывает на тот же namespace и путь к текстуре.