Releases: EssentialsX/Essentials
EssentialsX 2.19.1 - The Otherside Update Part 2
After months of hard work from our contributors, EssentialsX 2.19.1 is here! 🎉
This release adds 1.18.1 support, and contains countless new features and bug fixes. 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!
Finally, a massive thanks to our community members who have assisted countless people on GitHub and MOSS, including @triagonal, @JasonHorkles, @Evidentsinger14, @Chew, @Laarryy and many others.
In addition, a shoutout to our dozens of supporters on Patreon, GitHub Sponsors and Ko-fi, including:
- AKP
- madscientist032
- @aternosorg
- @pebblehost
- ...plus 26 more supporters!
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:
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.17.1
and1.18.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
, and1.16.5
- 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.
- Paper supports all properly-written plugins for 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. 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.19.1
If you're upgrading from 2.19.0, you can keep your current EssentialsX config file. However, 2.19.1 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.18.2 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.
Important changes
Teleport safety world height changes (#4641, #4667)
The world height is now properly taken into account when determining if a location is safe. EssentialsX should now take into account y-levels of 0 to 255, -64 to 319, and any custom y-level defined by a datapack.
New features
EssentialsX now supports 1.18.1 (#4640, #4667)
EssentialsX now has full support for Minecraft 1.18.1, including support for the new items in /give
, /item
and kits, new 1.18 world height changes, and new NMS/OBC mappings for accessing internal CraftBukkit code.
EssentialsX also no longer warns when installed on 1.18.1 servers.
New support for multiple TPA requests (#3801)
You can now receive and accept/deny TPA requests from multiple players at a time.
You can edit the maximum amount of TPA requests a player can have at once by changing tpa-max-amount
in the config:
# The maximum amount of simultaneous TPA requests that can be pending for any given user.
# Once at this threshold, any new TPA requests will bump the oldest TPA requests out of queue.
# Defaults to 5.
tpa-max-amount: 5
New Discord module features (#4520, #4541, #4620, #4534)
New action
message type
A Minecraft -> Discord message type, sent when a player uses the /me
or /action
commands.
# 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:
...
# Action messages sent when a player runs the /me or /action commands.
action: primary
# 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 runs the /me or /action command.
# The following placeholders can be used here:
# - {username}: The name of the user who ran the command
# - {displayname}: The display name of the user who ran the command
# - {action}: The action (message) the user used in the command.
# ... PlaceholderAPI placeholders are also supported here too!
action: ":person_biking: {displayname} *{action}*"
New /discordbroadcast
command
Allows you to send one off messages from Minecraft to Discord. Supports markdown and tab completes server emotes.
gCn04at9cG.mp4.mp4
New /discord
command
Sends a configured Discord invite link.
# The Discord invite URL that will be shown when a player when using the /discord command or in other areas.
discord-url: "https://discord.gg/invite-code"
New console regex filters
Allows you to filter certain console lines if they match a regex pattern.
# Console relay settings
# The console relay sends every message shown in the console to a Discord channel.
console:
...
# A regex pattern which will not sending matching console messages to Discord.
console-filter: ""
New /mail sendtempall
command (#4561)
Allows you to send a temporary mail to all users on the server with /mail sendtempall <expire time> <message>
. Requires the essentials.mail.sendtempall
permission.
New /playtime
command (#4562, #4619)
You can now run /playtime
to view your time in game. If you have the essentials.playtime.others
permission, you can also view the playtime of other players.
Jail notifications (#4576)
Players with the essentials.jail.notify
permission will now be notified if someone is jailed.
Kits subfolder and multiple kit files (#4407)
You can now optionally create a plugins/Essentials/kits/
folder (in addition to the default kits.yml
file) and organise your kits into multiple files within that folder. Kit files in this folder use the same structure as the normal kits.yml
file.
For example, you could have a structure like this:
plugins/Essentials/
|--- kits/ (optional)
|--- cosmetics.yml
|--- rewards.yml
|--- staff.yml
|--- kits.yml (required)
All kits will have the same name in-game as they do in the file where they are defined. Kits with the same name in different files will be ignored.
If you set pastebin-createkit: false
in your config.yml
and use /createkit
, it will always place new kits in the default plugins/Essentials/kits.yml
. If you want to place your /createkit
kits into separate files, we recommend setting pastebin-createkit: true
and manually adding the kit to the correct file as desired.
Other additions
EssentialsX 2.19.0 - The Otherside Update Part 1
After months of hard work from our contributors, EssentialsX 2.19.0 is here! 🎉
This release contains a new Discord addon, countless new features, bug fixes and internal improvements. Keep reading to see all the new additions!
Thanks to @JRoy, @triagonal, @pop4959, @jpenilla and all our other contributors who contributed to this release, as well as to everyone who has contributed to translations on Crowdin!
Finally, a massive thanks to our community members who have assisted countless people on GitHub and MOSS, including @triagonal, @JasonHorkles, @Evidentsinger14, @Chew, @Laarryy and many others.
In addition, a shoutout to our dozens of supporters on Patreon, GitHub Sponsors and Ko-fi!
A particular shoutout goes to our Hero tier supporters, including:
- AKP
- @aternosorg
- @pebblehost
- ...and 3 other anonymous Heroes
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:
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.16.5
and1.17.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
, and1.15.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
,/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. 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.19.0
If you're upgrading from 2.18.2, you can keep your current EssentialsX config file. However, 2.19.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.18.1 or older versions of EssentialsX? See the previous update changelogs.
New module: EssentialsX Discord! (#3844) 🎉
EssentialsX now has a Discord addon, which lets you easily bridge your Minecraft server with Discord with a bloat free and easy to understand configuration! You can read more about EssentialsX Discord and see how to get started here.
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.
Teleport requests can be dropped in rare cases
Due to a long-standing bug with teleport requests, in very rare cases teleport requests (/tpa
, /tpahere
, /tpaall
) may expire instantly. We're working on an overhaul of the teleport request system with new features. If you encounter this bug on your server, it should be fixed in a future release.
Important changes
Userdata format changes (#4072)
Due to a few changes in data format, once you upgrade to 2.19.0, you will not be able to downgrade your userdata to older versions. We strongly recommend taking a full backup of your plugins/Essentials/userdata/
folder and plugins/Essentials/usermap.csv
file before you update from 2.18.2 to 2.19.0 if you ever wish to downgrade in the future.
Currency symbol handling improvements (#3628, #3946, #3987)
Some handling of currency symbols has been improved to be more consistent. If you encounter issues with kits.yml
or currency on signs after updating to 2.19.0, you may need to update them to match the format set in your config (or simply change them to $123.45
, which should always work).
You can also now set the currency symbol to empty and use translation keys to handle currency formatting, if you prefer.
New features
EssentialsX now supports 1.17.1 (#4211, #4324)
EssentialsX now has full support for Minecraft 1.17.1, including support for the new items in /give
, /item
and kits, new 1.17 mobs in /spawnmob
and new NMS/OBC mappings for accessing internal CraftBukkit code.
EssentialsX also no longer warns when installed on 1.16.5 servers.
New mail features (#3710)
The entire mail system has been rewritten to add support for temporary mails, read status, and the abiltiy to clear individual mails.
You can use /mail sendtemp <player> <expire time> <message>
to send message which will expire at the given time or /mail clear <number>
to clear the mail at the given position.
New /warpinfo
command (#3820)
You can now use /warpinfo
to view information about a warp:
New cancel-afk-on-chat
setting (#3863)
You can now control whether chat cancels AFK for players separate to other types of interaction:
# Should we automatically remove afk status when a player sends a chat message?
cancel-afk-on-chat: true
New kit-auto-equip
setting to auto equip armor from kits (#3704)
You can now set kit-auto-equip
to true
in config.yml
to automatically equip armor when players redeem kits.
# When enabled, armor from kits will automatically be equipped as long as the player's armor slots are empty.
kit-auto-equip: false
New jail-online-time
setting (#3705)
You can now set jail-online-time
to true
in config.yml
to only count down time for jailed players while they're online.
# Whether or not jail time should only be counted while the user is online.
# If true, a jailed player's time will only decrement when they are online.
jail-online-time: false
Option to disable EssentialsX's custom full server message (#3899)
You can now disable EssentialsX's custom "This server is full!" message and restore the vanilla message by setting use-custom-server-full-message
to false
in config.yml
:
# Should Essentials override the vanilla "Server Full" message with its own from the language file?
# Set to false to keep the vanilla message.
use-custom-server-full-message: true
Option to disable message social spy (#3910)
You can now disable private messages showing in social spy by setting socialspy-messages
to false
in config.yml
:
# Whether social spy should spy on private messages or just the commands from the list above.
# If false, social spy will only monitor commands from the list above.
socialspy-messages: true
This is useful if you only want to monitor specific commands in social spy.
New /kitreset
command to reset kit cooldowns (#3909)
You can now run /kitreset <kit>
to reset the cooldown for a kit. If you have the essentials.kitreset.others
permission, you can also reset kits for other players with /kitreset <kit> [player]
.
You can combine this command with single-use kits to more precisely control when players are allowed to claim kits.
EssentialsX Chat: world aliases (#3912...
EssentialsX 2.18.2 - The 1.16.4 Update
EssentialsX 2.18.2 is here! 🎉 This release features full 1.16.4 support, as well as a few bug fixes and quality-of-life improvements.
Thanks to @JRoy, @pop4959, @Chew, and all our other contributors who contributed to this release!
In addition, thanks to our donors, in particular our Hero tier supporters on Patreon:
- AKP
- Wasted Ticks
If you'd like to support the hard work that goes into EssentialsX, you can join our Patreon to support on a monthly basis, or make a one-off donation on Ko-fi. We'd appreciate any donations, especially if your server makes money - all donations enable us to continue spending hours of our free time working on and improving EssentialsX for everyone.
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.15.2
and1.16.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
, and1.14.4
- these versions are still supported, but are not a priority for us, and may be dropped in a future release.
EssentialsX does not support the following Minecraft versions or server software:
- 🛑
1.7.x
or below - we do not provide support for these versions. - 🛑 Cauldron, Thermos, Magma, CatServer, or any other Forge/Bukkit hybrid server software - 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.
We recommend using the latest version of Paper, as it includes several performance enhancements over Spigot. EssentialsX 2.18+ includes significant improvements that are only effective on Paper, most notably asynchronous chunk loading which reduces lag spikes during player teleports.
Upgrading to 2.18.2
If you're upgrading from 2.18.1, you don't need to update your EssentialsX config. However, 2.18.2 adds a couple of 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 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.
Important changes
New option to prevent players from responding to vanished players (#3703)
In previous versions, the /reply
command would allow you to reply to a player even after they vanished, exposing that the player was still on the server. A new option to the config has been added to configure this behavior, last-message-reply-vanished
. This will default to allowing users to reply to vanished players (true
) for old configs, but will be set to block replying to vanished players for new configs (false
). So make sure to add last-message-reply-vanished
to your config if you're updating from 2.18.1 and you'd like to configure this.
# Changes the default /reply functionality.
# If true, /reply will not check if the person you're replying to has vanished.
# If false, players will not be able to /reply to players who they can no longer see due to vanish.
last-message-reply-vanished: false
New features
New virtual inventory commands (#3704)
There are new commands to let you open virtual anvils (/anvil
), cartography tables (/cartographytable
), grindstones (/grindstone
), looms (/loom
), smithing tables (/smithingtable
), and stone cutters (/stonecutter
).
Note: due to technical limitations, this is only available on Paper and on 1.15.2 or higher.
Other additions
- Internal codestyle has been standardized and is now enforced. (#3701)
- Internal tab-completion code for various commands has been minimized.
- Added ability to customize balancetop lines via translation files. (#3626)
- Added plugin names in tab-completion and improve command discovery
/help
. (#3713, #3675) - Improved the unsupported platform messages to make them more specific.
- Changed console
/sell
logging messages to use usernames instead of nicknames (#3693)
Bug fixes
Bugs fixed from 2.18.1 and older versions
- Fixed commands like
/editsign
not always targeting the correct block when looking below your head-level (#3763) - Fixed users tablist name getting reset after their AFK status changed. (#3624)
- Fixed
/paytoggle
displaying the opposite message than the action being taken. - Fixed
/time
throwing an exception when used in console. (#3622) - Fixed debug messages showing sometimes when a user tab completed in certain commands. (#3739)
- Fixed spaces in backup commands not being properly handled. (#3762)
- Fixed color codes appearing in the
trade.log
file. (#3699) - Fixed
/clear <player> <item>
not clearing matched items from offhand. (#3715) - Fixed some
/sell
and/worth
messages displaying{1}
instead of the item's actual value. (#3656) - Fixed
/sethome
preventing modifying homes when surpassed set-home limit. (#3776)
Regressions fixed from 2.18.1.x dev builds
- Fixed an ABI breakage in
IEssentials#getOnlineUsers
. - Fixed multiple regressions in
/clearinventory
that caused unexpected behavior than previously expected. - Fixed a regression in
/lightning
where attempting to smite another player wouldn't run theessentials.lightning.others
permission check (#3671) - Fixed a regression in
/delhome
where tab completing would not show user homes properly and/or throw a NPE. (#3775)
For a full commit log, click here.
EssentialsX 2.18.1 - The Little Big Update
EssentialsX 2.18.1 is here! 🎉 This release features full 1.16.2 support, as well as a few bug fixes and quality-of-life improvements.
Thanks to @JRoy, @pop4959, @triagonal and all our other contributors who contributed to this release!
In addition, thanks to our donors, in particular our Hero tier supporters on Patreon:
- AKP
- Wasted Ticks
- and 1 anonymous Hero
If you'd like to support the hard work that goes into EssentialsX, you can join our Patreon to support on a monthly basis, or make a one-off donation on Ko-fi. We'd appreciate any donations, especially if your server makes money - all donations enable us to continue spending hours of our free time working on and improving EssentialsX for everyone.
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.15.2
and1.16.2
- 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
and1.14.4
- these versions are still supported, but are not a priority for us, and may be dropped in a future release.
EssentialsX does not support the following Minecraft versions or server software:
- 🛑
1.7.x
or below - we do not provide support for these versions. - 🛑 Cauldron, Thermos, Magma, CatServer, or any other Forge/Bukkit hybrid server software - EssentialsX is built for the Bukkit API, which does not properly support mods, and so we do not provide support for these hybrid servers. For modded servers, use SpongeForge and Nucleus, or an alternative mod for Forge or Fabric.
We recommend using the latest version of Paper, as it includes several performance enhancements over Spigot. EssentialsX 2.18+ includes significant improvements which are only effective on Paper, most notably asynchronous chunk loading which reduces lag spikes during player teleports.
Upgrading to 2.18.1
If you're upgrading from 2.18.0, you don't need to update your EssentialsX config. However, 2.18.1 adds a couple of new options which 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 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.
Other known issues
These bugs will be fixed in 2.18.2. They may already be fixed in dev builds - if these affect you, you should download a dev build.
/time set
and/time add
do not work from the console. (#3621)- When players exit AFK mode, their prefix/suffix might be missing from the tab list. (#3606)
Important changes
/tpr
no longer caches locations on startup by default (#3496)
In 2.18.0, EssentialsX would generate and cache locations for the /tpr
command when the server started up. However, on CraftBukkit and Spigot this resulted in several sync chunk loads during startup, which significantly slowed down startup on these server implementations. As a countermeasure, /tpr
no longer caches locations on startup by default, though it will still cache locations after the /tpr
command has been used once after startup.
If you're using Paper, or if you're using Spigot and are willing to tolerate the slow startup, you can re-enable this by adding pre-cache: true
on a new line inside tpr.yml
.
EssentialsX Protect: protect.prevent.creeper-explosion
no longer cancels player damage (#3604)
Previously, disabling creeper explosion block damage with the protect.prevent.creeper-explosion
setting would also prevent players taking damage from the explosion. This has now been changed to match the other protect.prevent.<type>-explosion
settings, and this allows you to prevent block damage while allowing players to take damage from creeper explosions. As before, you should use protect.prevent.creeper-playerdamage
to prevent players taking damage from creeper explosions.
Teleportation safety now respects the world border (#3499, #3536)
EssentialsX's teleport safety mechanism will now prevent you teleporting outside the vanilla world border, instead placing you safely inside the world border. This prevents players taking damage when using /tpr
if you didn't manually set a maximum range for /tpr
locations.
Note that this won't apply if you are in creative mode or god mode, as teleport safety is disabled if you're invulnerable. If you'd like to disable teleport safety entirely, you can do so using the teleport-safety
and/or force-disable-teleport-safety
options in config.yml
.
New features
EssentialsX Spawn now supports respawn anchors (#3498)
You can now use the respawn-at-anchor
config option (disabled by default) to configure EssentialsX Spawn to respect respawn anchors set by players, instead of teleporting players to their home/bed:
# When users die, should EssentialsSpawn respect users' respawn anchors?
respawn-at-anchor: false
/editsign
now tab-completes existing sign contents (#3497)
If you attempt to edit a line that already has text on it, /editsign
will now suggest the existing text in tab completion, including any formatting codes. This makes it even easier to update existing signs!
New amplifier:<value>
attribute for potion item meta (#3614)
When defining custom potion effects in kits, /potion
, /give
and /item
, you can now use amplifier:<value>
in place of power:<value>
to specify a potion strength value as a "raw" Mojang strength value. The difference between amplifier:<value>
and the existing power:<value>
is that amplifier
always uses the value that Mojang stores in NBT rather than the strength displayed in tooltips, whereas power
adjusts inputs of 1-3 to match tooltips, which prevents spawning level IV (strength 3) potions.
TL;DR: you can now use amplifier:3
to spawn in level IV custom potions.
/spawner
delays now work correctly (#3239)
You can now use /spawner <mob> [delay]
to set a custom delay for a mob spawner. While this feature may have worked in the past, it has been reimplemented to use Bukkit API where possible and NMS as a fallback, which enables it to work on newer versions of Minecraft.
Other additions
- EssentialsX now supports sign functionality on crimson and warped signs. (#3487)
- Internal command code has now been refactored for improved readability. (#3336, #3337)
- The
/skull
command now pulls player skin data asynchronously. (#3579, #3337) /paytoggle
is now a toggle command, allowing admins to toggle payment status for other players and use wildcards. (#3087, #3337)
Bug fixes
Bugs fixed from 2.18.0 and older versions
- The minimum range setting for
/tpr
now correctly excludes a square shape in the centre of the world. (#3480) /togglejail
no longer teleports jailed players back to their previous location when they are unjailed ifteleport-back-when-freed-from-jail
is set tofalse
. (#3522)- Fixed a rare stacktrace when players disconnect that was caused by an internal CraftBukkit change. (ab545dc)
- Fixed a regression in
/tpaccept
where accepting a teleport request wouldn't always clear pending teleport requests if a teleport failed. (#3567) - Fixed a regression in teleport commands where players would be charged twice for teleports with a command cost. (#3601)
/tree
and/bigtree
now work on 1.12.2 and prior versions. (#3569)- Teleport safety no longer allows teleporting into lava on older versions of Minecraft. (#3537)
/list
's tab completion no longer reveals the online presence of groups where all the online members are vanished. (#3616)/eco take ** <percentage>
now works properly. (#3547, #3337)- AntiBuild: Blocks in the piston blacklist can no longer be pulled by a sticky piston. (#3610)
- GeoIP: Now shows a better message when GeoIP hasn't been configured. (#3568)
- Protect:
protect.prevent.creeper-explosion
no longer cancels player damage (#3623) - Spawn:
/setspawn
and/spawn
now correctly check permissions for tab completion. (#3339, #3337)
Regressions fixed from 2.18.0.x dev builds
- Fixed a regression in
/gamemode
which prevented the console changing players' gamemodes. (#3590) - Fixed a regression in
/time
where/time set
did not correctly check theessentials.time.set
permission. (#3616)
For a full commit log, click here.
EssentialsX 2.18.0 - The RGB Update
After many months of hard work, EssentialsX 2.18.0 is here! 🎉
This is the biggest EssentialsX release yet, and comes with tons of new features, brand new API and full support for 1.16.1, including RGB colours!
Thanks to @JRoy, @pop4959, @triagonal, @darbyjack, @latiku, @zml2008, @JasonHorkles and many other people who have contributed to this release!
In addition, thanks to our donors, in particular our Hero tier supporters on Patreon:
- AKP
- Wasted Ticks
- and 1 anonymous Hero
If your server makes money and you'd like to support the hard work that goes into EssentialsX, you can join our Patreon to support on a monthly basis, or make a one-off donation on Ko-fi.
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.15.2
and1.16.1
- EssentialsX targets these versions as a priority. ⚠️ 1.8.8
,1.9.4
,1.10.2
,1.11.2
,1.12.2
,1.13.2
and1.14.4
- these versions are still supported, but are not a priority for us.
We recommend using the latest version of Paper, as it includes several performance enhancements over Spigot. EssentialsX 2.18.0 includes significant improvements which are only effective on Paper, in particular async chunk loading and the return of /recipe
.
Upgrading to 2.18.0
If you're upgrading from 2.17.2 or a recent dev build, you don't need to update your EssentialsX config. However, 2.18.0 adds several new features which you may want to configure, and to do so you'll need to update your config. Read on for a list of changes and new config options.
Upgrading from older versions of EssentialsX? See the previous update changelogs.
New features
EssentialsX now supports 1.16.1! (#3408, #3394, #3422)
EssentialsX has been updated to support the new items and mobs in 1.16.1! You can now spawn in new items using the new aliases in 2.18.0, and the new Nether mobs can be spawned in using /spawnmob
.
In addition, you can now use RGB colours throughout EssentialsX using the &#RRGGBB
format, including in chat, on signs, in /itemname
and /itemlore
, and in nicknames, prefixes and suffixes:
EssentialsX now supports async chunk loading for teleports on Paper! (#3102)
EssentialsX now performs teleport safety checks by loading chunks asynchronously where possible. This significantly reduces TPS drops from teleportation when EssentialsX is installed on Paper 1.9+. CraftBukkit and Spigot don't support these async chunk loading APIs, so if you're using CraftBukkit or Spigot, you should consider switching to Paper to take advantage of these improvements.
New /editsign
command (#3415)
You can now update the content of signs you've already placed using the /editsign
command. For example:
- Running
/editsign set 1 &#b8ffbaMint green!
while looking at a sign will set the first line of the sign toMint green!
- Running
/editsign clear 1
will clear the first line of the sign - Running
/editsign clear
will clear the entire sign.
Note: to use formatting in /editsign
, you need the essentials.editsign.<format>
permissions - see the Color Permissions wiki page for more information.
New /itemlore
command (#3331)
You can now create and modify lore on items using the /itemlore
command! For example:
- Running
/itemlore add [text]
will add text to a new line at the end of the current lore on your currently-held item - Running
/itemlore set 1 [text]
will replace the first line of the lore with new text - Running
/itemlore clear
will clear the lore from the item
New /rest
command to reset phantoms (#3205)
You can now use the /rest
command to reset your last sleep time and stop phantoms from spawning.
messages.properties
now supports UTF-8 properly (#3358)
At last, you can now type section signs (§
) and non-Latin characters straight into your messages files, without needing to use \uXXXX
escape codes!
Before:
deleteHome=\u00a76Home\u00a7c {0} \u00a76has been removed.
deleteJail=\u00a76Jail\u00a7c {0} \u00a76has been removed.
deleteKit=\u00a76Kit\u00a7c {0} \u00a76has been removed.
deleteWarp=\u00a76Warp\u00a7c {0} \u00a76has been removed.
After:
deleteHome=§6Home§c {0} §6has been removed.
deleteJail=§6Jail§c {0} §6has been removed.
deleteKit=§6Kit§c {0} §6has been removed.
deleteWarp=§6Warp§c {0} §6has been removed.
messages.properties
now includes command usage and descriptions (#3284)
You can now customise and translate command usage and description messages in your messages.properties
file by using the <command>CommandUsage
and <command>CommandDescription
keys. For example:
balancetopCommandDescription=Gets the top balance values.
balancetopCommandUsage=/<command> <page>
banCommandDescription=Bans a player.
banCommandUsage=/<command> <player> [reason]
These strings are also on Crowdin, and translators have started to translate the commands already. If you'd like to contribute to translations, you can contribute on Crowdin.
Note: don't remove or translate /<command>
in usage strings, as this will break the usage message. If you notice this in any Crowdin translations, it would help if you could change these to include /<command>
and report the string so we can fix it.
EssentialsX now supports LuckPerms contexts! (#3320, #3476)
EssentialsX now includes several LuckPerms permission contexts, allowing you to do complex conditional permission setups! You can now set certain permissions to only apply when a user is/isn't AFK, muted, vanished or jailed, as well as setting specific permissions for players in specific jails.
The full list of contexts is as follows:
essentials:afk=<true/false>
essentials:muted=<true/false>
essentials:vanished=<true/false>
essentials:jailed=<true/false>
essentials:jail=<jail name>
Note: you need to install LuckPerms 5.0 or newer and Vault to use this feature.
Option to always run backups even if users haven't logged in (#3258)
In the past, EssentialsX's server backup system only ran if players had been online since the last backup. However, you can now configure it to always run a backup even if no players have logged in:
backup:
#...
# If true, the backup task will run even if there are no players online.
always-run: false
/heal
removing potion effects is now optional (#2754)
Previously, running /heal
would always clear potion effects for players. This can now be disabled by setting the remove-effects-on-heal
to false
in config.yml
.
Temporary mutes can now have a length limit (#2807)
Similar to temporary bans, you can now set a maximum length for tempmutes using the max-mute-time
config option:
# Set the maximum time /mute can be used for in seconds.
# Set to -1 to disable, and essentials.mute.unlimited can be used to override.
max-mute-time: -1
Jailed players can now build if given specific permissions (#2503)
You can now use the following permissions to allow players to build while jailed:
essentials.jail.allow-break
to allow breaking blocksessentials.jail.allow-place
to allow placing blocksessentials.jail.allow-block-damage
to allow hitting blocksessentials.jail.allow-interact
to allow interacting with blocks (usually right-clicking)
Teleporting to offline players (#2505)
You can now teleport to where a user last logged out using the /tpoffline <player>
command (or /otp
).
New EssentialsX Protect settings (#3111, #3210, #2504)
EssentialsX Protect now has several new config options to limit item damage, ender crystal explosions and various mob behaviours:
protect:
prevent:
# ...
# Prevents the following events destroying dropped items
lava-itemdamage: false
tnt-itemdamage: false
tnt-minecart-itemdamage: false
fireball-itemdamage: false
witherskull-itemdamage: false
creeper-itemdamage: false
# Prevents ender crystals from exploding
ender-crystal-explosion: false
# Prevents beds and respawn anchors from exploding
bed-explosion: false
respawn-anchor-explosion: false
# Prevents zombies from breaking down doors
zombie-door-break: false
# Prevents Ravagers from stealing blocks
ravager-thief: false
# Prevents sheep from turning grass to dirt
sheep-eat-grass: false
Option to dismount passengers before teleporting (#3069)
Players cannot teleport while they have passengers. Previously, teleports would silently fail, but you can now configure this behaviour:
# If a player has any passengers, the teleport will fail. Should their passengers be dismounted before they are teleported?
# If this is set to true, Essentials will dismount the player's passengers before teleporting.
# If this is set to false, attempted teleports will be canceled with a warning.
teleport-passenger-dismount: true
You can add the hidden force-passenger-teleport: true
option to your config to revert this behaviour.
Option to show real names on /list
(#3117)
You can now optionally configure /list
to show players' real names in brackets in /list
:
# Displays real names in /list next to players who are using a nickname.
...
EssentialsX 2.17.2: The Bees Update
EssentialsX 2.17.2 is here! This release comes with full 1.15.x support, as well as a couple new features and various bug fixes.
Thanks to @pop4959, @triagonal, @darbyjack, @Ichbinjoe, @AgentTroll, @JRoy, @CmdrKittens, @JasonHorkles and many other people who have contributed to this release!
In addition, thanks to our supporters on Patreon, in particular our Hero tier supporters:
- AKP
- Wasted Ticks
- ...and 2 other patrons
EssentialsX supports SpigotMC's "CraftBukkit" and Spigot server software, as well as Paper. We recommend using the latest version of Paper, as it includes several performance enhancements over Spigot and is fully compatible with Spigot plugins. Specifically, EssentialsX is designed to work on the following Minecraft versions:
⚠️ 1.8.8
,1.9.4
,1.10.2
,1.11.2
,1.12.2
and1.13.2
- these versions are still supported, but are not a priority for us.- ✅
1.14.4
and1.15.2
- these versions are regularly tested against.
NOTE: GeoIP changes
As you may have noticed, older versions of EssentialsX GeoIP will cause errors and no longer keep their databases up-to-date. You'll need to follow the new setup guide to get GeoIP up and running again.
Upgrading to 2.17.2
Except for GeoIP, EssentialsX 2.17.2 does not require any config changes from 2.17.1. However, 2.17.2 adds some new settings to config.yml
- to use these, you can either generate a new config.yml
or add them to your existing config.
Upgrading from older versions of EssentialsX? See the previous update changelogs.
New features
- You can now run
/delkit <kit>
to delete a kit. (b97eb12, #2908) - You can now specify more different types of projectile in
/fireball
, and control whether players have access to each type using permissions. (60c4e75, ff9f712) - You can now disable logging command blocks commands to the console by setting
log-command-block-commands: false
inconfig.yml
. (#2599) - You can now prevent players putting certain materials on as hats by giving them the permission
essentials.hat.prevent-type.<material>
. (#2574) - The
spawn-if-no-home
config option from the original Essentials has been re-added. (#2757) - You can now spawn in bees with
/spawnmob
(or kill them with/killall
, if you're a monster). (#2873) - You can now use UUIDs in more commands. (#2606)
- You can now include
|
characters in item lore by prepending it with a\\
. (#2831) - You can now add custom aliases on all versions using the
custom_items.yml
file. (#2895) - Beezooka! (#3003)
- AntiBuild: You can now use the
build: true
meta with LuckPerms. (4ce7dfa) - AntiBuild: "You are not permitted to..." messages now have a nicer-looking item name. (a2e0912)
- Chat: You can now use the
{USERNAME}
placeholder in chat formats if you want to include the unformatted username. (#2781) - Protect: You can now control entity transformations on 1.13.2 and above. (#2836, #2942)
Bug fixes
- Trade signs created on 1.12.x or below now work properly on 1.13+. (2c33fb6)
- The
player:<player>
metadata for spawning in player heads now works on all versions. (5f9eb22, 219012b) - The plugins now build on Java 9+. (#2871)
- You can now set one-word AFK messages. (#2876)
- Players in jail can no longer change their gamemode. (#2875)
- Command cooldowns now persist properly across server reboots. (#2888)
/unlimited
no longer corrupts user data. (#2811)/unbanip
now broadcasts unbans to players with theessentials.banip.notify
permission, not theessentials.ban.notify
permission. (#2774)- If an error occurs while copying
items.json
for the first time, the error message will now stateitems.json
instead ofitems.csv
. (6a7cf39) - EssentialsX will no longer assume that the player has a primary group, fixing issues with PEX 2.0 and potentially other permissions plugins. (1c4ce7b)
- Item resolvers providing item names to tab complete now works properly. (#2910)
- Builds of EssentialsX compiled against JDK9 will now run on Java 8. (fa06cd8)
- EssentialsX no longer displays its own bed spawn message on 1.15+. (#2926)
- Items which were renamed or replaced in 1.14 can now be spawned in on 1.13.x. (d92f5ce)
- Filtering commands for the autocompletion in 1.13+ is now more efficient, particularly on outdated unsupported permissions plugins. (#3026)
/fireball
now works on 1.8.8 again. (#3027)- GeoIP: The new MaxMind GeoLite2 API and license key system is now supported. (#2926)
- Nyan.
API changes
UserBalanceUpdateEvent
now includes aCause
. (#2824)
EssentialsX 2.17.1: The Don't-Dupe-My-Items Update
EssentialsX 2.17.1 is now out, fixing several bugs including a dupe exploit on 1.14.4 - you should update as soon as possible.
This version of EssentialsX supports the following server software:
- Spigot "CraftBukkit", Spigot and Paper (recommended) for
1.8.8
,1.9.4
,1.10.2
,1.11.2
,1.12.2
,1.13.2
, and1.14.4
- Glowstone
2018.10
onwards for Minecraft 1.12.2
Upgrading to 2.17.1
EssentialsX 2.17.1 does not require any config changes from 2.17.0.
Upgrading from older versions of EssentialsX? See the previous update changelogs.
Bug fixes
essentials.keepinv
no longer duplicates items on Spigot "CraftBukkit", Spigot and Paper for 1.14.4. If you are usingessentials.keepinv
, you need to update EssentialsX as soon as possible.- The locale messages for
/tpauto
are now included in the EssentialsX jar, fixing missing message errors. - Signs placed on walls are now correctly protected on Minecraft versions below 1.12.2.
/ess version
no longer complains when running on 1.14.4./r
and/reply
now show up correctly in the command autocomplete on 1.13 and above.
Special thanks
As usual, a massive thanks to all of the volunteers who have spent their time providing support on Discord and GitHub, especially over the past few weeks while I've been away. In addition, thanks to @darbyjack and @pop4959 for fixing bugs that have appeared in the mean time. Finally, thanks to everyone who has donated to the project, in particular our Hero donors on Patreon:
- AKP
- Wasted Ticks
- YouthInRevolt
- ...and 1 other patron
EssentialsX 2.17.0: The 1.14 Update
EssentialsX for 1.14.x is here! This release includes 1.14.3 support, plus some new features and several bug fixes.
This version officially supports the following server software:
- Spigot "CraftBukkit", Spigot and Paper (recommended) for
1.8.8
,1.9.4
,1.10.2
,1.11.2
,1.12.2
,1.13.2
and1.14.3
- Glowstone
2018.10
onwards (for Minecraft 1.12.2)
Upgrading from 2.16.1
You should be able to just replace the EssentialsX jars from 2.16.1 with new jars for 2.17.0 without any issues. However, there are some things to note:
- If you have players who use NetEase Minecraft (Minecraft China), you need to set
safe-usermap-names: false
! If you don't, your players may lose their homes and balance.
New features
/mute
now lets you specify a reason. For example:/mute MD678685 10m Swearing in public chat
. (#1557)/near
is now sorted by distance from nearest to furthest. (#2158)- The
teleport-back-when-freed-from-jail
option inconfig.yml
lets you disable teleporting players back to their prevoius location prior to being jailed. (#1949) - The new
/tpauto
command allows players to automatically accept/tpa
requests. (#2310) - The
bypass-sleep-when-afk
option inconfig.yml
lets you control whether night will pass if AFK players aren't sleeping. (#2329) - Attempting to use a warp sign without permission for that warp will now give you an error message. (#2450)
/back
now lets you teleport other players to their last locations by including their usernames if you haveessentials.back.other
. (#2451)- You can now use
/rtoggle
to control your own personallast-message-reply-recipient
setting. (#2455) /exp
now works more like/eco
. (#1953)- Teleporting to a home now shows a message. (#2489)
- EssentialsX now supports 1.14.x mobs, enchantments and items. (#2510)
- The
essentials.keepinv
permission will prevent players dropping their items on death. (#2531) - LLAMA COLO
URS (60ebe9e) - You can now change the
[Disposal]
and/disposal
inventory title. (#2461) /fireball
now lets you fire splash and lingering potions. (#2461)/itemname
lets you rename the item you're currently holding. (#672, #2573)- Players with
essentials.balancetop.exclude
will be hidden from the/baltop
. (#2499) safe-usermap-names: false
will disable usermap sanitisation (intended for Minecraft China servers). (c97918d)- You can now set formatting code permissions for each code separately. (#1441)
- You can now choose whether water is considered a "safe" teleport destination with the
is-water-safe
config option. (#2520)
API additions
- You can now add custom items to the item database by registering your own
ItemResolver
. (#2472)- (Example) from the Magic plugin
- You can now listen for
/tpa
requests withTPARequestEvent
. (#1727)
Bug fixes
- Offline players with exact name matches are now preferred to online players with partial name matches in some commands. (#2455)
- Commands are hidden from the 1.13+ autocomplete if the player doesn't have permission to use them. (#2469)
- The AFK timer is now reset correctly when you log out, preventing random kicks when logging back in. (#2458)
- Running
/mail clear
with an empty mailbox will now tell you your mailbox is already empty and will no longer charge command costs. (#2063) - GeoIP will now report localhost connections as from "an unknown country". (#2494)
/tpa(here)
will no longer show users the/tpacancel
message if they don't have permission to use that command. (#2498)- The usage message for
/bigtree
now includesdarkoak
as an option. (#2461) - NYAN (2ea3d89)
- EssentialsX will no longer warn about CloudNet v2's fake server list pinging. (cd7fa79)
/condense
will now only use square recipes. Be gone, leather boots! (dbd8615)- Standing on redstone ore will no longer bypass auto-AFK. (8b7bcbb)
- Item ID lookups now work on 1.12.2 and below again. (9089fe8)
- The kit delay strikethrough now works properly when the kit name includes capital letters. (2938330)
Translation updates
There have been several updates to translations in this release. If you have custom locale files, you may want to update them to the latest version from the EssentialsX jar.
You can help translate EssentialsX on Crowdin.
Website changes
The EssentialsX website has seen a couple of minor changes. The most notable is that the Downloads section now works properly, and gives you quick links to download all the latest builds of the EssentialsX plugins.
A new website is also in the works along with improved documentation - click here for a sneak peek of the new site!
Special thanks
Once again, this release wouldn't be here without all of our community supporters. Thanks to all of our contributors for providing support, translating strings, developing new features, and investigating and fixing bugs! In addition, thanks to everyone who has supported EssentialsX over the past few months.
EssentialsX 2.16.1 - The 1.13-and-Below Update
EssentialsX for 1.13.2 and all older supported versions is finally here! This release contains mainly bug fixes for 2.16.0; in particular, you can now use EssentialsX in 1.12.2 and below once more!
This release supports Bukkit servers running the following versions: 1.13.2
, 1.12.2
, 1.11.2
, 1.10.2
, 1.9.4
, and 1.8.8
. We do not support 1.7.10
, nor do we support old outdated versions like 1.8.3
or 1.13.1
- you should update your server to a supported version.
Important changes since 2.16.0
- The plugin now works on 1.12.2 and below, in case you missed it.
- You can now spawn in items, use
/enchant
and create and use kits, just like you always used to!
- You can now spawn in items, use
- Due to an oversight in 2.16.0,
items.json
did not update when you updated EssentialsX. This has now been fixed for new installs of EssentialsX.- You will need to delete
plugins/Essentials/items.json
when you update EssentialsX to let it create a newitems.json
. - This is recommended: lots of items were missing when 2.16.0 was released and have been added back more recently, but these won't work until you let EssentialsX create the new file.
- You will need to delete
- Teleportation now loads chunks asynchronously where possible.
- This fixes teleportation commands slowing down the server.
- You need to be running Paper for this to have any effect.
Bug fixes
- da89efb: Fix version checks breaking on Minecraft versions without a patch number (like
1.8
or1.12
) - 694cf7a: Remove 1.13-only code when spawning in items from
items.csv
- 97cc3d0: Fix damage potions spawning the wrong type of potion and incorrect wood aliases
- fd01b75: Fix spawning items in by ID and meta on versions below 1.13
- bd8ef2a: Hide warps in tabcomplete when players don't have permission to use them
- 417fe29: Don't send item IDs twice in
/itemdb
on versions below 1.13 - 4adb669: Add names for spawners for each entity
- 82ede45: Download GeoIP database over HTTPS
- 7948e76: Don't set beds in the Nether or End where they explode
- dd41b10: Don't override the ability to put on skulls
- 727d473: Fix enchantments breaking on versions below 1.13
- d24b061: Don't show SLPE errors when receiving legacy pings
- 7da90b3: Fix
item-spawn-blacklist
being loaded before the item database and constantly erroring - b831713: Send proper error when user tries to spawn unspawnable materials as items
- 8272178: Allow
[gamemode]
signs to switch into spectator mode - 7325113: Remove outdated permissions handlers
- fb77953: Replace NBSPs with normal spaces in translation files
- aca83bd: Depend on VaultAPI instead of Vault
- 9e73c29: Fix
/createkit
on 1.12.2 and below - f214696: Use the Material enum for the Protect and AntiBuild configs
- 3856a69: Use PaperLib to fix teleportation lag
- e72644a: Add mooshroom spawners; add new stone-like aliases
- eafd110: Add aliases for spawner that actually, you know, include the word "spawner"
- 289d34d: Relocate PaperLib in EssentialsXSpawn (but don't include it in the jar)
- 31b98fb: Allow the console to send mail using colour codes
- dde4a36: Attempt searching for users by UUID before giving up
- dda5e4e: Remove locked chest aliases
Translation updates
There are no translation updates in this release. If you want to contribute to translations, we're working on moving translation updates to Crowdin - click the link to visit our translation page.
Special thanks
Once again, big thanks to all our contributors. A special mention also goes to @triagonal and @DoNotSpamPls as well as countless others who have helped fix bugs and provide support. Finally, a big thanks to everyone who has been patient and supported us since the release of 2.16.0 in January.
EssentialsX 2.16.0 - The 1.13 Update
EssentialsX with 1.13 support is finally here!
Important changes since 2.15.0
Support is currently only guaranteed for 1.13 and aboveThe plugin may work on 1.12.2 and below, but 2.16-pre3 has not been extensively tested on these versions.- 2.16.1 onwards supports 1.12.2 and below once more!
- In several places, item IDs have been removed!
- On 1.12.2 and below, you can still use item IDs as before, but you will need to update your configs to use material names.
- On 1.13+, item IDs will not work anywhere, including permissions, item lookups or configs.
- One exception is that you can set
allow-old-id-signs: true
in your config to allow players to retrieve items stored in[trade]
signs that use IDs. You cannot create new signs with IDs, however.
- One exception is that you can set
- On 1.13+, EssentialsX now uses
items.json
, a new item database format.- Plugins can now manually load in additional items into EssentialsX's database.
- Some plugins that used to rely on EssentialsX's item database may require updates to continue working properly.
- The
items.csv
file is ignored on 1.13+.
- EssentialsX now requires Java 8 and will not run on older versions.
- Deprecated economy plugins are no longer supported - these are BOSEconomy, iConomy 5/6 and MultiCurrency
- This allows you to finally add EssentialsX as a dependency in your plugin without cloning and building it first.
Bug fixes
- 16b2c3d: Clear any pending unconfirmed commands when a player logs in
- de57a8c: EssentialsX Protect now disables emergency mode if Essentials somehow loads after it
- 8aa764f: Allow
/nick off
for players who can only change their username's colours - a44775c: Prevent usernames being duplicated in the
/ignore
list- This fixes issues with plugins that added users to player's ignore lists without removing them, which meant removing them from the list wouldn't work properly.
- 52d814f: Playtime is now accurately reported in
/whois
in 1.13 - 3ef0f20: Tipped arrows are supported by the old item database
- 37acdc1: Fix typo in comment above
milk-bucket-easter-egg
- 3c6a869: Only spawn mobs with iron armour if specified
- f569b89: Round down an account's balancec when converting to a double
- This works around a money duplication exploit in outdated versions of ChestShop, but you should still update ChestShop as the problem was properly mitigated across all economy plugins
- bad0272: Allow
/eco take
to subtract a player's exact balance - 935b5cf: Use the Bukkit
setUnbreakable
method where available instead of the Spigot one - 575a11b:
createKitSuccess
messages now correctly refer tokits.yml
instead ofconfig.yml
- 9576ea2: Use reflection to detect which item pickup listener to use
- EssentialsX should now start up on Glowstone, though support is not guaranteed - please report any issues with EssentialsX on Glowstone on our issue tracker
- ba95958: Use internal method for setting/updating the currency format
- The plugin should now run on Java 9 and above.
- 7dd52da: Add a Bukkit version utility class
- This can be used to replace the inconsistent usages of
ReflUtil
which break on Glowstone.
- This can be used to replace the inconsistent usages of
- ec83a5f: Add support for newer EntityPickupItemEvent in AntiBuild
- 7b67b3b: Don't send empty line join/quit messages
- Finally, you can now set
custom-join-message
/custom-quit-message
to""
and EssentialsX won't send any message at all!
- Finally, you can now set
- a18ce40: Add
hide-displayname-in-vanish
config option to hide nicknames of vanished users- This avoids revealing when players are in vanish rather than offline.
- 579f554: Fix nickname not being set properly when disabling AFK mode
Other features added since 2.15
- b29f98c: Add world-specific
/back
permissions- You can revoke
essentials.back.into.<world>
from players to prevent them using/back
to teleport into the specific world. - This permission defaults to true, meaning by default all players can teleport into all worlds.
- You can revoke
- 030eb33: Block ignite only for PvP, not for PvE
- Players in god mode can now ignite mobs with bows, which was not previously possible.
- 2ff29da: Add a message when trying to jail someone in a jail that doesn't exist
- This shows the message
jailNotExist
from yourmessages.properties
or equivalent localised file.
- This shows the message
- 817caf2: When a player uses
/setwarp
, store the player's UUID aslastowner
- 967bb44: Expose this in the API as getLastOwner
- 7298393: Add
essentials.msgtoggle.bypass
- This permission allows you to send private messages to users that have disabled them with
/msgtoggle
.
- This permission allows you to send private messages to users that have disabled them with
- 4873beb: Add config option to require a permission before updating a player's compass direction
- If
compass-towards-home-perm
is enabled in the EssentialsX config, then the permissionessentials.home.compass
is checked before changing the player's compass target.
- If
- aa622f8: Teleport safety is disabled in spectator mode
- 504a7ae: 1.13 mobs are now supported
- ed72d11: Add
{ONLINE}
variable to custom join messages - c79db98: Add more debug logging in
Settings
- When investigating group chat format issues, if
/ess debug
is enabled, EssentialsX will output which chat format is being used for each player. - When investigating command cooldown issues, if
/ess debug
is enabled, EssentialsX will output each command cooldown every time they are checked, stating which ones were matched.
- When investigating group chat format issues, if
- 81397d9: Make the "internal error" messages and the compass directions translatable
- f97c5fc: Make
/realname
's output message translatable - 959c788/634d62f9ef8ef30717bb0ffd8877a18b7d28d70d: Add
essentials.kickall.exempt
permission- Makes players exempt from
/kickall
- Makes players exempt from
- e642192: When banning by IP with
/banip
, all connected players with that IP are now kicked - 2806156: Add
allow-world-in-broadcastworld
config option- When set to
true
, players can use the command/broadcastworld [world] <message>
to specify what world to broadcast in. - This defaults to
false
.
- When set to
- e3c726b: The total amount of items loaded in the item database is now logged when the item database (re)loads.
- a3eb587: Add
essentials.nick.allowunsafe
permission- If a player has this, they can set their username to any value. Use with caution, as this has the potential to break userdata files.
- 79bc340: Allow
/clearinventory
to accept a comma-separated list of item names - a2a95ed: Add acacia, birch and dark oak trees to
/tree
and/bigtree
- 280d121: Add a
UserWarpEvent
class for when users teleport to a defined warp - 41b2449:
/enchant
now defaults to level 1 if no enchant is supplied - 35a2a4d: Add compatibility warnings in
/ess version
and on startup- The "Vault is not installed" message can now be translated as
versionOutputVaultMissing
. - If running an unsupported version of Bukkit, EssentialsX will now show a warning in
/ess version
and on startup. - If running an unsupported plugin alongside EssentialsX,
/ess version
will highlight it.
- The "Vault is not installed" message can now be translated as
- 6ee8451: Update the bStats Metrics class
/essentials optout
has been removed - use the global bStats config instead.
- 6a63834: Add
force-enable-recipe
config option- This option is not recommended. Do not use it unless you know what you are doing and fully understand the implications.
- 89d592c: Make
item-spawn-blacklist
debug messages more readable - 050287f: Add 1.13 enchantments
Translation updates
Thanks to several members of the community, we have enhanced translations, including:
- a brand new Vietnamese translation by @BaoKunVN
- updated Hungarian translations by @montlikadani and @gb2233
- minor corrections in Polish translations by @RikoDEV
- minor updates to the Italian translations by @Leomixer17
- updates to the Estonian translations by @Madis0
- improvements to the German translations by @Sprungente and @seema84
- updates to the Dutch translations by @Dutchuser
- more translatable messages added by @montlikadani and @Xeyame
createKitSuccess
messages correctly refering tokits.yml
instead ofconfig.yml
th...