Zurück zum Blog

EssentialsX : Vollständiger Installations- und Konfigurationsleitfaden

Erfahren Sie, wie Sie EssentialsX auf Ihrem Minecraft-Server installieren und konfigurieren. Vollständiger Leitfaden: Befehle, Wirtschaft, Kits, Berechtigungen und erweiterte Konfiguration.

EssentialsX : Vollständiger Installations- und Konfigurationsleitfaden

Einführung

EssentialsX ist das beliebteste und umfassendste Plugin für Minecraft-Server. Als modernes Fork des legendären Essentials bietet es über 130 Befehle und essentielle Funktionen für jeden Serveradministrator.

Warum EssentialsX wählen?

  • +130 Befehle — Teleportation, Wirtschaft, Kits, Warps, Homes...
  • Kostenlos und Open Source — Aktiv von der Community gepflegt
  • Modular — Installieren Sie nur, was Sie benötigen
  • Kompatibel — Funktioniert mit Spigot, Paper, Purpur (1.8 bis 1.21+)
  • Anpassbar — Detaillierte Konfiguration jeder Funktion
  • Übersetzt — Mehrsprachige Unterstützung, einschließlich Französisch

Installation

Voraussetzungen

Element Minimale Version
Minecraft 1.8.8+ (empfohlen 1.20+)
Server Spigot, Paper, Purpur
Java 17+ (für MC 1.20+)
Vault Empfohlen für die Wirtschaft

Schritt 1 : Download

Laden Sie EssentialsX nur von offiziellen Quellen herunter:

⚠️ Achtung : Laden Sie niemals von nicht offiziellen Seiten herunter. Risiko von Malware!

Schritt 2 : Installation

1. Stoppen Sie Ihren Server
2. Platzieren Sie EssentialsX-X.X.X.jar im Verzeichnis /plugins/
3. (Optional) Fügen Sie die gewünschten Module hinzu
4. Starten Sie den Server
5. EssentialsX generiert automatisch seine Konfigurationsdateien

Schritt 3 : Überprüfung

/plugins

EssentialsX sollte in grün erscheinen. Sie können auch testen :

/essentials

EssentialsX-Module

EssentialsX ist modular. Installieren Sie nur, was Sie benötigen:

Verfügbare Module

Modul Beschreibung Unverzichtbar?
EssentialsX Hauptplugin (Basisbefehle) ✅ Ja
EssentialsX Chat Chatformatierung, Präfixe, Farben ✅ Empfohlen
EssentialsX Spawn Spawnverwaltung, Respawn, Anfänger-Spawn ✅ Empfohlen
EssentialsX AntiBuild Bauverbote nach Berechtigung Optional
EssentialsX Discord Discord ↔ Minecraft-Verknüpfung Optional
EssentialsX GeoIP Geografische Lokalisierung der Spieler Optional
EssentialsX Protect Grundlegender Weltschutz Optional
EssentialsX XMPP Jabber/XMPP-Unterstützung Selten

Empfohlene Installation (Survival-Server)

plugins/
├── EssentialsX-2.XX.X.jar          # Hauptplugin
├── EssentialsXChat-2.XX.X.jar      # Chat
├── EssentialsXSpawn-2.XX.X.jar     # Spawn
└── Vault-X.X.X.jar                  # Wirtschaft (Abhängigkeit)

Optionale Abhängigkeiten

Plugin Nützlichkeit mit EssentialsX
Vault Verbindung mit Wirtschaft und Berechtigungen
LuckPerms Erweiterte Berechtigungsverwaltung
PlaceholderAPI Variablen im Chat und in Nachrichten

Grundkonfiguration

Nach dem ersten Start generiert EssentialsX seine Dateien in /plugins/Essentials/.

Dateistruktur

plugins/Essentials/
├── config.yml           # Hauptkonfiguration
├── messages.properties  # Anpassbare Nachrichten
├── items.json          # Alias der Items
├── kits.yml            # Konfiguration der Kits
├── spawn.yml           # Koordinaten des Spawns
├── warps/              # Warp-Dateien
└── userdata/           # Spieldaten

