Essentials

Il s'agit d'un fork d'Essentials appelé EssentialsX.

Si vous l'utilisez, ne demandez PAS d'assistance à Essentials.

Le référentiel officiel en amont du projet Essentials original se trouve sur https://github.com/Essentials/Essentials.

Pourquoi utiliser EssentialsX ?

EssentialsX est une continuation de la suite de plugins Essentials, mise à jour pour prendre en charge les versions modernes de Minecraft et Spigot.

Il fournit d'innombrables nouvelles fonctionnalités, améliorations de performances et correctifs qui ne sont pas disponibles dans la version originale Essentials ou Spigot-Essentials. Pour plus de détails, consultez le wiki.

Si vous venez du plugin Essentials d'origine, EssentialsX est un remplacement instantané d'Essentials. Il comporte cependant de nouvelles exigences :

• EssentialsX nécessite CraftBukkit, Spigot ou Paper pour fonctionner. D'autres logiciels serveur peuvent fonctionner, mais ils ne sont pas testés par l'équipe et nous ne serons peut-être pas en mesure de vous aider en cas de problème.
• EssentialsX prend actuellement en charge les versions 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. .4, 1.20.6 et 1.21.4.
• EssentialsX nécessite actuellement Java 8 ou supérieur. Nous vous recommandons d'utiliser la dernière version de Java prise en charge par votre logiciel serveur.
• EssentialsX nécessite que Vault active l'utilisation des préfixes/suffixes de chat et la prise en charge de groupe à partir des plugins d'autorisations pris en charge.
  • Nous vous recommandons d'utiliser LuckPerms pour les autorisations et les groupes.
  • Si vous disposez d'un plugin d'autorisations non pris en charge mais que vous souhaitez quand même utiliser des caractères génériques, activez use-bukkit-permissions dans la configuration. Sinon, le plugin reviendra aux autorisations basées sur la configuration.

Soutien

Besoin d'aide pour utiliser EssentialsX ? Rejoignez la communauté MOSS Discord pour demander de l'aide et discuter d'EssentialsX.

Si vous devez signaler un bug ou suggérer une nouvelle fonctionnalité, vous pouvez ouvrir un ticket sur GitHub.

Bâtiment

Pour créer EssentialsX, vous devez installer JDK 8 ou supérieur sur votre système.

Clonez ce dépôt, puis exécutez la commande suivante :

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

Vous pouvez ensuite trouver les versions des modules EssentialsX dans le répertoire jars/ .

Exécuter un serveur de test

Vous pouvez également exécuter un serveur de test depuis votre environnement de développement à l'aide de la commande suivante :

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

Notez les : - sans cela, vous exécuterez plusieurs serveurs à la fois, ce qui fera probablement planter Gradle.

Utiliser EssentialsX dans votre plugin

Voulez-vous intégrer EssentialsX dans votre plugin ? Vous pouvez créer votre plugin avec l' API EssentialsX , disponible à partir du dépôt EssentialsX Maven.

Les versions sont hébergées sur le dépôt Maven à l' https://repo.essentialsx.net/releases/ , tandis que les instantanés (y compris les versions de développement) sont hébergés sur https://repo.essentialsx.net/snapshots/ .

Pour ajouter EssentialsX à votre système de build, vous devez utiliser les artefacts suivants :

Taper	Identifiant du groupe	ID d'artefact	Version
Dernière version	net.essentialsx	EssentialsX	2.20.1
Instantanés	net.essentialsx	EssentialsX	2.21.0-SNAPSHOT
Versions plus anciennes	net.ess3	EssentialsX	2.18.2

Remarque : jusqu'à la version 2.18.2 , EssentialsX utilisait l'ID de groupe net.ess3 .
À partir de 2.19.0 , EssentialsX utilise l'ID de groupe net.essentialsx .
Lors de la mise à jour de votre plugin, assurez-vous d'utiliser le bon identifiant de groupe.

Vous pouvez trouver plus d'informations, y compris des exemples Maven et Gradle, sur le wiki.

Soutenez le projet EssentialsX

Vous souhaitez contribuer à l’amélioration d’EssentialsX ? Il existe plusieurs façons de soutenir et de contribuer au projet.

Faire un don à EssentialsX

Les dons nous permettent de couvrir les coûts de notre infrastructure, et nous permettent également de continuer à mettre à jour EssentialsX avec de nouvelles fonctionnalités et pour de nouvelles versions de Minecraft.

Vous pouvez nous soutenir avec un don unique ou mensuel via les sponsors GitHub, et vous recevrez un badge sur GitHub pour soutenir le projet à travers cela.

Alternativement, vous pouvez également faire un don mensuel au projet EssentialsX sur Patreon, ou vous pouvez faire un don unique sur notre page Ko-fi.

Si vous ne pouvez pas faire de don, ne vous inquiétez pas ! Il existe de nombreuses autres façons de contribuer :

Contribuer directement à EssentialsX

• Êtes-vous un développeur? Nous sommes toujours heureux de recevoir des corrections de bugs et des ajouts de fonctionnalités sous forme de demandes d'extraction.
• Parlez-vous plusieurs langues ? Si tel est le cas, nous apprécions toujours les contributions à nos traductions communautaires. Projet Crowdin.

Voir CONTRIBUTING.md pour en savoir plus.

Fournir une assistance aux autres utilisateurs

• Gérez-vous un serveur ? Jetez un œil à nos problèmes « aide recherchée » et « bug : non confirmé », où vous pouvez trouver les problèmes qui nécessitent des tests et une enquête supplémentaires.
• Voulez-vous aider les autres à configurer EssentialsX ? Vous pouvez contribuer aux documents EssentialsX. Vous pouvez également rejoindre la communauté MOSS Discord et fournir une assistance communautaire directe aux autres utilisateurs d'EssentialsX.