箱子备援

有些玩家看不到云界面画面，CloudUI 会把同一个画面自动变成箱子选单，不用另外做一套。

哪些玩家会用箱子选单

情况	说明
基岩版玩家	透过 Geyser 进服的玩家
拒绝资源包 / 下载失败	画面需要资源包里的着色器与图片
模组客户端回答「有开光影」	光影包会取代画面需要的核心着色器（实测 Iris + Complementary 开光影时选单整个看不到，服务器也侦测不到），所以装了模组的客户端第一次打开选单时会被问一次（menu.ask-modded），选「有开光影」就改用箱子选单并记住
/cui classic	玩家自己选择（例如光影包取代了核心着色器、画面显示不正常）；再输入一次换回云界面。管理员可以用 /cui classic <玩家> 帮忙切换。设定记在玩家身上，重进服务器也保留

插件用 API 的 open 打开画面时一样会自动判断。

怎么转换

• 按钮 → 物品：画面上每个有点击动作的按钮变成一格物品，大致照画面上的位置排（最多 6 列 × 9 栏）。
• 物品图示：按钮范围里有 item 元素就用那个物品；没有时，第一个动作是 back 的用箭、close 的用屏障，其他用纸。
• 名称与说明：按钮范围里最大的文字当物品名称，其他文字依序当说明；再加上按钮的 tooltip（或插件提供的说明行）。
• 箱子标题：画面里不在按钮上的最大文字；没有就用画面 ID。
• 隐藏的按钮不出现：按钮的 state 是 hidden 或 false、PlaceholderAPI 变量没被换掉、或对应的 states 图片是空的（画面上不显示）时，以及玩家没有按钮的 permission 时，不放进箱子。
• 点击：左键、右键、Shift + 左键、Shift + 右键照样对应 click 的四种点击（没有 Shift 版本时用一般版本）；权限、花费、deny 与画面完全相同。
• 画面切换：open 换成另一个箱子页，back 回到上一页（第一页就关闭），close 关闭，refresh 重新整理。

让箱子选单也好用

• 每个按钮的范围里放一段清楚的名称文字（最大字），再放一个 item 图示。
• 重要的说明写进按钮的 tooltip，箱子选单与画面都会显示。