Wesentliche Konfiguration (config.yml)

Öffnen Sie config.yml und ändern Sie diese Schlüsselpunkte:

Sprache des Plugins

# Ändern Sie die Sprache (fr für Französisch)
locale: fr

Pseudonym und Spitzname

# Erlauben Sie farbige Spitznamen
change-displayname: true


Format des Pseudonyms (mit Spitznamen)


nickname-prefix: '~'


Maximale Länge des Spitznamens


max-nick-length: 15


Erlauben Sie Farben in Spitznamen


nick-color: true

Nachrichten beim Einloggen/Ausloggen

# Deaktivieren Sie die Standardnachrichten (wenn Sie ein anderes Plugin verwenden)
custom-join-message: "none"
custom-quit-message: "none"


Oder anpassen


custom-join-message: "&8[&a+&8] &7{DISPLAYNAME}"
custom-quit-message: "&8[&c-&8] &7{DISPLAYNAME}"

Teleportation

# Verzögerung vor der Teleportation (in Sekunden)
teleport-delay: 3


Abbrechen, wenn der Spieler sich bewegt


teleport-cancel-on-move: true


Cooldown zwischen Teleportationen


teleport-cooldown: 30


Kostenlose Teleportation für OP


teleport-cost: 0

Essentielle Befehle

Spielerbefehle

Befehl Beschreibung Berechtigung
/spawn Zum Spawn zurückkehren essentials.spawn
/home Zu seinem Zuhause gehen essentials.home
/sethome [name] Ein Zuhause festlegen essentials.sethome
/delhome [name] Ein Zuhause löschen essentials.delhome
/tpa <spieler> Teleportationsanfrage senden essentials.tpa
/tpaccept Eine Anfrage annehmen essentials.tpaccept
/tpdeny Eine Anfrage ablehnen essentials.tpdeny
/back Zur vorherigen Position zurückkehren essentials.back
/warp <name> Zu einem Warp gehen essentials.warp
/warps Liste der Warps essentials.warp.list
/bal Sein Guthaben anzeigen essentials.balance
/pay <spieler> <betrag> Geld senden essentials.pay
/kit <name> Ein Kit erhalten essentials.kit
/kits Liste der Kits essentials.kit.list
/msg <spieler> <nachricht> Privatnachricht essentials.msg
/r <nachricht> Auf die letzte PN antworten essentials.msg
/afk AFK setzen essentials.afk
/nick <pseudonym> Seinen Spitznamen ändern essentials.nick
/seen <spieler> Letzte Verbindung eines Spielers essentials.seen
/mail send <spieler> <msg> Eine Mail senden essentials.mail.send
/mail read Seine Mails lesen essentials.mail
/helpop <nachricht> Hilfe vom Staff anfordern essentials.helpop

Moderationsbefehle

Befehl Beschreibung Berechtigung
/tp <spieler> Zu einem Spieler teleportieren essentials.tp
/tphere <spieler> Ein Spieler zu sich teleportieren essentials.tphere
/tppos <x> <y> <z> Teleportation zu den Koordinaten essentials.tppos
/tpall Alle zu sich teleportieren essentials.tpall
/kick <spieler> [grund] Ein Spieler ausschließen essentials.kick
/ban <spieler> [grund] Ein Spieler bannen essentials.ban
/tempban <spieler> <dauer> Vorübergehend bannen essentials.tempban
/unban <spieler> Ein Spieler entbannen essentials.unban
/mute <spieler> [dauer] Stumm schalten essentials.mute
/unmute <spieler> Das Wort zurückgeben essentials.unmute
/jail <spieler> <gefängnis> Einspielen essentials.jail
/unjail <spieler> Freilassen essentials.unjail
/vanish Unsichtbar werden essentials.vanish
/invsee <spieler> Inventar ansehen essentials.invsee
/socialspy PNs belauschen essentials.socialspy
/broadcast <nachricht> Globale Nachricht essentials.broadcast

Administrationsbefehle

