跳到主要内容

安装与获取

下载与授权（免费）​

  1. 打开 资源中心，注册并登录。
  2. 在 StarCrate 星月造物 点「免费领取」，永久授权码会加入你的会员中心。
  3. 打开详情，下载最新的 StarCrate-<版本>-簡體授權版.jar。

运行环境​

项目要求
服务端Paper / Purpur / Folia 1.20 – 26.x（26.x 需要 Java 25）。不支持 Spigot
前置插件无
数据库默认 SQLite（不用设定，数据存在 plugins/StarCrate/data.db）；多个子服共享数据时改用 MySQL / MariaDB，见 跨服
3D 动画、方块全息使用 Display 实体，需要 1.19.4+，支持的版本全部都有

可选联动​

都不是必装的，装了就自动接入，开服时控制台会写出接入了哪些。

插件装了以后
StarMail 星月邮箱奖励寄到玩家邮箱，背包满了也不怕，任何子服都能领。没装时奖励直接放进背包。见 奖励发放
云界面 CloudUI奖池预览改用全屏的云界面画面（展示台上旋转的奖品、稀有度卡框、保底进度条）。见 云界面预览
Vault + 经济插件奖池可以用 金币 当花费
PlayerPoints奖池可以用 点券 当花费
PlaceholderAPI可以使用 %starcrate_…% 变量，见 变量

全新安装​

  1. 把插件放进 plugins/（要用星月邮箱、Vault 等就一起放），启动服务器。
  2. 打开 plugins/StarCrate/token.yml，填入授权码，重启（首次启动自动绑定本机）。
  3. 输入 /sc version，看到版本、数据库与奖励发放方式就成功了。

第一次启动会生成一个示例奖池 example（星辉宝箱）：/sc open example 打开看看，/sc edit example 在游戏里编辑。 接着照 建立第一个奖池 动手做一个。

还没填授权码时

插件会正常启动，但抽奖功能是锁定的：除了 /sc version 与 /sc reload，其他指令、抽奖方块、宝箱物品都只会提示「星月造物尚未授权」，变量也不会显示。 填好授权码后重启即可；如果是开服时连不上授权服务器，插件会每 60 秒自动重试，连上就立刻开启，不需要重启。

控制台显示「无法连接授权服务器」

第一次启动必须连上 license.plugins.wiki 验证一次，之后断网也能离线运行 72 小时。控制台会写出原因：

原因处理
DNS 解析不到换 DNS（例如 223.5.5.5 / 119.29.29.29）后重启
连线被拒绝或无法建立主机商 / 面板的防火墙放行对外 HTTPS；本机电脑检查杀毒软件是否拦截 java.exe
连线超时网络太慢或被拦截；稍后会自动重试
HTTPS 握手失败关闭会拦截 HTTPS 的代理或网络设备；插件也会自动改用 HTTP 验证（回应带数字签名，安全性不受影响）

本机电脑如果是靠加速器 / 代理（例如 Clash）才打得开网站：浏览器会走代理，但 Java 不会。请开启加速器的「TUN / 虚拟网卡」模式， 或在启动参数加 -Djava.net.useSystemProxies=true。

/sc 被其他插件抢走了？​

星月造物的主指令是 /starcrate，别名 /sc。CMI 等插件也注册了 /sc，两个插件抢同一个指令时，玩家打 /sc 可能会打开别的插件的功能。

config.yml 里的 command-aliases 就是用来解决这个问题的：

# 这些指令一律交给星月造物处理（CMI 等插件也有 /sc，会抢走指令）。清空 [] 则不处理
command-aliases: [sc]

列在这里的指令，玩家输入时会在其他插件看到之前直接改成 /starcrate，所以 /sc open example 一定由星月造物处理。默认已经包含 sc，一般不用改。

  • 想让 /sc 还给别的插件：改成 command-aliases: []，之后请玩家使用 /starcrate。
  • 想多一个简短指令（例如 /cj）：写成 command-aliases: [sc, cj]，/sc reload 生效。
  • 这个转换只对玩家输入的指令有效；控制台与其他插件执行指令时请写 /starcrate（如果 /sc 没有被其他插件占用，控制台用 sc 也可以）。

文件说明​

路径用途
config.yml奖励发放、动画、公告、抽奖方块、宝箱物品外观、数据库、跨服，见 config.yml
messages.yml所有提示文字与编辑器文字，见 messages.yml
rarities.yml稀有度，见 稀有度
animations.yml每种动画的参数、文字与音效，见 抽奖动画
menus/preview.yml、results.yml、history.yml预览、抽奖结果、抽奖记录三个界面，见 界面配置
crates/*.yml一个奖池一个文件，文件名就是奖池 ID，见 奖池文件
blocks.yml抽奖方块的位置（只属于这一台服务器），见 抽奖方块
data.dbSQLite 数据库：保底次数、获得次数、抽奖记录、暂存奖励、待补发记录（使用 MySQL 时不会用到）
deleted-crates//sc delete 删除的奖池文件会移到这里，需要时可以搬回 crates/ 再 /sc reload
renamed-crates.yml/sc rename 留下的「旧 ID → 新 ID」对应，让改名前发出的宝箱物品与钥匙继续可用，请勿手动修改
token.yml授权码

升级​

  1. 关服，备份 plugins/StarCrate/（好习惯）。
  2. 删掉旧的 JAR，放入新的 StarCrate-<版本>-簡體授權版.jar。
  3. 开服。奖池、方块、玩家数据与授权码都会保留。

升级时设定文件的处理方式：

文件新版本新增的项目
config.yml不会写进你现有的文件。没写的项目直接使用默认值，功能照常；想调整就自己把键加进去（键名与默认值见 config.yml）。
messages.yml、animations.yml文件里没有的键自动使用插件内置的默认值，不会显示「Missing message」；想修改就把键加进文件。
menus/*.yml文件被删掉时，/sc reload 或重启会重新生成默认的界面文件。

每个版本改了什么见 更新记录。

最后于 更新