Nightbreak 账户关联和令牌
Nightbreak 管理的内容下载通过 MagmaCore 使用共享账户令牌。只需关联服务器一次，其上所有兼容的 MagmaGuy 插件都会使用同一个令牌。
从浏览器关联服务器
- 在游戏内或控制台中运行不带令牌的
/nightbreaklogin。 - 服务器会打印一个 nightbreak.io 链接和一个类似
K7QF-9XMB的代码。在游戏内，该链接可以点击。 - 打开链接，登录或创建免费的 Nightbreak 账户，确认页面显示的代码与服务器上的相同，然后批准该服务器。
- 几秒钟内，服务器会保存你的账户令牌，显示它现在所关联的账户，并提醒你
/nightbreaklogout会断开关联。 - 重启服务器以完成设置。
链接在 30 分钟后过期。如果链接过期或被拒绝，请再次运行 /nightbreaklogin 获取新链接。发起新链接会取消上一个链接。
批准页面会显示发出请求的服务器、插件和 Minecraft 版本。如果该服务器所在的网络与你的令牌所绑定的网络不同，页面会警告：进行关联会使你在旧网络上的服务器被锁定，最长 48 小时。
批准会把你的账户已有的令牌交给该服务器，因此你之前关联过的服务器仍可继续使用。尚无令牌的账户会获得一个令牌。如果你的令牌创建于服务器关联功能出现之前，页面会请求替换它。替换后，所有使用旧令牌的服务器都会断开，直到你重新关联它们。
已经有可用令牌的服务器不会自行切换账户。批准之后，它会保留旧令牌，并请你在 5 分钟内运行 /nightbreaklogin confirm 来切换。如果 Nightbreak 此前已拒绝了已保存的令牌，则批准的链接会立即替换它。
BetterStructures、FreeMinecraftModels、EternalTD、CannonRTP 和 ResurrectionChest 的首次设置菜单中的 Recommended Setup（推荐设置）选项，会在服务器尚未关联时为你发起一次关联。
如果服务器无法连接 nightbreak.io，或关联功能不可用，命令会说明这一情况，并指引你使用下方的令牌方式。
如何生成令牌并将其关联到你的服务器
令牌方式仍然可用，例如用于自动化设置，或在无法发起链接时。
- 打开你的 Nightbreak 账户页面。
- 点击 Generate New Token 按钮生成你的服务器令牌。
- 从账户页面复制该命令并在游戏内运行：
/nightbreaklogin <token>
- 重启服务器以完成令牌设置。
Generate New Token 会替换并使旧令牌失效；吊销已泄露的令牌时也使用此操作。已有令牌会被隐藏，无法再次复制。请安全保存新生成的命令，并更新每一台使用旧令牌的服务器，或用 /nightbreaklogin 重新关联每一台服务器。
令牌保存之后（无论是通过链接还是通过此命令），同一服务器上的兼容 MagmaGuy 插件都可以使用它进行 Nightbreak 访问检查和下载。
登录成功消息只确认令牌已保存到本地。该命令不会立即验证经过认证的访问权限。请打开内容菜单或请求一次有权限的下载，确认 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 感知的设置菜单状态
- 在游戏内下载插件 jar，包括插件更新以及
/nightbreak plugins中尚未安装的插件。Nightbreak 只允许支持者进行这些下载。对于插件更新，这意味着需要有效的支持者 Patreon 会员资格
它不会绕过插件特定的要求，例如：
- 安装资源包
- 在设置菜单中启用内容包
- 保持依赖项已安装
安全须知
- 将令牌视为服务器凭据。
- 不要在公共聊天、截图或支持日志中发布它。
- 如果您认为它已泄露，请运行
/nightbreaklogout，然后从 Nightbreak 账户页面撤销它并生成新的。 - 如果令牌不以
nbk_开头，MagmaCore 会发出警告，但仍会尝试保存它。 - 只批准你自己发起的链接，并核对页面上的代码与你的服务器一致。任何看到链接代码的人都可以把他们自己的账户批准到该服务器上；而别人发给你的链接，则会把他们的服务器关联到你的账户。
- 要撤销一次关联，请在该服务器上运行
/nightbreaklogout。要断开你已不再控制的服务器，请在账户页面生成新令牌。旧令牌随后会在所有地方失效，所以请重新关联你自己的服务器。
故障排除
"No token registered"
插件尚未检测到有效的共享 Nightbreak 令牌。再次使用 /nightbreaklogin 或 /nightbreaklogin <token> 关联服务器，并确认 plugins/MagmaCore/nightbreak.yml 现在包含真实的令牌，而不是缺失或占位符值。如果该文件根本不存在，那要么是令牌从未注册过，要么是有人运行了 /nightbreaklogout。
"The saved account token needs to be updated"
Nightbreak 拒绝了已保存的令牌，例如因为它已被更新的令牌取代。控制台会记录第一次拒绝以及服务器的响应，并隐藏之后的令牌错误。在你注册新令牌之前，内容下载、插件更新下载和游戏内插件安装都会因这条消息而停止。请运行 /nightbreaklogin 并批准链接，这会立即替换被拒绝的令牌；或者在 Nightbreak 账户页面生成新令牌，然后运行 /nightbreaklogin <token>。
/nightbreaklogin 要求提供令牌
最先加载的 Nightbreak 插件会注册 /nightbreaklogin，而在这台服务器上，该插件的版本早于服务器关联功能，所以该命令只接受令牌。请更新你的 Nightbreak 插件，或使用令牌方式。
服务器无法发起链接
命令无法连接 nightbreak.io、关联功能目前不可用，或者服务器在几分钟内请求了过多链接。消息会指出原因并显示令牌方式。请等待几分钟后重试，或改用令牌进行关联。
链接已过期或被拒绝
请再次运行 /nightbreaklogin 获取新链接。链接有效期为 30 分钟，一旦有人在页面上拒绝它，服务器就会立刻停止等待。
链接已批准，但服务器保留了旧账户
该服务器此前已有可用的令牌。请在批准后 5 分钟内运行 /nightbreaklogin confirm 切换到新账户，或者忽略它以保留旧账户。
"You don't have access to this content"
令牌有效，但关联的 Nightbreak 账户当前未解锁该包。
一个插件可以工作，另一个不行
检查插件特定的设置页面。某些插件仍然需要：
- 完成首次设置菜单
- 导入后重新加载
- 资源包安装步骤
- 可选依赖项，如 FreeMinecraftModels 或 ResourcePackManager