O EssentialsX é o plugin do dia a dia para servidores Paper e Spigot: Homes, Warps, um ponto de Spawn, pedidos de teleporte entre jogadores, Kits e uma saudação ao entrar. Quase todos os servidores de sobrevivência o usam, porque reúne os comandos que os jogadores esperam como algo básico. Este guia configura as funções principais e mostra quais permissões deves atribuir para isso. As capturas de ecrã vêm de um servidor de teste com Paper 1.21.4 e EssentialsX 2.21.0.

Instalação e primeira entrada

No painel encontras o EssentialsX em Plugins → Browser. Basta o módulo principal EssentialsX; módulos adicionais como EssentialsX Chat ou EssentialsX Spawn só devem ser instalados se precisares das suas funções. Depois de reiniciar, o EssentialsX cumprimenta cada jogador com uma mensagem de boas-vindas, o número de jogadores online e o tempo de jogo.

Mensagem de entrada do EssentialsX com aviso sobre uma versão mais recente
Mensagem de entrada do EssentialsX com aviso sobre uma versão mais recente

O aviso vermelho na imagem é a verificação de atualizações integrada: ela avisa operadores quando existe uma versão mais recente. A atualização é feita pelo navegador de plugins no painel, não pelo link. Quem não quiser a mensagem deve definir em plugins/Essentials/config.yml o valor update-check: false.

Spawn, Homes e Warps

Os três comandos que os jogadores usam com mais frequência:

/setspawn
/sethome
/home
/setwarp mercado
/warp mercado

/setspawn define o ponto onde novos jogadores aparecem e para onde /spawn os leva. /sethome guarda a posição atual como Home do jogador; /home leva-o de volta. Warps são pontos públicos que um administrador cria com /setwarp e que qualquer pessoa alcança com /warp.

Regresso por /home à aldeia: o jogador está novamente em frente à sua casa
Regresso por /home à aldeia: o jogador está novamente em frente à sua casa

Controlas vários Homes por jogador através de permissões: quem tiver essentials.sethome.multiple.vip recebe tantos Homes quantos estiverem definidos em config.yml, em sethome-multiple, para vip. Sem esses nós, fica limitado a um Home.

Permissões para o grupo padrão

Sem plugin de permissões, o EssentialsX dá à maioria dos comandos acesso para todos os jogadores. Assim que o LuckPerms estiver ativo, só vale o que permitires. Um conjunto sensato para o grupo default:

/lp group default permission set essentials.spawn true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.home true
/lp group default permission set essentials.warp true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.back true

/tpa envia um pedido de teleporte, /tpaccept aceita-o; /back leva o jogador de volta ao ponto da morte depois de morrer. Comandos como /gamemode, /give, /kick e /ban ficam reservados ao grupo de moderação. Como criar grupos está explicado em LuckPerms: configurar permissões.

Kits e saudação

Um Kit inicial dá ferramentas aos novos jogadores. Os Kits ficam em plugins/Essentials/config.yml, em kits; uma entrada define os itens e um tempo de recarga em segundos. O comando /kit starter precisa da permissão essentials.kits.starter. A saudação e a mensagem do dia ficam no mesmo ficheiro, em newbies e motd; defines cores com códigos &. Depois de alterações na configuração, /essentials reload carrega-as sem reiniciar.

Onde ficam os dados dos jogadores

O EssentialsX não guarda nada na pasta do mundo, mas sim no seu próprio diretório de plugin. Isto é importante se trocares um mundo ou mudares para outro servidor:

  • plugins/Essentials/userdata/ — um ficheiro por jogador com Homes, última posição, tempo de jogo e nicknames, nomeado pela sua UUID.
  • plugins/Essentials/warps/ — um ficheiro próprio por cada Warp.
  • plugins/Essentials/config.yml — Kits, saudação, atraso de teleporte e todas as restantes definições.

Um mundo novo deixa Homes e Warps intactos — mas as suas coordenadas depois apontam para o vazio e têm de ser definidas novamente. Ao migrar o servidor, leva contigo a pasta inteira plugins/Essentials/; assim, Homes e Warps são mantidos.

Erros típicos

  • /home sem efeito. O jogador não definiu um Home ou falta a permissão essentials.home.
  • O teleporte é cancelado. A definição teleport-delay espera alguns segundos e cancela ao haver movimento. Reduz o valor em config.yml ou atribui a permissão essentials.teleport.timer.bypass.
  • Warps desapareceram. Os Warps ficam como ficheiros em plugins/Essentials/warps/. O backup do painel guarda-os; uma nova pasta de mundo não muda isso.
  • Comandos duplicados. Outros plugins fornecem os seus próprios comandos /spawn ou /home. Em config.yml, em overridden-commands, defines qual plugin vence.

FAQ

Preciso de todos os módulos do EssentialsX?

Não. O módulo principal EssentialsX traz Homes, Warps, teleporte e Kits. Só instalas módulos adicionais para a sua função concreta: EssentialsX Chat para prefixos no chat, EssentialsX Spawn para regras de Spawn separadas na primeira entrada e depois da morte.

Porque é que os comandos deixam de funcionar depois de instalar o LuckPerms?

Sem plugin de permissões, o EssentialsX deixa a maioria dos comandos livre. Assim que o LuckPerms estiver ativo, só conta o que estiver expressamente permitido. Define os nós para o grupo default de forma limpa uma vez — depois disso, o comportamento fica previsível e decides quem pode usar /tpa ou /back.

Como é que um jogador recebe vários Homes?

Através de dois pontos ligados: em config.yml, defines em sethome-multiple quantos Homes um escalão permite, e no LuckPerms atribuis o nó correspondente, por exemplo essentials.sethome.multiple.vip. Sem esse nó, fica limitado a um Home por jogador.

Tenho de reiniciar depois de alterar a config.yml?

Para a maioria dos valores, /essentials reload chega, por exemplo em Kits, saudação ou atraso de teleporte. Um módulo adicional acabado de instalar e alterações que afetem outros plugins precisam de um reinício completo do servidor.

Homes e Warps estão incluídos no backup do painel?

Sim, o backup guarda todo o diretório do servidor e, por isso, também plugins/Essentials/. Trocar o mundo não apaga Homes nem Warps — mas as coordenadas deles deixam de corresponder ao terreno e têm de ser definidas novamente.

Guias avançados

Áreas que os jogadores não podem alterar são protegidas com WorldGuard: proteger regiões. Se o servidor estiver com lag apesar de ter poucos jogadores, spark: analisar lag ajuda.

Fontes

EssentialsX: ver exemplo

Gravações próprias de um ambiente de demonstração. A versão e a configuração mostradas podem diferir do teu servidor.

O ponto home atelier foi guardado.
O ponto home atelier foi guardado.

2.21.0