指令
主指令是 /starcrate，平常打 /sc 就好。如果 /sc 被 CMI 等插件占用，见 安装 · /sc 被其他插件抢走了？。
在游戏里输入 /sc 或 /sc help 会列出你能用的指令（有 starcrate.admin 才会显示管理指令）；所有指令都支持 Tab 补全。
看懂指令写法
| 写法 | 意思 |
|---|---|
<奖池> | 必填，奖池 ID（不分大小写），/sc list 可以查看 |
[玩家] | 选填，在线玩家名称；不写 = 自己 |
a|b | 二选一 |
/sc 的转向只对玩家输入有效，控制台、计划任务、其他插件的奖励指令请写 starcrate，并且一定要写出玩家名称，例如：
starcrate draw xinghui 1 Steve free
starcrate give xinghui 1 Steve
还没填授权码（或授权失效）时，除了 /sc version 与 /sc reload，其他指令都只会提示「星月造物尚未授权」。
总览
| 指令 | 权限 | 说明 |
|---|---|---|
/sc | starcrate.open | 打开抽奖画面（menu.default-crate 指定的奖池） |
/sc open <奖池> [玩家] | starcrate.open | 打开奖池预览 |
/sc list | — | 奖池列表 |
/sc history [玩家] [奖池] | — / starcrate.admin.history | 抽奖记录 |
/sc stash | — | 领取暂存的奖励 |
/sc animation | starcrate.skip-animation | 开关自己的抽奖动画 |
/sc help | — | 帮助 |
/sc create <ID> | starcrate.admin.edit | 建立奖池并打开编辑器 |
/sc delete <ID> | starcrate.admin.edit | 删除奖池 |
/sc rename <旧ID> <新ID> | starcrate.admin.edit | 改奖池 ID（数据一起转移） |
/sc edit <ID> | starcrate.admin.edit | 打开编辑器 |
/sc give <奖池> <数量> [玩家] | starcrate.admin.give | 给宝箱物品 |
/sc key <奖池> <数量> [玩家] | starcrate.admin.give | 给钥匙 |
/sc draw <奖池> <1|10> [玩家] [free] | starcrate.admin.draw | 替玩家抽奖 |
/sc setblock <奖池> | starcrate.admin.block | 把看着的方块设为抽奖入口 |
/sc removeblock | starcrate.admin.block | 解除抽奖方块 |
/sc setentity <奖池> [半径] [高度] | starcrate.admin.block | 把看着的实体（盔甲架 / 展示实体 / 物品展示框）设为抽奖入口 |
/sc setmodel <奖池> [半径] [高度] | starcrate.admin.block | 按位置绑定封包模型（ModelEngine、BetterModel、CraftEngine 家具等） |
/sc removeentity | starcrate.admin.block | 解除抽奖实体或模型区域 |
/sc cleanup | starcrate.admin.block | 清除残留的展示实体 |
/sc pity <玩家> <奖池> [次数] | starcrate.admin.pity | 查看 / 设置保底次数 |
/sc stats <奖池> | starcrate.admin.stats | 奖品实际出现率 |
/sc top [奖池] | starcrate.admin.stats | 抽奖次数排行 |
/sc import yunyuelottery [overwrite] [folder=路径] | starcrate.admin.import | 从 YunYueLottery 导入 |
/sc reload | starcrate.admin.reload | 重载 |
/sc version | — | 版本信息 |
全部权限节点见 权限。
玩家指令
/sc
/sc
玩家只打 /sc 会直接打开抽奖画面：装了云界面 CloudUI 就是 云界面抽奖画面，没装是箱子预览。打开的奖池由 config.yml 的 menu.default-crate 决定（留空 = 第一个奖池）。没有 starcrate.open 权限的玩家、控制台打 /sc 会显示帮助。
/sc open
/sc open <奖池> [玩家]
| 别名 | /sc preview |
| 权限 | 自己打开：starcrate.open（默认所有人都有）；替别人打开：starcrate.admin.open |
| 说明 | 打开奖池的预览界面（自选奖池打开选择界面）。在预览里点单抽 / 十连才是真正的抽奖，花费、权限、每日上限照常检查。从这里打开时不会消耗宝箱物品 |
/sc open xinghui # 自己打开
/sc open xinghui Steve # 替 Steve 打开（需要 starcrate.admin.open；控制台一定要写玩家）
没有 starcrate.admin.open 的玩家写了玩家名称，仍然只会打开给自己。
/sc list
/sc list
列出所有奖池的显示名称与 ID。不需要权限。
/sc history
/sc history [玩家] [奖池]
| 权限 | 看自己的：不需要；看别人的：starcrate.admin.history |
| 说明 | 打开抽奖记录界面，最近 200 条，新的在前。只能由玩家执行 |
/sc history # 自己在所有奖池的记录
/sc history Steve # Steve 在所有奖池的记录（玩家需要曾经进过服务器）
/sc history Steve xinghui # Steve 在 xinghui 的记录
预览界面的「抽奖记录」按钮打开的是自己在这个奖池的记录。记录保留天数见 config.yml 的 history-keep-days。
/sc stash
/sc stash
领取背包满时暂存的奖励，放得下几份就领几份。只能由玩家执行。见 奖励发放 · 领取暂存。
/sc animation
/sc animation
| 别名 | /sc anim |
| 权限 | starcrate.skip-animation（默认所有人都有） |
| 说明 | 关闭 / 开启自己的抽奖动画。关闭后抽奖直接显示结果。服务器重启后恢复为开启 |
奖池管理
/sc create
/sc create <ID>
建立一个空的奖池（crates/<ID>.yml），由玩家执行时直接打开编辑器。
ID 只能用字母、数字、中文、- 与 _，最多 48 个字；已经存在时提示「奖池 … 已存在」。
/sc create xinghui
/sc create 新春礼包
/sc delete
/sc delete <ID>
删除奖池：文件移到 plugins/StarCrate/deleted-crates/（不会真的删掉，可以搬回来），玩家数据保留。
绑定这个奖池的抽奖方块会一起解除，方块上方的全息也会移除。没有确认步骤，请小心输入。
/sc rename
/sc rename <旧ID> <新ID>
改奖池 ID。玩家的保底次数、获得次数、抽奖记录、待补发记录一起转移到新 ID，抽奖方块也会跟着改。
改名前发出的宝箱物品与钥匙照常可用：旧 ID → 新 ID 记在 plugins/StarCrate/renamed-crates.yml，旧 ID 之后会一直指向新奖池（所以 不能再用旧 ID 建立新奖池）。
只想改显示名称时，请在编辑器改「显示名称」就好。
/sc edit
/sc edit <ID>
打开 编辑器。只能由玩家执行。
物品
/sc give
/sc give <奖池> <数量> [玩家]
给宝箱物品（右键打开的随身奖池）。数量最少 1，超过一组自动分组，背包放不下的掉在脚下。见 宝箱物品与钥匙。
/sc give xinghui 1
/sc give xinghui 64 Steve
/sc key
/sc key <奖池> <数量> [玩家]
给钥匙。钥匙的外观是编辑器设定的模板，或默认的发光绊线钩。见 钥匙。
/sc key xinghui 10 Steve
抽奖
/sc draw
/sc draw <奖池> <1|10> [玩家] [free]
| 权限 | starcrate.admin.draw |
| 说明 | 替玩家抽一次（1）或十连（10，写其他数字都当成 1），会照常播放动画、发放奖励、计入保底与记录 |
| 写法 | 花费与检查 |
|---|---|
不加 free | 和玩家自己在预览里点抽奖一样：扣玩家的花费，检查开启权限、每日上限、能不能十连 |
加 free | 免费：不扣任何花费，也不检查开启权限与每日上限（是否允许十连、奖池有没有奖品、玩家还能抽到几个奖品仍会检查） |
免费代抽结束后打开的结果界面里，「再抽一次」「再来十连」是玩家自己的一般付费抽奖，不会再免费。
/sc draw xinghui 10 Steve free # 活动奖励：送 Steve 一次免费十连
/sc draw xinghui 1 # 自己付费单抽一次
适合放在任务、签到、投票、礼包插件的奖励指令里（控制台请写 starcrate draw …）。free 前面一定要写玩家名称。
抽奖方块
/sc setblock
/sc setblock <奖池>
把你看着的方块（6 格内）设为奖池入口。只能由玩家执行。见 抽奖方块。
/sc removeblock
/sc removeblock
解除你看着的抽奖方块。
/sc setentity
/sc setentity <奖池> [半径] [高度]
把你看着的实体（6 格内，盔甲架、展示实体、物品展示框、标记盔甲架都可以）设为奖池入口。没有碰撞箱的实体默认按半径 1.5 格、高 2 格判定点击，可以用 [半径] [高度] 指定。找不到实体时自动改为按位置绑定。只能由玩家执行。见 抽奖实体。
/sc setmodel
/sc setmodel <奖池> [半径] [高度]
以看着的方块（模型脚下）为底，设一个圆柱范围当奖池入口，默认半径 1.2 格、高 2 格。给只存在于客户端的封包模型用。见 封包模型。
/sc removeentity
/sc removeentity
解除你看着的抽奖实体或模型区域；看不到时，解除你身边 4 格内的那一个。
/sc cleanup
/sc cleanup
清除所有已载入世界里残留的方块全息与奖品展示实体，然后重新生成。
数据与统计
/sc pity
/sc pity <玩家> <奖池> [次数]
| 权限 | starcrate.admin.pity |
| 说明 | 不写次数：查看玩家的保底次数与总抽数；写次数：把保底次数设为这个数字（最小 0）。玩家可以不在线（需要曾经进过服务器） |
/sc pity Steve xinghui # → Steve 在 星辉宝箱：保底 12/50 · 共抽 87 次
/sc pity Steve xinghui 0 # 重置保底
/sc pity Steve xinghui 49 # 下一抽就触发硬保底（测试用）
保底次数的意思见 概率与保底。设置会写进数据库；使用 MySQL 时，玩家即使正在别的子服，下一抽也会使用你设的值（每次抽奖前都会重新读取）。
/sc stats
/sc stats <奖池>
列出奖池的总抽数、玩家数，以及每个奖品被抽到的次数、实际比例与设定概率。见 概率与保底 · 核对实际出现率。
/sc top
/sc top [奖池]
抽奖次数前 10 名（每个奖品算一次，十连算 10 次）。不写奖池（或写了不存在的奖池）= 所有奖池合计。
其他
/sc import
/sc import yunyuelottery [overwrite] [folder=路径]
从 YunYueLottery 导入奖池、抽奖方块与保底次数。见 从 YunYueLottery 导入。
/sc reload
/sc reload
重新读取 config.yml、messages.yml、rarities.yml、animations.yml、menus/、crates/、blocks.yml，并重新接入 Vault / PlayerPoints。
执行时会关闭所有玩家打开中的星月造物界面与编辑器（正在播放的动画不受影响）。数据库与跨服相关的设定需要重启，见 config.yml。
/sc version
/sc version
显示版本、版本类型、数据库（SQLite / MySQL）与奖励发放方式（StarMail / 直接放进背包）。不需要权限，未授权时也能用。