fix(deps): update dependency net.essentialsx:essentialsx to v2.20.0

[renovate[bot]]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
net.essentialsx:EssentialsX (source)	2.19.7 -> 2.20.0

---

Release Notes

EssentialsX/Essentials

### [`v2.20.0`](https://togithub.com/EssentialsX/Essentials/releases/tag/2.20.0): EssentialsX 2.20.0 - The Better Together Update [Compare Source](https://togithub.com/EssentialsX/Essentials/compare/2.19.7...2.20.0) After months of hard work from our contributors, **EssentialsX 2.20.0 is here**! 🎉 This release contains a new Discord Link addon, 1.19.4 support, a few new features, bug fixes and internal improvements. Keep reading to see all the new additions! Thanks to all our contributors who contributed to this release (all of whom are listed at the bottom of this release), as well as to everyone who has contributed to translations on [Crowdin](https://translate.essentialsx.net)! In addition, a massive thanks to our community members who have assisted countless people with using EssentialsX across GitHub and MOSS, including [@​triagonal](https://togithub.com/triagonal), [@​JasonHorkles](https://togithub.com/JasonHorkles), [@​Evidentsinger14](https://togithub.com/Evidentsinger14), [@​ImDarkLaw](https://togithub.com/ImDarkLaw), [@​Chew](https://togithub.com/Chew), [@​Laarryy](https://togithub.com/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](https://translate.essentialsx.net) - Help users in our support channel on [Discord](https://discord.gg/casfFyh) - Fixing bugs or offering new features on [GitHub](https://togithub.com/EssentialsX/Essentials/blob/2.x/CONTRIBUTING.md) Finally, a shoutout to our supporters on [Patreon](https://www.patreon.com/essentialsx) and [GitHub Sponsors](https://togithub.com/sponsors/EssentialsX/)!\ A special thanks goes to our Hero tier supporters: - AKP - Vestria MC - [@​aternosorg](https://togithub.com/aternosorg) - [@​pebblehost](https://togithub.com/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: [](https://www.patreon.com/essentialsx) [](https://togithub.com/sponsors/EssentialsX/) #### Supported server versions EssentialsX officially supports the CraftBukkit, Spigot, and [Paper](https://papermc.io) server software. Specifically, EssentialsX is designed to work on the following Minecraft versions: - ✅ `1.18.2` and `1.19.4` - 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`, and `1.17.1` - 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`, `/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: - 🛑 "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.](https://essentialsx.net/do-not-use-mohist.html)**\ 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](https://www.spongepowered.org/) and [Nucleus](https://nucleuspowered.org/), or an alternative mod for [Forge or Fabric](https://www.curseforge.com/minecraft/mc-mods). - 🛑 `1.7.10` or below. #### Upgrading to 2.20.0 If you're upgrading from **2.19.3 or above**, you can keep your current EssentialsX config file. However, 2.20.0 adds several new options that you may want to configure, and to do so you'll need to either update your config or add the new settings to your existing config. Read on for a list of changes and new config options. Upgrading from 2.19.2 or older versions of EssentialsX? See the [previous update changelogs](https://togithub.com/EssentialsX/Essentials/releases). #### New module: EssentialsX Discord Link! ([#​4155](https://togithub.com/EssentialsX/Essentials/issues/4155)) :tada: EssentialsX Discord now has the Discord Link addon, which lets your users easily link their Discord and Minecraft accounts! You can synchronize Discord roles with Vault groups, as well as optionally requiring players to link to Discord before playing, all with a bloat-free and easy-to-understand configuration! You can read more about EssentialsX Discord Link and see how to get started [here](https://essentialsx.net/wiki/Discord-Link.html). #### 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](https://hub.spigotmc.org/jira/browse/SPIGOT-5989). This bug has been patched in Paper. ##### Minecraft: Trails and Tales content not yet supported in commands EssentialsX 2.20.0 doesn't yet support blocks, items and mobs from Minecraft: Trails and Tales in 1.19.x or 1.20. As a result, some commands and features (including `/give`, `/spawnmob` and `/editsign`) won't recognise the new content yet. We plan to release a 2.20.1 update once Minecraft 1.20 has released, which will add support for the new content. #### Important changes ##### Usermap storage and cache changes ([#​4581](https://togithub.com/EssentialsX/Essentials/issues/4581), [#​5125](https://togithub.com/EssentialsX/Essentials/issues/5125)) EssentialsX 2.20 overhauls the user caching system, fixing issues with third-party plugins such as Towny. Due to a large overhaul in data format, once you upgrade to 2.20.0, **you will not be able to downgrade your userdata to older versions**. We strongly recommend taking a full backup of your `plugins/Essentials/usermap.csv` file *before* you update from 2.19.7 to 2.20.0 if you ever wish to downgrade in the future. #### New features ##### EssentialsX now supports 1.19.4 ([#​5179](https://togithub.com/EssentialsX/Essentials/issues/5179), [#​5273](https://togithub.com/EssentialsX/Essentials/issues/5273)) EssentialsX now officially supports CraftBukkit, Spigot and Paper for 1.19.4. ##### New `/renamehome` command ([#​5121](https://togithub.com/EssentialsX/Essentials/issues/5121)) You can now use `/renamehome` to change the name of your existing home. If you have the `essentials.renamehome.others` permission, you can rename the homes of other players. ##### New `/bottom` command ([#​5292](https://togithub.com/EssentialsX/Essentials/issues/5292)) You can now use `/bottom` to teleport to the lowest safe location in their current position. ##### Discord: New `first-join` message type ([#​5160](https://togithub.com/EssentialsX/Essentials/issues/5160)) A new Minecraft -> Discord message type, sent when a player joins the server for the first time. ```yml ### Configure which Discord channels different messages will be sent to. ### You can either use the names of the channels listed above or just the id of a channel. ### If an invalid channel is used, the primary channel will be used instead. # ### To disable a message from showing, use 'none' as the channel name. message-types: ... ### Join messages sent when a player joins the Minecraft server for the first time. This type is sent instead of the join type. first-join: primary ``` ```yml ### The following entries allow you to customize the formatting of messages sent by the plugin. ### Each message has a description of how it is used along with placeholders that can be used. messages: ... ### This is the message sent to Discord when a player joins the minecraft server for the first time. ### The following placeholders can be used here: ### - {username}: The name of the user joining ### - {displayname}: The display name of the user joining ### - {joinmessage}: The full default join message used in game ### - {online}: The amount of players online ### - {unique}: The amount of unique players to ever join the server ### ... PlaceholderAPI placeholders are also supported here too! first-join: ":arrow_right: :first_place: {displayname} has joined the server for the first time!" ``` ##### Discord: New `local`, `question`, and `shout` message types ([#​4684](https://togithub.com/EssentialsX/Essentials/issues/4684)) A few new Minecraft -> Discord message types and configuration options have been added in order to support local, question and shout chat. ```yml ### Whether to use Essentials Chat events instead of normal chat event. ### This allows you to filter chat by its type (local, question, shout). use-essentials-events: false ``` ```yml ### Configure which Discord channels different messages will be sent to. ### You can either use the names of the channels listed above or just the id of a channel. ### If an invalid channel is used, the primary channel will be used instead. # ### To disable a message from showing, use 'none' as the channel name. message-types: ... ### Message sent when a player talks in local chat. ### use-essentials-events must be set to "true" for this to work. local: none ### Message sent when a player asks a question in global chat. ### use-essentials-events must be set to "true" for this to work. question: primary ### Message sent when a player talks in global chat. ### use-essentials-events must be set to "true" for this to work. shout: primary ``` ```yml ### The following entries allow you to customize the formatting of messages sent by the plugin. ### Each message has a description of how it is used along with placeholders that can be used. messages: ... ### This is the message that is used to relay minecraft local chat in Discord. ### The following placeholders can be used here: ### - {username}: The username of the player sending the message ### - {displayname}: The display name of the player sending the message (This would be their nickname) ### - {message}: The content of the message being sent ### - {world}: The name of the world the player sending the message is in ### - {prefix}: The prefix of the player sending the message ### - {suffix}: The suffix of the player sending the message ### ... PlaceholderAPI placeholders are also supported here too! mc-to-discord-local: "**[Local]** {displayname}: {message}" ### This is the message that is used to relay questions from minecraft chat in Discord. ### The following placeholders can be used here: ### - {username}: The username of the player sending the message ### - {displayname}: The display name of the player sending the message (This would be their nickname) ### - {message}: The content of the message being sent ### - {world}: The name of the world the player sending the message is in ### - {prefix}: The prefix of the player sending the message ### - {suffix}: The suffix of the player sending the message ### ... PlaceholderAPI placeholders are also supported here too! mc-to-discord-question: "**[Question]** {displayname}: {message}" ### This is the message that is used to relay minecraft global chat in Discord. ### The following placeholders can be used here: ### - {username}: The username of the player sending the message ### - {displayname}: The display name of the player sending the message (This would be their nickname) ### - {message}: The content of the message being sent ### - {world}: The name of the world the player sending the message is in ### - {prefix}: The prefix of the player sending the message ### - {suffix}: The suffix of the player sending the message ### ... PlaceholderAPI placeholders are also supported here too! mc-to-discord-shout: "**[Shout]** {displayname}: {message}" ``` ##### Discord: Configurable webhook name You can now change the webhook name format for messages sent to Discord. ```yml ### The following entries allow you to customize the formatting of messages sent by the plugin. ### Each message has a description of how it is used along with placeholders that can be used. messages: ... ### This is the bot's name which appears in Discord when sending player-specific messages. ### The following placeholders can be used here: ### - {username}: The username of the player sending the message ### - {displayname}: The display name of the player sending the message (This would be their nickname) ### - {world}: The name of the world the player sending the message is in ### - {prefix}: The prefix of the player sending the message ### - {suffix}: The suffix of the player sending the message ### - {botname}: Name of the Discord bot ### ... PlaceholderAPI placeholders are also supported here too! mc-to-discord-name-format: "{botname}" ``` ##### Other additions - Translations have been updated with the latest community contributions from Crowdin. - Added tab completions for the `/mail clear` command. ([#​5132](https://togithub.com/EssentialsX/Essentials/issues/5132)) - Added the `essentials.nick.hideprefix` permission to hide the nickname prefix for those with it. ([#​4995](https://togithub.com/EssentialsX/Essentials/issues/4995)) - Added per command cooldown permissions: `essentials.commandcooldowns.bypass.`. ([#​4759](https://togithub.com/EssentialsX/Essentials/issues/4759)) #### Bug fixes ##### Bugs fixed from 2.19.7 and older versions - Further duplication glitches were fixed in `/recipe`. ([#​5122](https://togithub.com/EssentialsX/Essentials/issues/5122)) - Various performance issues with NPCs and jails have been fixed. ([#​5130](https://togithub.com/EssentialsX/Essentials/issues/5130)) - Playtime statistics in `/whois` no longer overflow. ([#​5177](https://togithub.com/EssentialsX/Essentials/issues/5177)) - Various offhand and inventory related issues have been fixed. ([#​5021](https://togithub.com/EssentialsX/Essentials/issues/5021)) - Doubles are now supported for coordinates in the `/tppos` command in the console. ([#​5231](https://togithub.com/EssentialsX/Essentials/issues/5231)) - Trade signs no longer accept water bottles as a valid trade for a potion. ([#​5260](https://togithub.com/EssentialsX/Essentials/issues/5260)) - An exception is no longer raised in `/tpoffline` when the player's last location is not known. ([#​5290](https://togithub.com/EssentialsX/Essentials/issues/5290)) - Sulk sensors no longer detect vanished players. ([#​5262](https://togithub.com/EssentialsX/Essentials/issues/5262)) - The `/top` command now sends feedback once again. ([#​5302](https://togithub.com/EssentialsX/Essentials/issues/5302)) - The `/editsign` command now calls the `SignChangeEvent`. ([#​5304](https://togithub.com/EssentialsX/Essentials/issues/5304)) - Commands preformed on offline players no longer raise a `NullPoinerException` in some cases. ([#​5339](https://togithub.com/EssentialsX/Essentials/issues/5339)) - **Discord**: The console relay no longer stops working after `/ess reload` in some cases. ([#​5149](https://togithub.com/EssentialsX/Essentials/issues/5149)) - **Discord**: Webhooks should no longer hang the server during shutdown in some cases. ([#​5165](https://togithub.com/EssentialsX/Essentials/issues/5165)) - **Discord**: Translated Discord command descriptions are now properly truncated to account for Discord character limits. ([#​5314](https://togithub.com/EssentialsX/Essentials/issues/5314)) ##### Regressions fixed from 2.20.0 dev builds The following bugs from 2.20.0 development builds have been fixed: - NPC users are once again added to the UserMap properly. ([#​5129](https://togithub.com/EssentialsX/Essentials/issues/5129)) - Servers with large amounts of user data no longer hang for minutes on startup. ([#​5143](https://togithub.com/EssentialsX/Essentials/issues/5143)) - The offhand is no longer used for `/hat`. ([#​5205](https://togithub.com/EssentialsX/Essentials/issues/5205)) - The `/createkit` command works on 1.8.8 once again. ([#​5212](https://togithub.com/EssentialsX/Essentials/issues/5212)) - Sending a mail to all online players works once again. ([#​5263](https://togithub.com/EssentialsX/Essentials/issues/5263)) - The user map now properly expels users from cache after a while. ([#​5331](https://togithub.com/EssentialsX/Essentials/issues/5331)) - **Discord**: Webhook names are no longer sanitized for markdown. ([#​5311](https://togithub.com/EssentialsX/Essentials/issues/5311)) - **Discord Link**: The `/link` Discord command no longer requires administrator privileges. ([#​5197](https://togithub.com/EssentialsX/Essentials/issues/5197)) - **Discord Link**: Synchronizing offline players no longer raises a `NullPointerException` ([#​5338](https://togithub.com/EssentialsX/Essentials/issues/5338)) #### Changes for developers ##### Viewers can now be modified for `DiscordRelayEvent` ([#​5080](https://togithub.com/EssentialsX/Essentials/issues/5080)) `DiscordRelayEvent` now has a `getViewers()` method which returns a mutable list of viewers for the relayed message. ##### Discord Link Module API ([#​3702](https://togithub.com/EssentialsX/Essentials/issues/3702)) With the addition of the Discord Link Module, there is now an API service to access information about a player's Discord account that they have linked. You can obtain an instance of this and use it in tandem with the Discord module API like so: ```java // Gets the API service for EssentialsX Discord Link final DiscordLinkService linkApi = Bukkit.getServicesManager().load(DiscordLinkService.class); final String discordId = linkApi.getDiscordId(player.getUniqueId()); if (discordId == null) { // The player has no Discord account linked. return; } // Gets the API service for EssentialsX Discord which we will use to get the actual user final DiscordService discordApi = Bukkit.getServicesManager().load(DiscordService.class); final InteractionMember member = discordApi.getMemberById(discordId).join(); final String userTag = member == null ? null : member.getTag(); ``` ##### New events EssentialsX 2.20.0 introduces several new events: - `GlobalChatEvent` is fired when players send a message in global chat. ([#​4683](https://togithub.com/EssentialsX/Essentials/issues/4683)) - `LocalChatEvent` is fired when players send a message in local chat. ([#​4683](https://togithub.com/EssentialsX/Essentials/issues/4683)) - `HomeModifyEvent` is fired when a home is created, updated or deleted. ([#​5216](https://togithub.com/EssentialsX/Essentials/issues/5216)) *** For a full commit log, [click here](https://togithub.com/EssentialsX/Essentials/compare/2.19.7...2.20.0).

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• [ ] If you want to rebase/retry this PR, check this box

---

This PR has been generated by Mend Renovate. View repository job log here.