Como a LADTech aloja o Minecraft com o Crafty e o Playit.gg no ZimaBoard 2

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Obrigado à LADTech por mostrar como configurar um servidor de Minecraft, desde a instalação até entrar no mundo. A configuração demonstrada utiliza o ZimaOS para instalar o Crafty Controller, cria um servidor de Minecraft Java baseado no Paper, testa-o na rede local e, em seguida, utiliza o Playit.gg para disponibilizar um endereço a que os amigos podem aceder. O Crafty gere o processo do jogo; o Playit fornece a ligação externa.

O vídeo utiliza um ZimaBoard 2 de 16 GB e também aborda a utilização de um computador compatível já existente. Este artigo segue a sequência do criador e acrescenta verificações que facilitam a manutenção: margem de memória, armazenamento persistente, uma lista de permissões, um destino de túnel acessível e uma cópia de segurança testada. Veja o guia original da LADTech sobre Minecraft antes de seguir os passos com os seus próprios endereços e versões.

Conheça as quatro partes desta configuração de Minecraft

Esta configuração combina hardware, uma aplicação de gestão, o próprio servidor de Minecraft e um túnel de rede. Manter estas funções separadas torna a resolução de problemas muito mais simples. Uma página de gestão funcional não prova que o servidor de jogo esteja pronto, e um túnel ligado não consegue resolver um servidor que ainda não terminou de arrancar.

Componente A sua função Uma verificação útil do sucesso
ZimaBoard 2 e ZimaOS Forneça o anfitrião, o armazenamento e o ambiente de aplicações. O anfitrião continua acessível e dispõe de recursos para a carga de trabalho combinada.
Crafty Controller Cria e gere o servidor de jogo, a consola, os ficheiros e as tarefas de cópia de segurança. Pode iniciar sessão e verificar a instância correta do servidor.
Servidor de Minecraft Paper Executa o mundo e aceita jogadores da Java Edition. Um cliente compatível entra no mundo pretendido através da LAN.
Agente e túnel do Playit Encaminhe um endereço de jogo externo para o ponto de acesso do servidor. Um jogador autorizado pode entrar através de outra ligação.

Para uma decisão mais abrangente sobre o hardware, a comparação de JBlanked entre o ZimaBoard 2 e o Raspberry Pi 5 aborda o papel da compatibilidade das aplicações e das ligações de armazenamento. Aqui, o objetivo é mais específico: manter um mundo de Minecraft disponível para as pessoas que devem poder jogar.

Prepare um anfitrião estável e armazenamento persistente

A LADTech começa por ligar o anfitrião à alimentação e à Ethernet e, em seguida, usa outro computador na mesma rede para aceder ao ZimaOS. A Ethernet proporciona ao anfitrião uma ligação com fios simples à rede. As especificações do ZimaBoard 2 distinguem as configurações de 8 GB/32 GB e 16 GB/64 GB; o vídeo utiliza a última.

Registe o endereço LAN do anfitrião e mantenha-o estável através de uma reserva DHCP ou configuração estática adequada. O endereço privado do criador é apenas um exemplo; não o copie. Um endereço estável é importante, porque uma entrada Minecraft guardada ou o destino de um túnel podem deixar de funcionar se o anfitrião receber uma concessão diferente.

Antes de criar um mundo, identifique onde o Crafty armazena a configuração, os servidores de jogo e as cópias de segurança. Os ficheiros do mundo aumentam à medida que os jogadores exploram, enquanto os registos e as cópias de segurança guardadas ocupam espaço adicional. Mantenha espaço livre suficiente para a próxima cópia de segurança, além do espaço ocupado pelo mundo em execução. Se mais tarde mover os dados para outra unidade, confirme o mapeamento persistente efetivo em vez de presumir que o novo disco será utilizado automaticamente.

O mesmo princípio aplica-se a um PC existente: tem de estar disponível quando os amigos quiserem jogar e o armazenamento deve continuar ligado após um reinício. O tutorial apresenta um modelo de alojamento de serviços, não garante que todos os computadores antigos suportem a mesma instalação de SO ou versão da aplicação. Verifique a compatibilidade antes de substituir uma instalação funcional.