Befehl Beschreibung Berechtigung
/setspawn Den Spawn festlegen essentials.setspawn
/setwarp <name> Ein Warp erstellen essentials.setwarp
/delwarp <name> Ein Warp löschen essentials.delwarp
/createkit <name> <verzögerung> Ein Kit aus dem Inventar erstellen essentials.createkit
/eco give <spieler> <betrag> Geld geben essentials.eco.give
/eco take <spieler> <betrag> Geld abheben essentials.eco.take
/eco set <spieler> <betrag> Guthaben festlegen essentials.eco.set
/god [spieler] Unbesiegbar-Modus essentials.god
/fly [spieler] Flugmodus essentials.fly
/speed <1-10> Bewegungsgeschwindigkeit essentials.speed
/heal [spieler] Heilen essentials.heal
/feed [spieler] Füttern essentials.feed
/gamemode <modus> Spielmodus ändern essentials.gamemode
/time <day/night> Uhrzeit ändern essentials.time
/weather <sun/rain> Wetter ändern essentials.weather
/essentials reload Konfiguration neu laden essentials.reload

Wirtschaftssystem

EssentialsX beinhaltet ein vollständiges Wirtschaftssystem.

Wirtschaftskonfiguration

In config.yml:

# Währungssymbol
currency-symbol: '€'


Name der Währung (Singular/Plural)


currency-singular: 'euro'
currency-plural: 'euros'


Startguthaben


starting-balance: 1000


Maximales Guthaben (0 = unbegrenzt)


max-money: 10000000000000


Minimales Guthaben (kann negativ sein, um Schulden zu erlauben)


min-money: -10000


Anzeigeformat


economy-log-enabled: false

Wirtschaftsbefehle

# Spieler
/bal                    # Sehen Sie Ihr Guthaben
/baltop                 # Rangliste der Reichsten
/pay <spieler> <betrag> # Geld senden


Verwaltung


/eco give <spieler> 1000  # 1000€ geben
/eco take <spieler> 500   # 500€ abheben
/eco set <spieler> 5000   # Guthaben auf 5000€ setzen
/eco reset <spieler>      # Auf Startguthaben zurücksetzen

Integration mit Vault

Um die Wirtschaft mit anderen Plugins (Shops, Jobs...) zu verbinden:

  1. Installieren Sie Vault : Vault herunterladen
  2. Platzieren Sie es in /plugins/
  3. Starten Sie den Server neu
  4. Die EssentialsX-Wirtschaft wird automatisch erkannt

Kits und Warps

Ein Kit erstellen

Methode 1 : Im Spiel (Empfohlen)

# Legen Sie die gewünschten Items in Ihr Inventar
# Erstellen Sie dann das Kit mit der Verzögerung in Sekunden
/createkit starter 86400

Methode 2 : Datei kits.yml

kits:
  starter:
    delay: 86400  # 24 Stunden in Sekunden
    items:
      - stone_sword 1
      - leather_helmet 1
      - leather_chestplate 1
      - leather_leggings 1
      - leather_boots 1
      - cooked_beef 16
      - torch 32
      

  vip:
    delay: 43200  # 12 Stunden
    items:
      - diamond_sword 1 sharpness:2
      - diamond_pickaxe 1 efficiency:3
      - golden_apple 5
      - ender_pearl 8


  weekly:
    delay: 604800  # 7 Tage
    items:
      - diamond 16
      - emerald 32
      - netherite_ingot 2

Verzauberungen in Kits

Format : item menge verzauberung:niveau

items:
  - diamond_sword 1 sharpness:5 unbreaking:3 fire_aspect:2
  - diamond_pickaxe 1 efficiency:5 fortune:3 unbreaking:3
  - elytra 1 unbreaking:3 mending:1

Berechtigungen der Kits

# Berechtigung zur Nutzung des Kits "starter"
essentials.kit.starter


Berechtigung zur Nutzung aller Kits


essentials.kit.*

Warps erstellen

