Skip to content

轮盘菜单模块 >=1.21.1 enhanced: 1.21.5 / 1.21.6 / 26.1

dev.anvilcraft.lib.v2.wheel 提供了一套高度可定制的环形菜单(Radial Menu) 系统,支持点按(Tap)和长按(Hold)两种打开模式、自定义扇形/圆点选中效果、子菜单以及自定义渲染器。

文档索引

文档内容
API 模型层WheelMenuModelWheelEntryWheelMenuBuilder、页面和分页
客户端渲染WheelWidgetWheelScreen、输入控制、着色器管道

架构概览

职责
api数据模型(条目、页面、分页、打开模式),不依赖客户端类
client.gui.componentWheelWidget 控件,处理鼠标交互、动画和渲染
client.gui.screenWheelScreen 屏幕宿主,管理页面堆栈和模式触发
client.gui.render.stateGUI 渲染状态(圆环、选中效果自定义着色器)
client.init着色器管道、动态 Uniform 缓冲
client.inputWheelScreenController 输入处理

注意事项

  • client 包下的类仅能在物理客户端使用
  • 动态 Uniform 使用帧内缓存,避免频繁重建 WheelWidget
  • GlobalRendererMixin(来自渲染模块)必须存在方可显示自定义管道
  • 子菜单仅支持一层嵌套(WheelSubmenuBuilder

Released under the CC-BY-NC-SA 4.0 License.