Instale o Crafty e proteja a conta de administração

O criador abre a loja de aplicações do ZimaOS, procura o Crafty, instala-o e abre o respetivo painel. Nessa instalação, as credenciais iniciais são obtidas num ficheiro gerado nos dados de configuração da aplicação. Utilize as credenciais criadas pela sua própria instalação e siga as instruções atuais; não utilize uma palavra-passe apresentada no vídeo de outra pessoa.

A LADTech abre o painel do ZimaOS antes de instalar o Crafty Controller
A LADTech começa no painel do ZimaOS e utiliza a loja de aplicações para instalar o Crafty. Mantenha o acesso de gestão separado do endereço do jogo que irá partilhar mais tarde com os jogadores. Imagem do vídeo aos 3:10, cortesia da LADTech.

Depois de iniciar sessão, altere a palavra-passe inicial e mantenha a interface de administração num canal de gestão de confiança. Um jogador de Minecraft não precisa de acesso à conta Crafty, aos ficheiros do servidor ou à consola. Estas são funcionalidades de gestão, distintas da ligação ao jogo que irá partilhar mais tarde.

A referência de instalação do Docker do Crafty distingue o acesso ao painel das portas do jogo e dos diretórios persistentes. Se um modelo de aplicação fornecer esses dados, verifique-os antes de editar seja o que for. O painel pode estar acessível, enquanto a porta de jogo selecionada não está publicada ou não pode ser alcançada.

Mantenha um registo de configuração breve: o endereço de confiança do painel, a localização dos dados persistentes, o nome do servidor de jogo, a porta do jogo e o destino das cópias de segurança. Isto é especialmente útil se experimentar várias instâncias. Conseguir iniciar sessão no Crafty indica que o gestor está a funcionar; o passo seguinte é criar e testar o servidor de jogo correto.

Crie um servidor Paper e deixe memória disponível para o anfitrião

A LADTech seleciona Minecraft Java, escolhe um servidor Minecraft normal em vez de um proxy e utiliza Paper. A versão do jogo selecionada tem de corresponder aos clientes e plugins que pretende utilizar. Considere a versão apresentada na gravação como uma escolha válida naquele momento, não como uma instrução permanente para instalar exatamente essa versão.

Formulário de criação de servidor do Crafty Controller no tutorial de Minecraft da LADTech
O formulário do servidor combina as escolhas de edição, versão e memória. O criador utiliza uma alocação de 8 GB num anfitrião com 16 GB; dimensione a carga de trabalho e deixe margem para o sistema. Imagem do vídeo aos 7:00, cortesia da LADTech.

No vídeo, são alocados 8 GB ao servidor demonstrado num anfitrião com 16 GB, e são discutidas alocações menores para mundos mais simples. Estes são exemplos do criador, não requisitos garantidos para qualquer número de jogadores. A alocação de memória Java é apenas uma parte do consumo total de memória: o sistema operativo, o Crafty, o agente de túnel, outras aplicações e a memória fora do heap Java também precisam de espaço.

Decisão de planeamento O que o vídeo demonstra O que verificar na sua implementação
Edição e tipo de servidor Minecraft Java a executar Paper. Edição do cliente, versão exata do servidor e compatibilidade com os plugins pretendidos.
Alocação de memória Uma alocação de 8 GB num anfitrião com 16 GB. Memória disponível no anfitrião durante o jogo e as atividades em segundo plano.
Capacidade do mundo Um pequeno mundo de teste com um jogador ligado. Exploração, distância de simulação, plugins e jogadores em simultâneo.
Endpoint do servidor Um endereço da LAN que utiliza a porta do jogo. O endereço e a porta a que os clientes e o agente de túnel conseguem realmente aceder.