# Gehen Sie zu dem gewünschten Ort
/setwarp shop        # Erstellt den Warp "shop"
/setwarp arena       # Erstellt den Warp "arena"
/setwarp spawn       # Erstellt den Warp "spawn"


Löschen Sie einen Warp


/delwarp shop


Listet die Warps auf


/warps

Berechtigungen der Warps

# Zugriff auf einen bestimmten Warp
essentials.warps.shop


Zugriff auf alle Warps


essentials.warps.*

Homes und Teleportation

Konfiguration der Homes

In config.yml:

# Standardanzahl an Homes
default-home-limit: 1


Homes nach Gruppe (mit LuckPerms)


Festlegen über Berechtigungen : essentials.sethome.multiple.<anzahl>

Multi-Homes-Berechtigungen

Berechtigung Effekt
essentials.sethome.multiple.2 2 Homes
essentials.sethome.multiple.5 5 Homes
essentials.sethome.multiple.unlimited Unbegrenzte Homes

Beispiel mit LuckPerms

# Normale Spieler : 2 Homes
/lp group default permission set essentials.sethome.multiple.2


VIP : 5 Homes


/lp group vip permission set essentials.sethome.multiple.5


Staff : unbegrenzt


/lp group staff permission set essentials.sethome.multiple.unlimited

Konfiguration der Teleportation

# Verzögerung vor der Teleportation (in Sekunden)
teleport-delay: 3


Deaktivieren Sie die Verzögerung für bestimmte Gruppen über Berechtigungen


essentials.teleport.timer.bypass


Cooldown zwischen den /tpa


teleport-cooldown: 60


Gültigkeitsdauer einer TPA-Anfrage


tpa-accept-cancellation: 120


Teleportation zu AFK-Spielern


teleport-to-afk: true

Berechtigungen

Struktur der EssentialsX-Berechtigungen

essentials.<befehl>              # Grundberechtigung
essentials.<befehl>.others       # Auf andere Spieler anwenden
essentials.<befehl>.<argument>   # Spezifische Argumente

Empfohlene Berechtigungen nach Gruppe

Gruppe : default (Spieler)

permissions:
  - essentials.spawn
  - essentials.home
  - essentials.sethome
  - essentials.delhome
  - essentials.tpa
  - essentials.tpaccept
  - essentials.tpdeny
  - essentials.back
  - essentials.back.ondeath
  - essentials.warp
  - essentials.warp.list
  - essentials.balance
  - essentials.balance.others
  - essentials.pay
  - essentials.kit
  - essentials.kit.starter
  - essentials.msg
  - essentials.mail
  - essentials.mail.send
  - essentials.afk
  - essentials.seen
  - essentials.list
  - essentials.motd
  - essentials.rules
  - essentials.helpop
  - essentials.sethome.multiple.2

Gruppe : VIP

permissions:
  - essentials.nick
  - essentials.nick.color
  - essentials.back.ondeath
  - essentials.kit.vip
  - essentials.sethome.multiple.5
  - essentials.tpa.cooldown.bypass
  - essentials.teleport.timer.bypass

Gruppe : Moderator

permissions:
  - essentials.tp
  - essentials.tphere
  - essentials.tppos
  - essentials.kick
  - essentials.kick.notify
  - essentials.mute
  - essentials.mute.notify
  - essentials.tempban
  - essentials.tempban.notify
  - essentials.jail
  - essentials.vanish
  - essentials.vanish.see
  - essentials.invsee
  - essentials.socialspy
  - essentials.helpop.receive
  - essentials.fly
  - essentials.god

Gruppe : Admin

permissions:
  - essentials.*
  # Oder selektiv:
  - essentials.ban
  - essentials.unban
  - essentials.setspawn
  - essentials.setwarp
  - essentials.delwarp
  - essentials.createkit
  - essentials.eco
  - essentials.eco.give
  - essentials.eco.take
  - essentials.eco.set
  - essentials.gamemode
  - essentials.time
  - essentials.weather
  - essentials.broadcast
  - essentials.essentials

Konfiguration mit LuckPerms (Vollständiges Beispiel)

