EssentialsX is de dagelijkse plugin voor Paper- en Spigot-servers: homes, warps, een spawnpunt, teleportverzoeken tussen spelers, kits en een begroeting bij het joinen. Bijna elke survivalserver gebruikt hem, omdat hij de commando's bundelt die spelers vanzelfsprekend verwachten. Deze guide stelt de basisfuncties in en laat zien welke rechten je daarvoor geeft. De screenshots komen van een testserver met Paper 1.21.4 en EssentialsX 2.21.0.

Installatie en eerste keer joinen

In het panel vind je EssentialsX onder Plugins → Browser. De hoofdmodule EssentialsX is genoeg; extra modules zoals EssentialsX Chat of EssentialsX Spawn installeer je alleen als je hun functies nodig hebt. Na de herstart begroet EssentialsX elke speler met een welkomstbericht, het aantal spelers online en de speeltijd.

Joinbericht van EssentialsX met melding over een nieuwere versie
Joinbericht van EssentialsX met melding over een nieuwere versie

De rode melding in de afbeelding is de ingebouwde updatecontrole: die meldt operators wanneer er een nieuwere versie beschikbaar is. Updaten doe je via de pluginbrowser in het panel, niet via de link. Wie de melding niet wil, zet in plugins/Essentials/config.yml de waarde update-check: false.

Spawn, homes en warps

De drie commando's die spelers het vaakst gebruiken:

/setspawn
/sethome
/home
/setwarp markt
/warp markt

/setspawn legt het punt vast waar nieuwe spelers verschijnen en waar /spawn naartoe leidt. /sethome slaat de huidige positie op als home van de speler; /home brengt hem terug. Warps zijn openbare punten die een administrator met /setwarp aanmaakt en die iedereen met /warp bereikt.

Terugkeer met /home naar het dorp: de speler staat weer voor zijn huis
Terugkeer met /home naar het dorp: de speler staat weer voor zijn huis

Meerdere homes per speler regel je via rechten: wie essentials.sethome.multiple.vip heeft, krijgt zoveel homes als in config.yml onder sethome-multiple voor vip is ingesteld. Zonder deze nodes blijft het bij één home.

Rechten voor de standaardgroep

EssentialsX geeft zonder rechtenplugin alle spelers de meeste commando's. Zodra LuckPerms draait, geldt alleen wat je toestaat. Een zinvolle set voor de groep 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 stuurt een teleportverzoek, /tpaccept accepteert het; /back brengt je na de dood terug naar het sterfpunt. Commando's zoals /gamemode, /give, /kick en /ban blijven voorbehouden aan de moderatiegroep. Hoe je groepen aanmaakt, staat in LuckPerms: rechten instellen.

Kits en begroeting

Een starterkit geeft nieuwe spelers gereedschap om mee te beginnen. Kits staan in plugins/Essentials/config.yml onder kits; een item noemt de voorwerpen en een cooldown in seconden. Het commando /kit starter heeft het recht essentials.kits.starter nodig. De begroeting en het bericht van de dag staan in hetzelfde bestand onder newbies en motd; kleuren stel je in met &-codes. Na wijzigingen aan de configuratie laadt /essentials reload ze zonder herstart.

Waar de spelergegevens staan

EssentialsX slaat niets op in de wereldmap, maar in zijn eigen pluginmap. Dat is belangrijk om te weten als je een wereld vervangt of naar een andere server verhuist:

  • plugins/Essentials/userdata/ — per speler één bestand met homes, laatste positie, speeltijd en nicknames, genoemd naar zijn UUID.
  • plugins/Essentials/warps/ — per warp een eigen bestand.
  • plugins/Essentials/config.yml — kits, begroeting, teleportvertraging en alle overige instellingen.

Een nieuwe wereld laat homes en warps dus ongemoeid — hun coördinaten wijzen daarna wel naar niets en moeten opnieuw worden ingesteld. Bij een serververhuizing neem je de hele map plugins/Essentials/ mee, dan blijven homes en warps behouden.

Typische fouten

  • /home zonder effect. De speler heeft geen home ingesteld of het recht essentials.home ontbreekt.
  • Teleport breekt af. De instelling teleport-delay wacht een paar seconden en breekt af bij beweging. Verlaag de waarde in config.yml of geef het recht essentials.teleport.timer.bypass.
  • Warps verdwenen. Warps staan als bestanden in plugins/Essentials/warps/. De panelback-up neemt ze mee; een nieuwe wereldmap verandert daar niets aan.
  • Dubbele commando's. Andere plugins leveren eigen /spawn- of /home-commando's. In config.yml onder overridden-commands leg je vast welke plugin wint.

FAQ

Heb ik alle EssentialsX-modules nodig?

Nee. De hoofdmodule EssentialsX brengt homes, warps, teleport en kits mee. Extra modules installeer je alleen voor hun concrete functie: EssentialsX Chat voor prefixen in de chat, EssentialsX Spawn voor aparte spawnregels bij de eerste keer joinen en bij dood.

Waarom werken commando's na de LuckPerms-installatie niet meer?

Zonder rechtenplugin geeft EssentialsX de meeste commando's vrij baan. Zodra LuckPerms draait, geldt alleen nog wat expliciet is toegestaan. Stel de nodes voor de groep default één keer netjes in — daarna is het gedrag voorspelbaar en bepaal jij wie /tpa of /back mag gebruiken.

Hoe krijgt een speler meerdere homes?

Via twee bij elkaar horende plekken: in config.yml leg je onder sethome-multiple vast hoeveel homes een niveau toestaat, en in LuckPerms geef je de bijpassende node, bijvoorbeeld essentials.sethome.multiple.vip. Zonder deze node blijft het bij één home per speler.

Moet ik na een wijziging aan config.yml opnieuw starten?

Voor de meeste waarden is /essentials reload genoeg, bijvoorbeeld bij kits, begroeting of teleportvertraging. Een nieuw geïnstalleerde extra module en wijzigingen die andere plugins raken, hebben een volledige herstart van de server nodig.

Zitten homes en warps in de panelback-up?

Ja, de back-up bewaart de volledige servermap en daarmee ook plugins/Essentials/. Een vervanging van de wereld verwijdert homes en warps niet — hun coördinaten passen daarna alleen niet meer bij het terrein en moeten opnieuw worden ingesteld.

Verdere guides

Gebieden die spelers niet mogen veranderen, bescherm je met WorldGuard: regio's beschermen. Als de server ondanks weinig spelers hapert, helpt spark: lag analyseren.

Bronnen

EssentialsX: voorbeeld bekijken

Eigen opnames uit een demo-omgeving. De getoonde versie en instellingen kunnen afwijken van jouw server.

Het home-punt atelier is opgeslagen.
Het home-punt atelier is opgeslagen.

2.21.0