Essentials

Dies ist eine Abzweigung von Essentials namens EssentialsX.

Wenn Sie dies verwenden, bitten Sie Essentials NICHT um Unterstützung.

Das offizielle Upstream-Repository für das ursprüngliche Essentials-Projekt finden Sie unter https://github.com/Essentials/Essentials.

Warum EssentialsX verwenden?

EssentialsX ist eine Fortsetzung der Essentials-Plugin-Suite, aktualisiert, um moderne Minecraft- und Spigot-Versionen zu unterstützen.

Es bietet unzählige neue Funktionen, Leistungsverbesserungen und Korrekturen, die in den ursprünglichen Essentials oder Spigot-Essentials nicht verfügbar sind. Weitere Einzelheiten finden Sie im Wiki.

Wenn Sie das ursprüngliche Essentials-Plugin verwenden, ist EssentialsX ein direkter Ersatz für Essentials. Es gibt jedoch einige neue Anforderungen:

• Für die Ausführung von EssentialsX sind CraftBukkit, Spigot oder Paper erforderlich. Andere Serversoftware funktioniert möglicherweise, diese wird jedoch nicht vom Team getestet und wir können bei auftretenden Problemen möglicherweise nicht helfen.
• EssentialsX unterstützt derzeit die Minecraft-Versionen 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 und 1.21.4.
• EssentialsX erfordert derzeit Java 8 oder höher. Wir empfehlen die Verwendung der neuesten Java-Version, die von Ihrer Serversoftware unterstützt wird.
• EssentialsX erfordert, dass Vault die Verwendung von Chat-Präfixen/Suffixen und Gruppenunterstützung durch unterstützte Berechtigungs-Plugins ermöglicht.
  • Wir empfehlen die Verwendung von LuckPerms für Berechtigungen und Gruppen.
  • Wenn Sie ein nicht unterstütztes Berechtigungs-Plugin haben, aber dennoch Platzhalter verwenden möchten, aktivieren Sie use-bukkit-permissions in der Konfiguration. Andernfalls greift das Plugin auf konfigurationsbasierte Berechtigungen zurück.

Unterstützung

Benötigen Sie Hilfe bei der Verwendung von EssentialsX? Treten Sie der MOSS Discord-Community bei, um um Hilfe zu bitten und über EssentialsX zu diskutieren.

Wenn Sie einen Fehler melden müssen oder eine neue Funktion vorschlagen möchten, können Sie ein Issue auf GitHub öffnen.

Gebäude

Um EssentialsX zu erstellen, muss JDK 8 oder höher auf Ihrem System installiert sein.

Klonen Sie dieses Repository und führen Sie dann den folgenden Befehl aus:

• Unter Linux oder macOS: ./gradlew build
• Unter Windows: gradlew build

Anschließend finden Sie Builds von EssentialsX-Modulen im Verzeichnis jars/ .

Ausführen eines Testservers

Sie können mit dem folgenden Befehl auch einen Testserver aus Ihrer Entwicklungsumgebung ausführen:

• Unter Linux oder macOS: ./gradlew build :runServer
• Unter Windows: gradlew build :runServer

Beachten Sie Folgendes : - Ohne es werden mehrere Server gleichzeitig ausgeführt, was wahrscheinlich zum Absturz von Gradle führen wird.

Verwenden Sie EssentialsX in Ihrem Plugin

Möchten Sie EssentialsX in Ihr Plugin integrieren? Sie können Ihr Plugin mit der EssentialsX-API erstellen, die im EssentialsX Maven-Repository verfügbar ist.

Veröffentlichungen werden im Maven-Repo unter https://repo.essentialsx.net/releases/ gehostet, während Snapshots (einschließlich Entwickler-Builds) unter https://repo.essentialsx.net/snapshots/ gehostet werden.

Um EssentialsX zu Ihrem Build-System hinzuzufügen, sollten Sie die folgenden Artefakte verwenden:

Typ	Gruppen-ID	Artefakt-ID	Version
Neueste Veröffentlichung	net.essentialsx	EssentialsX	2.20.1
Schnappschüsse	net.essentialsx	EssentialsX	2.21.0-SNAPSHOT
Ältere Veröffentlichungen	net.ess3	EssentialsX	2.18.2

Hinweis: Bis Version 2.18.2 verwendete EssentialsX die Gruppen-ID net.ess3 .
Ab 2.19.0 verwendet EssentialsX die Gruppen-ID net.essentialsx .
Stellen Sie beim Aktualisieren Ihres Plugins sicher, dass Sie die richtige Gruppen-ID verwenden.

Weitere Informationen, einschließlich Maven- und Gradle-Beispiele, finden Sie im Wiki.

Unterstützen Sie das EssentialsX-Projekt

Möchten Sie dabei helfen, EssentialsX zu verbessern? Es gibt verschiedene Möglichkeiten, wie Sie das Projekt unterstützen und dazu beitragen können.

Spenden Sie an EssentialsX

Durch Spenden können wir die Kosten unserer Infrastruktur decken und EssentialsX weiterhin mit neuen Funktionen und für neue Minecraft-Versionen aktualisieren.

Sie können uns mit einer einmaligen oder monatlichen Spende über GitHub Sponsors unterstützen und erhalten auf GitHub ein Abzeichen, wenn Sie das Projekt dadurch unterstützen.

Alternativ können Sie auch monatlich auf Patreon für das EssentialsX-Projekt spenden oder auf unserer Ko-Fi-Seite eine einmalige Spende tätigen.

Wenn Sie nicht spenden können, machen Sie sich keine Sorgen! Es gibt viele andere Möglichkeiten, einen Beitrag zu leisten:

Direkter Beitrag zu EssentialsX

• Sind Sie Entwickler? Wir freuen uns immer über Fehlerbehebungen und Funktionserweiterungen als Pull-Requests.
• Sprechen Sie mehrere Sprachen? Wenn ja, freuen wir uns immer über Beiträge zu unseren Community-Übersetzungen. Crowdin-Projekt.

Weitere Informationen finden Sie unter CONTRIBUTING.md.

Bereitstellung von Support für andere Benutzer

• Betreiben Sie einen Server? Werfen Sie einen Blick auf unsere Probleme „Hilfe gesucht“ und „Fehler: unbestätigt“. Dort finden Sie Probleme, die einer zusätzlichen Prüfung und Untersuchung bedürfen.
• Möchten Sie anderen bei der Einrichtung von EssentialsX helfen? Sie können zu den EssentialsX-Dokumenten beitragen. Sie können auch der MOSS Discord-Community beitreten und anderen EssentialsX-Benutzern direkten Community-Support bieten.