Bapel Hologram Toggle

全息文字切换

一款轻量级客户端 Fabric 模组，只需按下一个按键或输入命令，即可瞬间切换悬浮全息文字、服务器标签和文本显示的可见性。

为什么要用全息文字切换？

你是否厌倦了多人服务器大厅和出生点里挤满悬浮全息文字？它们会挡住视线、影响截图，甚至导致 FPS 下降？

全息文字切换可以在客户端彻底解决这个问题！想要画面清爽时，随时隐藏所有全息文字；需要查看规则、排行榜数据或商店标签时，再随时将它们显示出来。

功能特色

• 纯客户端：无需在服务端安装。在任何公共或私人服务器上都能顺畅使用（Hypixel、SMP、MMO、小游戏等）。
• 一键切换：按下 H（可配置）即可立即显示/隐藏全息文字，并显示操作栏提示和播放点击音效。
• 支持命令：提供简洁命令（/holotoggle 和 /ht），并支持 Tab 补全。
• 广泛支持服务器插件：
• 隐藏新版 文本显示实体（Minecraft 1.19.4+ / 1.20+ / 1.21+ 显示实体）。
• 隐藏隐形及标记用的 盔甲架全息文字（HolographicDisplays、DecentHolograms、Spigot/Paper 全息文字）。
• 隐藏 区域效果云 / 交互 / 标记实体全息文字（如 CMI 全息文字等）。
• 保留普通玩家名牌和正常可见的生物！
• 设置持久保存：切换偏好会自动异步保存到 config/hologramtoggle.json，不会造成卡顿。

使用方法

1. 按键绑定

• 默认按键：H
• 设置方法：前往 Options ➔ Controls ➔ Key Binds ➔ Hologram Toggle ➔ Toggle Holograms。

2. 游戏内命令

也可以通过聊天命令切换显示状态或查看当前状态：

| 命令 | 说明 |
|—|—|
| /ht 或 /holotoggle | 切换全息文字的显示状态（开/关） |
| /ht toggle | 切换全息文字的显示状态 |
| /ht hide 或 /ht off | 隐藏全息文字 |
| /ht show 或 /ht on | 显示全息文字 |
| /ht status | 查看当前全息文字显示状态 |

运行要求

• Minecraft：1.21.11，26.1.2
• Fabric 加载器：>= 0.19.5
• Fabric API：必需

常见问题（FAQ）

许可与条款

版权所有 (c) 2026 Bapel。保留所有权利。

• 免费使用：可免费下载、安装并在个人游戏中使用本模组。
• 整合包：允许在 Modrinth/CurseForge 上发布的公共或私人整合包中使用，但须注明出处。
• 限制：本模组不开源。未经许可，严禁重新托管、反编译或单独重新分发二进制文件/代码。