EssentialsX

Note: Looking for addons? See the full EssentialsX collection on Modrinth!

---

🎉 EssentialsX 2.21.2 is here, bringing with it 1.21.8 support, support for content from Chase the Skies, and a handful of bug fixes.

Thanks to everyone who has contributed code to this release (many of whom are listed at the bottom of this release), as well as to everyone who has contributed to translations on Crowdin!

In addition, a massive thanks to our community members who have assisted countless people with using EssentialsX across GitHub and MOSS, including @Evidentsinger14, @JasonHorkles, @ImDarkLaw, @Chew and many others.

The EssentialsX project is powered by the community. If you want to help us out, you can contribute by;

• Updating or reviewing translations on Crowdin
• Help users in our support channel on Discord
• Fixing bugs or offering new features on GitHub

Finally, a shoutout to our supporters on Patreon and GitHub Sponsors!
A special thanks goes to our Hero tier supporters:

• AKP
• @aternosorg
• @pebblehost
• and one anonymous supporter!

Your support helps us to continue spending hours of our free time working on and improving EssentialsX for everyone. If you've got any spare change, you can click one of the buttons below to support the EssentialsX project with a one-off or monthly pledge:

Supported server versions

EssentialsX officially supports the Paper server software. Specifically, EssentialsX is designed to work on the following Minecraft versions:

• ✅ 1.21.8 - EssentialsX actively develops for and supports this version.
• ⚠️ 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, and 1.20.6 - these versions are still supported, but are not a priority for us, and may be dropped in a future release.
• ⚠️ Spigot is still supported but is a low priority for us, and may be dropped in a future release.

We recommend using the latest version of Paper. EssentialsX includes significant improvements that require Paper, including:

• Paper's async chunk loading reduces lag spikes during player teleports. CraftBukkit and Spigot do not support async chunk loading from plugins.
• /anvil, /grindstone, /cartographytable, /loom, /smithingtable, and /stonecutter are only supported on Paper.
  CraftBukkit and Spigot do not support the API needed for these.
• /recipe on 1.12+ requires Paper to avoid a dupe bug introduced by CraftBukkit and Spigot.
• Paper contains countless overall performance optimisations over CraftBukkit and Spigot.

EssentialsX does not support the following Minecraft versions or server software:

• ℹ️ Folia is not supported yet. We are working on proper Folia support. Do not attempt to use current versions of EssentialsX on Folia or forks of it - you may lose userdata.
• 🛑 "Ultra-performance" Paper forks including Akarin, Yatopia, and similar projects.
  These often perform non-standard behaviour and can break your worlds and installed plugins.
• 🛑 Mohist and its associated projects - The Mohist project is known to be sketchy, and has, in the past, tricked users into deleting official EssentialsX jars and installing an unofficial build.
  We cannot guarantee the safety or functionality of unofficial builds of EssentialsX; you should avoid using Mohist where possible.
• 🛑 Other Forge/Bukkit hybrid servers including Cauldron, Thermos, Magma, CatServer, Arclight - EssentialsX is built for the Bukkit API, which does not properly support mods.
  For modded servers running Minecraft Forge, NeoForge or Fabric, you should use FTB Essentials.
• 🛑 1.7.10 or below.

Upgrading to 2.21.2

If you're upgrading from 2.21.1, you can keep your current EssentialsX config file. There are no new changes to configuration files in this release.

Upgrading from 2.21.0 or older versions of EssentialsX? See the previous update changelogs.

Known issues

Anchor charges deplete on Spigot even when EssentialsX Spawn overrides the spawn location

On CraftBukkit and Spigot, anchor charges will deplete regardless of the respawn-at-anchor due to an unfixed bug in CraftBukkit. This bug has been patched in Paper.

Fly mode is reset when teleporting between worlds on Spigot

On Spigot 1.17.1 and greater, player's fly mode will be reset regardless of the world-change-fly-reset setting due to behavior change in vanilla. A fix for this is in place for Paper servers. (#6012)

New features

EssentialsX now supports 1.21.8 (#6166, #6196, #6224)

EssentialsX now officially supports Paper 1.21.8.

Other additions

• The /tpr command now sends a message before the teleport commences. (#6205)

Bug fixes

Bugs fixed from 2.21.1 and older versions

• The /tpr command no longer allows players to bypass max and minimum range. (#6205)
• The /tpr command works again on legacy versions. (#6212)
• Nicknames that use hex color codes now properly respect the max-nickname-length setting when ignore-colors-in-max-nick-length is enabled. (#6185)
• Creating new player heads with the /skull command now works on 1.20.4 and above. (#6188)
• The description of the /whois command is now less misleading. (#6187)
• Canceling the SignChangeEvent from the /editsign paste command no longer erroneously informs the player that the paste was successful. (#6136)
• Unsupported permissions plugins no longer cause bStats to error during startup. (#6190)
• When confirm to /clear is enabled, the command passed to the confirmClear message no longer has a trailing space. (#6213)
• Translation messages with arguments now properly respect the per-player-locale setting. (#6227)
• EssentialsX no longer considers the hidden body and saddle inventory slots to be part of the inventory. (#6218)
• AntiBuild: Various issues related to breaking signs without permission have been fixed. (#6186)
• Chat: Chat messages sent with URLs that have TLDs longer than three characters are now properly censored. (#6184)
• Chat: Shout or question message types can no longer have blank space in front of them. (#6192)
• Chat: Formatting for local chat no longer clips off color codes. (#6226)
• Discord: Custom bot names can be set without also setting show-avatar: true. (#6239)

Regressions fixed from 2.21.2 dev builds

The following bugs from 2.21.2 development builds have been fixed:

• The player-commands feature now works again. (#6214)

---

For a full commit log, click here.