跳到主要内容

稀有度

稀有度决定一个奖品「看起来有多稀有」：名称颜色、动画里的光、揭晓时的音效与屏幕大字、要不要放烟花、要不要全服公告。 稀有度定义在 plugins/StarCrate/rarities.yml，所有奖池共用；每个奖品在编辑器里用数字键 1–9 或在文件里用 rarity: 选择。

排列顺序就是稀有程度​

文件里越下面的稀有度越稀有。 这个顺序会用在：

  • 编辑器数字键：1 = 第一个，2 = 第二个……（只能用数字键设前 9 个，更多的请在奖品详细设定页用左右键切换）；
  • 十连保底 ten-guarantee: rare 的「稀有以上」；
  • 动画：十连从最普通翻到最稀有、翻牌的「闪耀预告」与「颤动」、老虎机的「三轮全中」等，见 抽奖动画；
  • 编辑器的「按稀有度排序」。

奖品写了不存在的稀有度时，会被当成第一个（最普通的）稀有度。稀有度 ID 不分大小写。

默认的五个稀有度​

ID名称颜色发光屏幕大字默认公告烟花
common普通#C9CED6
rare稀有#5EC8FF
epic史诗#C77DFF✔✦ 史诗 ✦✔
legendary传说#FFB627✔✦ 传说 ✦✔✔
mythic神话#FF4D6D✔✦ 神话降临 ✦✔✔
plugins/StarCrate/rarities.yml（节选）
legendary:
  name: '<gold>传说</gold>'
  color: '#FFB627'
  pane: ORANGE_STAINED_GLASS_PANE
  glow: true
  sound: 'UI_TOAST_CHALLENGE_COMPLETE:0.9:1.0'
  title: '<gradient:#FFD86F:#FC6262><bold>✦ 传说 ✦</bold></gradient>'
  subtitle: '{prize}'
  broadcast: true
  firework: true
  lore: []

每个键​

键类型默认作用
name文字稀有度 ID显示名称，也就是各处的 {rarity}：预览与结果界面的「稀有度 …」、聊天结果、公告、邮件、抽奖记录。支持 MiniMessage 与 & 颜色。
color#RRGGBB#FFFFFF稀有度的颜色：烟花颜色、3D 动画里奖品的发光颜色与粒子颜色，以及翻牌动画 card-name-hint 里的 {color}。写错时当成白色。
pane材质WHITE_STAINED_GLASS_PANE箱子动画里亮起的彩色玻璃板、抽奖结果界面奖品旁边的灯、编辑器奖品详细设定页的边框。必须是物品材质，写错时改用白色玻璃板并在控制台警告。
glowtrue / falsefalse奖品在预览、结果、动画、抽奖记录与编辑器里带附魔光泽。
sound音效''揭晓这个稀有度的奖品时播放，写法 音效名:音量:音调，例如 ENTITY_PLAYER_LEVELUP:0.8:1.3；也可以写资源包音效 myserver:crate.win。留空不播放。
title文字''揭晓时的屏幕大字，留空不显示。可用 {prize}（奖品名称）与 {rarity}（稀有度名称）。
subtitle文字''屏幕大字下方的小字，留空时显示奖品名称。只有 title 不是空白时才会显示。
broadcasttrue / falsefalse这个稀有度的奖品默认是否全服公告。每个奖品可以单独改成「公告」或「不公告」，见 奖励发放 · 公告。
fireworktrue / falsefalse揭晓时在玩家身上放一个这个颜色的烟花（不会造成伤害）。第 4 个以后的稀有度是星形烟花，前 3 个是大球形。
lore文字列表[]加在奖品说明最后的文字，出现在预览界面（menus/preview.yml 的 {rarity_lore} 那一行）与动画中的奖品上。

屏幕大字什么时候出现​

  • 单抽：揭晓奖品时，稀有度有 title 就显示。
  • 十连：每个奖品揭晓时只播音效与烟花；全部揭晓后，最稀有的那个奖品显示屏幕大字。
  • 终极大奖：稀有度有 title 时显示稀有度自己的 title；稀有度没有 title 时改用 animations.yml 的 common.grand-title（默认「✦ 终极大奖 ✦」）。所以终极大奖一定会有屏幕大字，副标题使用稀有度的 subtitle（空白时为奖品名称）。

新增或修改稀有度​

# 在 mythic 下面加一个比神话更稀有的
divine:
  name: '<gradient:#FFFFFF:#FFE8A3>神迹</gradient>'
  color: '#FFF2B3'
  pane: WHITE_STAINED_GLASS_PANE
  glow: true
  sound: 'UI_TOAST_CHALLENGE_COMPLETE:1:0.7'
  title: '<gradient:#FFFFFF:#FFE8A3><bold>✦ 神迹 ✦</bold></gradient>'
  subtitle: '{prize}'
  broadcast: true
  firework: true
  lore: ['<gradient:#FFFFFF:#FFE8A3>✦ 万中无一</gradient>']

存档后 /sc reload。注意：

  • 调换顺序会改变稀有程度，十连保底与动画会跟着变。
  • 改 ID 或删除稀有度：奖池文件里还写着旧 ID 的奖品会被当成最普通的稀有度，请一起修改奖池文件（或在编辑器重新设定）。
  • 3D 流星动画可以为每个稀有度指定流星的样子（animations.yml 的 meteor.star-items.<稀有度 ID>），新增稀有度时可以一起加上。
  • 文件里没有任何稀有度时，插件使用内置的「普通」并在控制台警告。
最后于 更新