跳到主要内容

Nightbreak 账号绑定与令牌

Nightbreak 托管内容的下载现在通过 MagmaCore 使用共享令牌流程。

工作方式​

  1. 打开你的 Nightbreak 账号页面。
  2. 生成或复制你的服务器令牌。
  3. 运行：
/nightbreaklogin <token>

成功之后，同一台服务器上的兼容 MagmaGuy 插件就可以使用这个共享令牌进行 Nightbreak 访问检查和内容下载。

MagmaCore 为该命令注册的共享权限是 nightbreak.login。默认情况下该权限授予服务器管理员，除非服主自行修改。

令牌存放位置​

令牌存储在：

plugins/MagmaCore/nightbreak.yml

中的 token 键下，而不是放在每个插件自己的私有文件夹中。

这意味着：

  • 你不需要为每个插件分别注册令牌
  • 重新安装某一个插件通常不会导致令牌丢失
  • 如果删除了共享的 MagmaCore 配置，你可能需要重新注册令牌

令牌能解锁什么​

已绑定的令牌用于：

  • 检查服务器账号是否可访问某个内容包
  • 检查受管理内容包的远程版本信息
  • 将内容直接下载到插件的导入文件夹
  • 检测已安装包是否过期
  • 启用 Nightbreak 感知的设置菜单状态

它不会绕过插件自己的额外要求，例如：

  • 安装资源包
  • 在设置菜单中启用内容包
  • 保持必需依赖已安装

安全说明​

  • 请把令牌视为服务器凭证。
  • 不要把它发布到公共聊天、截图或支持日志里。
  • 如果你怀疑它已经泄露，请前往 Nightbreak 账号页面撤销它并重新生成新令牌。
  • 如果令牌前缀看起来不像 Nightbreak 令牌，MagmaCore 会发出警告，但仍会尝试保存。

故障排查​

“No token registered”​

插件尚未检测到有效的共享 Nightbreak 令牌。请再次运行 /nightbreaklogin <token>，并确认 plugins/MagmaCore/nightbreak.yml 中现在保存的是实际令牌，而不是缺失值或占位值。

“You don't have access to this content”​

令牌本身是有效的，但当前绑定的 Nightbreak 账号并没有解锁该内容包。

一个插件能用，另一个不能​

请检查对应插件自己的设置页面。有些插件仍然需要：

  • 先完成首次设置菜单
  • 在导入后进行一次重载
  • 安装资源包
  • 安装可选依赖，例如 FreeMinecraftModels 或 ResourcePackManager