Paper Labels

Paper Labels

给纸片改名后，名称会像text_display一样显示在世界中：出现在掉落物、物品展示框、盔甲架和手持物品上。只需在物品名称中加入小标签即可设置文字样式。仅需客户端安装，无需服务器模组，也不使用自定义数据包。

未安装此模组的玩家只会看到完整名称，包括标签。不会造成任何问题。

功能

• 为改名后的纸片显示悬浮文字：适用于掉落物、物品展示框（包括荧光物品展示框）、盔甲架和手持物品
• 标签直接写在名称中：颜色、大小、倾斜、俯仰、偏航、粗体、斜体、下划线、删除线、阴影、背景、不透明度、对齐方式、行宽、广告牌模式、高度、与展示框的距离、透视显示
• 标签对你隐藏：提示框、快捷栏物品名称、聊天中的物品链接、容器和铁砧文本框中只显示干净的文字
• 铁砧面板中有一个文字按钮：滑块、调色板和 HEX 输入框、开关、广告牌/对齐/朝向按钮、字符计数，以及实时预览
• 3D 预览：用鼠标旋转、滚轮缩放；可在纯文字和显示在草方块物品展示框上的文字之间切换（方块为实体，转到方块内部的文字会被遮挡）
• 物品展示框：可隐藏展示框和纸片，只留下文字；移除展示框上方原版的名称文字；点击展示框可让文字每次旋转 45°
• 双面文字，可选fixed、vertical、horizontal或center（朝向玩家）广告牌模式
• 紧凑格式符合原版 50 字符名称限制（见下文）
• 可选的 Mod Menu 配置界面，提供英文和俄文翻译

使用方法

1. 将纸放入铁砧。
2. 输入文字，点击铁砧旁的文字按钮并选择样式。名称会自动改写并加入标签。
3. 取出纸片。在物品栏中，你只会看到干净的文字；丢出纸片或放进物品展示框，就能看到标签。

你也可以手动输入标签，例如Hello[cred s2 t15]。

标签

文字后添加一组方括号，值紧跟键名，多个标签之间用空格分隔：Shop[cgold s2 b sh]。
长格式（[ color red ]、[c=red]）也能识别。方括号内的大小写和空格不影响识别。

| 标签 | 简写 | 值 | 示例 |
|—|—|—|—|
| 颜色 | c | Minecraft 颜色名称，#rgb、#rrggbb | cred、c#f80 |
| 大小 | s | 0.25 到 8 | s2 |
| 倾斜 / 翻转 | t | -180 到 180 | t15 |
| 俯仰、偏航 | p、y | -180 到 180 | p30、y-45 |
| 朝向 | f | u文字平铺朝上，d朝下，w直立 | fu |
| 偏移 | h | 物品上方的高度，-2 到 4 | h1.5 |
| 距离 | d | 与物品展示框的距离，0 到 1 | d0.15 |
| 不透明度 | o | 10 到 100 | o50 |
| 宽度 | w | 自动换行宽度，20 到 400 | w100 |
| 对齐 | a | l、c、r | ar |
| 广告牌 | bb | f固定（默认）、v、h、c | bbv |
| 背景 | bg | 颜色或none | bgnone |
| 样式标记 | b i u k sh st | 粗体、斜体、下划线、删除线、阴影、透视显示 | b sh |

未知或无效的标签不算标签，会保留在文字中。方括号必须完整有效，否则不会识别其中任何内容。若要显示普通方括号，请使用转义符：\[和\]。
数值会自动限制在有效范围内（例如大小、宽度、不透明度等），因此文字不会变得过大或完全不可见。

关于 50 字符限制

原版铁砧的名称长度上限为 50 个字符，服务器也会强制执行，因此标签会尽可能精简。如果文本和所有标签超出长度，你的文本不会被截断：系统会移除不太重要的标签，并在面板中告诉你移除了哪些。字符计数器会显示剩余可用字符数。

配置

config/paperlabels.json（或在 Mod Menu 界面中）：

| 选项 | 默认值 | 说明 |
|—|—|—|
| enabled | true | 开启/关闭模组 |
| hideTags | true | 隐藏物品名称中的标签 |
| renderDistance | 24 | 标签显示的最大距离（方块） |
| renderInFirstPerson | false | 在你手持的物品上方显示标签 |
| items | minecraft:paper | 显示标签的物品 |
| hideItemFrames / hidePaperInFrame | true | 隐藏展示框 / 隐藏框内的物品 |
| hideFrameName | true | 移除展示框上方原版显示的名称文本 |
| doubleSided | true | 正反两面都能阅读 |
| frameRotationTurnsText | true | 点击展示框可旋转文字 |

运行要求

• Minecraft 26.2、Java 25
• Fabric Loader 和 Fabric API
• Mod Menu（可选）

仅客户端：在客户端安装即可，任何服务器（包括原版服务器）都能正常使用。

备注

• 其他玩家只有安装了此模组才能看到你的标签；未安装的玩家看到的是带标签的名称。
• 名称使用普通自定义名称，因此遵循常见的铁砧规则（例如，重命名需要消耗 1 级经验）。

链接

源代码：（添加你的代码仓库） · 问题反馈：（添加你的问题追踪页面）