Minecraft Essentials EssentialsX 2.22.0 Update Details
EssentialsX 2.22.0 patches dupe exploits, supports Minecraft 26.1.2 and 1.21.11 drops, and adds AFK timeout commands.
The Minecraft essentials EssentialsX 2.22.0 update has landed, delivering security patches alongside compatibility for recent gameplay drops. According to release notes from gh:EssentialsX/Essentials, this build targets servers running on Paper while closing critical stability flaws.
Content and Minecraft version support
EssentialsX 2.22.0 officially targets Paper builds running Minecraft 26.1.2 as its primary development baseline. In addition to active work on that release, it maintains legacy support for version 1.21.11 alongside older historical releases stretching back to 1.8.8.
Feature drop compatibility
This release brings full mechanical handling for additions introduced across three recent content drops:
- The Copper Age
- Mounts of Mayhem
- Tiny Takeover
Administrators managing Minecraft 26.1.2 servers or networks running Minecraft 1.21.11 servers gain native support for all items, blocks, entities and enchantments packaged within those content expansions.
Platform requirements and incompatibilities
The development team advises running modern Paper software to benefit from asynchronous chunk loading during player teleports, which prevents lag spikes. Certain core commands—including /anvil, /grindstone, /cartographytable, /loom, /smithingtable, and /stonecutter—rely on APIs only available on Paper, while /recipe on 1.12 and newer uses Paper patches to avert duplication exploits present in upstream CraftBukkit.
EssentialsX 2.22.0 actively rejects several alternative environments:
- Folia and its derivatives are unsupported due to risks of user data loss while proper architecture work continues.
- Aggressive forks such as Akarin and Yatopia are blocked due to non-standard engine alterations.
- Bukkit-Forge hybrid software including Mohist, Cauldron, Thermos, Magma, CatServer, and Arclight are unsupported. Operators running Forge, NeoForge, or Fabric should deploy FTB Essentials instead.
- Minecraft versions 1.7.10 and older are completely unsupported.
Administrative controls and configuration additions
Several new configuration keys and commands appear in config.yml to help staff manage automated actions and resource consumption.
Automated AFK commands
Administrators can configure afk-timeout-commands alongside auto-afk-timeout. This setting runs a list of custom console commands once an idle player crosses the duration boundary, superseding the legacy kick toggle.
When configuring afk-timeout-commands, the list must include an action that disconnects the user or ends their inactive status; otherwise, Essentials executes the entry every second. Placeholders {USERNAME} and {KICKTIME} provide the player's account name and idle duration in minutes. Leaving the command list blank while setting a positive timeout preserves the traditional disconnect message.
Moderation and performance toggles
baltop-entry-limit: Restricts the total records cached for/balancetopto prevent runaway memory usage on communities with large cumulative player bases. A value of-1removes the ceiling.gamemode-change-preserve-flying: When set to true, players holding theessentials.flypermission remain airborne when transitioning from spectator or creative mode into survival or adventure mode.essentials.whitelist.bypass: Grants permission to join the server even when a whitelist is active and the account is not listed on it./powertoollist: Displays every command assigned to held items configured through/powertool.- Kit slot targeting: Kits now accept
slot:<id>prefixes on item definitions, enabling direct inventory placement when building kits via/createkit.
What this breaks and upgrade steps for server owners
Because EssentialsX 2.22.0 addresses multiple item duplication glitches and server crash vectors, the project team recommends all existing deployments upgrade immediately.
Hosts running versions 2.21.1 or 2.21.2 can drop the new jar into place and keep their current config.yml. However, accessing the new settings requires manually appending the keys or renaming the existing configuration folder so the plugin can generate a fresh template. Deployments upgrading from 2.21.0 or earlier must consult intermediate changelogs for migration guidance.
Platform-specific quirks remain present on unpatched servers:
- On CraftBukkit and Spigot, respawn anchor charges deplete regardless of anchor spawn settings due to an upstream engine bug fixed solely in Paper.
- On Spigot 1.17.1 and newer, cross-world teleportation resets flight status because of vanilla behaviour shifts, an issue circumvented on Paper.
What players will notice on upgraded servers
Players exploring servers on the general Minecraft server list will experience fewer exploits, cleaner kit deliveries, and altered idle handling.
When receiving kits, equipment can now land directly in designated hotbar or armour slots rather than filling standard inventory pockets. Inactive players may also encounter custom server punishments—such as small currency deductions or branded notifications—instead of standard disconnect screens when their idle timer elapses. Furthermore, staff shifting out of creative modes will no longer plunge to the ground if flight preservation is enabled.
Common questions
- Can I run EssentialsX 2.22.0 on Folia?
- No. Folia and its forks are not supported in EssentialsX 2.22.0, and using it risks userdata loss while dedicated Folia support remains in development.
- Do I have to reset my config.yml when upgrading from 2.21.2?
- No, existing configs from 2.21.1 and 2.21.2 remain functional. You only need to edit your file or generate a fresh one if you want to use new settings like afk-timeout-commands.
- What command lists all active powertool bindings?
- Administrators and players can inspect all commands tied to items via the new /powertoollist command.
- Tags
- minecraft
- Share
Published · 4 min read