Привязка аккаунта Nightbreak и токены
Загрузки контента, управляемого Nightbreak, теперь используют общий поток токенов через MagmaCore.
Как сгенерировать токен и привязать его к серверу
- Откройте страницу своего аккаунта Nightbreak.
- Сгенерируйте серверный токен, нажав кнопку Generate New Token.
- Скопируйте команду со страницы аккаунта и выполните её в игре:
/nightbreaklogin <token>
- Перезапустите сервер, чтобы завершить настройку токена.
Generate New Token заменяет предыдущий токен и делает его недействительным; это же действие используется для отзыва раскрытого токена. Существующие токены скрыты, и повторно скопировать их нельзя. Сохраните новую команду в безопасном месте и обновите сервер, который использовал старый токен.
После успешного выполнения совместимые плагины 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 и сгенерируйте новый. - MagmaCore предупреждает, если токен не начинается с
nbk_, но всё равно пытается его сохранить.
Устранение неполадок
"No token registered"
Плагин ещё не обнаружил действительный общий токен Nightbreak. Выполните /nightbreaklogin <token> снова и убедитесь, что plugins/MagmaCore/nightbreak.yml теперь содержит реальный токен, а не отсутствующее или заполнительное значение. Если файла вообще нет, значит токен либо никогда не регистрировался, либо кто-то выполнил /nightbreaklogout.
"The saved account token needs to be updated"
Nightbreak отклонил сохранённый токен, например потому, что его заменил более новый токен. Консоль записывает первый отказ с ответом сервера и скрывает последующие ошибки токена. Пока вы не зарегистрируете новый токен, загрузки контента, загрузки обновлений плагинов и установки плагинов в игре останавливаются с этим сообщением. Сгенерируйте новый токен на странице аккаунта Nightbreak и снова выполните /nightbreaklogin <token>.
"You don't have access to this content"
Токен действителен, но привязанный аккаунт Nightbreak в данный момент не разблокирует этот пакет.
Один плагин работает, другой нет
Проверьте страницу настройки конкретного плагина. Некоторым плагинам всё ещё необходимо:
- завершить меню первоначальной настройки
- перезагрузка после импорта
- шаг установки ресурс-пака
- необязательная зависимость, такая как FreeMinecraftModels или ResourcePackManager