JoinGG

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.

SweetMask · 4 min read

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 /balancetop to prevent runaway memory usage on communities with large cumulative player bases. A value of -1 removes the ceiling.
  • gamemode-change-preserve-flying: When set to true, players holding the essentials.fly permission 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

SweetMask

Published · 4 min read

All articles

Keep reading

Game Updates · Minecraft

Minecraft 26.4 Snapshot 2 Overhauls Fog and F3

Minecraft 26.4 snapshot 2 updates render fog, redesigns the F3 debug screen, bumps pack versions, and fixes chunk crashes for servers.

· 3 min read