# Gruppen erstellen
/lp creategroup vip
/lp creategroup mod
/lp creategroup admin


Hierarchie


/lp group vip parent add default
/lp group mod parent add vip
/lp group admin parent add mod


Spielerberechtigungen


/lp group default permission set essentials.spawn
/lp group default permission set essentials.home
/lp group default permission set essentials.sethome
/lp group default permission set essentials.tpa
/lp group default permission set essentials.warp
/lp group default permission set essentials.balance
/lp group default permission set essentials.kit.starter


VIP-Berechtigungen


/lp group vip permission set essentials.fly
/lp group vip permission set essentials.nick
/lp group vip permission set essentials.kit.vip


Moderatoren-Berechtigungen


/lp group mod permission set essentials.kick
/lp group mod permission set essentials.mute
/lp group mod permission set essentials.vanish
/lp group mod permission set essentials.tp


Admin-Berechtigungen


/lp group admin permission set essentials.*

Erweiterte Konfiguration

EssentialsX Chat

Installieren Sie EssentialsXChat, um den Chat anzupassen.

Konfiguration in config.yml :

# Aktivieren Sie die Chatformatierung
chat:
  # Globales Chatformat
  format: '{DISPLAYNAME}&7: &f{MESSAGE}'
  

Format nach Gruppe (benötigt Vault + LuckPerms)


group-formats:
    default: '&7[Spieler] {DISPLAYNAME}&7: &f{MESSAGE}'
    vip: '&6[VIP] {DISPLAYNAME}&7: &f{MESSAGE}'
    mod: '&9[Mod] {DISPLAYNAME}&7: &f{MESSAGE}'
    admin: '&c[Admin] {DISPLAYNAME}&7: &f{MESSAGE}'

Verfügbare Chat-Variablen

Variable Beschreibung
{DISPLAYNAME} Pseudonym oder Spitzname des Spielers
{USERNAME} Reales Pseudonym
{MESSAGE} Gesendete Nachricht
{GROUP} Gruppe des Spielers
{PREFIX} LuckPerms-Präfix
{SUFFIX} LuckPerms-Suffix
{WORLD} Aktuelle Welt
{WORLDNAME} Name der Welt

EssentialsX Spawn

Konfiguration des Spawns in config.yml :

# Teleportation zum Spawn beim Beitritt
spawn-on-join: true


Nur für neue Spieler


spawn-on-join: newbies


Spawn nach Gruppe


spawn-on-join-groups:


    

  • default
    • 



Respawn am Spawn (anstatt im Bett)


respawn-at-spawn: true


Spawn nach Welt


respawn-at-spawn-by-world: false

Konfiguration in spawn.yml :

spawns:
  default:
    world: world
    x: 0.5
    y: 100.0
    z: 0.5
    yaw: 0.0
    pitch: 0.0

Benutzerdefinierte Nachrichten (MOTD, Regeln)

Nachricht des Tages (MOTD)

Erstellen/Ändern Sie motd.txt :

&6╔════════════════════════════════════╗
&6║  &eWillkommen auf &bMeinServer&e !        &6║
&6║                                    &6║
&6║  &7• Website: &fwww.meinserver.de        &6║
&6║  &7• Discord: &fdiscord.gg/meinserver &6║
&6║  &7• Shop: &f/shop                &6║
&6║                                    &6║
&6║  &aViel Spaß!                  &6║
&6╚════════════════════════════════════╝

Regeln

Erstellen/Ändern Sie rules.txt :

&6&l▬▬▬ SERVERREGELN ▬▬▬


&e1. &fRespektieren Sie alle Spieler
&e2. &fKein Cheaten oder Hacken
&e3. &fKein Griefing oder Diebstahl
&e4. &fKeine Werbung oder Spam
&e5. &fVerwenden Sie gesunden Menschenverstand


&7Verstöße gegen diese Regeln = Permanenter Bann

Farbcodes

