ModMenu Badges Lib

ModMenu Badges Lib - это небольшая библиотека для Minecraft, которая даёт возможность добавлять собственные значки (бейджи) в меню модов ModMenu. По сути, это инструмент для тех, кто хочет сделать свой мод или сборку более информативными прямо в интерфейсе.

Зачем это нужно

Стандартный ModMenu неплох, но в нём не хватает наглядности. Хочется сразу видеть, какие моды - просто моды, какие - библиотеки, а какие вообще датапаки или ресурс-паки. Вот тут и пригождается ModMenu Badges Lib. С её помощью можно развесить теги прямо рядом с названием мода.

Например, Tschipcraft использует эту библиотеку, чтобы показать значок "Data Pack" для мода Dynamic Lights. Мелочь, а удобно - сразу понятно, что мод работает через датапаки.

Для кого это

Библиотека пригодится двум категориям пользователей:

Мододелам

Если вы пишете мод и хотите, чтобы игроки сразу видели его особенности (например, что он требует Fabric API или является чисто клиентским), можно добавить кастомный бейдж через ModMenu Badges Lib. Делается это в несколько шагов:

1. Добавьте зависимость в build.gradle или build.gradle.kts.
   • Можно включить библиотеку прямо в jar мода (дополнительно ~5 кб).
   • Или указать её как рекомендованную зависимость, чтобы игроки ставили её отдельно.
2. Пропишите рекоммендацию в fabric.mod.json.
3. Откройте генератор бейджей (он есть онлайн), настройте цвета и текст, и вставьте результат в custom-секцию fabric.mod.json.

Формат настройки простой:

{
  "custom": {
    "mcb": [
      {
        "name": "Example Badge",
        "fillColor": -2003942227,
        "outlineColor": -2003084874
      }
    ]
  }
}

Можно задать только имя - остальные цвета сгенерируются автоматически.

Сборщикам модов

Если вы собираете модпак для сервера или одиночной игры, библиотека тоже пригодится. Создайте файл modmenu-extra-badges.json в корневой папке профиля (рядом с .minecraft) и настройте значки для любых модов.

Пример:

{
  "modmenu-badges-lib": {
    "sort": true,
    "overwrite": true,
    "badges": [
      {
        "name": "Another House"
      },
      {
        "name": "COLORFUL",
        "fillColor": -16776961,
        "outlineColor": -65536
      }
    ]
  },
  "minecraft": {
    "badges": [
      {
        "delete": true,
        "name": "Minecraft"
      }
    ]
  }
}

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

Что по планам

Автор уже сделал онлайн-редактор бейджей с превью в реальном времени (очень удобно). В планах - добавить поиск по бейджам, чтобы в большом списке модов быстро найти нужный.

Особенности

• Библиотека лёгкая, весит всего несколько килобайт.
• Работает только с ModMenu, так что ModMenu обязателен.
• Не добавляет новых мобов, блоков или механик - чисто косметический инструмент для удобства.

ModMenu Badges Lib - это такой "мод для модов", который не влияет на геймплей, но делает меню модов понятнее. Если вы собираете модпак или разрабатываете мод - гляньте, пригодится.