Skip to content

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, and 1.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 using essentials.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
Assets 9

@md678685 md678685 released this Jun 26, 2019 · 28 commits to 2.x since this release

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 and 1.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 in config.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 in config.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 have essentials.back.other. (#2451)
  • You can now use /rtoggle to control your own personal last-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 COLOURS (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)
  • You can now listen for /tpa requests with TPARequestEvent. (#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 includes darkoak 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.

Assets 9
Jun 26, 2019
EssentialsX 2.17-pre1: The 1.14 Update!
=======================================

EssentialsX for 1.14.x is now out! This release includes 1.14.3 support, plug some new features and several bug fixes!

This version officially supports the following servers:
* Spigot and **[Paper](https://papermc.io) (recommended)** for `1.8.8`, `1.9.4`, `1.10.2`, `1.11.2`, `1.12.2`, `1.13.2` and `1.14.3`
* [Glowstone](https://glowstone.net) `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's 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 in `config.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 in `config.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 have `essentials.back.other`. (#2451)
* You can now use `/rtoggle` to control your own personal `last-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~~U~~RS (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](https://github.com/elBukkit/MagicPlugin/blob/e4a5fa946dda7cf41e5347438ec29ed2038ee069/Magic/src/main/java/com/elmakers/mine/bukkit/essentials/MagicItemDb.java)) from the Magic plugin
* You can now listen for `/tpa` requests with `TPARequestEvent`. (#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 includes `darkoak` 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](https://crowdin.com/project/essentialsx-official).

Website changes
---------------

The [EssentialsX website](https://essentialsx.github.io) 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](https://essentialsx-dev.netlify.com) 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](https://github.com/EssentialsX/Essentials/graphs/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.

@md678685 md678685 released this Mar 1, 2019 · 249 commits to 2.x since this release

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!
  • 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 new items.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.
  • 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 or 1.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.

Assets 9

@md678685 md678685 released this Jan 3, 2019 · 300 commits to 2.x since this release

EssentialsX with 1.13 support is finally here!

Important changes since 2.15.0

  • Support is currently only guaranteed for 1.13 and above
    • The 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.
  • 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 to kits.yml instead of config.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.
  • 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!
  • 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.
  • 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 your messages.properties or equivalent localised file.
  • 817caf2: When a player uses /setwarp, store the player's UUID as lastowner
    • 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.
  • 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 permission essentials.home.compass is checked before changing the player's compass target.
  • 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.
  • 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
  • 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.
  • 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.
  • 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 to kits.yml instead of config.yml thanks to @DutchUser
  • a bRaNd NeW bRiTiSh EnGlIsH tRaNsLaTiOn!!!!1!11!1oneone thanks to @md678685

Special thanks

Special thanks goes to everyone who has helped us reach this point. This includes enterih on Discord, who has supported us through significant donations to the project. In addition, massive thanks to our translators mentioned above, as well as all our contributors, not to mention people that have gone out of their way to help test the plugin and report and replicate issues, such as @DoNotSpamPls, @pop4959 and @triagonal.

Assets 9

EssentialsX with 1.13 support is finally nearly here! (Scroll to the bottom for changes between pre3 and pre4.)

Important changes since 2.15.0

  • Support is currently only guaranteed for 1.13 and above.
    • The plugin may work on 1.12.2 and below, but 2.16-pre3 has not been extensively tested on these versions.
  • 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.
  • 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 to kits.yml instead of config.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.
  • 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!
  • 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.
  • 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 your messages.properties or equivalent localised file.
  • 817caf2: When a player uses /setwarp, store the player's UUID as lastowner
    • 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.
  • 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 permission essentials.home.compass is checked before changing the player's compass target.
  • 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.
  • 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
  • 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.
  • 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.
  • 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 to kits.yml instead of config.yml thanks to @DutchUser
  • a bRaNd NeW bRiTiSh EnGlIsH tRaNsLaTiOn!!!!1!11!1oneone thanks to @md678685

Special thanks

Special thanks goes to everyone who has helped us reach this point. This includes enterih on Discord, who has supported us through significant donations to the project. In addition, massive thanks to our translators mentioned above, as well as all our contributors, not to mention people that have gone out of their way to help test the plugin and report and replicate issues, such as @DoNotSpamPls, @pop4959 and @triagonal.

Changes since 2.16-pre3

  • 3b1cef9: Restore essentials.itemspawn.item-<id> permissions
  • 19cffe3: Restore repair-<id> command costs
  • 9882392: Restore essentials.build.<action>.<material>:<durabililty> permissions in EssentialsX AntiBuild
  • 6260b49: Add new item ID message in /itemdb on 1.12.2 and below

The rest of the changes are inernal changes that should restore functionality on 1.12.2 and below. You can see these changes here.

Assets 9

EssentialsX with 1.13 support is finally nearly here!

Important changes since 2.15.0

  • Support is currently only guaranteed for 1.13 and above.
    • The plugin may work on 1.12.2 and below, but 2.16-pre3 has not been extensively tested on these versions.
  • Item IDs have been removed! This means any permissions with item IDs will not be recognised.
    • To be precise, item IDs have been removed from permission checks, command costs and item lookups in /worth, /give, /item, more, /repair, and EssentialsX AntiBuild and Protect
    • On 1.12.2 and below, you can still use item IDs in /give and /item.
    • On 1.13+, 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.
  • 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 and above.
  • 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 to kits.yml instead of config.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.
  • 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!
  • 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.
  • 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 your messages.properties or equivalent localised file.
  • 817caf2: When a player uses /setwarp, store the player's UUID as lastowner
    • 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.
  • 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 permission essentials.home.compass is checked before changing the player's compass target.
  • 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.
  • 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
  • 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.
  • 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.
  • 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
  • updates to the Dutch translations by @DutchUser
  • more translatable messages added by @montlikadani and @Xeyame
  • createKitSuccess messages correctly refering to kits.yml instead of config.yml thanks to @DutchUser
  • a bRaNd NeW bRiTiSh EnGlIsH tRaNsLaTiOn!!!!1!11!1oneone thanks to @md678685
Assets 9
Dec 25, 2018
Bump to 2.16-pre2
Dec 9, 2018
Bump version to 2.16.0 and release 2.16-pre1

@md678685 md678685 released this Mar 29, 2018 · 555 commits to 2.x since this release

This version supports Minecraft 1.8.8-1.12.2.

Additions since b488

  • Messages files are now consistent and include updated translations.
  • /clearinventory has an optional confirmation check, similar to /pay. #1309
  • Add notify-player-of-mail-cooldown, a cooldown for how often "You have new mail" messages appear. #1312 11a03bb
  • Show UUID in /whois. #1394 d7685dc
  • Add delay-motd, a delay for sending the MOTD after a user connects. #1396 50f2e7a
  • MCStats Metrics has been replaced with bStats.
  • Socialspy displays chat messages from muted players. #1430 fd63a7d
  • Server list no longer shows vanished players.
  • Kits now support the unbreakable tag. #377 203d656
  • Add allow-direct-hat, allowing players with essentials.hat to click on their helmet slot to put any item there. #960 7958cd0
  • Add configurable messages to send to banned players on join attempts. #420 e5c7ba7
    • This was added to temporary bans later: #1709 a904dab
  • Disable god mode on login when players don't have essentials.god. #1475 91b2622
  • Spawn: Separate respawn and spawn-on-join listener priority options. #1491 ed5aa1f
  • Socialspy messages can now be formatted in the messages file. #1460 (unknown commit)
  • Mails can now be formatted like chat messages with essentials.mail.color etc. #1611 c14d565
  • Players no longer receive /me messages from ignored users. #1768 87c6672
  • ItemFlags are now supported in kits. #795 377c716
  • Chat: Add {PREFIX} and {SUFFIX} plaxeholders. #1663 738efe8
  • Add configurable messages to /jails. #1732 e38b155
  • Add /disposal, a command that opens a disposal inventory like the [Disposal] sign. #1729 d69e3a2
  • Move kits to kits.yml and automatically migrate old kits to the new file. #1774 cd43355
  • Disable pastebin-createkit by default, and switch to Hastebin. #1916 0d5da06
  • Add /ess version command, giving detailed info for support purposes. #1514 4e8e7be
  • Add extra permissions to /whois and /seen. #735 95ac4a4
  • Add colour formatting to /mail sendall. #1867 d3c4c2b
  • cancel-afk-on-move now works independently of cancel-afk-on-interact. #1804 823f1c2

Fixes since b488

  • /condense now works on 1.12. #1298 3831464
  • World is now passed when retrieving Vault prefix and suffix. #1327 341263b
  • Tab complete now includes player names. #1301 12930cf
  • LuckPerms is now supported by default, and is recommended over other permissions plugins. #1356 d5cbfef
  • Players can no longer reply to PMs while muted. #1375 518a43d
  • Tab completion with /warp now requires essentials.warp.list. #1378 301a3a7
  • Arrows shot by people in god mode or who are vanished without the PvP permission no longer set people on fire. #1462 13fbd31
  • Powertools that include {player} no longer run when powertools are disabled. #1474 eb341c0
  • PlayerInteractEvent no longer causes constant stack traces on 1.12.2.
  • Spawners now work correctly. #1536 b346970
  • Logger parent infinite loop fixed on Paper servers. #1570 2c4ff35
  • /tppos now checks for per-world teleport permissions. #1516 cd7e096
  • Send an error when trying to show an invalid page. #1754 ef1e57f
  • Kits parse correctly without unpredictable behaviour. #1757 1f0f77f
  • GeoIP: Rewritten to use the newer MaxMind GeoIP 2 database to avoid breakage. #1748 938f94e
  • Arguments are now passed in the correct order in the construction of GodStatusChangeEvents. #1790 16a496c
  • Vanished players are no longer targeted by entities. #1829 0540042
  • /clearinventory now clears the offhand slot. 983f3a7
  • Don't show error that MOTD is missing on login. #1811 e4a8222
  • Vanished players can leave vanish properly after switching worlds while vanished. (This fixes the infamous hidden unvanished players bug.) #1796 61c1485
Assets 9
You can’t perform that action at this time.