CobbleAsia 图形界面

CobbleAsia GUI

CobbleAsia GUI 是 Minecraft 1.21.1（Fabric）的客户端界面模组。 它取代了 Cobblemon 服务器通常用来构建其功能的箱子窗口菜单和原版记分板侧边栏，并将其绘制为专门设计的全屏界面和合适的 HUD 覆盖层。

它是 CobbleAsia Cobblemon 服务器的官方配套模组，其界面目前也正是在该服务器上使用。它不包含任何游戏逻辑——它绘制的每个菜单均由服务器描述，它提供的每个按钮都会将点击操作发送回服务器进行验证。安装它不会改变任何游戏机制、添加任何物品或给予任何玩家优势；它只会改变服务器现有菜单在您屏幕上的外观和行为方式。

---

它所解决的问题

Minecraft 服务器有两种向玩家展示内容的方式：

1. 箱子窗口。 固定的 9 列网格，每格一个物品，所有信息都塞在悬停提示框中。一个抽卡横幅、一份合成配方列表和一个任务日志最终看起来都像一个装满纸片的箱子。
2. 记分板侧边栏。 最多 15 行，每行只能显示一段纯文本。进度必须用 █████░░░░░ 这样的块状字符来模拟，货币只能用文字拼写出来，而超过第 15 行的任何内容都会悄无声息地消失。

CobbleAsia GUI 为安装它的玩家消除了这两个限制。

---

您将获得的功能

真正的 HUD 面板，取代记分板侧边栏

侧边栏变成了一个带有雕刻斜角边框的绘制覆盖面板——而且行内容可以超过一行文字：

• 填充式进度条，以真正的条形渲染，而非块状字符。
• 任意行上的物品图标，包括自定义模型数据变体，因此货币可以显示其专属美术图标而非名称。
• 货币芯片行——一行内可显示多组 图标 + 金额 对，将四行余额压缩为一行。
• 每行的颜色编码状态（已完成、已锁定、进行中），而非整个面板只有一个单调颜色。
• 面板底部的按键提示胶囊（[J] 任务、[K] 帮助），显示您的按键绑定，并在客户端解析——因此如果您重新绑定按键，提示也会保持正确。
• 没有 15 行上限。 面板会根据内容自动调整大小。

面板会自动适配您的屏幕：它会被缩放，确保宽度不超过屏幕的 34% 或高度不超过 55%，这使其在 1280×720 分辨率下依然可用，而固定大小的面板可能会吞掉半个屏幕。它优先采用整数 GUI 缩放级别，以保证文字像素级清晰，并且在现有 GUI 缩放已合适时会保留您的设置不变。

按 U 键可隐藏面板——它会收缩为同一角落的一个小标签页，显示恢复面板的按键，因此隐藏绝不是单向操作。在 F1 视角模式下或当其他屏幕打开时，它也会自动让出空间。

全屏界面，取代箱子窗口

当服务器打开其菜单之一时，您将看到一个精心设计的界面而非一个箱子：

• 召唤横幅——标题区域显示横幅美术、精选奖励、抽取价格和您的余额，并有拉取结果的动画揭示效果。
• 概率详情——实际概率表，排版清晰易读，并配有小保底机制运作方式的通俗说明。
• 许愿历史——您所有的抽取记录，最新的在前，并附有每件物品的美术图标。
• 战斗通行证轨道——层级水平排列，锁定 / 可领取 / 已领取状态一目了然，无需埋在提示框中。
• 转盘和卷轴界面——服务器轮盘赌风格玩法的动画转轮和滚轴。
• 任务与委托——您的活跃列表，包含每个目标的进度条，可通过按键而不是命令打开。
• 合成 / 合成器界面——配方选项并排显示，包含输入、输出以及当前是否能够负担。
• 装备界面——装备及其属性以布局形式展示，而非一排物品栏位。
• 通用文档渲染器——服务器的其他任何菜单（排名、图鉴进度、商店、排行榜）都可以驱动它，因此它们都共享相同的外观、提示框和导航方式。

行内容无论是否可点击，悬停时都会显示提示框，因此您仍然可以检查已锁定的奖励层级，查看其奖励内容。

按键绑定与客户端命令

三个可重新绑定的按键，全部列在 选项 → 控制 下的 “CobbleAsia” 分类中：

按键	操作
J	打开任务 / 委托
K	打开服务器的帮助界面
U	隐藏 / 显示 HUD 面板

客户端命令（绝不会触及服务器）：

• /ascui hud —— 切换 HUD 面板。
• /ascui scale auto\|1-4 —— 如果您希望面板比自动适配更大或更小，可将其固定到指定的 GUI 缩放级别，而无需改动游戏全局的 GUI 滑块。设置保存至 config/asc-clientui.properties，因此重启后依然有效。
• /ascui show —— 重新显示面板。

---

它不做什么

• 此 jar 中不包含任何游戏逻辑。 掉率、小保底计数器、价格、配方、任务进度以及所有资格检查均位于服务器端并在服务器上验证。客户端仅发送“我点击了这个横幅的抽取”并绘制返回的内容。
• 无 mixin。 它不会修补或更改任何原版类，也不会改变任何原版机制。
• 并非游玩必需。 未安装的玩家看到的是服务器普通的箱子窗口菜单和原版记分板，奖励和结果完全相同。此模组仅用于展示——安装它不会带来任何优势。
• 在单人游戏中不做任何事情，在未发送其菜单的服务器上也同样不运作。它是一个等待被指示绘制内容的渲染器。

---

环境要求

• Minecraft 1.21.1
• Fabric Loader 0.16.0+
• Fabric API
• Java 21+
• 仅限客户端——请勿将其放入服务器的 mods 文件夹中。

Cobblemon 是建议安装而非必需：当服务器界面中存在宝可梦美术时，此模组会使用它来渲染，且没有它也能正常运行。

---

支持

问题与疑问：CobbleAsia Discord —— https://discord.gg/qB3ExYsUAH