Essentials

Este é um fork do Essentials chamado EssentialsX.

Se você estiver usando isso, NÃO peça suporte ao Essentials.

O repositório upstream oficial do projeto Essentials original está em https://github.com/Essentials/Essentials.

Por que usar o EssentialsX?

EssentialsX é uma continuação do conjunto de plug-ins Essentials, atualizado para oferecer suporte às versões modernas do Minecraft e Spigot.

Ele fornece inúmeros novos recursos, melhorias de desempenho e correções que não estão disponíveis no Essentials original ou no Spigot-Essentials. Para mais detalhes, consulte o wiki.

Se você vier do plug-in Essentials original, o EssentialsX é um substituto imediato para o Essentials. No entanto, tem alguns novos requisitos:

• EssentialsX requer CraftBukkit, Spigot ou Paper para funcionar. Outros softwares de servidor podem funcionar, mas não são testados pela equipe e talvez não possamos ajudar com quaisquer problemas que ocorrerem.
• EssentialsX atualmente oferece suporte às versões 1.8.8, 1.9.4, 1.10.2, 1.11.2, 1.12.2, 1.13.2, 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.2, 1.19 do Minecraft .4, 1.20.6 e 1.21.4.
• EssentialsX atualmente requer Java 8 ou superior. Recomendamos usar a versão Java mais recente compatível com o software do seu servidor.
• EssentialsX requer que o Vault habilite o uso de prefixos/sufixos de bate-papo e suporte de grupo de plug-ins de permissões compatíveis.
  • Recomendamos o uso de LuckPerms para permissões e grupos.
  • Se você tiver um plugin de permissões não suportado, mas ainda quiser usar curingas, habilite use-bukkit-permissions na configuração. Caso contrário, o plug-in retornará às permissões baseadas em configuração.

Apoiar

Precisa de ajuda para usar o EssentialsX? Junte-se à comunidade MOSS Discord para pedir ajuda e discutir EssentialsX.

Se precisar relatar um bug ou sugerir um novo recurso, você pode abrir um problema no GitHub.

Prédio

Para construir o EssentialsX, você precisa do JDK 8 ou superior instalado em seu sistema.

Clone este repositório e execute o seguinte comando:

• No Linux ou macOS: ./gradlew build
• No Windows: gradlew build

Você pode então encontrar compilações de módulos EssentialsX no diretório jars/ .

Executando um servidor de teste

Você também pode executar um servidor de teste no seu ambiente de desenvolvimento usando o seguinte comando:

• No Linux ou macOS: ./gradlew build :runServer
• No Windows: gradlew build :runServer

Observe o : - sem ele, você executará vários servidores ao mesmo tempo, o que provavelmente travará o Gradle.

Usando EssentialsX em seu plugin

Deseja integrar com EssentialsX em seu plugin? Você pode construir seu plugin com base na API EssentialsX , disponível no repositório EssentialsX Maven.

As versões são hospedadas no repositório Maven em https://repo.essentialsx.net/releases/ , enquanto os snapshots (incluindo compilações de desenvolvimento) são hospedados em https://repo.essentialsx.net/snapshots/ .

Para adicionar EssentialsX ao seu sistema de compilação, você deve usar os seguintes artefatos:

Tipo	ID do grupo	ID do artefato	Versão
Último lançamento	net.essentialsx	EssentialsX	2.20.1
Instantâneos	net.essentialsx	EssentialsX	2.21.0-SNAPSHOT
Versões mais antigas	net.ess3	EssentialsX	2.18.2

Nota: até a versão 2.18.2 , o EssentialsX usava o ID do grupo net.ess3 .
A partir da 2.19.0 , o EssentialsX usa o ID do grupo net.essentialsx .
Ao atualizar seu plugin, certifique-se de usar o ID de grupo correto.

Você pode encontrar mais informações, incluindo exemplos de Maven e Gradle, no wiki.

Apoie o projeto EssentialsX

Quer ajudar a melhorar o EssentialsX? Existem várias maneiras de apoiar e contribuir com o projeto.

Doe para EssentialsX

As doações nos permitem cobrir os custos de nossa infraestrutura e também nos permitem continuar atualizando o EssentialsX com novos recursos e para novas versões do Minecraft.

Você pode nos apoiar com uma doação única ou mensal por meio dos patrocinadores do GitHub e receberá um selo no GitHub por apoiar o projeto.

Alternativamente, você também pode doar mensalmente para o projeto EssentialsX no Patreon ou pode fazer uma doação única em nossa página Ko-fi.

Se você não puder fazer uma doação, não se preocupe! Existem muitas outras maneiras de contribuir:

Contribuindo diretamente para EssentialsX

• Você é um desenvolvedor? Ficamos sempre felizes em receber correções de bugs e acréscimos de recursos como solicitações pull.
• Você fala vários idiomas? Nesse caso, sempre receberemos contribuições para as traduções da nossa comunidade. Projeto Crowdin.

Consulte CONTRIBUTING.md para saber mais.

Fornecendo suporte a outros usuários

• Você administra um servidor? Dê uma olhada em nossos problemas de “procura-se ajuda” e “bug: não confirmado”, onde você pode encontrar problemas que precisam de testes e investigação adicionais.
• Você quer ajudar outras pessoas a configurar o EssentialsX? Você pode contribuir com os documentos do EssentialsX. Você também pode ingressar na comunidade MOSS Discord e fornecer suporte comunitário direto a outros usuários do EssentialsX.