Pack Branding

PackBranding

Заставь Minecraft выглядеть как твой модпак. PackBranding — это лёгкий клиентский мод для Fabric, который позволяет создателям модпаков перебрендировать окно игры, главное меню и меню паузы — без программирования, достаточно пары конфиг-файлов.

Всё опционально и настраивается, так что меняешь только то, что хочешь.

⚠️ Версии старше 1.2.0 больше не поддерживаются. Пожалуйста, обновитесь до последнего релиза.

✨ Что он умеет

• 🪟 Своё название окна — замени скучный заголовок "Minecraft 26.2" на имя твоего модпака, используя динамические токены.
• 📝 Текст в меню — показывай свой брендированный текст в любом из четырёх углов главного меню и меню паузы, отдельный текст для каждого угла.
• 🔗 Кликабельные ссылки — преврати часть любого текста в меню в ссылку через [label](https://…), открывается через ванильное окно подтверждения.
• 🔘 Кнопки-иконки — добавь свои кликабельные кнопки-иконки (Discord, сайт, …) в меню паузы и на титульный экран, размести их в любом месте ряда и используй PNG или встроенный спрайт.
• 🚫 Скрытие ванильных иконок — убери иконки баг-репорта / фидбэка / жалобы на игрока / друзей из меню паузы и замени их своими.
• 🎨 Полная поддержка цветов — hex-цвета (#RRGGBB) и классические цветовые коды Minecraft (&c, &a, &l, …).
• 🔢 Динамические токены — автоматически вставляй версию Minecraft, версию твоего модпака, имя игрока, количество модов или версию любого мода.
• 🛰️ Скрытие Realms — убери кнопку Realms и её уведомления из главного меню для более чистого вида.
• 🖼️ Своя иконка окна — замени иконку окна/панели задач на свою.

⚙️ Как это работает

При первом запуске PackBranding создаёт один конфиг-файл по пути:

.minecraft/config/packbranding/config.json

Отредактируй его, перезапусти игру — и твой брендинг применится. Рабочий пример генерируется при первом запуске. Каждая секция содержит поле _comment с пояснением (мод игнорирует все ключи с префиксом _, это просто документация внутри файла).

config.json

{
  "packVersion": "1.0",
  "windowTitle": {
    "enabled": true,
    "title": "Minecraft {mcversion}"
  },
  "icon": {
    "enabled": false
  },
  "hideRealms": true,
  "mainMenu": {
    "enabled": true,
    "aboveCopyright": true,
    "topLeft": "&6&lMyPack",
    "topRight": "&7v{packversion}",
    "bottomLeft": "[Website](https://example.com)",
    "bottomRight": "&8| &fMC {mcversion}"
  },
  "pauseMenu": {
    "enabled": true,
    "topLeft": "&6&lMyPack",
    "topRight": "&7v{packversion}",
    "bottomLeft": "&7Playing as &f{username}",
    "bottomRight": "&8| &fMC {mcversion}"
  },
  "menuButtons": {
    "enabled": true,
    "title": [
      { "icon": "example.png", "url": "https://example.com", "tooltip": "&9Visit our website" }
    ],
    "pause": [
      { "icon": "example.png", "url": "https://example.com", "tooltip": "&9Visit our website" }
    ],
    "hidePauseIcons": []
  }
}

У каждого меню четыре независимых угла (topLeft, topRight, bottomLeft, bottomRight) — оставь один пустым, чтобы там ничего не отрисовывалось. На титульном экране aboveCopyright: true держит нижние углы над ванильной строкой копирайта/версии.

🔤 Справка по форматированию

Это применяется ко всем текстовым полям меню и тултипам.

Токены

Цвета и стили

Ссылки

Преврати часть любого текста в кликабельную ссылку:

[Website](https://example.com)

При клике откроется URL после стандартного подтверждения «Открыть эту ссылку?».

🖼️ Своя иконка

1. Установи "icon": { "enabled": true } в config.json.

2. Предоставь либо:

   • одну квадратную PNG в config/packbranding/icon.png (256×256 подойдёт хорошо), либо
   • разделённую пару: config/packbranding/icon/icon_16x16.png и icon_32x32.png (нужны обе).
3. Перезапусти игру.

🔘 Кнопки-иконки

Добавь кликабельные кнопки-иконки в меню паузы и на титульный экран — отлично подойдёт для приглашения в Discord, твоего сайта, вики и т. д.

1. Положи PNG-иконки (рекомендуется 16×16) в config/packbranding/buttons/.
2. Перечисли их в menuButtons в config.json — отдельно для экрана title и меню pause (ESC):

"menuButtons": {
  "enabled": true,
  "title": [
    { "icon": "discord.png", "url": "https://discord.gg/example", "tooltip": "&9Join our Discord" }
  ],
  "pause": [
    { "icon": "website.png", "url": "https://example.com", "tooltip": "Visit our website" }
  ],
  "hidePauseIcons": ["menu.reportBugs"]
}

3. Перезапусти. При клике на кнопку откроется её ссылка после стандартного подтверждения «Открыть эту ссылку?». Кнопки с отсутствующей иконкой или неверной ссылкой пропускаются.

Использование встроенной (ванильной) иконки

Вместо PNG-файла icon может ссылаться на ванильный/атласный спрайт, если добавить префикс sprite::

{ "icon": "sprite:icon/language", "url": "https://example.com", "tooltip": "Language-style icon" }

Полезные спрайты: icon/language, icon/accessibility, pause_menu/bug, pause_menu/social_interactions, pause_menu/player_reporting. Спрайты из других модов тоже работают (например, modid:path).

Позиция кнопки

Каждая кнопка может задать index, чтобы разместить её в точном месте ряда иконок (0 = первая, перед ванильными иконками). Пропусти его (или используй -1), чтобы добавить в конец. Это работает и на титульном экране, и в меню паузы, а ряд автоматически перецентрируется, так что пропусков не будет.

{ "icon": "example.png", "url": "https://example.com", "tooltip": "First!", "index": 0 }

Скрытие ванильных иконок паузы

hidePauseIcons убирает ванильные иконки из ряда иконок меню ESC по имени, чтобы ты мог заменить их своими. Доступные ключи:

(Иконки, добавленные другими модами, например ModMenu, так скрыть нельзя.)

📦 Установка

1. Установи Fabric Loader.
2. Установи Fabric API.
3. Положи packbranding-x.x.x.jar в папку mods.
4. Запусти игру один раз, чтобы сгенерировался config.json, затем отредактируй его.

PackBranding — только клиентский — игрокам он не нужен на сервере, и его безопасно включать в любой модпак.

✅ Требования

• Minecraft 26.2
• Fabric Loader 0.19.3+
• Fabric API

📄 Лицензия

Apache 2.0 — не стесняйся включать его в любой модпак.