O guia de criação de servidores Minecraft da Crafty aborda a seleção da edição, a preparação do servidor e as definições de memória e de portas. No primeiro arranque, o servidor apresenta o EULA do Minecraft. Leia-o e aceite-o se concordar; depois, aguarde pela conclusão do arranque e verifique se há erros na consola antes de tentar estabelecer ligação.

Comece com uma instância funcional. Adicionar outro servidor implica mais um limite de memória, diretório de dados e endpoint para acompanhar. Definir um número máximo de jogadores mais elevado num ficheiro de configuração não significa que o hardware consiga suportar esse número de jogadores ativos com a carga de trabalho escolhida.

Comprove a ligação local antes de criar um túnel

O primeiro teste usa o endereço LAN do anfitrião e a porta do jogo na janela «Adicionar servidor» do Minecraft. Numa configuração Java típica, a porta habitual é 25565, mas o valor de que precisa é o que está configurado e acessível na sua própria instalação. Escreva o endpoint como YOUR_SERVER_LAN_IP:YOUR_GAME_PORT.

Use um cliente com a edição e a versão corretas e, em seguida, verifique tanto o jogo como a consola do Crafty. Ver o jogador entrar no mundo pretendido é uma prova mais sólida do que o servidor aparecer simplesmente numa lista. Faça uma pequena alteração reconhecível, saia e volte a ligar-se para se certificar de que está a testar a mesma instância.

O vídeo desativa a lista de permissões para ultrapassar uma rejeição de entrada. Num servidor apenas para amigos, mantenha a lista de permissões ativada e adicione os jogadores pretendidos. Na consola do servidor, comandos como whitelist on e whitelist add PLAYER_NAME exprimem essa intenção. A referência das propriedades do servidor do Paper explica a definição da lista de permissões. Mantenha a autenticação normal dos jogadores, a menos que uma configuração de proxy concebida separadamente exija outra configuração.

Se o teste local falhar, verifique pela seguinte ordem

  1. Confirme que o servidor de jogo pretendido concluiu o arranque.
  2. Verifique o endereço do anfitrião, a porta do servidor e qualquer mapeamento de portas do contentor.
  3. Verifique se o cliente e o servidor usam versões de jogo compatíveis.
  4. Verifique na consola se há erros de lista de permissões, autenticação ou plugins.
  5. Ligue-se com sucesso através da LAN antes de alterar a ligação remota.

Esta sequência evita introduzir um túnel enquanto o serviço de jogo subjacente ainda não está a funcionar. Também cria um endpoint local fiável com o qual poderá comparar mais tarde. Se o jogo remoto falhar, mas este teste local continuar a funcionar, já reduziu o âmbito da investigação.

Ligar o Playit.gg ao endpoint do jogo

Em seguida, a LADTech instala o agente Playit a partir da loja de aplicações ZimaOS, abre os respetivos registos e segue a ligação de ativação da instalação para associar o agente a uma conta. Siga a ligação gerada para o seu próprio agente. A ligação de ativação e as credenciais da conta são informações de configuração, não o endereço do jogo a enviar aos amigos.

O criador cria um túnel para Minecraft Java e aponta-o para o endpoint de jogo acessível do anfitrião. Esta é a distinção importante: o destino local é para onde o agente envia o tráfego, enquanto o endereço público atribuído é onde os jogadores se ligam. Os dois endereços têm funções diferentes e não devem ser trocados.

A LADTech seleciona Minecraft Java como tipo de túnel do Playit
Na configuração do Playit, selecione primeiro o tipo de túnel do jogo e, em seguida, indique o servidor local como destino. O endereço público para os jogadores e o endpoint local acessível pelo agente têm funções diferentes. Fotograma do vídeo aos 12:20, cortesia da LADTech.

Se o agente e o servidor do jogo forem executados em contentores separados, é particularmente fácil interpretar mal o loopback. Um endereço como 127.0.0.1 refere-se ao próprio contexto de rede do agente; não corresponde automaticamente ao contentor do Minecraft nem ao anfitrião. Utilize um endpoint acessível a partir da rede efetivamente utilizada pelo agente. No vídeo, o endereço da LAN do anfitrião e a porta do jogo fornecem esse destino.

