EssentialsX 2.20.1 - The Trails and Tales Update

[mdcfe]

🎉 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. (Update Gradle, build plugins and GitHub Actions #5383)
• Added the ability to get the recipe of the item you're holding with /recipe hand. (Add ability to get recipe of item in 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. (Fix NPE during first join for LuckPerms contexts #5364)
• Shout and question prefixes now work when using the /toggleshout command. (Fix question and shout prefixes with toggle shout #5367)
• Underscores in kit placeholders no longer are removed upon receiving the kit. (Fix variables in kits having underscores replaced with spaces #5366)
• Invalid decimal values provided in configuration files now return proper default values. (Fix config BigDecimal parsing returning null on error #5373)
• An exception is no longer raised when doing operations on some offline players. (Don't do visibility checks for OfflinePlayers #5375, Fix remaining offline visibility checks #5466)
• Invalid material names in /unlimited user data values no longer prevent user data from loading. (still fixing the configurate pr #5438)
• Trade signs no longer break when setting currency-symbol-suffix to true in the config. (Fix trade signs not working with currency suffix #5441)
• The enchant command now supports items held in the offhand. (some offhand stuff #5449)
• The book command now works properly with other items held in the offhand. (some offhand stuff #5449)
• Various issues related to offline player lookups have been fixed. (some usermap bug fixes 4 u #5462)
• AntiBuild: AntiBuild checks are no longer ran for NPCs. (Don't run AntiBuild checks on NPCs #5365)
• Discord: Console messages and webhook messages should no longer spam console or die out after spam. (Migrate Discord module to JDA 5 #4786)
• Discord: The quit message online player count placeholder is no longer off by one. (Fix inaccurate online player count for Discord leave message #5440)
• Discord: The console relay now properly filters all formatting codes. (Fix discord module console relay not filtering all color codes #5454)
• Discord Link: Player link data is no longer saved to disk when no data has changed. (Some link module fixups #5388)
• Discord Link: Discord roles and minecraft groups are now removed instantly upon unlink. (Some link module fixups #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. (Fix keywords in kit commands not working #5377)
• Empty lines in kits no longer raise an exception. (Fix regression w/empty strings with KeywordReplacer #5378)
• Kits no longer only replace spaces with underscores in commands. (Fix regression in 8d07c4b #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. (Add KitPreExpandItemsEvent #5407)

---

For a full commit log, click here.

---

This discussion was created from the release EssentialsX 2.20.1 - The Trails and Tales Update.