云界面预览
安装 云界面 CloudUI 后，奖池预览不再是箱子菜单，而是一个全屏的抽奖画面： 左边是一座亮着光的展示台，台上缓缓旋转着你正在看的奖品；右边是排列整齐、带稀有度卡框的奖品卡片、保底进度条与单抽 / 十连按钮。
不需要额外设定，装好云界面、重启服务器就会生效。
启用条件
| 条件 | 说明 |
|---|---|
| 安装了云界面 CloudUI | 开服时控制台显示「检测到云界面 CloudUI：奖池预览将使用云界面画面（无法显示的玩家仍使用箱子菜单）」 |
config.yml 的 menu.cloudui: true | 默认开启。改成 false 就一律使用箱子菜单。修改后需要重启服务器 |
| 奖池类型是「抽奖」或「立即抽取」 | 「自选」奖池仍然使用箱子菜单的选择界面 |
| 这位玩家能显示云界面 | 由云界面判断；不能显示的玩家自动改用箱子菜单（玩家刚进服、抽奖数据还在读取时也一样） |
所有打开奖池预览的方式都会使用云界面画面：点抽奖方块、右键宝箱物品、只打 /sc（打开 menu.default-crate 指定的奖池）、/sc open、抽奖结果界面的「回到奖池」、编辑器的「以玩家身份预览」、API 的 StarCrateAPI.open(...)。
画 面说明
左侧：展示台
- 展示中的奖品放在展示台上缓缓旋转，背后的光环是它的稀有度颜色。
- 下方显示奖品名称、稀有度，以及一行说明：概率（奖池开启「显示概率」时，是这位玩家下一抽的真实概率）、「终极大奖」、「已获得 N/上限」。
- 打开时展示的是奖池里最稀有的奖品（同稀有度时优先终极大奖）。鼠标移到右边任何一张奖品卡上（或点一下），展示台就换成那个奖品。
- 画面下方的提示：「鼠标移到奖品上查看 · 按住左键拖动旋转视角」。
右侧：奖品与按钮
| 区块 | 内容 |
|---|---|
| 标题 | 「星月造物 ›」与奖池名称，下面是「已抽次数」（这位玩家在这个奖池抽过几次） |
| 奖品卡片 | 每页 5 × 3 = 15 张。卡框按稀有度 ID 分成 common、rare、epic、legendary、mythic 五种（自己新增的其他稀有度使用 common 的卡框）。卡片显示奖品物品、名称（太长时截短）与概率；奖池不显示概率时改为显示稀有度名称。已达每人上限的奖品会变暗 |
| 奖品提示 | 鼠标停在卡片上显示：奖品名称、物品原本的说明、稀有度、概率（显示概率时）、终极大奖标记 |
| 翻页 | 奖品超过 15 个时出现上一页 / 下一页与页数 |
| 保底进度 | 奖池有硬保底、而且有终极大奖时显示「保底进度 N/最大」与进度条 |
| 单抽 / 十连 | 按钮下方显示花费；奖池不允许十连时不显示十连按钮 |
| 抽奖记录 | 关闭画面，打开自己在这个奖池的抽奖记录（箱子菜单） |
| 返回 | 关闭画面 |
点了单抽 / 十连之后
照常开始抽奖：检查花费与权限、扣除花费、决定结果，和在箱子菜单里点抽奖完全相同；开启方式也会保留，例如从宝箱物品打开的画面，抽奖时照样消耗宝箱物品。 接着画面换成云界面抽奖动画，播完在同一个画面显示结果、「再抽一次」与「返回」：
- 奖池设成
cui-flip命运翻牌、cui-wheel星轮转盘、cui-stars星空连线时播放那一种； - 设成其他动画时播放
cui-dial星盘祈愿；设成none时不播动画，直接显示结果； - 五十连不播动画，直接显示结果。
4 种云界面动画的样子见 抽奖动画 · 云界面专属动画。
自动安装的文件
星月造物连接云界面时，会把抽奖画面的文件安装进云界面：
| 文件 | 内容 |
|---|---|
screens/starcrate/starcrate.yml | 画面 starcrate 的布局 |
images/starcrate/*.png | 画面用到的图片：背景、展示台、光环、面板、5 种稀有度卡框与空卡、悬停框、单抽 / 十连 / 小按钮与它们的悬停图、翻页按钮、装饰、标签、进度条框、提示框 |
控制台显示「已安装 N 个云界面抽奖画面文件」代表这次有安装文件。想调整位置、大小、图片，请用云界面修改这个画面。
奖池名称、奖品名称、稀有度名称里用到的文字与稀有度颜色，星月造物会自动提供给云界面；在编辑器修改奖池或 /sc reload 后会重新提供。
画面可用的数据
在云界面里编辑 starcrate 画面时，可以使用这些数据（{键}）：
| 键 | 内容 |
|---|---|
lang.<键> | messages.yml 里 cloudui 段的文字（见下方） |
crate | 奖池名称 |
total | 这位玩家在这个奖池抽过的次数 |
page / pages | 目前页数 / 总页数 |
prev / next | 没有上一页 / 下一页时为 hidden |
pity / pity_max | 保底次数 / 硬保底次数 |
pity_ratio | 保底进度条的比例（pity/pity_max） |
pity_visible | 奖池没有保底时为 hidden |
cost_single / cost_ten | 单抽 / 十连花费 |
ten_state | 奖池不能十连时为 hidden |
featured_item / featured_name / featured_rarity / featured_info / featured_tint | 展示台上的奖品：物品、名称、稀有度、说明行、稀有度颜色 |
prizes.<第几张>.frame | 卡框：rare、epic、legendary、mythic，普通为空白，没有奖品的格子为 empty |
prizes.<第几张>.icon / name / namecolor / chance / chancecolor | 卡片的物品、名称与颜色、概率与颜色 |
prizes.<第几张>.dim | 已达获得上限时为空白（显示变暗层），否则 hidden |
prizes.<第几张>.hit | 没有奖品的格子为 hidden |
文字
画面上的文字可以在 messages.yml 加上 cloudui 段来替换，没写的键使用下表的默认值：
cloudui:
single: '单 抽'
ten: '十 连'
hint: '鼠标移到奖品上查看'
| 键 | 默认 | 用在哪里 |
|---|---|---|
crumb | 星月造物 › | 奖池名称上方的小标题 |
drawn | 已抽次数 | 抽奖次数的标签 |
hint | 鼠标移到奖品上查看 · 按住左键拖动旋转视角 | 画面下方的提示 |
pity | 保底进度 | 保底进度的标签 |
single | 单 抽 | 单抽按钮 |
ten | 十 连 | 十连按钮 |
history | 抽奖记录 | 抽奖记录按钮 |
close | 返回 | 返回按钮 |
chance | 概率 {chance}% | 展示台说明与奖品提示里的概率 |
grand | 终极大奖 | 终极大奖标记 |
limit | 已获得 {won}/{limit} | 每人上限 |
free | 免费 | 免费奖池的花费 |
none | （空） | 奖池没有奖品时展示台的名称 |
rarity | 稀有度 | 奖品提示里的「稀有度」 |
修改后 /sc reload。
常见问题
装了云界面，打开的还是箱子菜单？
依序检查：menu.cloudui 是否为 true、改过设定后有没有重启、奖池是不是「自选」类型、开服时控制台有没有「检测到云界面 CloudUI」或「抽奖画面无法连接，改用箱子菜单」的提示；以及这位玩家能不能显示云界面。
不想用云界面画面，但服务器装了云界面？
config.yml 写 menu: { cloudui: false }（或在 menu: 底下把 cloudui 改成 false），重启。