包品牌

包品牌

自定义窗口标题、菜单文本、颜色并隐藏Realms按钮。非常适合整合包作者。

工具

PackBranding

让 Minecraft 感觉像是你自己的整合包。 PackBranding 是一个轻量级的客户端 Fabric 模组，让整合包作者能够重新为游戏窗口、主菜单和暂停菜单打上品牌标识——无需编程，只需几个配置文件。

一切功能都是可选且可配置的，所以你可以只更改你想要的部分。

⚠️ 1.2.0 之前的版本不再受支持。 请更新到最新版本。

✨ 功能

  • 🪟 自定义窗口标题 — 使用动态令牌，用你的整合包名称替换无聊的 "Minecraft 26.2" 标题栏。
  • 📝 菜单文本 — 在主菜单和暂停菜单的四个角落中的任意一个显示自定义的品牌文本，每个角落可以有单独的文本。
  • 🔗 可点击链接 — 使用 [label](https://…) 将任意菜单文本的一部分变成链接，通过原版确认提示打开。
  • 🔘 图标按钮 — 向暂停菜单和标题界面添加你自己的可点击图标按钮（Discord、网站等），将它们放置在图标栏中的任意位置，并使用 PNG 或内置精灵图。
  • 🚫 隐藏原版图标 — 从暂停菜单中移除漏洞报告 / 反馈 / 玩家举报 / 好友图标，并用你自己的图标替换它们。
  • 🎨 完整颜色支持 — 十六进制颜色（#RRGGBB）和经典 Minecraft 颜色代码（&c、&a、&l 等）。
  • 🔢 动态令牌 — 自动插入 Minecraft 版本、你的整合包版本、玩家名称、模组数量或任意模组的版本。
  • 🛰️ 隐藏 Realms — 从主菜单中移除 Realms 按钮及其通知，让界面更清爽。
  • 🖼️ 自定义窗口图标 — 将窗口/任务栏图标替换为你自己的图标。

标题界面

ESC 菜单

⚙️ 工作原理

首次启动时，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 会让底部角落位于原版 版权/版本行的上方。

🔤 格式参考

这些适用于每个菜单文本字段和工具提示。

令牌

令牌 替换为
{mcversion} 当前 Minecraft 版本
{packversion} config.json 中的 packVersion
{username} 当前玩家名称
{modcount} 已加载的模组数量
{modversion:modid} 特定模组的版本 （仅限窗口标题）

颜色与样式

代码 含义 代码 含义
&0–&9、&a–&f 标准颜色 &l 粗体
#RRGGBB 任意十六进制颜色 &o 斜体
&r 重置 &n 下划线
&m 删除线

链接

将任意文本的一部分变成可点击链接：

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

点击后会在原版“打开此链接？”确认后打开该 URL。

🖼️ 自定义图标

  1. 在 config.json 中设置 "icon": { "enabled": true }。
  2. 提供以下两者之一：
    • 一个正方形 PNG 文件，位于 config/packbranding/icon.png（256×256 效果不错），或
    • 一对拆分文件：config/packbranding/icon/icon_16x16.png 和 icon_32x32.png（两者都需要）。
  3. 重启游戏。

🔘 图标按钮

向暂停菜单和标题界面添加可点击的图标按钮——非常适合 Discord 邀请、 你的网站、wiki 等。

  1. 将图标 PNG 文件（推荐 16×16）放入 config/packbranding/buttons/。
  2. 在 config.json 的 menuButtons 下列出它们——分别为 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"]
}
  1. 重启。点击按钮会在原版“打开此链接？”确认后打开其链接。 图标缺失或链接无效的按钮会被跳过。

使用内置（原版）图标

icon 可以不引用 PNG 文件，而是通过在前面加上 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 菜单图标栏中移除原版图标，这样你 就可以用自己的图标替换它们。可用的键：

键 图标
menu.reportBugs 报告漏洞
menu.sendFeedback 提供反馈
menu.playerReporting 玩家举报
menu.online 好友

（其他模组添加的图标，如 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——欢迎将其包含在任何整合包中。