A descrição geral do serviço Playit explica uma ligação através de relay que permite aos jogadores entrar sem configurar uma regra de encaminhamento de portas no router. Ainda assim, torna o serviço de jogo selecionado acessível através de uma rede de terceiros. Controle o acesso dos jogadores e partilhe o endpoint do jogo, não o painel do Crafty, os registos da aplicação ou a ligação para reivindicar o agente.

Teste o endereço atribuído e, em seguida, peça a um amigo autorizado, ligado a outra ligação à Internet, que entre. O facto de o anfitrião conseguir aceder ao próprio endereço público é útil, mas um cliente externo verifica o percurso que pretende realmente disponibilizar. Confirme a entrada na consola do servidor e verifique se aparece o mesmo mundo.

Não prometa que um relay elimina a latência. A LADTech regista um ping superior na ligação através do relay do que na ligação local; esses resultados dependem da localização e da rota utilizadas. A sua ligação de carregamento, a rota selecionada, a localização do relay e a rede do jogador podem ser diferentes. Os guias de apoio do Playit fornecem informações atualizadas sobre a configuração e a resolução de problemas de ligação.

Distinga o atraso da rede do desempenho do servidor

Depois de entrar, o criador verifica o TPS e demonstra comandos do jogo. Uma leitura de TPS próxima do valor normal do servidor durante um teste pequeno é um ponto de partida útil. Não demonstra o desempenho num mundo movimentado com vários jogadores a gerar chunks ou a executar plugins pesados.

O que observa Investigue primeiro Comparação útil
A LAN funciona, o endereço público não Estado do agente, destino do túnel, edição e porta. O endpoint da LAN que se sabe funcionar, em comparação com o destino configurado do túnel.
«Anfitrião desconhecido» O hostname público copiado e a respetiva resolução DNS. A resolução de problemas do hostname de Java do Playit.
Atraso remoto enquanto o jogo local continua a responder bem Percurso de rede e qualidade da ligação. Clientes locais e remotos a jogar no mesmo mundo.
O jogo fica lento tanto localmente como remotamente Carga de trabalho do servidor, registos, CPU, atividade de armazenamento e pressão sobre a memória. A mesma atividade antes e depois de uma alteração na carga de trabalho.
Os problemas começam após uma alteração de plugin A compatibilidade dos plugins e o registo de arranque. Uma instância de teste com cópia de segurança, sem essa alteração.

Altere uma variável de cada vez. Reduzir a carga de trabalho ou corrigir um problema com um plugin pode ajudar a resolver atrasos do lado do servidor; adicionar memória heap não vai corrigir um percurso de rede longo. Conceda privilégios de operador apenas a quem deles precisar, uma vez que os comandos administrativos da consola e do jogo podem alterar o mundo ou o acesso de outros jogadores.

O guia de instalação de plugins do Paper também distingue os plugins dos ficheiros de mods. Os plugins do Paper e os mods são opções de implementação diferentes. Muitos plugins do Paper funcionam no servidor sem uma instalação correspondente no cliente, mas algumas funcionalidades requerem suporte adicional do cliente. Os mods podem ser do lado do servidor, do lado do cliente ou necessários em ambos. Não parta do princípio de que todos os mods podem substituir diretamente um plugin do Paper.

Agende cópias de segurança e verifique um mundo restaurado

O vídeo termina a configuração prática com a criação de uma tarefa de cópia de segurança diária no Crafty. Agendar uma tarefa é o primeiro passo para proteger o servidor. Verifique o destino da cópia de segurança, o número de cópias retidas, os diretórios incluídos e o último resultado bem-sucedido. Um mundo, a configuração do servidor e os dados dos plugins podem ser importantes para uma recuperação eficaz.

Formulário de agendamento de cópias de segurança do Crafty na demonstração de um servidor de Minecraft da LADTech
Uma cópia de segurança agendada faz parte da configuração demonstrada. Verifique o destino, a retenção, o resultado da tarefa e uma cópia independente do mundo restaurada. Imagem do vídeo aos 15:00, cortesia de LADTech.

