Como dar um kit inicial aos novos jogadores no teu servidor Paper

O que faz um kit inicial Minecraft na primeira entrada

O kit deste guia é uma espada de pedra, uma picareta de pedra e 16 pães, seguidos de uma linha privada no chat que diz ao novo jogador o que acabou de receber. É entregue automaticamente quando um jogador entra no teu servidor pela primeira vez. Não há comando para escrever nem permissão para configurar.

"Primeira vez" quer dizer aqui o que o Paper já sabe: um jogador que o servidor nunca tinha guardado antes de ele entrar. O runtime não mantém nenhuma lista própria nem contador. É por isso que o kit funciona num servidor que já tens a correr, e também é por isso que não consegue fazer algumas coisas, indicadas mais abaixo.

Esta receita usa o editor de blocos do NimBlock e o seu runtime à parte, gratuito. Uma conta NimBlock permite-te guardar a regra. Para a executar, precisas de um servidor Minecraft Java que já exista e cujo alojamento permita enviar plugins. Os passos abaixo são para o Paper 1.21.11 com Java 21. Não precisas de um servidor alojado pelo NimBlock.

Monta a regra do kit no estúdio

1. Abre os teus plugins no NimBlock e cria um novo plugin. O editor começa com uma regra de boas-vindas; podes mantê-la ou apagá-la.
2. Em Regras, arrasta uma nova regra para o plugin e dá-lhe o nome Kit inicial.
3. Em Gatilhos, coloca Um jogador entra no espaço quando.
4. Em Condições, coloca É a primeira visita do jogador no espaço se.
5. Em Ações, adiciona Dar um item ao jogador três vezes: STONE_SWORD com quantidade 1, STONE_PICKAXE com quantidade 1, BREAD com quantidade 16.
6. Adiciona Enviar uma mensagem ao jogador no fim, por exemplo Bem-vindo, {player}! Aqui tens um kit inicial para começares. Mantém {player} exatamente como está escrito: o runtime substitui-o pelo nome do jogador.
7. Guarda o plugin. Na página dele, copia o JSON completo que aparece para um ficheiro de texto simples chamado starter-kit.json, guardado em UTF-8.

Os itens escrevem-se com o nome Minecraft, como IRON_AXE ou COOKED_BEEF. Troca os três itens pelo teu próprio kit: uma ação por item, cada uma com a sua quantidade. A gramática pública lista todos os gatilhos, condições e ações disponíveis.

Instala-o no teu servidor Paper

1. Descarrega o runtime do NimBlock. Desliga o servidor, coloca o .jar do runtime diretamente em plugins/ e depois inicia o servidor.
2. Confirma que o NimBlock está ativo com /plugins. O guia de instalação de plugins do Paper explica como diagnosticar um carregamento que falhou.
3. Envia starter-kit.json para plugins/NimBlock/specs/. Mantém as maiúsculas do nome da pasta. Se for preciso, cria a pasta primeiro.
4. Como operador do servidor, executa /nimblock reload e depois /nimblock list. O nome do plugin que guardaste deve aparecer. Na consola do servidor, não escrevas a barra inicial.

Corrige qualquer erro indicado durante o recarregamento antes de testar. Um nome de item desconhecido só é detetado quando a regra é executada, por isso confirma a ortografia de cada item antes do primeiro teste.

Testa com uma conta que nunca entrou

A tua própria conta já jogou no teu servidor, por isso não vai receber o kit, e é a regra a funcionar. Testa com uma conta Minecraft Java que nunca tenha entrado neste servidor, por exemplo a de um amigo, ou numa cópia do teu servidor com um mundo novo. Nessa primeira entrada, a conta deve receber a espada, a picareta, o pão e a mensagem. Desliga-te, espera um pouco e volta a ligar-te: não deve ser dado mais nada.

Os jogadores que entraram antes de instalares a regra não são novos e não vão receber o kit. Carregar a regra não repete as entradas anteriores.

Os limites de um kit na primeira entrada

• Uma vez por jogador, enquanto o servidor se lembrar dele: a condição lê os dados de jogador do próprio Paper. Se começares um mundo novo, todos voltam a ser novos jogadores e recebem o kit outra vez. Se apagares os dados de um jogador, só esse jogador volta a ser novo e recebe o kit outra vez.
• Verdadeira durante toda a primeira sessão: a condição é verdadeira não só no momento em que o novo jogador entra, mas até ele se desligar, mesmo que o servidor o guarde entretanto. Mantém-na em Um jogador entra; noutro gatilho, como renascer, um novo jogador podia receber o kit uma segunda vez durante essa primeira sessão.
• Sem kit diário, sem tempo de espera, sem contador: o runtime reage a eventos e não se lembra de nada, por isso não consegue dar um kit "uma vez por dia" ou "três vezes por jogador".
• Itens simples: a ação dá um tipo de item e uma quantidade. Encantamentos e nomes personalizados não fazem parte dela.
• Inventário cheio: o que não couber cai no chão aos pés do jogador. O inventário de um novo jogador está normalmente vazio, por isso isto raramente importa.

Mudar o kit sem reinstalar o runtime

Edita a regra no estúdio e guarda uma nova versão. Substitui o conteúdo do mesmo ficheiro starter-kit.json pelo JSON acabado de guardar e depois executa /nimblock reload. O próximo novo jogador recebe o novo kit; os jogadores que já receberam o antigo não recebem mais nada. Se mantiveres o ficheiro antigo e o novo, as duas regras são carregadas e são entregues dois kits.

Podes usar o runtime no teu próprio servidor Paper compatível sem comprar o alojamento NimBlock. A tua regra continua a ser um ficheiro JSON legível que podes consultar e guardar com a cópia de segurança do teu servidor.