Nightbreak 账户关联和令牌
Nightbreak 管理的内容下载现在通过 MagmaCore 使用共享令牌流程。
如何生成令牌并将其关联到你的服务器
- 打开你的 Nightbreak 账户页面。
- 点击 Generate New Token 按钮生成你的服务器令牌。
- 从账户页面复制该命令并在游戏内运行：
/nightbreaklogin <token>
- 重启服务器以完成令牌设置。
成功后，同一服务器上的兼容 MagmaGuy 插件可以使用共享令牌进行 Nightbreak 访问检查和下载。
每个插件都会在共享令牌文件发生变化时重新读取它，因此已经加载的插件无需重启就能察觉到新令牌。不过仍然建议以重启作为收尾步骤，因为某些插件的启动工作 —— 包括自动更新下载 —— 只在插件启用期间运行。
MagmaCore 为此命令注册的共享权限是 nightbreak.login，默认授予服务器操作员，除非服务器管理员进行更改。
由 Nightbreak 签发的令牌以 nbk_ 开头。如果你粘贴的内容不是这样，命令会向你发出警告但仍会保存它。空值以及字面占位符 YOUR_TOKEN_HERE 会被直接拒绝。
断开一台服务器的关联
要把一台服务器与其 Nightbreak 账户解除关联，请运行：
/nightbreaklogout
它使用与登录相同的 nightbreak.login 权限。它会直接删除 plugins/MagmaCore/nightbreak.yml，而不是把值清空，因此文件中不会残留任何令牌副本。已加载的插件会在下一次令牌检查时发现该文件消失，并无需重启就退回到未关联状态下的行为。
在把服务器交给他人之前、在把服务器副本上传到任何地方之前，或者当你怀疑令牌已经泄露时，请使用它。登出只会把令牌从这台服务器上移除 —— 如果它可能已经暴露，请同时在 Nightbreak 账户页面上吊销它。
如何将你的 Patreon 或 Itch 账户关联到 Nightbreak 账户
- 打开你的 Nightbreak 账户页面。
- 向下滚动到 Linked Accounts 部分，点击你想关联的服务对应的 Link 按钮。
- 你会被带到该服务的网页，如果尚未登录会要求你登录，然后直接进入授权窗口，在那里会要求你允许 Nightbreak 访问关联账户所需的数据。
- 关联账户之后，只要令牌设置正确，你就应当能在 Nightbreak 账户上以及游戏内访问通过该服务获得的内容。
令牌存储位置
令牌存储在：
plugins/MagmaCore/nightbreak.yml
位于 token 键下，而非各个插件的私有文件夹内。
这意味着：
- 您不需要为每个插件单独注册令牌
- 重新安装一个插件不一定会丢失令牌
- 删除 MagmaCore 的共享配置可能需要您重新注册令牌
令牌解锁的功能
已关联的令牌用于：
- 检查服务器账户是否可以访问内容包
- 检查管理包的远程版本元数据
- 将内容直接下载到插件导入文件夹
- 检测已安装的包是否过时
- 启用 Nightbreak 感知的设置菜单状态
它不会绕过插件特定的要求，例如：
- 安装资源包
- 在设置菜单中启用内容包
- 保持依赖项已安装
安全须知
- 将令牌视为服务器凭据。
- 不要在公共聊天、截图或支持日志中发布它。
- 如果您认为它已泄露，请运行
/nightbreaklogout，然后从 Nightbreak 账户页面撤销它并生成新的。 - 如果令牌不以
nbk_开头，MagmaCore 会发出警告，但仍会尝试保存它。
故障排除
"No token registered"
插件尚未检测到有效的共享 Nightbreak 令牌。再次运行 /nightbreaklogin <token> 并确认 plugins/MagmaCore/nightbreak.yml 现在包含真实的令牌，而不是缺失或占位符值。如果该文件根本不存在，那要么是令牌从未注册过，要么是有人运行了 /nightbreaklogout。
"You don't have access to this content"
令牌有效，但关联的 Nightbreak 账户当前未解锁该包。
一个插件可以工作，另一个不行
检查插件特定的设置页面。某些插件仍然需要：
- 完成首次设置菜单
- 导入后重新加载
- 资源包安装步骤
- 可选依赖项，如 FreeMinecraftModels 或 ResourcePackManager