对于开发人员,详见���文下方的快速开始示例。
对于使用者,你首先需要满足以下条件
- 服务端版本在
1.19.4或以上,可使用 Spigot/Paper/Folia 服务端。 - 至少使用
Java 17运行服务端 - 安装前置插件 packetevents
然后,你可以使用以下任意一种方法获取插件:
Warning
任何第三方构建都是不可信的,为了您的安全,即使您不想购买,也请自行构建插件。
人话:提醒到这个份上了,遇到了后门别找我。
你可想象过各种科幻电影、游戏中,悬在空中的半透明控制面板?
托文本展示实体可以自由旋转的福,现在,你可以轻松创建这样的控制面板!且无需对客户端作出任何修改,不需要 Mod,甚至不需要资源包。
示例插件 VectorLoginUI:
你可能会好奇这个依赖库/插件是怎么工作的。我们只是做了一点较为复杂的数学运算,让文本展示实体出现在它应该出现的地方,并应用正确的旋转变换。所有文本展示实体的朝向都是默认的(朝向正南方,即Z轴正方向),我们改变的是文本展示实体的左旋转。
文本展示实体的旋转变换使用四元数,这使得我们可以将其旋转到任意角度。即使四元数表达起来并不直观,但这在 1.19 之前几乎是不敢想的。
你可以自由设定这个控制面板中拥有哪些元素,使用类似于 Swing 或 WinForm 的形式,但 Minecraft 中限制较大,没有办法做到与他们并肩的自由度。
除了修改文本展示实体可以调整的背景颜色、文本组件、亮度、缩放等以外,还可以:
- 监听准心悬停状态更改事件,让元素在被玩家准心悬停时更改背景颜色等等
- 监听玩家点击事件,让元素在被玩家点击时执行自定义操作
请参阅 MCIO Plugins 上的开发文档。
- FabricMC/yarn 本项目 TextRenderer 实现参考
- HologramAPI 1.2.x 悬浮字控制逻辑
- Tofaa2/EntityLib 虚拟实体控制逻辑
- retrooper/packetevents 用于发包控制虚拟悬浮字
- 豆包AI 复杂数学运算的原型代码参考