Code Farbe Code Farbe
&0 Schwarz &8 Dunkelgrau
&1 Dunkelblau &9 Blau
&2 Dunkelgrün &a Helles Grün
&3 Dunkelcyan &b Cyan
&4 Dunkelrot &c Rot
&5 Violett &d Rosa
&6 Gold &e Gelb
&7 Grau &f Weiß
Code Format
&l Fett
&o Kursiv
&n Unterstrichen
&m ~~Durchgestrichen~~
&r Zurücksetzen

Fehlerbehebung

Häufige Probleme

"Unbekannter Befehl" nach der Installation

Mögliche Ursachen:

  1. Das Plugin wurde nicht korrekt geladen
  2. Konflikt mit einem anderen Plugin

Lösungen:

# Überprüfen Sie, ob das Plugin geladen ist
/plugins


Wenn rot, überprüfen Sie die Protokolle


/logs/latest.log


Sauber neu starten


/stop

Die Wirtschaft funktioniert nicht mit anderen Plugins

Lösung:

  1. Installieren Sie Vault
  2. Überprüfen Sie, ob Vault EssentialsX erkennt :
/vault-info economy

Die Berechtigungen funktionieren nicht

Überprüfungen:

# Testen Sie eine Berechtigung
/essentials:perm <spieler> essentials.fly


Mit LuckPerms, überprüfen Sie


/lp user <spieler> permission check essentials.fly

Die Homes/Warps werden nicht gespeichert

Ursachen:

  • Probleme mit den Dateiberechtigungen
  • Plötzlicher Serverabbruch

Lösungen:

# Manuell speichern
/essentials save


Überprüfen Sie die Berechtigungen des Ordners


chmod -R 755 plugins/Essentials/

Fehlermeldungen in der Konsole

Fehler: "Spielerdaten nicht gefunden"

  • Normal für neue Spieler
  • Die Daten werden beim ersten Beitritt erstellt

Fehler: "Konfiguration konnte nicht geladen werden"

  • YAML-Syntaxfehler
  • Verwenden Sie einen Online-YAML-Validator
  • Überprüfen Sie die Abstände (keine Tabulatoren!)

Diagnosebefehle

# Version von EssentialsX
/essentials version


Konfiguration neu laden


/essentials reload


Debug eines Spielers


/essentials debug


Wirtschaftsinformationen


/essentials eco

Komplett zurücksetzen

Wenn alles kaputt ist :

1. Stoppen Sie den Server
2. Sichern Sie den Ordner plugins/Essentials/
3. Löschen Sie plugins/Essentials/
4. Starten Sie den Server neu (generiert die Standardkonfigurationen)
5. Konfigurieren Sie schrittweise neu

Schnelle Befehle - Merkblatt

Erstkonfiguration

# 1. Den Spawn festlegen
/setspawn


2. Wichtige Warps erstellen


/setwarp shop
/setwarp arena
/setwarp mine


3. Das Starterkit erstellen


(mit Items im Inventar)


/createkit starter 86400


4. Testen


/kit starter
/warp shop
/spawn

Schnelle Spielerverwaltung

# Teleportation
/tp <spieler>           # Gehe zu
/tphere <spieler>       # Zu sich bringen


Moderation


/kick <spieler> grund
/tempban <spieler> 1h grund
/mute <spieler> 10m


Wirtschaft


/eco give <spieler> 1000

Nützliche Ressourcen

Fazit

EssentialsX ist das Fundament eines jeden guten Minecraft-Servers. Mit diesem Leitfaden haben Sie alle Schlüssel, um :

  • Das Plugin korrekt zu installieren und zu konfigurieren
  • Die Wirtschaft, Kits und Warps zu verwalten
  • Die Berechtigungen nach Gruppen zu konfigurieren
  • Den Chat und die Nachrichten anzupassen
  • Häufige Probleme zu lösen

Empfohlene nächste Schritte :

  1. LuckPerms für erweiterte Berechtigungen installieren
  2. EssentialsX Chat für einen professionellen Chat konfigurieren
  3. Kits erstellen, die zu Ihrem Gameplay passen
  4. Nachrichten anpassen (MOTD, Regeln)
Zurück zum Blog