Note: These patch notes are for EssentialsX 2.20.1, which was released on 5th August 2023 and supports Minecraft 1.20.1.
EssentialsX 2.20.0 was previously released on 23rd May 2023 with lots of new features and important changes, including the new Discord Link addon.
Please read both changelogs before updating, else you may run into issues!

EssentialsX 2.20.1 is here, bringing with it 1.20.1 support and several 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 @triagonal, @JasonHorkles, @Evidentsinger14, @ImDarkLaw, @Chew, @Laarryy 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
• Vestria MC
• @aternosorg
• @pebblehost

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 CraftBukkit, Spigot, and Paper server software. Specifically, EssentialsX is designed to work on the following Minecraft versions:

• ✅ 1.19.4 and 1.20.1 - EssentialsX actively develops against and supports these 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, and 1.18.2 - these versions are still supported, but are not a 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 - 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 - EssentialsX is built for the Bukkit API, which does not properly support mods.
  For modded servers, use SpongeForge and Nucleus, or an alternative mod for Forge or Fabric.
• 1.7.10 or below.

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

Upgrading from 2.19.7 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. (#4325)
On Minecraft 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. This will be fixed in a future version of Essentials.

New features
EssentialsX now supports 1.20.1 (#5389)
EssentialsX now officially supports Paper, Spigot, and CraftBukkit 1.20.1.

Other additions

• Translations have been updated with the latest community contributions from Crowdin.
• Our dependencies and build tools have been updated to their latest versions. (#5383)
• Added the ability to get the recipe of the item you're holding with /recipe hand. (#5346)

Bug fixes
Bugs fixed from 2.20.0 and older versions

• An exception is no longer raised during new joins when using LuckPerms contexts. (#5364)
• Shout and question prefixes now work when using the /toggleshout command. (#5367)
• Underscores in kit placeholders no longer are removed upon receiving the kit. (#5366)
• Invalid decimal values provided in configuration files now return proper default values. (#5373)
• An exception is no longer raised when doing operations on some offline players. (#5375, #5466)
• Invalid material names in /unlimited user data values no longer prevent user data from loading. (#5438)
• Trade signs no longer break when setting currency-symbol-suffix to true in the config. (#5441)
• The enchant command now supports items held in the offhand. (#5449)
• The book command now works properly with other items held in the offhand. (#5449)
• Various issues related to offline player lookups have been fixed. (#5462)
• AntiBuild: AntiBuild checks are no longer ran for NPCs. (#5365)
• Discord: Console messages and webhook messages should no longer spam console or die out after spam. (#4786)
• Discord: The quit message online player count placeholder is no longer off by one. (#5440)
• Discord: The console relay now properly filters all formatting codes. (#5454)
• Discord Link: Player link data is no longer saved to disk when no data has changed. (#5388)
• Discord Link: Discord roles and minecraft groups are now removed instantly upon unlink. (#5388)

Regressions fixed from 2.20.1 dev builds
The following bugs from 2.20.1 development builds have been fixed:

• Commands in kits no longer replace spaces with underscores. (#5377)
• Empty lines in kits no longer raise an exception. (#5378)
• Kits no longer only replace spaces with underscores in commands. (#5379)

Changes for developers
New events
EssentialsX 2.20.1 introduces a new event:

• KitPreExpandItemsEvent is fired before players are about to receive kit items. (#5407)

For a full commit log, click here.