A documentação do gestor de cópias de segurança do Crafty abrange as configurações das cópias de segurança, as cópias retidas, as localizações de armazenamento e as opções de restauro. Use o agendador de tarefas com a frequência adequada ao seu mundo. Mantenha uma cópia independente, separada do armazenamento onde se encontra o servidor ativo.

  1. Crie uma cópia de segurança depois de uma alteração conhecida no mundo.
  2. Confirme que a tarefa foi concluída e que os ficheiros esperados existem.
  3. Restaure para uma instância de teste separada ou uma localização de teste isolada.
  4. Use versões compatíveis do servidor e do plugin e, em seguida, verifique a alteração identificável.
  5. Documente os passos antes que seja necessário recorrer a eles durante um incidente real.

Crie uma cópia recuperável antes de atualizar o Paper ou adicionar um plug-in. Restaurá-la diretamente sobre o servidor ativo pode substituir progresso mais recente, por isso, primeiro confirme o que faz a opção de restauro escolhida. O objetivo é ter um mundo que possa recuperar, não apenas um agendamento que aparece no painel de controlo.

Por fim, planeie um reinício controlado do anfitrião. Confirme que o Crafty, a instância de jogo pretendida e o agente Playit voltam a funcionar da forma configurada. Repita uma ligação local e outra externa. É possível executar outros serviços no mesmo anfitrião, mas a respetiva manutenção e utilização de recursos também passam a fazer parte da disponibilidade do servidor Minecraft.

Perguntas frequentes

Todos os jogadores têm de instalar o Playit?

No padrão demonstrado, o anfitrião executa o agente e os amigos usam o endereço atribuído num cliente Minecraft compatível. Não precisam de aceder às aplicações de gestão do anfitrião.

Os jogadores de Bedrock podem entrar automaticamente neste servidor Java?

Não. O servidor demonstrado é para a Edição Java. Um servidor compatível com Bedrock ou uma ponte configurada deliberadamente exige uma configuração separada; escolha o servidor e o tipo de túnel adequados.

São necessários 8 GB de memória atribuída para todos os mundos?

Não. É o exemplo do criador num anfitrião com 16 GB. Dimensione a carga de trabalho real e reserve recursos para o sistema operativo e os outros serviços.

Porque é que o Crafty abre, mas o Minecraft não consegue estabelecer ligação?

O painel e o servidor de jogo usam pontos finais diferentes. Verifique o arranque do jogo, a porta de jogo selecionada, os mapeamentos dos contentores, a versão do cliente e a política de acesso do servidor.

Devo desativar a lista de permissões para resolver uma ligação rejeitada?

Para um mundo apenas para amigos, adicione os jogadores pretendidos e mantenha a lista de permissões. Consulte o motivo da rejeição na consola em vez de abrir o mundo a todos os jogadores.

É suficiente ter uma cópia de segurança na mesma unidade?

Pode ajudar a recuperar algumas alterações acidentais, mas partilha o risco de falha de armazenamento do mundo ativo. Mantenha uma cópia independente e confirme que funciona restaurando-a numa instância de teste.

Conclusão

A configuração da LADTech deixa clara a sequência: preparar o anfitrião, criar uma instância do Minecraft fácil de gerir, confirmar uma ligação local e só depois adicionar a ligação remota. O Crafty gere o ciclo de vida do servidor, o Paper executa o mundo e o Playit fornece uma rota pública para o ponto final de jogo escolhido.

Conclua a mesma sequência com os seus próprios endereços, versões compatíveis, acesso controlado dos jogadores e uma cópia de segurança testada. Assim, a primeira ligação bem-sucedida transforma-se num serviço em que os seus amigos podem confiar. Regresse ao vídeo completo da LADTech para ver a demonstração original e consulte a documentação atual da aplicação se a interface da sua instalação for diferente.

Centro de campanhas Zima

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.