McPvP.com 等级标签器

McPvP.com 等级标签器

这是一个使用McPvP.com公共API更新的等级标签器，不要与McTiers或Og McPvP混淆。

社交

McPvP.com 等级标签器预览查看大图

轻量级段位标签

一个轻量级、100% 纯客户端的 Fabric 模组，可在玩家名称旁显示他们的 McPvP.com 段位——包括 Tab 列表、头顶名称以及聊天指令。从零开始构建，依赖极少，按需获取数据，即使在大型服务器上也能保持流畅。

功能特性

  • 两处段位标签
    • Tab 列表（Tab 菜单）—— 显示在每个玩家名称旁
    • 头顶名称牌 —— 显示在世界中悬浮名称旁
    • 两者可独立开关
  • 真实物品图标 覆盖每种游戏模式，通过自定义位图字体随文字内联绘制（不是字母代码——而是真正的钻石剑、喷溅药水、末影水晶等）
  • 按段位分级配色，从铜色到紫水晶色的清晰渐变：
    • T5 铜色
    • T4 铁银色
    • T3 金色
    • T2 钻石青色
    • T1 紫水晶紫色
    • 全部加粗；退役段位额外使用斜体
  • “最高”模式 —— 可选择单一游戏模式的套件，或让模组显示玩家个人最佳段位（图标会自动切换为该套件的物品）
  • 按需获取 —— 仅为你实际能看到的玩家拉取段位；无批量排行榜下载，无后台扫描。两个并行 HTTP 工作线程以约 25 请求/秒的速率运行，可在几秒内填充 200 人服务器的大厅，且不会对 API 造成压力
  • 逐条缓存 —— 一旦获取了玩家的段位，渲染的聊天组件只构建一次并在每帧复用；即使 Tab 列表中有数百名玩家，分配开销也极小
  • 客户端侧 /playertier <名称> 指令 —— 在聊天中输入该指令，一条仅本地显示的消息会回复该玩家的总排名、积分、地区以及每个套件的段位（附图标）
  • 配置文件中的实时名称搜索 —— 自动检测你的用户名并预览你的段位；输入其他玩家名称后，结果会在短暂防抖后即时显示。无需保存/退出循环
  • 可自定义的套件图标 —— 内置 24 种物品纹理（包含所有胸甲、剑类变体、斧类变体、末影水晶、狼牙棒、三叉戟、图腾、末影珍珠、金苹果、喷溅药水等）。可通过配置中的“图标”选项卡为任何套件选择任意物品
  • 可配置的 API 端点 —— 如果 mcpvp.com 更改了其主机名或路径，在“高级”部分粘贴新的基础 URL 即可——无需重新构建
  • 宽容的解析器 —— 自动兼容当前 mctiers 架构（rankings.{kit}.{tier, pos}）和旧版 McPvP 架构（kitRanks.{kit}: "HT1"）

隐私说明

轻量级段位标签在其模组元数据中声明了 "environment": "client"，因此 Fabric 将拒绝在专用服务器上加载它。JAR 包含：

  • 无任何数据包代码 —— 零 ClientPlayNetworking，无 sendCommand，无任何类型的数据包发送器
  • 无服务端指令注册 —— /playertier 指令仅通过 Fabric 的客户端指令调度器注册，因此本地客户端会在它离开你的设备之前将其拦截
  • 无遥测、无分析

模组唯一的对外流量是你的电脑直接发出的 HTTPS 请求：

主机 用途
www.mcpvp.com/tiers/data 主要段位查询（可配置）
mctiers.com/api/profile/{uuid} 备用段位查询（可配置，可禁用）
api.mojang.com/users/profiles/minecraft/{name} 用户名 → UUID 解析

你连接的 Minecraft 服务器不会收到任何额外的数据包。

配置

通过 Mod Menu → 轻量级段位标签 打开。配置界面包含三个选项卡。

“显示”选项卡

  • 启用 —— 总开关
  • 在 Tab 中显示 —— 切换玩家列表中的段位标签
  • 在头顶显示 —— 切换世界中名称牌上的段位标签
  • 显示套件图标 —— 切换物品图标（关闭后仅显示段位文字）
  • 套件 —— 显示哪个游戏模式的段位（最高、原版、剑、斧、药水、下界药水、SMP、UHC、狼牙棒）
  • 缓存时长 —— 1 至 24 小时；玩家段位在重新检查前保留在缓存中的时间
  • API URL —— 默认为 https://mctiers.com/api；如果上游服务发生更改，可进行覆盖

“图标”选项卡

八个循环按钮（每个游戏模式一个）—— 点击可在 24 种可用物品纹理间循环。按钮预览会在物品名称旁显示实际图标，方便你预览效果。更改会立即生效；每个玩家的标签缓存会自动失效。

默认图标：

游戏模式 默认图标
原版 末影水晶
剑 钻石剑
斧 钻石斧
药水 喷溅药水
下界药水 下界合金胸甲
SMP 钻石胸甲
UHC 金苹果
狼牙棒 狼牙棒

“你的段位”选项卡

  • 你的段位会自动从你的本地 Minecraft 账号加载——无需输入你的名字
  • 标题行显示你的总排名、积分和地区
  • 每个套件的细分显示你获得排名的每个游戏模式，附图标和带颜色的加粗段位
  • 搜索其他玩家 —— 输入任意名字；结果会在约 1 秒内实时显示

指令

/playertier <用户名>

仅客户端。在 mctiers 上查询指定玩家并在本地聊天中打印包含其完整段位卡的消息：

正在查询 coldified 的段位…
coldified  •  排名 #2  •  326 分  •  欧盟
<剑> LT1  <斧> LT1  <药水> LT1  <下界药水> LT2  …

输出仅显示在你的聊天框中——不会发送到服务器或其他玩家。

性能说明

  • Tab 列表和名称牌标签在每次设置更改时为每个玩家预渲染一次，然后复用——即使在 60 FPS 下显示 200 个 Tab 条目，每帧的额外工作量也可忽略不计
  • HTTP 获取在两条守护工作线程上运行，并带有去重请求队列，因此反复打开 Tab 不会堆积重复查询
  • 404（未排名玩家）会以负面结果缓存，避免重复查询

兼容性

  • Minecraft： 26.1+
  • 加载器： Fabric（Loader 0.18+）
  • 必需依赖： Fabric API、MixinExtras
  • 可选依赖： Mod Menu（用于通过模组列表打开配置界面）
  • 可与其他段位标签模组共存——使用 MixinExtras @ModifyReturnValue，可安全地与任何也修改同一名称渲染方法的模组组合使用

数据来源

段位数据由 mcpvp.com 提供，这是 McPvP 测试社区的官方 API。本模组与 mcpvp.com 或 McPvP 无隶属关系——它是一个使用其公开 API 的独立客户端。

许可证

MIT