跳到主要内容

常见问题

指令与安装​

输入 /sc 打开的是 CMI（或别的插件）？​

CMI 等插件也注册了 /sc。检查 config.yml：

command-aliases: [sc]

有 sc 时，玩家输入的 /sc … 会在其他插件看到之前转给星月造物。改过这个设定后 /sc reload。 控制台与其他插件执行指令时不经过这个转向，请写 starcrate …。见 安装 · /sc 被其他插件抢走了？

所有指令都提示「星月造物尚未授权」？​

授权码还没填或还没验证通过。打开 plugins/StarCrate/token.yml 填入授权码后重启；控制台会写出原因。见 安装与获取。

中文变成乱码？​

crates/、messages.yml 等文件都要存成 UTF-8。请用 VS Code、Notepad++ 等编辑器另存为 UTF-8 后 /sc reload。在游戏里用编辑器输入的中文不会有这个问题。

奖励​

奖励没有寄到星月邮箱，直接进了背包？​

输入 /sc version 看「奖励：」后面写的是什么。显示「直接放进背包」时：

  • 没有安装 StarMail 星月邮箱，或星月邮箱没有成功启用（例如还没填它自己的授权码）；
  • config.yml 的 delivery.use-starmail 是 false。

开服时控制台也会写出「奖励发放方式：…」。

背包满了，奖励去哪里了？​

使用星月邮箱时奖励本来就在邮箱里。直接放背包时，放不下的部分默认暂存：输入 /sc stash，或点预览界面的「领取暂存奖励」。 config.yml 的 delivery.overflow: drop 时则是掉在脚下。

动画播到一半关服 / 掉线，奖励会不会丢？​

不会。结果在动画开始前就存进数据库：下线或正常关服时会立刻发放；崩溃时玩家下次上线会自动补发。见 奖励发放。

奖品的指令没有执行？​

  • 奖励寄到星月邮箱时，指令默认在玩家领取邮件时才执行（delivery.mail-commands: claim）。还没领就还没执行；想抽中就执行改成 now。
  • 指令默认由控制台执行，开头不用写 /；要让玩家自己执行请在开头加 [player]。
  • 看控制台有没有「奖励指令执行失败」。见 奖池文件 · 奖励指令。

概率与保底​

预览里显示的概率一直在变？​

这是正常的。预览显示的是你下一抽的真实概率：

  • 奖池有软保底时，越接近保底，终极大奖的概率越高、其他奖品越低；
  • 下一抽触发硬保底时，终极大奖合计 100%、其他 0%；
  • 达到每人上限的奖品显示 0%，其他奖品的概率按比例变大。

抽到终极大奖后就会回到原本的概率。见 概率与保底。

十连时提示「你最多只能再抽 N 次」？​

奖池的奖品都有每人上限，而这位玩家剩下能抽到的奖品不够 10 个。为了不让他付了十连的钱却拿不满，插件会整次拒绝、不扣费，请他改用单抽。见 概率与保底 · 十连。

十连保底没有触发？​

十连保底只有在 10 个结果全都低于指定稀有度时才介入；已经有一个达标就不会再加。 另外，稀有度低于保底等级的终极大奖不算达标；奖池没设定十连保底时使用 config.yml 的 defaults.ten-guarantee（默认不保底）。

怎么查一个玩家的保底、或帮他重置？​

/sc pity <玩家> <奖池> 查看，/sc pity <玩家> <奖池> 0 重置。见 指令 · /sc pity。

每日上限什么时候重置？​

服务器所在时区的每天 0 点。十连算 10 次，剩下的次数不够时整次十连不能抽。

奖池玩法​

怎么做「三选一」礼包？​

把奖池类型设为 自选（type: select），「自选数量」设 1，放进 3 个奖品。玩家打开后点一个奖品再按「确认选择」领取。 配合宝箱物品（/sc give <奖池> 1 <玩家>）发给玩家，开一次就用掉一个。见 奖池文件 · 三种奖池类型。

怎么做「不播动画、点了就开」的箱子？​

奖池类型设为 立即抽取（type: instant），结果直接写在聊天栏。

抽奖没有动画，直接显示结果？​

依序检查：奖池类型是不是「立即抽取」；config.yml 的 animation.enabled；你是不是用 /sc animation 关掉了自己的动画（再输入一次开启）；奖池的单抽 / 十连动画是不是设成「无动画」。

3D 动画别的玩家看不到？​

这是设计如此：3D 动画只有抽奖的玩家看得到，不会打扰旁边的人。

宝箱物品打开后没有被用掉？​

  • 奖池的「用宝箱物品开启时消耗宝箱」是关闭的（宝箱说明会写「开启时不会用掉这个宝箱」）；
  • 或者是用抽奖方块、/sc open 打开的——只有右键宝箱物品打开的预览才会消耗宝箱。

可以用别的插件发的物品当钥匙吗？​

可以。在编辑器「奖池设置」拿着那个物品点「钥匙物品」，之后和它完全相同的物品都会被当成钥匙。见 钥匙。

终极大奖不想全服公告？​

终极大奖在「跟随稀有度」时一律公告。在奖品详细设定把「全服公告」切到「不公告」，或关闭整个奖池的「全服公告」。见 全服公告。

活动想送玩家免费抽一次？​

在活动、签到、任务插件的奖励指令里写（控制台执行）：

starcrate draw xinghui 1 %player% free

%player% 换成那个插件的玩家变量。

文件与数据​

改了奖池文件没有生效？​

手改文件后要 /sc reload。另外，如果编辑器同时开着这个奖池，编辑器下一次保存会覆盖你手改的内容。

奖池改了 ID，玩家手上的宝箱和钥匙还能用吗？​

能。用 /sc rename 改 ID 时，插件会把旧 ID 记在 renamed-crates.yml，改名前发出的宝箱物品与钥匙会自动对应到新奖池。 请不要直接改 crates/ 里的文件名，那样玩家数据与旧物品都不会跟着走。见 奖池文件 · 删除与改名。

方块上方的全息重叠、或删不掉？​

执行 /sc cleanup，会清除残留的展示实体并重新生成。

跨服时保底次数不同步？​

  • 每个子服的 database（地址、数据库名称）与 table-prefix 要完全相同，type: mysql，并且重启过；
  • 各子服的奖池 ID 要相同（把同一份 crates/<奖池>.yml 复制过去）；
  • 每个子服设一个不同的 sync.server-id。

见 跨服。

怎么备份、搬服？​

关服后复制整个 plugins/StarCrate/：奖池在 crates/，方块在 blocks.yml，玩家数据在 data.db（使用 MySQL 时请另外备份数据库）。

最后于 更新