抽奖动画
星月造物有 5 种箱子界面动画、2 种 3D 世界动画，装了云界面 CloudUI 时再多 4 种云界面专属动画。
每个奖池分别选择单抽动画（animation）与十连动画（ten-animation），在编辑器「奖池设置」里左右键切换即可。
动画一览
| ID | 名称 | 种类 | 单抽 | 十连 |
|---|---|---|---|---|
roulette | 星轨轮盘 | 箱子界面 | ✔ | — |
cards | 星辰翻牌 | 箱子界面 | ✔ | ✔ |
starfall | 星落 | 箱子界面 | ✔ | ✔ |
slots | 星月老虎机 | 箱子界面 | ✔ | — |
carousel | 星环回廊 | 箱子界面 | ✔ | — |
orbit | 星环（3D） | 3D 世界 | ✔ | ✔ |
meteor | 流星（3D） | 3D 世界 | ✔ | ✔ |
cui-dial | 星盘祈愿 | 云界面 | ✔ | ✔ |
cui-flip | 命运翻牌 | 云界面 | ✔ | ✔ |
cui-wheel | 星轮转盘 | 云界面 | ✔ | — |
cui-stars | 星空连线 | 云界面 | ✔ | ✔ |
none | 无动画 | — | ✔ | ✔ |
只能单抽的动画（roulette、slots、carousel）被设为十连动画时，会自动改用 cards；写了不存在的动画名称时，单抽用 roulette、十连用 cards。
星轨轮盘（roulette）
一整排奖品从界面中间那一行飞快滑过，越转越慢，最后停在上下两个指针之间的就是你的奖品。 上下两行的跑马灯跟着转动闪烁，经过指针的是真正的奖品时会亮起它的稀有度颜色；停下后整个框闪烁三次稀有度的颜色。
星辰翻牌（cards）
背面朝上发牌（单抽 1 张在正中间，十连 10 张排成两行）。发完牌后，藏着稀有奖品的牌会先闪耀预告； 接着一张一张翻开，越稀有的牌翻开前会颤动，翻开后上下亮起它的稀有度颜色。十连默认从最普通翻到最稀有，最后揭晓最稀有的那一张。
星落（starfall）
黑暗中星光闪烁，一颗流星从左上方划向中央——先是白色，接近时变成这次结果中最稀有奖品的颜色——然后炸开一圈圈光环，奖品出现在中间。 十 连时 10 个奖品从最普通到最稀有依序出现。
星月老虎机（slots）
三个转轮往下转动，依序停下：左、右，最后是中间（中间那格就是奖品），中奖线亮起奖品的稀有度颜色。
奖品达到 jackpot-rarity（默认传说）或是终极大奖时，三个转轮都停在奖品上；否则两侧停在同稀有度的其他奖品上。
星环回廊（carousel）
奖品沿着界面外圈顺时针奔跑，越来越慢，停在顶部正中间的那一个落进界面中央，四周聚起它的稀有度颜色。
星环（orbit，3D）
玩家面前浮现一圈奖品，旋转、减速，中心聚起这次最稀有奖品颜色的光点。
- 单抽：圈上有数个奖品（其中一个是真的），停下时真正的奖品转到正前方、放大、发出稀有度颜色的光，上方显示名称，其他奖品消失。
- 十连：圈上就是 10 个结果，从最普通到最稀有一个一个亮起、浮起并显示名称。
流星（meteor，3D）
一颗星星从天而降，拖着稀有度颜色的光尾坠落在玩家面前，落地炸开，奖品从光里旋转升起，上方显示名称。 十连时 10 颗流星依序落在玩家前方的弧线上，最稀有的最后落下。流星本身的样子按稀有度不同（默认普通是石英、稀有是海晶碎片、史诗是紫水晶碎片、传说是下界之星、神话是末地水晶）。
- 3D 动画用 Display 实体在世界里播放，只有抽奖的玩家看得到，别人看不到也不会被挡路。
- 播放位置在动画开始时按玩家所在位置与面向决定；动画中玩家可以自由移动。
- 实体不会存进世界，动画结束（或玩家下线、关服）时立即清除。
- 3D 动画不占用界面，所以没有跳过按钮，按潜行（Shift）跳过。
云界面专属动画
服务器装了 云界面 CloudUI、而且云界面侦测到星月造物时，编辑器的动画选项会多出下面 4 种（cui- 开头）。
它们在全屏的云界面画面里播放，结束后同一个画面显示结果与「再抽一次」「返回」，Shift / F 也能返回。
| ID | 名称 | 玩法 |
|---|---|---|
cui-dial | 星盘祈愿 | 星盘转动、光柱落下、冲击波扩散后卡牌依序翻开；光柱与冲击波的颜色是这次最稀有奖品的稀有度 |
cui-flip | 命运翻牌 | 卡背排开，玩家自己点选翻开。单抽从 5 张里选 1 张，选中的翻开、其余离场；十连 10 张逐张点开，或点「全部翻开」。十连里史诗以上的卡背会先透出稀有度光，翻开时依稀有度爆出光芒 |
cui-wheel | 星轮转盘 | 12 格奖品绕着星盘排成一圈，光点由快到慢转动，停在抽中的那一格后中央翻开奖品（只有单抽；十连设成它时改用 cui-dial） |
cui-stars | 星空连线 | 星星一颗颗亮起并连成星座，每颗星的颜色是那一抽的稀有度；闪光后星星化成卡牌翻开 |
- 装了云界面时，奖池设成其他原版动画（
roulette、orbit等）也会在云界面里用cui-dial星盘祈愿播放；none仍然不播放动画，直接显示结果。 - 玩家暂时不能显示云界面（刚进服、资源包还没载入、拒绝了资源包）时，这一抽改用原版动画。
- 奖池设成
cui-*、但服务器没有装云界面（或config.yml的menu.cloudui: false）时，单抽改用roulette、十连改用cards， 开服时控制台会用一般消息说明是哪个文件、哪个键；装好云界面后自动使用原本设的cui-*，不用改设定。 - 跳过：画面右上角「跳过 ›」直接翻开全部（命运翻牌单抽会翻开中间那张）。
- 音效在
config.yml的menu段：draw-sound（星盘、星空开始时）、reveal-sound（翻开时，命运翻牌只有史诗以上会播）、flip-sound（命运翻牌每翻一张）、wheel-sound（星轮光点每走一格）。
什么时候播放、播放哪一个
依序判断：
- 奖池类型是「立即抽取」（
instant）→ 不播放；「自选」（select）没有抽奖动画。 config.yml的animation.enabled: false→ 所有奖池都不播放。- 玩家用
/sc animation关掉了自己的动画 → 不播放。 - 单抽用奖池的
animation，十连用ten-animation。 - 装了云界面、玩家也能显示时，在云界面里播放（见上面的 云界面专属动画）。
不播放动画时，抽完立刻发放奖励，结果写在聊天栏，不打开结果界面。
一次抽奖的流程
- 抽奖结果在点下按钮的那一刻就已决定并存进数据库（见 奖励发放）。
- 播放动画。稀有度的音效、屏幕大字、烟花在揭晓时出现，见 稀有度。
- 动画最后一格停留
result-hold-ticks（默认 50 tick = 2.5 秒；3D 动画至少 1 秒）。 - 发放奖励，聊天栏显示抽到的奖品。
- 打开「抽奖结果」界面（
config.yml的animation.results-menu），可以再抽一次、再来十连或回到奖池，见 界面配置。 关闭这个选项时，箱子动画直接关闭。
动画播放期间玩家不能再开始另一次抽奖（提示「你的抽奖动画还在进行中」）。
跳过
config.yml 的 animation.allow-skip: true（默认）时：
| 动画 | 怎么跳过 |
|---|---|
| 箱子界面动画 | 点界面最下面中间的「跳过动画 »」（羽毛） |
| 3D 动画 | 按潜行（Shift） |
跳过会直接揭晓结果（音效、屏幕大字照常出现）并马上发放奖励、打开结果界面；如果动画已经播完、正在最后一格停留，跳过后最多再停 0.5 秒。
关闭箱子动画界面（按 Esc）时：animation.close-skips: true（默认）= 直接结束动画、发放奖励；false = 界面关不掉，会马上重新打开。
关掉自己的动画
/sc animation
玩家输入后，之后的抽奖不播放动画，直接显示结果；再输入一次重新开启。需要 starcrate.skip-animation 权限（默认所有人都有）。
这个开关存在内存里，服务器重启后恢复为开启。
速度
config.yml 的 animation.speed 是全部动画的速度倍率（范围 0.25 ～ 4）：2 = 两倍速，0.5 = 慢一倍。
速度会套用在所有「以 tick 为单位的时间」上（下表标示「tick」的键）。「格数」「帧数」类的键（例如轮盘的 steps、老虎机的 spin-frames）
不受影响；想让轮盘转得少一点，直接调小 steps。
animations.yml
plugins/StarCrate/animations.yml 设定每种动画的文字、材质、时间与音效。修改后 /sc reload 生效。
文件里没写的键使用插件内置的默认值。
几个通用规则：
- 时间单位是 tick（20 tick = 1 秒），会再除以
animation.speed。 - 音效写法：
音效名:音量:音调（例如BLOCK_BEACON_ACTIVATE:0.6:1.6），或资源包音效myserver:crate.open；留空不播放。 下表标示「只写名称」的音效，音量与音调由动画自动控制（例如越转越高），只写音效名，不要加:音量:音调。 - 材质 用 Bukkit 材质名称；写错时使用默认材质。
- 每种动画的段落都可以写
common里的同名键来覆盖，例如在roulette:下面写background: GRAY_STAINED_GLASS_PANE，只改轮盘的背景。
common（所有动画共用）
| 键 | 默认 | 作用 |
|---|---|---|
background | BLACK_STAINED_GLASS_PANE | 箱子动画的背景玻璃板 |
skip-material | FEATHER | 跳过按钮的材质 |
skip-name | <gray>跳过动画 <dark_gray>» | 跳过按钮的名称 |
result-rarity-line | <gray>稀有度 {rarity} | 动画中奖品说明最后加的稀有度行 |
grand-line | <gold><bold>✦ 终极大奖 ✦ | 终极大奖在动画中额外加的一行 |
grand-title | ✦ 终极大奖 ✦（渐变粗体） | 揭晓终极大奖、而它的稀有度没有设定 title 时的屏幕大字（稀有度有 title 时用稀有度的） |
roulette 星轨轮盘
| 键 | 默认 | 作用 |
|---|---|---|
title | ✦ {crate} · 星轨轮盘 | 界面标题，{crate} = 奖池名称 |
steps | 36 | 转动的格数，越多转越久（最少 12） |
steps-random | 6 | 随机多转 0 ～ (这个数 − 1) 格，每次停的时间不一样 |
slowest-delay | 6 | 最后最慢时，每格停留的 tick |
pointer-top / pointer-bottom | HOPPER / END_ROD | 上方 / 下方指针的材质 |
pointer-name / pointer-name-bottom | ▼ 结果 ▼ / ▲ 结果 ▲ | 指针的名称 |
spin-light | LIGHT_BLUE_STAINED_GLASS_PANE | 转动中跑马灯的颜色 |
start-sound | BLOCK_BEACON_ACTIVATE:0.6:1.6 | 开始音效 |
tick-sound | BLOCK_NOTE_BLOCK_HAT | 每转一格的音效（只写名称，音调越转越高） |
cards 星辰翻牌
| 键 | 默认 | 作用 |
|---|---|---|
title | ✦ {crate} · 星辰翻牌 ×{count} | 界面标题，{count} = 抽数 |
sort-ascending | true | 十连时从最普通翻到最稀有；false = 按抽出的顺序翻 |
hint-rarity | epic | 发牌后，这个稀有度 以上的牌先闪耀（预告） |
suspense-rarity | epic | 这个稀有度以上的牌翻开前会颤动 |
card-material | PAPER | 牌背的材质 |
card-custom-model-data | 0 | 牌背的 CustomModelData（资源包做牌背用，0 = 不设） |
card-item-model | '' | 牌背的 item_model（1.21.4+，例如 myserver:card_back） |
card-name | ✦ ？？？ ✦ | 牌背的名称 |
card-name-hint | <{color}>✦ 卡牌在闪耀 ✦ | 闪耀中的牌的名称，{color} = 稀有度颜色 |
frame | GRAY_STAINED_GLASS_PANE | 上下边框 |
deal-gap | 3 | 每发一张牌的间隔（tick） |
hint-delay | 8 | 发完牌到闪耀预告的等待（tick） |
hint-hold | 16 | 闪耀预告后到开始翻牌的等待（tick） |
flip-gap | 6 | 每翻一张牌的间隔（tick），颤动的牌会多等一点 |
start-sound | ITEM_BOOK_PAGE_TURN:0.8:0.8 | 开始音效 |
deal-sound | ITEM_BOOK_PAGE_TURN | 发牌音效（只写名称） |
hint-sound | BLOCK_AMETHYST_BLOCK_RESONATE:1:1.2 | 闪耀预告音效 |
flip-sound | ITEM_ARMOR_EQUIP_ELYTRA | 翻牌音效（只写名称） |
shake-sound | BLOCK_NOTE_BLOCK_BELL | 颤动音效（只写名称 ） |
hint-rarity、suspense-rarity 写了不存在的稀有度时会当成最普通的稀有度，等于每张牌都闪耀、都颤动。
starfall 星落
| 键 | 默认 | 作用 |
|---|---|---|
title | ✦ {crate} · 星落 | 界面标题 |
twinkle-frames | 8 | 开场星光闪烁几次 |
meteor-gap | 3 | 流星每移动一格的间隔（tick） |
reveal-gap | 5 | 每个结果出现后的停顿（tick） |
rare-extra-gap | 6 | 传说以上（rarities.yml 第 4 个以后的稀有度）的结果再多停几 tick |
start-sound | BLOCK_BEACON_POWER_SELECT:0.5:1.8 | 开始音效 |
launch-sound | ENTITY_FIREWORK_ROCKET_LAUNCH:1:0.8 | 流星出现的音效 |
burst-sound | 按稀有度自动选择 | 炸开的音效（默认文件里没有这一行；最稀有结果是第 4 个稀有度以上时用大型爆炸声） |
slots 星月老虎机
| 键 | 默认 | 作用 |
|---|---|---|
title | ✦ {crate} · 星月老虎机 | 界面标题 |
jackpot-rarity | legendary | 抽中这个稀有度以上（或终极大奖）时三个转轮都停在奖品上 |
spin-frames | 26 | 第一个转轮停下前转几帧（最少 10） |
stop-gap | 8 | 每个转轮之间相差几帧停下（最少 2） |
frame | GRAY_STAINED_GLASS_PANE | 转轮之间的隔板 |
payline-marker | SPECTRAL_ARROW | 中奖线两端的标记 |
payline-name | » 中奖线 | 标记的名称 |
spin-light | YELLOW_STAINED_GLASS_PANE | 两侧闪烁灯的颜色 |
start-sound | BLOCK_LEVER_CLICK:1:0.8 | 开始音效 |
stop-sound | BLOCK_IRON_TRAPDOOR_CLOSE | 转轮停下的音效（只写名称） |
tick-sound | BLOCK_NOTE_BLOCK_HAT | 转动音效（只写名称） |
carousel 星环回廊
| 键 | 默认 | 作用 |
|---|---|---|
title | ✦ {crate} · 星环回廊 | 界面标题 |
steps | 38 | 转动的格数（最少 25，也就是一整圈） |
steps-random | 6 | 随机多转 0 ～ (这个数 − 1) 格 |
slowest-delay | 5 | 最后最慢时，每格停留的 tick |
inner | BLACK_STAINED_GLASS_PANE | 内圈的玻璃板 |
pointer | HOPPER | 指针材质（顶部中间下方） |
pointer-name | ▲ 停在这里的就是你的奖品 | 指针名称 |
start-sound | BLOCK_END_PORTAL_FRAME_FILL:1:1.4 | 开始音效 |
tick-sound | BLOCK_NOTE_BLOCK_CHIME | 转动音效（只写名称） |
orbit 星环（3D）
| 键 | 默认 | 作用 |
|---|---|---|
distance | 3.2 | 星环中心离玩家眼睛的距离（格） |
radius | 1.6 | 星环半径（格） |
ring-size | 8 | 单抽时星环上有几个物品（其中一个是奖品，最少 4）；十连固定是 10 个结果 |
turns | 3 | 至少转几圈 |
spin-ticks | 70 | 旋转的时间（tick） |
item-scale | 0.8 | 物品大小 |
winner-scale | 1.7 | 单抽时奖品放大到多大 |
reveal-gap | 6 | 十连时每个结果亮起后的停顿（tick） |
rare-extra-gap | 6 | 传说以上（rarities.yml 第 4 个以后的稀有度）的结果再多停几 tick |
label | {rarity} <white>{prize} | 奖品上方的名称，{rarity} 稀有度、{prize} 奖品名称 |
start-sound | BLOCK_BEACON_ACTIVATE:0.8:1.4 | 开始音效 |
tick-sound | BLOCK_NOTE_BLOCK_CHIME | 旋转音效（只写名称） |
meteor 流星（3D）
| 键 | 默认 | 作用 |
|---|---|---|
fall-ticks | 22 | 每颗流星坠落的时间（tick） |
start-height | 14 | 流星从多高开始落（格） |
start-back | 5 | 流星从玩家后方多远开始落（格） |
arc-degrees | 120 | 十连时流星落点排成的弧形角度 |
arc-radius | 4.2 | 十连时弧形离玩家的距离（格）；单抽落在正前方 3.2 格 |
stagger | 7 | 十连时每颗流星的间隔（tick） |
star-scale | 0.9 | 流星大小 |
star-item | NETHER_STAR | 流星的默认物品 |
star-items.<稀有度 ID> | 见文件 | 各稀有度流星的物品，没写的用 star-item |
label | {rarity} <white>{prize} | 奖品上方的名称 |
start-sound | ENTITY_ILLUSIONER_PREPARE_MIRROR:0.6:1.6 | 开始音效 |
fall-sound | ENTITY_FIREWORK_ROCKET_LAUNCH | 坠落音效（只写名称） |
impact-sound | ENTITY_GENERIC_EXPLODE | 落地音效（只写名称） |