Pular para o conteúdo principal

Ligação de conta Nightbreak e tokens

Os downloads de conteúdo gerido pelo Nightbreak agora utilizam um fluxo de tokens partilhado através do MagmaCore.

Como gerar um token e vinculá-lo ao seu servidor​

  1. Abra a sua página de conta Nightbreak.
  2. Gere o seu token de servidor clicando no botão Generate New Token.
image
  1. Copie o comando da página da conta e execute-o no jogo:
/nightbreaklogin <token>
  1. Reinicie o servidor para concluir a configuração do token.

Após o sucesso, os plugins MagmaGuy compatíveis no mesmo servidor podem usar o token partilhado para verificações de acesso e downloads do Nightbreak.

Cada plugin volta a ler o ficheiro de token partilhado sempre que este muda, por isso os plugins já carregados detetam um novo token sem reinício. Ainda assim, reiniciar continua a ser o passo final recomendado, porque parte do trabalho de arranque dos plugins — incluindo os downloads automáticos de atualizações — só corre enquanto o plugin está a ser ativado.

A permissão partilhada registada pelo MagmaCore para este comando é nightbreak.login, que por defeito está disponível para operadores do servidor, a menos que um administrador a altere.

Os tokens emitidos pelo Nightbreak começam por nbk_. Se colar algo que não comece assim, o comando avisa-o e guarda-o na mesma. Valores vazios e o marcador de posição literal YOUR_TOKEN_HERE são recusados de imediato.

Desligar um servidor​

Para desvincular um servidor da sua conta Nightbreak, execute:

/nightbreaklogout

Isto usa a mesma permissão nightbreak.login do login. Elimina plugins/MagmaCore/nightbreak.yml por completo em vez de apagar apenas o valor, por isso não fica nenhuma cópia do token no ficheiro. Os plugins carregados veem o ficheiro desaparecer na verificação de token seguinte e voltam ao comportamento de não vinculado sem reinício.

Use isto antes de entregar um servidor a outra pessoa, antes de carregar uma cópia do servidor para qualquer lado, ou se suspeitar que o token foi comprometido. Terminar sessão apenas remove o token deste servidor — revogue-o também na página de conta Nightbreak se houver hipótese de ter sido exposto.

Como vincular a sua conta Patreon ou Itch à sua conta Nightbreak​

  1. Abra a sua página de conta Nightbreak.
  2. Desça até à secção Linked Accounts e clique no botão Link do serviço que pretende vincular.
image
  1. Será levado para a página do serviço, onde lhe será pedido que inicie sessão caso ainda não o tenha feito, e depois diretamente para a janela de autorização, onde lhe será pedido que permita ao Nightbreak aceder aos dados necessários para vincular as contas.
  2. Depois de vincular as contas, deverá ter acesso ao conteúdo adquirido através desse serviço na sua conta Nightbreak e no jogo, se o token tiver sido configurado corretamente.

Onde o token é armazenado​

O token é armazenado em:

plugins/MagmaCore/nightbreak.yml

sob a chave token, não dentro da pasta privada de cada plugin.

Isso significa:

  • não precisa de registar o token separadamente para cada plugin
  • reinstalar um plugin não perde necessariamente o token
  • eliminar a configuração partilhada do MagmaCore pode exigir que registe o token novamente

O que o token desbloqueia​

Um token vinculado é usado para:

  • verificar se a conta do servidor pode aceder a um pacote de conteúdo
  • verificar metadados de versão remota para pacotes geridos
  • descarregar conteúdo diretamente para as pastas de importação do plugin
  • detetar se os pacotes instalados estão desatualizados
  • ativar estados do menu de configuração com reconhecimento do Nightbreak

Não contorna requisitos específicos do plugin, tais como:

  • instalar um pacote de recursos
  • ativar um pacote de conteúdo no menu de configuração
  • manter as dependências instaladas

Notas de segurança​

  • Trate o token como uma credencial do servidor.
  • Não o publique em chat público, capturas de ecrã ou registos de suporte.
  • Se pensa que foi comprometido, execute /nightbreaklogout e depois revogue-o na página de conta Nightbreak e gere um novo.
  • O MagmaCore avisa se o token não começar por nbk_, mas ainda assim tenta guardá-lo.

Resolução de problemas​

"No token registered"​

O plugin ainda não deteta um token Nightbreak partilhado válido. Execute /nightbreaklogin <token> novamente e confirme que plugins/MagmaCore/nightbreak.yml agora contém um token real em vez de um valor ausente ou de marcador de posição. Se o ficheiro nem sequer existir, ou o token nunca foi registado ou alguém executou /nightbreaklogout.

"You don't have access to this content"​

O token é válido, mas a conta Nightbreak vinculada atualmente não desbloqueia esse pacote.

Um plugin funciona, outro não​

Verifique a página de configuração específica do plugin. Alguns plugins ainda precisam de:

  • um menu de configuração inicial completado
  • uma recarga após as importações
  • um passo de instalação do pacote de recursos
  • uma dependência opcional como FreeMinecraftModels ou ResourcePackManager