Release 2.18.2

Fixes #3761

.checkstyle/checkstyle.xml

@@ -0,0 +1,183 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE module PUBLIC "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+        "https://checkstyle.org/dtds/configuration_1_3.dtd">
+
+<!-- based on https://github.com/KyoriPowered/adventure/blob/master/.checkstyle/checkstyle.xml -->
+
+<module name="Checker">
+    <property name="charset" value="UTF-8"/>
+    <property name="fileExtensions" value="java, properties, xml"/>
+    <property name="severity" value="error"/>
+
+    <!-- https://checkstyle.org/config_filefilters.html#BeforeExecutionExclusionFileFilter -->
+    <module name="BeforeExecutionExclusionFileFilter">
+        <property name="fileNamePattern" value="module\-info\.java$"/>
+    </module>
+
+    <!-- https://checkstyle.org/config_whitespace.html#FileTabCharacter -->
+    <module name="FileTabCharacter">
+        <property name="eachLine" value="true"/>
+    </module>
+
+    <!-- https://checkstyle.org/config_misc.html#NewlineAtEndOfFile -->
+    <module name="NewlineAtEndOfFile"/>
+
+    <!-- https://checkstyle.org/config_filters.html#SuppressionFilter -->
+    <module name="SuppressionFilter">
+        <property name="file" value="${checkstyle.suppressions.file}"/>
+    </module>
+
+    <!-- https://checkstyle.org/config_filters.html#SuppressWithPlainTextCommentFilter -->
+    <module name="SuppressWithPlainTextCommentFilter"/>
+
+    <module name="TreeWalker">
+        <!-- https://checkstyle.org/config_misc.html#ArrayTypeStyle -->
+        <module name="ArrayTypeStyle"/>
+
+        <!-- https://checkstyle.org/config_imports.html#AvoidStarImport -->
+        <module name="AvoidStarImport"/>
+
+        <!-- https://checkstyle.org/config_misc.html#AvoidEscapedUnicodeCharacters -->
+        <module name="AvoidEscapedUnicodeCharacters">
+            <property name="allowByTailComment" value="true"/>
+            <property name="allowEscapesForControlCharacters" value="true"/>
+            <property name="allowNonPrintableEscapes" value="true"/>
+            <property name="severity" value="info"/>
+        </module>
+
+        <!-- https://checkstyle.org/config_misc.html#CommentsIndentation -->
+        <module name="CommentsIndentation"/>
+
+        <!-- https://checkstyle.org/config_whitespace.html#EmptyForInitializerPad -->
+        <module name="EmptyForInitializerPad"/>
+
+        <!-- https://checkstyle.org/config_whitespace.html#EmptyForIteratorPad -->
+        <module name="EmptyForIteratorPad"/>
+
+        <!-- https://checkstyle.org/config_whitespace.html#EmptyLineSeparator -->
+        <module name="EmptyLineSeparator">
+            <property name="allowMultipleEmptyLines" value="false"/>
+            <property name="allowMultipleEmptyLinesInsideClassMembers" value="false"/>
+            <property name="allowNoEmptyLineBetweenFields" value="true"/>
+            <property name="tokens"
+                      value="CLASS_DEF, CTOR_DEF, ENUM_DEF, IMPORT, INSTANCE_INIT, INTERFACE_DEF, METHOD_DEF, STATIC_IMPORT, STATIC_INIT, VARIABLE_DEF"/> <!-- remove PACKAGE_DEF, temporarily remove COMPACT_CTOR_DEF, RECORD_DEF -->
+        </module>
+
+        <!-- https://checkstyle.org/config_coding.html#FallThrough -->
+        <module name="FallThrough">
+            <property name="checkLastCaseGroup" value="true"/>
+        </module>
+
+        <!-- https://checkstyle.org/config_design.html#FinalClass -->
+        <module name="FinalClass"/>
+
+        <!-- https://checkstyle.org/config_coding.html#FinalLocalVariable -->
+        <module name="FinalLocalVariable"/>
+
+        <!-- https://checkstyle.org/config_whitespace.html#GenericWhitespace -->
+        <module name="GenericWhitespace"/>
+
+        <!-- https://checkstyle.org/config_design.html#HideUtilityClassConstructor -->
+        <module name="HideUtilityClassConstructor"/>
+
+        <!-- https://checkstyle.org/config_imports.html#IllegalImport -->
+        <module name="IllegalImport">
+            <property name="illegalPkgs" value="sun, jdk, com.sun"/>
+        </module>
+
+        <!-- https://checkstyle.org/config_coding.html#IllegalTokenText -->
+        <module name="IllegalTokenText">
+            <property name="format"
+                      value="\\u00(09|0(a|A)|0(c|C)|0(d|D)|22|27|5(C|c))|\\(0(10|11|12|14|15|42|47)|134)"/>
+            <property name="message"
+                      value="Consider using special escape sequence instead of octal value or Unicode escaped value."/>
+            <property name="tokens" value="CHAR_LITERAL, STRING_LITERAL"/>
+        </module>
+
+        <!-- https://checkstyle.org/config_misc.html#Indentation -->
+        <module name="Indentation"/>
+
+        <!-- https://checkstyle.org/config_blocks.html#LeftCurly -->
+        <module name="LeftCurly"/>
+
+        <!-- https://checkstyle.org/config_naming.html#MethodName -->
+        <module name="MethodName">
+            <property name="format" value="^[_]?[a-z][a-zA-Z0-9]*$"/>
+        </module>
+
+        <!-- https://checkstyle.org/config_whitespace.html#MethodParamPad -->
+        <module name="MethodParamPad"/>
+
+        <!-- https://checkstyle.org/config_javadoc.html#MissingJavadocMethod -->
+        <module name="MissingJavadocMethod">
+            <property name="allowMissingPropertyJavadoc" value="true"/>
+            <property name="tokens" value="METHOD_DEF, ANNOTATION_FIELD_DEF"/> <!-- remove CTOR_DEF, COMPACT_CTOR_DEF -->
+        </module>
+
+        <!-- https://checkstyle.org/config_javadoc.html#MissingJavadocType -->
+        <module name="MissingJavadocType"/>
+
+        <!-- https://checkstyle.org/config_coding.html#NoFinalizer -->
+        <module name="NoFinalizer"/>
+
+        <!-- https://checkstyle.org/config_whitespace.html#NoLineWrap -->
+        <module name="NoLineWrap"/>
+
+        <!-- https://checkstyle.org/config_whitespace.html#NoWhitespaceAfter -->
+        <module name="NoWhitespaceAfter">
+            <property name="allowLineBreaks" value="false"/>
+        </module>
+
+        <!-- https://checkstyle.org/config_whitespace.html#NoWhitespaceBefore -->
+        <module name="NoWhitespaceBefore">
+            <property name="allowLineBreaks" value="true"/>
+        </module>
+
+        <!-- https://checkstyle.org/config_coding.html#OneStatementPerLine -->
+        <module name="OneStatementPerLine"/>
+
+        <!-- https://checkstyle.org/config_misc.html#OuterTypeFilename -->
+        <module name="OuterTypeFilename"/>
+
+        <!-- https://checkstyle.org/config_imports.html#RedundantImport -->
+        <module name="RedundantImport"/>
+
+        <!-- https://checkstyle.org/config_modifier.html#RedundantModifier -->
+        <module name="RedundantModifier">
+            <property name="tokens"
+                      value="ANNOTATION_FIELD_DEF, CLASS_DEF, CTOR_DEF, ENUM_DEF, INTERFACE_DEF, VARIABLE_DEF"/> <!-- remove METHOD_DEF and RESOURCE -->
+        </module>
+
+        <!-- https://checkstyle.org/config_coding.html#RequireThis -->
+        <module name="RequireThis"/>
+
+        <!-- https://checkstyle.org/config_blocks.html#RightCurly -->
+        <module name="RightCurly">
+            <property name="id" value="RightCurlyAlone"/>
+            <property name="option" value="alone"/>
+            <property name="tokens"
+                      value="ANNOTATION_DEF, CLASS_DEF, CTOR_DEF, ENUM_DEF, INSTANCE_INIT, LITERAL_FOR, LITERAL_WHILE, METHOD_DEF, STATIC_INIT"/>
+        </module>
+        <module name="RightCurly">
+            <property name="id" value="RightCurlySame"/>
+            <property name="option" value="same"/>
+            <property name="tokens"
+                      value="LITERAL_CATCH, LITERAL_DO, LITERAL_ELSE, LITERAL_FINALLY, LITERAL_IF, LITERAL_TRY"/> <!-- add LITERAL_DO -->
+        </module>
+
+        <!-- https://checkstyle.org/config_whitespace.html#SingleSpaceSeparator -->
+        <module name="SingleSpaceSeparator">
+            <property name="validateComments" value="true"/>
+        </module>
+
+        <!-- https://checkstyle.org/config_whitespace.html#TypecastParenPad -->
+        <module name="TypecastParenPad"/>
+
+        <!-- https://checkstyle.org/config_coding.html#UnnecessaryParentheses -->
+        <module name="UnnecessaryParentheses"/>
+
+        <!-- https://checkstyle.org/config_imports.html#UnusedImports -->
+        <module name="UnusedImports"/>
+
+    </module>
+</module>

.checkstyle/suppressions.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE suppressions PUBLIC "-//Checkstyle//DTD SuppressionFilter Configuration 1.2//EN" "http://checkstyle.org/dtds/suppressions_1_2.dtd">
+<suppressions>
+    <suppress files=".*[\\/]test[\\/]java[\\/].*" checks="RequireExplicitVisibilityModifier"/>
+    <!-- TODO: don't suppress I-prefixed API interfaces under com.earth2me.essentials -->
+    <suppress files="(com[\\/]earth2me[\\/]essentials[\\/]|net[\\/]ess3[\\/])(?:[^\\/]+$|(?!api)[^\\/]+[\\/])" checks="MissingJavadoc(Method|Type)"/>
+</suppressions>

.classpath

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<classpath>
-	<classpathentry kind="src" path="src"/>
-	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
-	<classpathentry kind="lib" path="lib/bukkit-0.0.1-SNAPSHOT.jar"/>
-	<classpathentry kind="lib" path="lib/Permissions3.jar"/>
-</classpath>

.github/FUNDING.yml

@@ -0,0 +1,13 @@
+# Currently used
+patreon: EssentialsX
+ko_fi: essentialsx
+
+# Currently not used
+#github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+#open_collective: # Replace with a single Open Collective username
+#tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+#community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+#liberapay: # Replace with a single Liberapay username
+#issuehunt: # Replace with a single IssueHunt username
+#otechie: # Replace with a single Otechie username
+#custom: # Replace with a single custom sponsorship URL

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: MOSS Discord Server
+    url: https://discord.gg/casfFyh
+    about: Need help with using EssentialsX? Join the MOSS Discord server for help.

.github/ISSUE_TEMPLATE/help.md

@@ -0,0 +1,86 @@
+---
+name: Help!
+about: Encountered a problem with EssentialsX? Not sure how to fix it?
+labels: 'type: question'
+
+---
+
+<!-- EssentialsX help request guide
+
+NOTE: Failure to fill out this template properly may result in your issue being
+      delayed or ignored.
+
+Don't type between any arrows in the template, as this text will be hidden.
+This includes this header block and any other explanatory text blocks.
+
+Want faster support? Come join our Discord server to get help from both
+developers and community members: https://discord.gg/F7gexAQ
+
+If you're happy to wait (or you were sent here from Discord), read on:
+
+1.  Check the Common Issues page.
+      Read through the wiki page to see if you've encountered a regular issue:
+      https://essentialsx.net/wiki/Common-Issues.html
+
+2.  Fill out the template.
+      Run the commands in the console. Don't just put "latest" as a version, or
+      we will ignore it. This will help us understand what problem you've
+      encountered and help us find a solution.
+
+3.  When linking logs or config files, do not attach them to the post!
+      Copy and paste any logs into https://gist.github.com/, then paste a
+      link to them in the relevant parts of the template. Do not use Hastebin
+      or Pastebin, as this can cause issues when trying to solve issues in the
+      future.
+      **DO NOT drag logs into this text box!**
+
+4.  If you are encountering a performance issue, please include a link to a
+    Timings and/or profiler report.
+
+-->
+
+### Information
+
+**Full output of `/ess version`:**
+<!--
+    Run /ess version in the console, then paste the full output of the command
+    between the ```s.
+-->
+```
+
+```
+
+**Server startup log:**
+<!--
+    Restart your server and upload `logs/latest.log` to
+    https://gist.github.com/. You may redact sensitive data (such as IP
+    addresses), but you should make it clear what data was removed. Once
+    uploaded, paste the link below this block.
+-->
+
+
+**EssentialsX config:**
+<!--
+    Upload `plugins/Essentials/config.yml` (and other config files if relevant)
+    to https://gist.github.com/ then paste the link below this block.
+-->
+
+
+### Help request
+
+**Problem:**  
+<!-- What problem did you encounter? Type below this line. -->
+
+**What I have tried:**  
+<!-- What have you tried so far? Type below this line. -->
+
+**Console stack trace:**  
+<!--
+    If you are reporting an error in the console, paste it between the ```s.
+-->
+```
+
+```
+
+**Screenshots:**  
+<!-- If relevant, include any screenshots or a video below this line. -->

.github/ISSUE_TEMPLATE/report-a-bug.md

@@ -0,0 +1,83 @@
+---
+name: Report a bug
+about: Report an EssentialsX bug. Only use this if you're 100% sure there's something wrong with EssentialsX - otherwise, try "Help!".
+labels: 'bug: unconfirmed'
+
+---
+
+<!-- EssentialsX bug reporting guide
+
+NOTE: Failure to fill out this template properly may result in your issue being
+      delayed or ignored.
+
+Don't type between any arrows in the template, as this text will be hidden.
+This includes this header block and any other explanatory text blocks.
+
+If you are reporting a bug, please follow the following steps:
+
+1.  Fill out the template in full.
+      Run the commands in the console. Don't just put "latest" as a version,
+      or we will ignore it.
+
+2.  When linking files, do not attach them to the post!
+      Copy and paste any logs into https://gist.github.com/, then paste a
+      link to them in the relevant parts of the template. Avoid using
+      Hastebin or Pastebin, as this makes providing support more difficult.
+      **DO NOT drag files into this text box!**
+
+3.  If you are reporting a performance issue, please include a link to a
+    Timings and/or profiler report.
+
+4.  If you are reporting a bug with commands or something else in-game,
+    please include screenshots to help us diagnose the problem.
+
+-->
+
+### Information
+
+**Full output of `/ess version`:**
+<!--
+    Run /ess version in the console, then paste the full output of the command
+    between the ```s.
+-->
+```
+
+```
+
+**Server startup log:**
+<!--
+    Restart your server and upload `logs/latest.log` to
+    https://gist.github.com/. You may redact sensitive data (such as IP
+    addresses), but you should make it clear what data was removed. Once
+    uploaded, paste the link below this block.
+-->
+
+
+**EssentialsX config:**
+<!--
+    Upload `plugins/Essentials/config.yml` (and other config files if relevant)
+    to https://gist.github.com/ then paste the link below this block.
+-->
+
+
+### Details
+
+**Description:**  
+<!-- What is the bug? Type a brief summary below this line. -->
+
+**Steps to reproduce:**  
+<!-- How did you cause it? Describe what you did to cause the bug below. -->
+
+**Expected behavior:**  
+<!-- What did you expect to happen? Type below this line. -->
+
+**Console stack trace:**  
+<!--
+    If you are encountering an error in the console, paste it between the ```s.
+-->
+```
+
+```
+
+**Screenshots:**  
+<!-- If necessary, include screenshots or a video below this line. -->

.github/ISSUE_TEMPLATE/request-a-feature.md

@@ -0,0 +1,52 @@
+---
+name: Request a feature
+about: Suggest a feature you want to see in EssentialsX!
+labels: 'type: enhancement'
+
+---
+
+<!-- EssentialsX feature request guide
+
+NOTE: Failure to fill out this template properly may result in your issue being
+      delayed or ignored.
+
+Don't type between any arrows in the template, as this text will be hidden.
+This includes this header block and any other explanatory text blocks.
+
+Not sure if your feature fits in EssentialsX? Feel free to ask on our Discord
+server: https://discord.gg/F7gexAQ
+
+If you have a feature suggestion for EssentialsX, read the following tips:
+
+1.  Fill out the template.
+      This will help us understand what you're requesting and why you want us
+      to add it.
+
+2.  Keep it simple.
+      Make sure it's easy to understand what you're requesting. A good way is
+      to keep it to one request per GitHub issue, as we can then easily track
+      feature requests.
+
+3.  Check whether it has already been asked or added.
+      You can search the issue tracker to see if your feature has already been
+      requested at https://github.com/EssentialsX/Essentials/issues. You can
+      also check the changelogs to see if the feature was recently added:
+      https://github.com/EssentialsX/Essentials/releases
+
+4.  Ask yourself: "Does this belong in EssentialsX?"
+      There are lots of features that we reject because most servers won't
+      need or use them. If your feature is very specific or already exists in
+      another plugin, it might not be a good fit for EssentialsX.
+
+-->
+
+### Feature request
+
+**Feature description:**  
+<!-- What feature are you suggesting? Type below this line. -->
+
+**How the feature is useful:**  
+<!--
+    How is the feature useful to players, server owners and/or developers?
+    Type below this block.
+-->

.github/PULL_REQUEST_TEMPLATE/bug-fix.md

@@ -0,0 +1,82 @@
+---
+name: Bug fix
+about: Use this if your PR fixes a bug in EssentialsX.
+labels: 'type: bugfix'
+---
+
+<!-- EssentialsX bug fix submission guide
+
+NOTE: Failure to fill out this template properly may result in your PR being
+      delayed or ignored without warning.
+
+Don't type between any arrows in the template, as this text will be hidden.
+This includes this header block and any other explanatory text blocks.
+
+Want to discuss your PR before submitting it? Join the EssentialsX Development
+server: https://discord.gg/CUN7qVb
+
+By contributing to EssentialsX, you agree to license your code under the
+GNU General Public License version 3, which can be found at the link below:
+https://github.com/EssentialsX/Essentials/blob/2.x/LICENSE
+
+If you are submitting a bug fix, please follow the following steps:
+
+1.  Fill out the template in full.
+      This includes providing screenshots and a link to the original bug 
+      report. If there isn't an existing bug report, we recommend opening a new
+      detailed bug report BEFORE opening your PR to fix it, else your PR may be
+      delayed or rejected without warning.
+      
+      You can open a new bug report by following this link:
+      https://github.com/EssentialsX/Essentials/issues/new/choose 
+
+2.  When linking logs or config files, do not attach them to the post!
+      Copy and paste any logs into https://gist.github.com/, then paste a
+      link to them in the relevant parts of the template. Do not use Hastebin
+      or Pastebin, as this can cause issues with future reviews.
+      **DO NOT drag logs into this text box!**
+
+3.  If you are fixing a performance issue, please include a link to a
+    Timings and/or profiler report, both before and after your PR.
+
+4.  If you are fixing a visual bug, such as in commands, please include
+    screenshots so that we can more easily review the proposed fix.
+    (You may drag screenshots directly into this box.)
+
+-->
+
+### Information
+
+<!--
+    Replace #nnnn with the number of the original issue. If this PR fixes
+    multiple issues, you should repeat the phrase "fixes #nnnn" for each issue. 
+-->
+
+This PR fixes #nnnn. 
+
+### Details
+
+**Proposed fix:**    
+<!-- Type a description of your proposed fix below this line. -->
+
+
+**Environments tested:**    
+<!--
+    Below this line, put an "x" inside the box for the environments you have
+    tested this bug fix on, and if relevant alter the OS and Java version
+    accordingly. If this feature does not apply to an environment, strike
+    through the environment using ~~strikethrough~~. If you have tested on
+    other environments, add a new line with relevant details.
+-->
+
+- [ ] [Latest](https://papermc.io/downloads) Paper Version (any OS, any Java 8+ version)
+- [ ] CraftBukkit/Spigot/Paper 1.12.2 (any OS, any Java 8+ version)
+- [ ] CraftBukkit 1.8.8 (any OS, any Java 8+ version)
+
+
+**Demonstration:**    
+<!--
+    Below this block, include screenshots/log snippets from before and after as
+    necessary. If you have created or used a test case plugin, please link to a
+    download of the plugin, source code and exact version used where possible.
+-->

.github/PULL_REQUEST_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: MOSS Discord Server
+    url: https://discord.gg/casfFyh
+    about: Need help with using EssentialsX? Join the MOSS Discord server for help.
+  - name: EssentialsX Development Discord Server
+    url: https://discord.gg/CUN7qVb
+    about: Got questions or want to discuss changes before opening your PR? Join the EssentialsX Development Discord server. (Need help? Join MOSS instead.)

.github/PULL_REQUEST_TEMPLATE/new-feature.md

@@ -0,0 +1,82 @@
+---
+name: Feature addition
+about: Use this if your PR adds a new feature to EssentialsX.
+labels: 'type: enhancement'
+---
+
+<!-- EssentialsX feature submission guide
+
+NOTE: Failure to fill out this template properly may result in your PR being
+      delayed or ignored without warning.
+
+Don't type between any arrows in the template, as this text will be hidden.
+This includes this header block and any other explanatory text blocks.
+
+Want to discuss your PR before submitting it? Join the EssentialsX Development
+server: https://discord.gg/CUN7qVb
+
+By contributing to EssentialsX, you agree to license your code under the
+GNU General Public License version 3, which can be found at the link below:
+https://github.com/EssentialsX/Essentials/blob/2.x/LICENSE
+
+If you are submitting a new feature, please follow the following steps:
+
+1.  Fill out the template in full.
+      This includes providing screenshots and a link to the original feature 
+      request. If there isn't an existing feature request, we strongly
+      recommend opening a new feature request BEFORE opening your PR to
+      implement it, as this allows us to review whether we're likely to accept
+      your feature in advance, and also allows us to discuss possible
+      implementations for the feature. If there is no associated feature
+      request, your PR may be delayed or rejected without warning.
+      
+      You can open a new feature request by following this link:
+      https://github.com/EssentialsX/Essentials/issues/new/choose
+
+2.  If you are fixing a performance issue, please use the "Bug fix" PR template
+      instead. The "bug fix" template is better suited to performance issues.
+
+3.  Include a demonstration.
+      If you are adding commands, please provide screenshots and/or a video
+      demonstration of the feature. Similarly, if you are adding a new API,
+      please include a link to example code that takes advantage of your
+      proposed API. This will aid us in reviewing PRs and speed up the process
+      significantly.
+
+-->
+
+### Information
+
+<!--
+    Replace #nnnn with the number of the original issue. If this PR implements
+    features from multiple issues, you should repeat the phrase "closes #nnnn"
+    for each issue. 
+-->
+
+This PR closes #nnnn. 
+
+### Details
+
+**Proposed feature**  
+<!-- Type a description of your proposed feature below this line. -->
+
+**Environments tested:**  
+<!--
+    Below this block, put an "x" inside the box for the environments you have
+    tested this bug fix on, and if relevant alter the OS and Java version
+    accordingly. If this feature does not apply to an environment, strike
+    through the environment using ~~strikethrough~~. If you have tested on
+    other environments, add a new line with relevant details.
+-->
+
+- [ ] [Latest](https://papermc.io/downloads) Paper Version (any OS, any Java 8+ version)
+- [ ] CraftBukkit/Spigot/Paper 1.12.2 (any OS, any Java 8+ version)
+- [ ] CraftBukkit 1.8.8 (any OS, any Java 8+ version)
+
+**Demonstration:**  
+<!--
+    Below this block, include screenshots/code snippets from before and after
+    as necessary. If you have created or used a test case plugin, please link
+    to a download of the plugin, source code and exact version used where
+    possible.
+-->

.github/workflows/build.yml

@@ -0,0 +1,38 @@
+name: Build EssentialsX
+
+on:
+  push:
+    branches: 
+    - 2.x
+    - mc/*
+  pull_request:
+    branches: 
+    - 2.x
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout Git repo
+      uses: actions/checkout@v1
+    - name: Restore Maven cache
+      uses: actions/cache@v1
+      with:
+        path: ~/.m2/repository
+        key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
+        restore-keys: |
+          ${{ runner.os }}-maven-
+    - name: Set up JDK 1.8
+      uses: actions/setup-java@v1
+      with:
+        java-version: 1.8
+    - name: Build with Maven
+      run: mvn package verify --file pom.xml
+    - name: Copy artifacts
+      run: mkdir -p ./out/ && cp -t ./out/ **/target/Essentials*.jar
+    - uses: actions/upload-artifact@master
+      with:
+        name: Plugin jars
+        path: out/

.gitignore

@@ -1,47 +1,22 @@
-.DS_Store
-/BuildAll/nbproject/private/
-/EssentialsProtect/nbproject/private/
-/EssentialsChat/nbproject/private/
-/EssentialsGroupBridge/nbproject/private/
-/EssentialsGeoIP/nbproject/private/
-/EssentialsSpawn/nbproject/private/
-/EssentialsXMPP/nbproject/private/
-/EssentialsGroupManager/nbproject/private/
-/BuildAll/build/
-/EssentialsGroupBridge/dist/
-/EssentialsGroupBridge/build/
-/EssentialsGeoIP/dist/
-/EssentialsGeoIP/build/
-/EssentialsGroupManager/build/
-/EssentialsGroupManager/dist/
-/BuildAll/dist/
-/EssentialsChat/build/
-/EssentialsChat/dist/
-/EssentialsSpawn/build/
-/EssentialsSpawn/dist/
-/EssentialsXMPP/dist/
-/EssentialsXMPP/build/
-/EssentialsProtect/dist/
-/EssentialsProtect/build/
-/EssentialsPermissionsCommands/nbproject/private/
-/EssentialsPermissionsCommands/build/
-/EssentialsPermissionsCommands/dist/
-/Essentials/nbproject/private/
-/Essentials/dist/
-/Essentials/build/
-/YamlAnnotations/
-/EssentialsUpdate/nbproject/private/
-/EssentialsRelease/
-/EssentialsUpdate/dist/
-/EssentialsUpdate/build/
-/WebPush/apikey.php
-/WebPush/nbproject/private
-/.idea
-*.iml
-/EssentialsGroupManager/bin
-/EssentialsGroupManager/.externalToolBuilders
-/EssentialsAntiBuild/nbproject/private/
-/EssentialsAntiBuild/dist/
-/EssentialsAntiBuild/build/
-/jars
-/out
+# Other IDE files
+*.classpath
+*.project
+*.settings/
+.idea/*
+*.iml
+.DS_Store
+
+# Checkstyle-IDEA config
+!.idea/checkstyle-idea.xml
+
+# Essentials files
+/Essentials/userdata
+/Essentials/config.yml
+/Essentials/kits.yml
+/Essentials/userdata/testplayer1.yml
+/Essentials/usermap.csv
+
+# Build files
+target/
+jars/
+out/

.idea/checkstyle-idea.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="CheckStyle-IDEA">
+    <option name="configuration">
+      <map>
+        <entry key="active-configuration" value="PROJECT_RELATIVE:$PROJECT_DIR$/.checkstyle/checkstyle.xml:EssentialsX" />
+        <entry key="checkstyle-version" value="8.36.2" />
+        <entry key="copy-libs" value="true" />
+        <entry key="location-0" value="BUNDLED:(bundled):Sun Checks" />
+        <entry key="location-1" value="BUNDLED:(bundled):Google Checks" />
+        <entry key="location-2" value="PROJECT_RELATIVE:$PROJECT_DIR$/.checkstyle/checkstyle.xml:EssentialsX" />
+        <entry key="property-2.checkstyle.suppressions.file" value=".checkstyle/suppressions.xml" />
+        <entry key="scan-before-checkin" value="false" />
+        <entry key="scanscope" value="JavaOnly" />
+        <entry key="suppress-errors" value="false" />
+      </map>
+    </option>
+  </component>
+</project>

.project

@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<projectDescription>
-	<name>Essentials</name>
-	<comment></comment>
-	<projects>
-	</projects>
-	<buildSpec>
-		<buildCommand>
-			<name>org.eclipse.jdt.core.javabuilder</name>
-			<arguments>
-			</arguments>
-		</buildCommand>
-	</buildSpec>
-	<natures>
-		<nature>org.eclipse.jdt.core.javanature</nature>
-	</natures>
-</projectDescription>

.travis.yml

@@ -1,17 +0,0 @@
-language: java
-jdk:
-  - oraclejdk7
-  - openjdk7
-  - openjdk6
-script: ant collect
-notifications:
-  irc: 
-    channels: 
-      - "irc.esper.net#lain"
-    on_success: change
-    on_failure: always
-  email:
-    recipients:
-      - "khobbits@ess3.net"
-    on_success: change
-    on_failure: always

BuildAll/build.xml

@@ -1,74 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- You may freely edit this file. See commented blocks below for -->
-<!-- some examples of how to customize the build. -->
-<!-- (If you delete it and reopen the project it will be recreated.) -->
-<!-- By default, only the Clean and Build commands use this build script. -->
-<!-- Commands such as Run, Debug, and Test only use this build script if -->
-<!-- the Compile on Save feature is turned off for the project. -->
-<!-- You can turn off the Compile on Save (or Deploy on Save) setting -->
-<!-- in the project's Project Properties dialog box.-->
-<project name="BuildAll" default="default" basedir=".">
-    <description>Builds, tests, and runs the project BuildAll.</description>
-    <import file="nbproject/build-impl.xml"/>
-    <!--
-
-    There exist several targets which are by default empty and which can be 
-    used for execution of your tasks. These targets are usually executed 
-    before and after some main targets. They are: 
-
-      -pre-init:                 called before initialization of project properties
-      -post-init:                called after initialization of project properties
-      -pre-compile:              called before javac compilation
-      -post-compile:             called after javac compilation
-      -pre-compile-single:       called before javac compilation of single file
-      -post-compile-single:      called after javac compilation of single file
-      -pre-compile-test:         called before javac compilation of JUnit tests
-      -post-compile-test:        called after javac compilation of JUnit tests
-      -pre-compile-test-single:  called before javac compilation of single JUnit test
-      -post-compile-test-single: called after javac compilation of single JUunit test
-      -pre-jar:                  called before JAR building
-      -post-jar:                 called after JAR building
-      -post-clean:               called after cleaning build products
-
-    (Targets beginning with '-' are not intended to be called on their own.)
-
-    Example of inserting an obfuscator after compilation could look like this:
-
-        <target name="-post-compile">
-            <obfuscate>
-                <fileset dir="${build.classes.dir}"/>
-            </obfuscate>
-        </target>
-
-    For list of available properties check the imported 
-    nbproject/build-impl.xml file. 
-
-
-    Another way to customize the build is by overriding existing main targets.
-    The targets of interest are: 
-
-      -init-macrodef-javac:     defines macro for javac compilation
-      -init-macrodef-junit:     defines macro for junit execution
-      -init-macrodef-debug:     defines macro for class debugging
-      -init-macrodef-java:      defines macro for class execution
-      -do-jar-with-manifest:    JAR building (if you are using a manifest)
-      -do-jar-without-manifest: JAR building (if you are not using a manifest)
-      run:                      execution of project 
-      -javadoc-build:           Javadoc generation
-      test-report:              JUnit report generation
-
-    An example of overriding the target for project execution could look like this:
-
-        <target name="run" depends="BuildAll-impl.jar">
-            <exec dir="bin" executable="launcher.exe">
-                <arg file="${dist.jar}"/>
-            </exec>
-        </target>
-
-    Notice that the overridden target depends on the jar target and not only on 
-    the compile target as the regular run target does. Again, for a list of available 
-    properties which you can use, check the target you are overriding in the
-    nbproject/build-impl.xml file. 
-
-    -->
-</project>

BuildAll/nbproject/genfiles.properties

@@ -1,8 +0,0 @@
-build.xml.data.CRC32=cab45985
-build.xml.script.CRC32=7a797370
-build.xml.stylesheet.CRC32=28e38971@1.50.3.46
-# This file is used by a NetBeans-based IDE to track changes in generated files such as build-impl.xml.
-# Do not edit this file. You may delete it but then the IDE will never regenerate such files for you.
-nbproject/build-impl.xml.data.CRC32=b4df970c
-nbproject/build-impl.xml.script.CRC32=8905537e
-nbproject/build-impl.xml.stylesheet.CRC32=6ddba6b6@1.53.1.46

BuildAll/nbproject/project.properties

@@ -1,129 +0,0 @@
-annotation.processing.enabled=true
-annotation.processing.enabled.in.editor=false
-annotation.processing.run.all.processors=true
-annotation.processing.source.output=${build.generated.sources.dir}/ap-source-output
-application.title=BuildAll
-application.vendor=
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.expand-tabs=true
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.indent-shift-width=2
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.spaces-per-tab=2
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.tab-size=2
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.text-limit-width=120
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.text-line-wrap=none
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.usedProfile=project
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineAnnotationArgs=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineArrayInit=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineAssignment=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineBinaryOp=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineCallArgs=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineDisjunctiveCatchTypes=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineFor=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineImplements=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineMethodParams=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineParenthesized=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineTernaryOp=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineThrows=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineTryResources=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.blankLinesAfterClassHeader=0
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.blankLinesBeforeClass=2
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.classDeclBracePlacement=NEW_LINE
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.expand-tabs=false
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.indent-shift-width=4
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.indentCasesFromSwitch=false
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.methodDeclBracePlacement=NEW_LINE
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.otherBracePlacement=NEW_LINE
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.placeCatchOnNewLine=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.placeElseOnNewLine=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.placeFinallyOnNewLine=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.placeWhileOnNewLine=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.spaceAfterTypeCast=false
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.spaces-per-tab=4
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.tab-size=4
-build.classes.dir=${build.dir}/classes
-build.classes.excludes=**/*.java,**/*.form
-# This directory is removed when the project is cleaned:
-build.dir=build
-build.generated.dir=${build.dir}/generated
-build.generated.sources.dir=${build.dir}/generated-sources
-# Only compile against the classpath explicitly listed here:
-build.sysclasspath=ignore
-build.test.classes.dir=${build.dir}/test/classes
-build.test.results.dir=${build.dir}/test/results
-# Uncomment to specify the preferred debugger connection transport:
-#debug.transport=dt_socket
-debug.classpath=\
-    ${run.classpath}
-debug.test.classpath=\
-    ${run.test.classpath}
-# This directory is removed when the project is cleaned:
-dist.dir=dist
-dist.jar=${dist.dir}/BuildAll.jar
-dist.javadoc.dir=${dist.dir}/javadoc
-endorsed.classpath=
-excludes=
-includes=**
-jar.compress=true
-javac.classpath=\
-    ${reference.Essentials.jar}:\
-    ${reference.EssentialsChat.jar}:\
-    ${reference.EssentialsAntiBuild.jar}:\
-    ${reference.EssentialsProtect.jar}:\
-    ${reference.EssentialsSpawn.jar}:\
-    ${reference.EssentialsGeoIP.jar}:\
-    ${reference.EssentialsXMPP.jar}:\
-    ${reference.EssentialsGroupManager.jar}
-# Space-separated list of extra javac options
-javac.compilerargs=
-javac.deprecation=false
-javac.processorpath=\
-    ${javac.classpath}
-javac.source=1.6
-javac.target=1.6
-javac.test.classpath=\
-    ${javac.classpath}:\
-    ${build.classes.dir}
-javac.test.processorpath=\
-    ${javac.test.classpath}
-javadoc.additionalparam=
-javadoc.author=false
-javadoc.encoding=${source.encoding}
-javadoc.noindex=false
-javadoc.nonavbar=false
-javadoc.notree=false
-javadoc.private=false
-javadoc.splitindex=true
-javadoc.use=true
-javadoc.version=false
-javadoc.windowtitle=
-meta.inf.dir=${src.dir}/META-INF
-mkdist.disabled=false
-platform.active=default_platform
-project.Essentials=../Essentials
-project.EssentialsChat=../EssentialsChat
-project.EssentialsGeoIP=../EssentialsGeoIP
-project.EssentialsGroupManager=../EssentialsGroupManager
-project.EssentialsAntiBuild=../EssentialsAntiBuild
-project.EssentialsProtect=../EssentialsProtect
-project.EssentialsSpawn=../EssentialsSpawn
-project.EssentialsXMPP=../EssentialsXMPP
-reference.Essentials.jar=${project.Essentials}/dist/Essentials.jar
-reference.EssentialsChat.jar=${project.EssentialsChat}/dist/EssentialsChat.jar
-reference.EssentialsGeoIP.jar=${project.EssentialsGeoIP}/dist/EssentialsGeoIP.jar
-reference.EssentialsGroupManager.jar=${project.EssentialsGroupManager}/dist/EssentialsGroupManager.jar
-reference.EssentialsAntiBuild.jar=${project.EssentialsAntiBuild}/dist/EssentialsAntiBuild.jar
-reference.EssentialsProtect.jar=${project.EssentialsProtect}/dist/EssentialsProtect.jar
-reference.EssentialsSpawn.jar=${project.EssentialsSpawn}/dist/EssentialsSpawn.jar
-reference.EssentialsXMPP.jar=${project.EssentialsXMPP}/dist/EssentialsXMPP.jar
-run.classpath=\
-    ${javac.classpath}:\
-    ${build.classes.dir}
-# Space-separated list of JVM arguments used when running the project
-# (you may also define separate properties like run-sys-prop.name=value instead of -Dname=value
-# or test-sys-prop.name=value to set system properties for unit tests):
-run.jvmargs=
-run.test.classpath=\
-    ${javac.test.classpath}:\
-    ${build.test.classes.dir}
-source.encoding=UTF-8
-src.dir=src
-test.src.dir=test

BuildAll/nbproject/project.xml

@@ -1,84 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://www.netbeans.org/ns/project/1">
-    <type>org.netbeans.modules.java.j2seproject</type>
-    <configuration>
-        <data xmlns="http://www.netbeans.org/ns/j2se-project/3">
-            <name>BuildAll</name>
-            <source-roots>
-                <root id="src.dir"/>
-            </source-roots>
-            <test-roots>
-                <root id="test.src.dir"/>
-            </test-roots>
-        </data>
-        <libraries xmlns="http://www.netbeans.org/ns/ant-project-libraries/1">
-            <definitions>..\lib\nblibraries.properties</definitions>
-        </libraries>
-        <references xmlns="http://www.netbeans.org/ns/ant-project-references/1">
-            <reference>
-                <foreign-project>Essentials</foreign-project>
-                <artifact-type>jar</artifact-type>
-                <script>build.xml</script>
-                <target>jar</target>
-                <clean-target>clean</clean-target>
-                <id>jar</id>
-            </reference>
-            <reference>
-                <foreign-project>EssentialsChat</foreign-project>
-                <artifact-type>jar</artifact-type>
-                <script>build.xml</script>
-                <target>jar</target>
-                <clean-target>clean</clean-target>
-                <id>jar</id>
-            </reference>
-            <reference>
-                <foreign-project>EssentialsGeoIP</foreign-project>
-                <artifact-type>jar</artifact-type>
-                <script>build.xml</script>
-                <target>jar</target>
-                <clean-target>clean</clean-target>
-                <id>jar</id>
-            </reference>
-            <reference>
-                <foreign-project>EssentialsGroupManager</foreign-project>
-                <artifact-type>jar</artifact-type>
-                <script>build.xml</script>
-                <target>jar</target>
-                <clean-target>clean</clean-target>
-                <id>jar</id>
-            </reference>
-            <reference>
-                <foreign-project>EssentialsAntiBuild</foreign-project>
-                <artifact-type>jar</artifact-type>
-                <script>build.xml</script>
-                <target>jar</target>
-                <clean-target>clean</clean-target>
-                <id>jar</id>
-            </reference>
-            <reference>
-                <foreign-project>EssentialsProtect</foreign-project>
-                <artifact-type>jar</artifact-type>
-                <script>build.xml</script>
-                <target>jar</target>
-                <clean-target>clean</clean-target>
-                <id>jar</id>
-            </reference>
-            <reference>
-                <foreign-project>EssentialsSpawn</foreign-project>
-                <artifact-type>jar</artifact-type>
-                <script>build.xml</script>
-                <target>jar</target>
-                <clean-target>clean</clean-target>
-                <id>jar</id>
-            </reference>
-            <reference>
-                <foreign-project>EssentialsXMPP</foreign-project>
-                <artifact-type>jar</artifact-type>
-                <script>build.xml</script>
-                <target>jar</target>
-                <clean-target>clean</clean-target>
-                <id>jar</id>
-            </reference>
-        </references>
-    </configuration>
-</project>

CONTRIBUTING.md

@@ -0,0 +1,31 @@
+Contributing to EssentialsX
+===========================
+
+Want to help improve EssentialsX? There are several ways you can support and contribute to the project.
+
+If you'd like to make a financial contribution to the project, you can join our [Patreon](https://www.patreon.com/essentialsx/),
+or to make a one-off donation you can visit our [Ko-fi page](https://ko-fi.com/essentialsx). If you can't make a
+donation, don't worry! There are lots of other ways to contribute:
+
+* Do you run a server? Take a look at our ["help wanted"](https://github.com/EssentialsX/Essentials/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22help+wanted%22)
+  and ["bug: unconfirmed"](https://github.com/EssentialsX/Essentials/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22bug%3A+unconfirmed%22)
+  issues, where you can find issues that need extra testing and investigation.
+* Do you speak multiple languages? If so, we always welcome contributions to our [Crowdin project](https://crowdin.com/project/essentialsx-official).
+* Do you enjoy helping others? If so, why not contribute to the [EssentialsX documentation](https://github.com/EssentialsX/wiki)?
+  You can also join the [MOSS Discord community](https://discord.gg/casfFyh) and provide direct community support to
+  other EssentialsX users.
+* If you're a developer, you could look through our ["open to PR"](https://github.com/EssentialsX/Essentials/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22status%3A+open+to+PR%22)
+  issues. We're always happy to receive bug fixes and feature additions as pull requests.
+
+Submitting a PR
+---------------
+
+EssentialsX has extensive templates for PRs that detail how to submit your PR. To find out more, see the PR templates for:
+* [Bug fixes](https://github.com/EssentialsX/Essentials/blob/2.x/.github/PULL_REQUEST_TEMPLATE/bug-fix.md) 
+* [New features](https://github.com/EssentialsX/Essentials/blob/2.x/.github/PULL_REQUEST_TEMPLATE/new-feature.md)
+
+Want to discuss a feature before opening a PR? Join the [EssentialsX Development Discord server](https://discord.gg/CUN7qVb). Note that this server is **not for end-users** - if you need support with EssentialsX, you should join [MOSS](https://discord.gg/casfFyh) instead.
+
+By contributing to EssentialsX, you agree to license your code under the [GNU General Public License version 3](https://github.com/EssentialsX/Essentials/blob/2.x/LICENSE).
+
+

Essentials/build.xml

@@ -1,84 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- You may freely edit this file. See commented blocks below for -->
-<!-- some examples of how to customize the build. -->
-<!-- (If you delete it and reopen the project it will be recreated.) -->
-<!-- By default, only the Clean and Build commands use this build script. -->
-<!-- Commands such as Run, Debug, and Test only use this build script if -->
-<!-- the Compile on Save feature is turned off for the project. -->
-<!-- You can turn off the Compile on Save (or Deploy on Save) setting -->
-<!-- in the project's Project Properties dialog box.-->
-<project name="Essentials" default="default" basedir=".">
-
-    <description>Builds, tests, and runs the project Essentials.</description>
-    <import file="nbproject/build-impl.xml"/>
-    <!--
-
-    There exist several targets which are by default empty and which can be 
-    used for execution of your tasks. These targets are usually executed 
-    before and after some main targets. They are: 
-
-      -pre-init:                 called before initialization of project properties
-      -post-init:                called after initialization of project properties
-      -pre-compile:              called before javac compilation
-      -post-compile:             called after javac compilation
-      -pre-compile-single:       called before javac compilation of single file
-      -post-compile-single:      called after javac compilation of single file
-      -pre-compile-test:         called before javac compilation of JUnit tests
-      -post-compile-test:        called after javac compilation of JUnit tests
-      -pre-compile-test-single:  called before javac compilation of single JUnit test
-      -post-compile-test-single: called after javac compilation of single JUunit test
-      -pre-jar:                  called before JAR building
-      -post-jar:                 called after JAR building
-      -post-clean:               called after cleaning build products
-
-    (Targets beginning with '-' are not intended to be called on their own.)
-
-    Example of inserting an obfuscator after compilation could look like this:
-
-        <target name="-post-compile">
-            <obfuscate>
-                <fileset dir="${build.classes.dir}"/>
-            </obfuscate>
-        </target>
-
-    For list of available properties check the imported 
-    nbproject/build-impl.xml file. 
-
-
-    Another way to customize the build is by overriding existing main targets.
-    The targets of interest are: 
-
-      -init-macrodef-javac:     defines macro for javac compilation
-      -init-macrodef-junit:     defines macro for junit execution
-      -init-macrodef-debug:     defines macro for class debugging
-      -init-macrodef-java:      defines macro for class execution
-      -do-jar-with-manifest:    JAR building (if you are using a manifest)
-      -do-jar-without-manifest: JAR building (if you are not using a manifest)
-      run:                      execution of project 
-      -javadoc-build:           Javadoc generation
-      test-report:              JUnit report generation
-
-    An example of overriding the target for project execution could look like this:
-
-        <target name="run" depends="Essentials-impl.jar">
-            <exec dir="bin" executable="launcher.exe">
-                <arg file="${dist.jar}"/>
-            </exec>
-        </target>
-
-    Notice that the overridden target depends on the jar target and not only on 
-    the compile target as the regular run target does. Again, for a list of available 
-    properties which you can use, check the target you are overriding in the
-    nbproject/build-impl.xml file. 
-
-    -->
-	<!--target name="-post-jar">
-	    <jar jarfile="${dist.dir}/Essentials.jar">
-	      <zipfileset src="${dist.jar}" excludes="META-INF/*" />
-	      <zipfileset src="${dist.dir}/lib/Register.jar" excludes="META-INF/*" />
-	      <manifest>
-	        <attribute name="Classpath" value="Essentials.jar"/>
-	      </manifest>
-	    </jar>
-	  </target-->
-</project>

Essentials/nbproject/genfiles.properties

@@ -1,11 +0,0 @@
-build.xml.data.CRC32=7d758acf
-build.xml.script.CRC32=3233ee78
-build.xml.stylesheet.CRC32=28e38971@1.38.2.45
-# This file is used by a NetBeans-based IDE to track changes in generated files such as build-impl.xml.
-# Do not edit this file. You may delete it but then the IDE will never regenerate such files for you.
-nbproject/build-impl.xml.data.CRC32=a830bc14
-nbproject/build-impl.xml.script.CRC32=21ffdddf
-nbproject/build-impl.xml.stylesheet.CRC32=c6d2a60f@1.56.1.46
-nbproject/profiler-build-impl.xml.data.CRC32=ab78ce15
-nbproject/profiler-build-impl.xml.script.CRC32=abda56ed
-nbproject/profiler-build-impl.xml.stylesheet.CRC32=f10cf54c@1.11.1

Essentials/nbproject/pmd.settings

@@ -1,3 +0,0 @@
-DoNotUseThreads
-LongVariable
-SignatureDeclareThrowsException

Essentials/nbproject/project.properties

@@ -1,154 +0,0 @@
-annotation.processing.enabled=true
-annotation.processing.enabled.in.editor=true
-annotation.processing.processors.list=lombok.core.AnnotationProcessor
-annotation.processing.run.all.processors=false
-annotation.processing.source.output=${build.generated.sources.dir}/ap-source-output
-application.title=Essentials
-application.vendor=
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.expand-tabs=true
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.indent-shift-width=2
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.spaces-per-tab=2
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.tab-size=2
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.text-limit-width=120
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.project.text-line-wrap=none
-auxiliary.org-netbeans-modules-editor-indent.CodeStyle.usedProfile=project
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineAnnotationArgs=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineArrayInit=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineAssignment=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineBinaryOp=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineCallArgs=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineDisjunctiveCatchTypes=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineFor=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineImplements=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineMethodParams=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineParenthesized=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineTernaryOp=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineThrows=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.alignMultilineTryResources=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.blankLinesAfterClassHeader=0
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.blankLinesBeforeClass=2
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.classDeclBracePlacement=NEW_LINE
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.expand-tabs=false
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.importGroupsOrder=*
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.indent-shift-width=4
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.indentCasesFromSwitch=false
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.methodDeclBracePlacement=NEW_LINE
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.otherBracePlacement=NEW_LINE
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.placeCatchOnNewLine=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.placeElseOnNewLine=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.placeFinallyOnNewLine=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.placeWhileOnNewLine=true
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.separateImportGroups=false
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.spaceAfterTypeCast=false
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.spaces-per-tab=4
-auxiliary.org-netbeans-modules-editor-indent.text.x-java.CodeStyle.project.tab-size=4
-build.classes.dir=${build.dir}/classes
-build.classes.excludes=**/*.java,**/*.form
-# This directory is removed when the project is cleaned:
-build.dir=build
-build.generated.dir=${build.dir}/generated
-build.generated.sources.dir=${build.dir}/generated-sources
-# Only compile against the classpath explicitly listed here:
-build.sysclasspath=ignore
-build.test.classes.dir=${build.dir}/test/classes
-build.test.results.dir=${build.dir}/test/results
-# Uncomment to specify the preferred debugger connection transport:
-#debug.transport=dt_socket
-debug.classpath=\
-    ${run.classpath}
-debug.test.classpath=\
-    ${run.test.classpath}
-# This directory is removed when the project is cleaned:
-dist.dir=dist
-dist.jar=${dist.dir}/Essentials.jar
-dist.javadoc.dir=${dist.dir}/javadoc
-endorsed.classpath=
-excludes=
-file.reference.BOSEconomy7.jar=../lib/BOSEconomy7.jar
-file.reference.bPermissions.jar=../lib/bPermissions.jar
-file.reference.bpermissions2.jar=../lib/bpermissions2.jar
-file.reference.bukkit.jar=../lib/bukkit.jar
-file.reference.iCo4.jar=../lib/iCo4.jar
-file.reference.iCo5.jar=../lib/iCo5.jar
-file.reference.iCo6.jar=../lib/iCo6.jar
-file.reference.lombok.jar=../lib/lombok-0.10.8.jar
-file.reference.MultiCurrency.jar=../lib/MultiCurrency.jar
-file.reference.Permissions3.jar=../lib/Permissions3.jar
-file.reference.PermissionsBukkit-1.2.jar=../lib/PermissionsBukkit-1.2.jar
-file.reference.PermissionsEx.jar=../lib/PermissionsEx.jar
-file.reference.Privileges.jar=..\\lib\\Privileges.jar
-file.reference.Vault.jar=../lib/Vault.jar
-file.reference.SimplyPerms.jar=../lib/SimplyPerms.jar
-includes=**
-jar.archive.disabled=${jnlp.enabled}
-jar.compress=true
-jar.index=${jnlp.enabled}
-javac.classpath=\
-    ${file.reference.Permissions3.jar}:\
-    ${file.reference.iCo4.jar}:\
-    ${file.reference.iCo5.jar}:\
-    ${file.reference.iCo6.jar}:\
-    ${file.reference.MultiCurrency.jar}:\
-    ${file.reference.BOSEconomy7.jar}:\
-    ${file.reference.PermissionsEx.jar}:\
-    ${file.reference.bPermissions.jar}:\
-    ${file.reference.PermissionsBukkit-1.2.jar}:\
-    ${file.reference.lombok.jar}:\
-    ${reference.EssentialsGroupManager.jar}:\
-    ${file.reference.bukkit.jar}:\
-    ${file.reference.Vault.jar}:\
-    ${file.reference.Privileges.jar}:\
-    ${file.reference.bpermissions2.jar}:\
-    ${file.reference.SimplyPerms.jar}
-# Space-separated list of extra javac options
-javac.compilerargs=-Xlint:unchecked
-javac.deprecation=false
-javac.processorpath=\
-    ${javac.classpath}
-javac.source=1.6
-javac.target=1.6
-javac.test.classpath=\
-    ${javac.classpath}:\
-    ${build.classes.dir}:\
-    ${libs.junit_4.10.classpath}
-javac.test.processorpath=\
-    ${javac.test.classpath}
-javadoc.additionalparam=
-javadoc.author=false
-javadoc.encoding=${source.encoding}
-javadoc.noindex=false
-javadoc.nonavbar=false
-javadoc.notree=false
-javadoc.private=false
-javadoc.reference.PermissionsEx.jar=../lib/PermissionsEx-javadoc.jar
-javadoc.splitindex=true
-javadoc.use=true
-javadoc.version=false
-javadoc.windowtitle=
-jnlp.codebase.type=no.codebase
-jnlp.descriptor=application
-jnlp.enabled=false
-jnlp.mixed.code=default
-jnlp.offline-allowed=false
-jnlp.signed=false
-jnlp.signing=
-jnlp.signing.alias=
-jnlp.signing.keystore=
-meta.inf.dir=${src.dir}/META-INF
-mkdist.disabled=true
-platform.active=default_platform
-project.EssentialsGroupManager=../EssentialsGroupManager
-reference.EssentialsGroupManager.jar=../EssentialsGroupManager/dist/EssentialsGroupManager.jar
-run.classpath=\
-    ${javac.classpath}:\
-    ${build.classes.dir}
-# Space-separated list of JVM arguments used when running the project
-# (you may also define separate properties like run-sys-prop.name=value instead of -Dname=value
-# or test-sys-prop.name=value to set system properties for unit tests):
-run.jvmargs=-Djline.terminal=jline.UnsupportedTerminal
-run.test.classpath=\
-    ${javac.test.classpath}:\
-    ${build.test.classes.dir}
-source.encoding=UTF-8
-src.dir=src
-test.src.dir=test

Essentials/nbproject/project.xml

@@ -1,28 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://www.netbeans.org/ns/project/1">
-    <type>org.netbeans.modules.java.j2seproject</type>
-    <configuration>
-        <data xmlns="http://www.netbeans.org/ns/j2se-project/3">
-            <name>Essentials</name>
-            <source-roots>
-                <root id="src.dir"/>
-            </source-roots>
-            <test-roots>
-                <root id="test.src.dir"/>
-            </test-roots>
-        </data>
-        <libraries xmlns="http://www.netbeans.org/ns/ant-project-libraries/1">
-            <definitions>../lib/nblibraries.properties</definitions>
-        </libraries>
-        <references xmlns="http://www.netbeans.org/ns/ant-project-references/1">
-            <reference>
-                <foreign-project>EssentialsGroupManager</foreign-project>
-                <artifact-type>jar</artifact-type>
-                <script>build.xml</script>
-                <target>jar</target>
-                <clean-target>clean</clean-target>
-                <id>jar</id>
-            </reference>
-        </references>
-    </configuration>
-</project>

Essentials/pom.xml

@@ -0,0 +1,118 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>net.ess3</groupId>
+        <artifactId>EssentialsXParent</artifactId>
+        <version>2.18.2</version>
+    </parent>
+
+    <artifactId>EssentialsX</artifactId>
+
+    <build>
+        <finalName>EssentialsX-${full.version}</finalName>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.8.0</version>
+                <configuration>
+                    <showDeprecation>false</showDeprecation>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-shade-plugin</artifactId>
+                <version>3.2.1</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>shade</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <createDependencyReducedPom>false</createDependencyReducedPom>
+                    <relocations>
+                        <relocation>
+                            <pattern>io.papermc.lib</pattern>
+                            <shadedPattern>com.earth2me.essentials.paperlib</shadedPattern>
+                        </relocation>
+                    </relocations>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.github.milkbowl</groupId>
+            <artifactId>VaultAPI</artifactId>
+            <version>1.7</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.bukkit</groupId>
+                    <artifactId>bukkit</artifactId>
+                </exclusion>
+            </exclusions>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>net.luckperms</groupId>
+            <artifactId>api</artifactId>
+            <version>5.0</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.papermc</groupId>
+            <artifactId>paperlib</artifactId>
+            <version>1.0.6-SNAPSHOT</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>net.ess3</groupId>
+            <artifactId>BaseProviders</artifactId>
+            <version>2.18.2</version>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>net.ess3</groupId>
+            <artifactId>NMSReflectionProvider</artifactId>
+            <version>2.18.2</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.bukkit</groupId>
+                    <artifactId>bukkit</artifactId>
+                </exclusion>
+            </exclusions>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>net.ess3</groupId>
+            <artifactId>PaperProvider</artifactId>
+            <version>2.18.2</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>com.destroystokyo.paper</groupId>
+                    <artifactId>paper-api</artifactId>
+                </exclusion>
+            </exclusions>
+            <scope>compile</scope>
+        </dependency>
+        <dependency>
+            <groupId>net.ess3</groupId>
+            <artifactId>1_8Provider</artifactId>
+            <version>2.18.2</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.bukkit</groupId>
+                    <artifactId>bukkit</artifactId>
+                </exclusion>
+            </exclusions>
+            <scope>compile</scope>
+        </dependency>
+    </dependencies>
+</project>

Essentials/src/book.txt

@@ -13,6 +13,6 @@ Minecraft colors:
 &8 &&8  &9 &&9  &a &&a  &b &&b
 &c &&c  &d &&d  &e &&e  &f &&f
 &0 
-&&k &kMagic&r   &&l &lBold
-&&m &mStrike&r  &&n &nUline
-&&o &oItalic&r   &&r &rReset
+&&k &kMagic&r   &&l &lBold&r
+&&m &mStrike&r  &&n &nUline&r
+&&o &oItalic&r   &&r &rReset

Essentials/src/com/earth2me/essentials/AlternativeCommandsHandler.java

@@ -1,138 +1,108 @@
 package com.earth2me.essentials;
 
-import java.util.*;
-import java.util.logging.Level;
-import java.util.logging.Logger;
+import net.ess3.api.IEssentials;
 import org.bukkit.command.Command;
 import org.bukkit.command.PluginCommand;
 import org.bukkit.command.PluginCommandYamlParser;
 import org.bukkit.plugin.Plugin;
 
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.logging.Level;
+import java.util.logging.Logger;
 
-public class AlternativeCommandsHandler
-{
-	private static final Logger LOGGER = Logger.getLogger("Minecraft");
-	private final transient Map<String, List<PluginCommand>> altcommands = new HashMap<String, List<PluginCommand>>();
-	private final transient Map<String, String> disabledList = new HashMap<String, String>();
-	private final transient IEssentials ess;
+public class AlternativeCommandsHandler {
+    private static final Logger LOGGER = Logger.getLogger("Essentials");
+    private final transient Map<String, List<PluginCommand>> altcommands = new HashMap<>();
+    private final transient Map<String, String> disabledList = new HashMap<>();
+    private final transient IEssentials ess;
 
-	public AlternativeCommandsHandler(final IEssentials ess)
-	{
-		this.ess = ess;
-		for (Plugin plugin : ess.getServer().getPluginManager().getPlugins())
-		{
-			if (plugin.isEnabled())
-			{
-				addPlugin(plugin);
-			}
-		}
-	}
+    public AlternativeCommandsHandler(final IEssentials ess) {
+        this.ess = ess;
+        for (final Plugin plugin : ess.getServer().getPluginManager().getPlugins()) {
+            if (plugin.isEnabled()) {
+                addPlugin(plugin);
+            }
+        }
+    }
 
-	public final void addPlugin(final Plugin plugin)
-	{
-		if (plugin.getDescription().getMain().contains("com.earth2me.essentials"))
-		{
-			return;
-		}
-		final List<Command> commands = PluginCommandYamlParser.parse(plugin);
-		final String pluginName = plugin.getDescription().getName().toLowerCase(Locale.ENGLISH);
+    public final void addPlugin(final Plugin plugin) {
+        if (plugin.getDescription().getMain().contains("com.earth2me.essentials")) {
+            return;
+        }
+        final List<Command> commands = PluginCommandYamlParser.parse(plugin);
+        final String pluginName = plugin.getDescription().getName().toLowerCase(Locale.ENGLISH);
 
-		for (Command command : commands)
-		{
-			final PluginCommand pc = (PluginCommand)command;
-			final List<String> labels = new ArrayList<String>(pc.getAliases());
-			labels.add(pc.getName());
+        for (final Command command : commands) {
+            final PluginCommand pc = (PluginCommand) command;
+            final List<String> labels = new ArrayList<>(pc.getAliases());
+            labels.add(pc.getName());
 
-			PluginCommand reg = ess.getServer().getPluginCommand(pluginName + ":" + pc.getName().toLowerCase(Locale.ENGLISH));
-			if (reg == null)
-			{
-				reg = ess.getServer().getPluginCommand(pc.getName().toLowerCase(Locale.ENGLISH));
-			}
-			if (reg == null || !reg.getPlugin().equals(plugin))
-			{
-				continue;
-			}
-			for (String label : labels)
-			{
-				List<PluginCommand> plugincommands = altcommands.get(label.toLowerCase(Locale.ENGLISH));
-				if (plugincommands == null)
-				{
-					plugincommands = new ArrayList<PluginCommand>();
-					altcommands.put(label.toLowerCase(Locale.ENGLISH), plugincommands);
-				}
-				boolean found = false;
-				for (PluginCommand pc2 : plugincommands)
-				{
-					if (pc2.getPlugin().equals(plugin))
-					{
-						found = true;
-					}
-				}
-				if (!found)
-				{
-					plugincommands.add(reg);
-				}
-			}
-		}
-	}
+            PluginCommand reg = ess.getServer().getPluginCommand(pluginName + ":" + pc.getName().toLowerCase(Locale.ENGLISH));
+            if (reg == null) {
+                reg = ess.getServer().getPluginCommand(pc.getName().toLowerCase(Locale.ENGLISH));
+            }
+            if (reg == null || !reg.getPlugin().equals(plugin)) {
+                continue;
+            }
+            for (final String label : labels) {
+                final List<PluginCommand> plugincommands = altcommands.computeIfAbsent(label.toLowerCase(Locale.ENGLISH), k -> new ArrayList<>());
+                boolean found = false;
+                for (final PluginCommand pc2 : plugincommands) {
+                    if (pc2.getPlugin().equals(plugin)) {
+                        found = true;
+                        break;
+                    }
+                }
+                if (!found) {
+                    plugincommands.add(reg);
+                }
+            }
+        }
+    }
 
-	public void removePlugin(final Plugin plugin)
-	{
-		final Iterator<Map.Entry<String, List<PluginCommand>>> iterator = altcommands.entrySet().iterator();
-		while (iterator.hasNext())
-		{
-			final Map.Entry<String, List<PluginCommand>> entry = iterator.next();
-			final Iterator<PluginCommand> pcIterator = entry.getValue().iterator();
-			while (pcIterator.hasNext())
-			{
-				final PluginCommand pc = pcIterator.next();
-				if (pc.getPlugin() == null || pc.getPlugin().equals(plugin))
-				{
-					pcIterator.remove();
-				}
-			}
-			if (entry.getValue().isEmpty())
-			{
-				iterator.remove();
-			}
-		}
-	}
+    public void removePlugin(final Plugin plugin) {
+        final Iterator<Map.Entry<String, List<PluginCommand>>> iterator = altcommands.entrySet().iterator();
+        while (iterator.hasNext()) {
+            final Map.Entry<String, List<PluginCommand>> entry = iterator.next();
+            entry.getValue().removeIf(pc -> pc.getPlugin() == null || pc.getPlugin().equals(plugin));
+            if (entry.getValue().isEmpty()) {
+                iterator.remove();
+            }
+        }
+    }
 
-	public PluginCommand getAlternative(final String label)
-	{
-		final List<PluginCommand> commands = altcommands.get(label);
-		if (commands == null || commands.isEmpty())
-		{
-			return null;
-		}
-		if (commands.size() == 1)
-		{
-			return commands.get(0);
-		}
-		// return the first command that is not an alias
-		for (PluginCommand command : commands)
-		{
-			if (command.getName().equalsIgnoreCase(label))
-			{
-				return command;
-			}
-		}
-		// return the first alias
-		return commands.get(0);
-	}
+    public PluginCommand getAlternative(final String label) {
+        final List<PluginCommand> commands = altcommands.get(label);
+        if (commands == null || commands.isEmpty()) {
+            return null;
+        }
+        if (commands.size() == 1) {
+            return commands.get(0);
+        }
+        // return the first command that is not an alias
+        for (final PluginCommand command : commands) {
+            if (command.getName().equalsIgnoreCase(label)) {
+                return command;
+            }
+        }
+        // return the first alias
+        return commands.get(0);
+    }
 
-	public void executed(final String label, final PluginCommand pc)
-	{
-		final String altString = pc.getPlugin().getName() + ":" + pc.getLabel();
-		if (ess.getSettings().isDebug())
-		{
-			LOGGER.log(Level.INFO, "Essentials: Alternative command " + label + " found, using " + altString);
-		}
-		disabledList.put(label, altString);
-	}
+    public void executed(final String label, final PluginCommand pc) {
+        final String altString = pc.getPlugin().getName() + ":" + pc.getLabel();
+        if (ess.getSettings().isDebug()) {
+            LOGGER.log(Level.INFO, "Essentials: Alternative command " + label + " found, using " + altString);
+        }
+        disabledList.put(label, altString);
+    }
 
-	public Map<String, String> disabledCommands()
-	{
-		return disabledList;
-	}
+    public Map<String, String> disabledCommands() {
+        return disabledList;
+    }
 }

Essentials/src/com/earth2me/essentials/AsyncTeleport.java

@@ -0,0 +1,455 @@
+package com.earth2me.essentials;
+
+import com.earth2me.essentials.api.IAsyncTeleport;
+import com.earth2me.essentials.commands.WarpNotFoundException;
+import com.earth2me.essentials.utils.DateUtil;
+import com.earth2me.essentials.utils.LocationUtil;
+import io.papermc.lib.PaperLib;
+import net.ess3.api.IEssentials;
+import net.ess3.api.IUser;
+import net.ess3.api.InvalidWorldException;
+import net.ess3.api.events.UserWarpEvent;
+import net.ess3.api.events.teleport.PreTeleportEvent;
+import net.ess3.api.events.teleport.TeleportWarmupEvent;
+import org.bukkit.Bukkit;
+import org.bukkit.Location;
+import org.bukkit.entity.Player;
+import org.bukkit.event.player.PlayerRespawnEvent;
+import org.bukkit.event.player.PlayerTeleportEvent.TeleportCause;
+
+import java.math.BigDecimal;
+import java.util.Calendar;
+import java.util.GregorianCalendar;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ExecutionException;
+
+import static com.earth2me.essentials.I18n.tl;
+
+public class AsyncTeleport implements IAsyncTeleport {
+    private final IUser teleportOwner;
+    private final IEssentials ess;
+    private AsyncTimedTeleport timedTeleport;
+
+    private TeleportType tpType;
+
+    public AsyncTeleport(final IUser user, final IEssentials ess) {
+        this.teleportOwner = user;
+        this.ess = ess;
+        tpType = TeleportType.NORMAL;
+    }
+
+    public void cooldown(final boolean check) throws Throwable {
+        final CompletableFuture<Boolean> exceptionFuture = new CompletableFuture<>();
+        if (cooldown(check, exceptionFuture)) {
+            try {
+                exceptionFuture.get();
+            } catch (final ExecutionException e) {
+                throw e.getCause();
+            }
+        }
+    }
+
+    public boolean cooldown(final boolean check, final CompletableFuture<Boolean> future) {
+        final Calendar time = new GregorianCalendar();
+        if (teleportOwner.getLastTeleportTimestamp() > 0) {
+            // Take the current time, and remove the delay from it.
+            final double cooldown = ess.getSettings().getTeleportCooldown();
+            final Calendar earliestTime = new GregorianCalendar();
+            earliestTime.add(Calendar.SECOND, -(int) cooldown);
+            earliestTime.add(Calendar.MILLISECOND, -(int) ((cooldown * 1000.0) % 1000.0));
+            // This value contains the most recent time a teleportPlayer could have been used that would allow another use.
+            final long earliestLong = earliestTime.getTimeInMillis();
+
+            // When was the last teleportPlayer used?
+            final long lastTime = teleportOwner.getLastTeleportTimestamp();
+
+            if (lastTime > time.getTimeInMillis()) {
+                // This is to make sure time didn't get messed up on last teleportPlayer use.
+                // If this happens, let's give the user the benifit of the doubt.
+                teleportOwner.setLastTeleportTimestamp(time.getTimeInMillis());
+                return false;
+            } else if (lastTime > earliestLong
+                && cooldownApplies()) {
+                time.setTimeInMillis(lastTime);
+                time.add(Calendar.SECOND, (int) cooldown);
+                time.add(Calendar.MILLISECOND, (int) ((cooldown * 1000.0) % 1000.0));
+                future.completeExceptionally(new Exception(tl("timeBeforeTeleport", DateUtil.formatDateDiff(time.getTimeInMillis()))));
+                return true;
+            }
+        }
+        // if justCheck is set, don't update lastTeleport; we're just checking
+        if (!check) {
+            teleportOwner.setLastTeleportTimestamp(time.getTimeInMillis());
+        }
+        return false;
+    }
+
+    private boolean cooldownApplies() {
+        boolean applies = true;
+        final String globalBypassPerm = "essentials.teleport.cooldown.bypass";
+        switch (tpType) {
+            case NORMAL:
+                applies = !teleportOwner.isAuthorized(globalBypassPerm);
+                break;
+            case BACK:
+                applies = !(teleportOwner.isAuthorized(globalBypassPerm) &&
+                    teleportOwner.isAuthorized("essentials.teleport.cooldown.bypass.back"));
+                break;
+            case TPA:
+                applies = !(teleportOwner.isAuthorized(globalBypassPerm) &&
+                    teleportOwner.isAuthorized("essentials.teleport.cooldown.bypass.tpa"));
+                break;
+        }
+        return applies;
+    }
+
+    private void warnUser(final IUser user, final double delay) {
+        final Calendar c = new GregorianCalendar();
+        c.add(Calendar.SECOND, (int) delay);
+        c.add(Calendar.MILLISECOND, (int) ((delay * 1000.0) % 1000.0));
+        user.sendMessage(tl("dontMoveMessage", DateUtil.formatDateDiff(c.getTimeInMillis())));
+    }
+
+    @Override
+    public void now(final Location loc, final boolean cooldown, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        if (cooldown && cooldown(false, future)) {
+            return;
+        }
+        final ITarget target = new LocationTarget(loc);
+        nowAsync(teleportOwner, target, cause, future);
+    }
+
+    @Override
+    public void now(final Player entity, final boolean cooldown, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        if (cooldown && cooldown(false, future)) {
+            future.complete(false);
+            return;
+        }
+        final ITarget target = new PlayerTarget(entity);
+        nowAsync(teleportOwner, target, cause, future);
+        future.thenAccept(success -> {
+            if (success) {
+                teleportOwner.sendMessage(tl("teleporting", target.getLocation().getWorld().getName(), target.getLocation().getBlockX(), target.getLocation().getBlockY(), target.getLocation().getBlockZ()));
+            }
+        });
+    }
+
+    private void runOnMain(final Runnable runnable) throws ExecutionException, InterruptedException {
+        if (Bukkit.isPrimaryThread()) {
+            runnable.run();
+            return;
+        }
+        final CompletableFuture<Object> taskLock = new CompletableFuture<>();
+        Bukkit.getScheduler().runTask(ess, () -> {
+            runnable.run();
+            taskLock.complete(new Object());
+        });
+        taskLock.get();
+    }
+
+    protected void nowAsync(final IUser teleportee, final ITarget target, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        cancel(false);
+
+        final PreTeleportEvent event = new PreTeleportEvent(teleportee, cause, target);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
+        teleportee.setLastLocation();
+
+        if (!ess.getSettings().isForcePassengerTeleport() && !teleportee.getBase().isEmpty()) {
+            if (!ess.getSettings().isTeleportPassengerDismount()) {
+                future.completeExceptionally(new Exception(tl("passengerTeleportFail")));
+                return;
+            }
+
+            try {
+                runOnMain(() -> teleportee.getBase().eject()); //EntityDismountEvent requires a sync context.
+            } catch (final ExecutionException | InterruptedException e) {
+                future.completeExceptionally(e);
+                return;
+            }
+        }
+        teleportee.setLastLocation();
+        final Location targetLoc = target.getLocation();
+        if (ess.getSettings().isTeleportSafetyEnabled() && LocationUtil.isBlockOutsideWorldBorder(targetLoc.getWorld(), targetLoc.getBlockX(), targetLoc.getBlockZ())) {
+            targetLoc.setX(LocationUtil.getXInsideWorldBorder(targetLoc.getWorld(), targetLoc.getBlockX()));
+            targetLoc.setZ(LocationUtil.getZInsideWorldBorder(targetLoc.getWorld(), targetLoc.getBlockZ()));
+        }
+        PaperLib.getChunkAtAsync(targetLoc).thenAccept(chunk -> {
+            Location loc = targetLoc;
+            if (LocationUtil.isBlockUnsafeForUser(teleportee, chunk.getWorld(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ())) {
+                if (ess.getSettings().isTeleportSafetyEnabled()) {
+                    if (ess.getSettings().isForceDisableTeleportSafety()) {
+                        //The chunk we're teleporting to is 100% going to be loaded here, no need to teleport async.
+                        teleportee.getBase().teleport(loc, cause);
+                    } else {
+                        try {
+                            //There's a chance the safer location is outside the loaded chunk so still teleport async here.
+                            PaperLib.teleportAsync(teleportee.getBase(), LocationUtil.getSafeDestination(ess, teleportee, loc), cause);
+                        } catch (final Exception e) {
+                            future.completeExceptionally(e);
+                            return;
+                        }
+                    }
+                } else {
+                    future.completeExceptionally(new Exception(tl("unsafeTeleportDestination", loc.getWorld().getName(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ())));
+                    return;
+                }
+            } else {
+                if (ess.getSettings().isForceDisableTeleportSafety()) {
+                    //The chunk we're teleporting to is 100% going to be loaded here, no need to teleport async.
+                    teleportee.getBase().teleport(loc, cause);
+                } else {
+                    if (ess.getSettings().isTeleportToCenterLocation()) {
+                        loc = LocationUtil.getRoundedDestination(loc);
+                    }
+                    //There's a *small* chance the rounded destination produces a location outside the loaded chunk so still teleport async here.
+                    PaperLib.teleportAsync(teleportee.getBase(), loc, cause);
+                }
+            }
+            future.complete(true);
+        });
+    }
+
+    @Override
+    public void teleport(final Location loc, final Trade chargeFor, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        teleport(teleportOwner, new LocationTarget(loc), chargeFor, cause, future);
+    }
+
+    @Override
+    public void teleport(final Player entity, final Trade chargeFor, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        teleportOwner.sendMessage(tl("teleportToPlayer", entity.getDisplayName()));
+        teleport(teleportOwner, new PlayerTarget(entity), chargeFor, cause, future);
+    }
+
+    @Override
+    public void teleportPlayer(final IUser otherUser, final Location loc, final Trade chargeFor, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        teleport(otherUser, new LocationTarget(loc), chargeFor, cause, future);
+    }
+
+    @Override
+    public void teleportPlayer(final IUser otherUser, final Player entity, final Trade chargeFor, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        final ITarget target = new PlayerTarget(entity);
+        teleport(otherUser, target, chargeFor, cause, future);
+        future.thenAccept(success -> {
+            if (success) {
+                otherUser.sendMessage(tl("teleporting", target.getLocation().getWorld().getName(), target.getLocation().getBlockX(), target.getLocation().getBlockY(), target.getLocation().getBlockZ()));
+                teleportOwner.sendMessage(tl("teleporting", target.getLocation().getWorld().getName(), target.getLocation().getBlockX(), target.getLocation().getBlockY(), target.getLocation().getBlockZ()));
+            }
+        });
+    }
+
+    private void teleport(final IUser teleportee, final ITarget target, final Trade chargeFor, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        double delay = ess.getSettings().getTeleportDelay();
+
+        final TeleportWarmupEvent event = new TeleportWarmupEvent(teleportee, cause, target, delay);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
+        delay = event.getDelay();
+
+        Trade cashCharge = chargeFor;
+
+        if (chargeFor != null) {
+            chargeFor.isAffordableFor(teleportOwner, future);
+            if (future.isCompletedExceptionally()) {
+                return;
+            }
+
+            //This code is to make sure that commandcosts are checked in the initial world, and not in the resulting world.
+            if (!chargeFor.getCommandCost(teleportOwner).equals(BigDecimal.ZERO)) {
+                //By converting a command cost to a regular cost, the command cost permission isn't checked when executing the charge after teleport.
+                cashCharge = new Trade(chargeFor.getCommandCost(teleportOwner), ess);
+            }
+        }
+
+        if (cooldown(true, future)) {
+            return;
+        }
+        if (delay <= 0 || teleportOwner.isAuthorized("essentials.teleport.timer.bypass") || teleportee.isAuthorized("essentials.teleport.timer.bypass")) {
+            if (cooldown(false, future)) {
+                return;
+            }
+            nowAsync(teleportee, target, cause, future);
+            if (cashCharge != null) {
+                cashCharge.charge(teleportOwner, future);
+                if (future.isCompletedExceptionally()) {
+                    return;
+                }
+            }
+            return;
+        }
+
+        cancel(false);
+        warnUser(teleportee, delay);
+        initTimer((long) (delay * 1000.0), teleportee, target, cashCharge, cause, false);
+    }
+
+    private void teleportOther(final IUser teleporter, final IUser teleportee, final ITarget target, final Trade chargeFor, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        double delay = ess.getSettings().getTeleportDelay();
+
+        final TeleportWarmupEvent event = new TeleportWarmupEvent(teleportee, cause, target, delay);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
+        delay = event.getDelay();
+
+        Trade cashCharge = chargeFor;
+
+        if (teleporter != null && chargeFor != null) {
+            chargeFor.isAffordableFor(teleporter, future);
+            if (future.isCompletedExceptionally()) {
+                return;
+            }
+
+            //This code is to make sure that commandcosts are checked in the initial world, and not in the resulting world.
+            if (!chargeFor.getCommandCost(teleporter).equals(BigDecimal.ZERO)) {
+                //By converting a command cost to a regular cost, the command cost permission isn't checked when executing the charge after teleport.
+                cashCharge = new Trade(chargeFor.getCommandCost(teleporter), ess);
+            }
+        }
+
+        if (cooldown(true, future)) {
+            return;
+        }
+        if (delay <= 0 || teleporter == null
+            || teleporter.isAuthorized("essentials.teleport.timer.bypass")
+            || teleportOwner.isAuthorized("essentials.teleport.timer.bypass")
+            || teleportee.isAuthorized("essentials.teleport.timer.bypass")) {
+            if (cooldown(false, future)) {
+                return;
+            }
+
+            nowAsync(teleportee, target, cause, future);
+            if (teleporter != null && cashCharge != null) {
+                cashCharge.charge(teleporter, future);
+                if (future.isCompletedExceptionally()) {
+                    return;
+                }
+            }
+            return;
+        }
+
+        cancel(false);
+        warnUser(teleportee, delay);
+        initTimer((long) (delay * 1000.0), teleportee, target, cashCharge, cause, false);
+    }
+
+    @Override
+    public void respawn(final Trade chargeFor, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        double delay = ess.getSettings().getTeleportDelay();
+
+        final TeleportWarmupEvent event = new TeleportWarmupEvent(teleportOwner, cause, null, delay);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
+        delay = event.getDelay();
+
+        if (chargeFor != null) {
+            chargeFor.isAffordableFor(teleportOwner, future);
+            if (future.isCompletedExceptionally()) {
+                return;
+            }
+        }
+        if (cooldown(true, future)) {
+            return;
+        }
+        if (delay <= 0 || teleportOwner.isAuthorized("essentials.teleport.timer.bypass")) {
+            if (cooldown(false, future)) {
+                return;
+            }
+            respawnNow(teleportOwner, cause, future);
+            if (chargeFor != null) {
+                chargeFor.charge(teleportOwner, future);
+            }
+            return;
+        }
+
+        cancel(false);
+        warnUser(teleportOwner, delay);
+        initTimer((long) (delay * 1000.0), teleportOwner, null, chargeFor, cause, true);
+    }
+
+    void respawnNow(final IUser teleportee, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        final Player player = teleportee.getBase();
+        PaperLib.getBedSpawnLocationAsync(player, true).thenAccept(location -> {
+            if (location != null) {
+                nowAsync(teleportee, new LocationTarget(location), cause, future);
+            } else {
+                if (ess.getSettings().isDebug()) {
+                    ess.getLogger().info("Could not find bed spawn, forcing respawn event.");
+                }
+                final PlayerRespawnEvent pre = new PlayerRespawnEvent(player, player.getWorld().getSpawnLocation(), false);
+                ess.getServer().getPluginManager().callEvent(pre);
+                nowAsync(teleportee, new LocationTarget(pre.getRespawnLocation()), cause, future);
+            }
+        });
+    }
+
+    @Override
+    public void warp(final IUser otherUser, String warp, final Trade chargeFor, final TeleportCause cause, final CompletableFuture<Boolean> future) {
+        final UserWarpEvent event = new UserWarpEvent(otherUser, warp, chargeFor);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
+
+        warp = event.getWarp();
+        final Location loc;
+        try {
+            loc = ess.getWarps().getWarp(warp);
+        } catch (final WarpNotFoundException | InvalidWorldException e) {
+            future.completeExceptionally(e);
+            return;
+        }
+        otherUser.sendMessage(tl("warpingTo", warp, loc.getWorld().getName(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ()));
+        if (!otherUser.equals(teleportOwner)) {
+            teleportOwner.sendMessage(tl("warpingTo", warp, loc.getWorld().getName(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ()));
+        }
+        teleport(otherUser, new LocationTarget(loc), chargeFor, cause, future);
+    }
+
+    @Override
+    public void back(final Trade chargeFor, final CompletableFuture<Boolean> future) {
+        back(teleportOwner, chargeFor, future);
+    }
+
+    @Override
+    public void back(final IUser teleporter, final Trade chargeFor, final CompletableFuture<Boolean> future) {
+        tpType = TeleportType.BACK;
+        final Location loc = teleportOwner.getLastLocation();
+        teleportOwner.sendMessage(tl("backUsageMsg", loc.getWorld().getName(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ()));
+        teleportOther(teleporter, teleportOwner, new LocationTarget(loc), chargeFor, TeleportCause.COMMAND, future);
+    }
+
+    @Override
+    public void back(final CompletableFuture<Boolean> future) {
+        nowAsync(teleportOwner, new LocationTarget(teleportOwner.getLastLocation()), TeleportCause.COMMAND, future);
+    }
+
+    public void setTpType(final TeleportType tpType) {
+        this.tpType = tpType;
+    }
+
+    //If we need to cancelTimer a pending teleportPlayer call this method
+    private void cancel(final boolean notifyUser) {
+        if (timedTeleport != null) {
+            timedTeleport.cancelTimer(notifyUser);
+            timedTeleport = null;
+        }
+    }
+
+    private void initTimer(final long delay, final IUser teleportUser, final ITarget target, final Trade chargeFor, final TeleportCause cause, final boolean respawn) {
+        timedTeleport = new AsyncTimedTeleport(teleportOwner, ess, this, delay, teleportUser, target, chargeFor, cause, respawn);
+    }
+
+    public enum TeleportType {
+        TPA,
+        BACK,
+        NORMAL
+    }
+}

Essentials/src/com/earth2me/essentials/AsyncTimedTeleport.java

@@ -0,0 +1,151 @@
+package com.earth2me.essentials;
+
+import net.ess3.api.IEssentials;
+import net.ess3.api.IUser;
+import org.bukkit.Location;
+import org.bukkit.event.player.PlayerTeleportEvent.TeleportCause;
+
+import java.util.UUID;
+import java.util.concurrent.CompletableFuture;
+
+import static com.earth2me.essentials.I18n.tl;
+
+public class AsyncTimedTeleport implements Runnable {
+    private static final double MOVE_CONSTANT = 0.3;
+    private final IUser teleportOwner;
+    private final IEssentials ess;
+    private final AsyncTeleport teleport;
+    private final UUID timer_teleportee;
+    private final long timer_started; // time this task was initiated
+    private final long timer_delay; // how long to delay the teleportPlayer
+    // note that I initially stored a clone of the location for reference, but...
+    // when comparing locations, I got incorrect mismatches (rounding errors, looked like)
+    // so, the X/Y/Z values are stored instead and rounded off
+    private final long timer_initX;
+    private final long timer_initY;
+    private final long timer_initZ;
+    private final ITarget timer_teleportTarget;
+    private final boolean timer_respawn;
+    private final boolean timer_canMove;
+    private final Trade timer_chargeFor;
+    private final TeleportCause timer_cause;
+    private int timer_task;
+    private double timer_health;
+
+    AsyncTimedTeleport(final IUser user, final IEssentials ess, final AsyncTeleport teleport, final long delay, final IUser teleportUser, final ITarget target, final Trade chargeFor, final TeleportCause cause, final boolean respawn) {
+        this.teleportOwner = user;
+        this.ess = ess;
+        this.teleport = teleport;
+        this.timer_started = System.currentTimeMillis();
+        this.timer_delay = delay;
+        this.timer_health = teleportUser.getBase().getHealth();
+        this.timer_initX = Math.round(teleportUser.getBase().getLocation().getX() * MOVE_CONSTANT);
+        this.timer_initY = Math.round(teleportUser.getBase().getLocation().getY() * MOVE_CONSTANT);
+        this.timer_initZ = Math.round(teleportUser.getBase().getLocation().getZ() * MOVE_CONSTANT);
+        this.timer_teleportee = teleportUser.getBase().getUniqueId();
+        this.timer_teleportTarget = target;
+        this.timer_chargeFor = chargeFor;
+        this.timer_cause = cause;
+        this.timer_respawn = respawn;
+        this.timer_canMove = user.isAuthorized("essentials.teleport.timer.move");
+
+        timer_task = ess.runTaskTimerAsynchronously(this, 20, 20).getTaskId();
+    }
+
+    @Override
+    public void run() {
+
+        if (teleportOwner == null || !teleportOwner.getBase().isOnline() || teleportOwner.getBase().getLocation() == null) {
+            cancelTimer(false);
+            return;
+        }
+
+        final IUser teleportUser = ess.getUser(this.timer_teleportee);
+
+        if (teleportUser == null || !teleportUser.getBase().isOnline()) {
+            cancelTimer(false);
+            return;
+        }
+
+        final Location currLocation = teleportUser.getBase().getLocation();
+        if (currLocation == null) {
+            cancelTimer(false);
+            return;
+        }
+
+        if (!timer_canMove && (Math.round(currLocation.getX() * MOVE_CONSTANT) != timer_initX || Math.round(currLocation.getY() * MOVE_CONSTANT) != timer_initY || Math.round(currLocation.getZ() * MOVE_CONSTANT) != timer_initZ || teleportUser.getBase().getHealth() < timer_health)) {
+            // user moved, cancelTimer teleportPlayer
+            cancelTimer(true);
+            return;
+        }
+
+        class DelayedTeleportTask implements Runnable {
+            @Override
+            public void run() {
+
+                timer_health = teleportUser.getBase().getHealth(); // in case user healed, then later gets injured
+                final long now = System.currentTimeMillis();
+                if (now > timer_started + timer_delay) {
+                    try {
+                        teleport.cooldown(false);
+                    } catch (final Throwable ex) {
+                        teleportOwner.sendMessage(tl("cooldownWithMessage", ex.getMessage()));
+                        if (teleportOwner != teleportUser) {
+                            teleportUser.sendMessage(tl("cooldownWithMessage", ex.getMessage()));
+                        }
+                    }
+                    try {
+                        cancelTimer(false);
+                        teleportUser.sendMessage(tl("teleportationCommencing"));
+
+                        final CompletableFuture<Boolean> future = new CompletableFuture<>();
+                        future.exceptionally(e -> {
+                            ess.showError(teleportOwner.getSource(), e, "\\ teleport");
+                            return false;
+                        });
+                        if (timer_chargeFor != null) {
+                            timer_chargeFor.isAffordableFor(teleportOwner);
+                        }
+                        if (timer_respawn) {
+                            teleport.respawnNow(teleportUser, timer_cause, future);
+                        } else {
+                            teleport.nowAsync(teleportUser, timer_teleportTarget, timer_cause, future);
+                        }
+                        future.thenAccept(success -> {
+                            if (timer_chargeFor != null) {
+                                try {
+                                    timer_chargeFor.charge(teleportOwner);
+                                } catch (final ChargeException ex) {
+                                    ess.showError(teleportOwner.getSource(), ex, "\\ teleport");
+                                }
+                            }
+                        });
+
+                    } catch (final Exception ex) {
+                        ess.showError(teleportOwner.getSource(), ex, "\\ teleport");
+                    }
+                }
+            }
+        }
+
+        ess.scheduleSyncDelayedTask(new DelayedTeleportTask());
+    }
+
+    //If we need to cancelTimer a pending teleportPlayer call this method
+    void cancelTimer(final boolean notifyUser) {
+        if (timer_task == -1) {
+            return;
+        }
+        try {
+            ess.getServer().getScheduler().cancelTask(timer_task);
+            if (notifyUser) {
+                teleportOwner.sendMessage(tl("pendingTeleportCancelled"));
+                if (timer_teleportee != null && !timer_teleportee.equals(teleportOwner.getBase().getUniqueId())) {
+                    ess.getUser(timer_teleportee).sendMessage(tl("pendingTeleportCancelled"));
+                }
+            }
+        } finally {
+            timer_task = -1;
+        }
+    }
+}

Essentials/src/com/earth2me/essentials/Backup.java

@@ -1,154 +1,133 @@
 package com.earth2me.essentials;
 
-import static com.earth2me.essentials.I18n._;
-import java.io.BufferedReader;
-import java.io.IOException;
-import java.io.InputStreamReader;
-import java.util.logging.Level;
-import java.util.logging.Logger;
+import net.ess3.api.IEssentials;
 import org.bukkit.Server;
 import org.bukkit.command.CommandSender;
 
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.atomic.AtomicBoolean;
+import java.util.logging.Level;
+import java.util.logging.Logger;
 
-public class Backup implements Runnable
-{
-	private static final Logger LOGGER = Logger.getLogger("Minecraft");
-	private transient final Server server;
-	private transient final IEssentials ess;
-	private transient boolean running = false;
-	private transient int taskId = -1;
-	private transient boolean active = false;
+import static com.earth2me.essentials.I18n.tl;
 
-	public Backup(final IEssentials ess)
-	{
-		this.ess = ess;
-		server = ess.getServer();
-		if (server.getOnlinePlayers().length > 0)
-		{
-			ess.runTaskAsynchronously(new Runnable()
-			{
-				@Override
-				public void run()
-				{
-					startTask();
-				}
-			});
-		}
-	}
+public class Backup implements Runnable {
+    private static final Logger LOGGER = Logger.getLogger("Essentials");
+    private transient final Server server;
+    private transient final IEssentials ess;
+    private final AtomicBoolean pendingShutdown = new AtomicBoolean(false);
+    private transient boolean running = false;
+    private transient int taskId = -1;
+    private transient boolean active = false;
+    private transient CompletableFuture<Object> taskLock = null;
 
-	public void onPlayerJoin()
-	{
-		startTask();
-	}
+    public Backup(final IEssentials ess) {
+        this.ess = ess;
+        server = ess.getServer();
+        if (!ess.getOnlinePlayers().isEmpty() || ess.getSettings().isAlwaysRunBackup()) {
+            ess.runTaskAsynchronously(this::startTask);
+        }
+    }
 
-	public synchronized void stopTask()
-	{
-		running = false;
-		if (taskId != -1)
-		{
-			server.getScheduler().cancelTask(taskId);
-		}
-		taskId = -1;
-	}
+    public void onPlayerJoin() {
+        startTask();
+    }
 
-	private synchronized void startTask()
-	{
-		if (!running)
-		{
-			final long interval = ess.getSettings().getBackupInterval() * 1200; // minutes -> ticks
-			if (interval < 1200)
-			{
-				return;
-			}
-			taskId = ess.scheduleSyncRepeatingTask(this, interval, interval);
-			running = true;
-		}
-	}
+    public synchronized void stopTask() {
+        running = false;
+        if (taskId != -1) {
+            server.getScheduler().cancelTask(taskId);
+        }
+        taskId = -1;
+    }
 
-	@Override
-	public void run()
-	{
-		if (active)
-		{
-			return;
-		}
-		active = true;
-		final String command = ess.getSettings().getBackupCommand();
-		if (command == null || "".equals(command))
-		{
-			return;
-		}
-		if ("save-all".equalsIgnoreCase(command))
-		{
-			final CommandSender cs = server.getConsoleSender();
-			server.dispatchCommand(cs, "save-all");
-			active = false;
-			return;
-		}
-		LOGGER.log(Level.INFO, _("backupStarted"));
-		final CommandSender cs = server.getConsoleSender();
-		server.dispatchCommand(cs, "save-all");
-		server.dispatchCommand(cs, "save-off");
+    private synchronized void startTask() {
+        if (!running) {
+            final long interval = ess.getSettings().getBackupInterval() * 1200; // minutes -> ticks
+            if (interval < 1200) {
+                return;
+            }
+            taskId = ess.scheduleSyncRepeatingTask(this, interval, interval);
+            running = true;
+        }
+    }
 
-		ess.runTaskAsynchronously(
-				new Runnable()
-				{
-					@Override
-					public void run()
-					{
-						try
-						{
-							final ProcessBuilder childBuilder = new ProcessBuilder(command);
-							childBuilder.redirectErrorStream(true);
-							childBuilder.directory(ess.getDataFolder().getParentFile().getParentFile());
-							final Process child = childBuilder.start();
-							final BufferedReader reader = new BufferedReader(new InputStreamReader(child.getInputStream()));
-							try
-							{
-								child.waitFor();
-								String line;
-								do
-								{
-									line = reader.readLine();
-									if (line != null)
-									{
-										LOGGER.log(Level.INFO, line);
-									}
-								}
-								while (line != null);
-							}
-							finally
-							{
-								reader.close();
-							}
-						}
-						catch (InterruptedException ex)
-						{
-							LOGGER.log(Level.SEVERE, null, ex);
-						}
-						catch (IOException ex)
-						{
-							LOGGER.log(Level.SEVERE, null, ex);
-						}
-						finally
-						{
-							ess.scheduleSyncDelayedTask(
-									new Runnable()
-									{
-										@Override
-										public void run()
-										{
-											server.dispatchCommand(cs, "save-on");
-											if (server.getOnlinePlayers().length == 0)
-											{
-												stopTask();
-											}
-											active = false;
-											LOGGER.log(Level.INFO, _("backupFinished"));
-										}
-									});
-						}
-					}
-				});
-	}
+    public CompletableFuture<Object> getTaskLock() {
+        return taskLock;
+    }
+
+    public void setPendingShutdown(final boolean shutdown) {
+        pendingShutdown.set(shutdown);
+    }
+
+    @Override
+    public void run() {
+        if (active) {
+            return;
+        }
+        final String command = ess.getSettings().getBackupCommand();
+        if (command == null || "".equals(command)) {
+            return;
+        }
+        active = true;
+        taskLock = new CompletableFuture<>();
+        if ("save-all".equalsIgnoreCase(command)) {
+            final CommandSender cs = server.getConsoleSender();
+            server.dispatchCommand(cs, "save-all");
+            active = false;
+            taskLock.complete(new Object());
+            return;
+        }
+        LOGGER.log(Level.INFO, tl("backupStarted"));
+        final CommandSender cs = server.getConsoleSender();
+        server.dispatchCommand(cs, "save-all");
+        server.dispatchCommand(cs, "save-off");
+
+        ess.runTaskAsynchronously(() -> {
+            try {
+                final ProcessBuilder childBuilder = new ProcessBuilder(command.split(" "));
+                childBuilder.redirectErrorStream(true);
+                childBuilder.directory(ess.getDataFolder().getParentFile().getParentFile());
+                final Process child = childBuilder.start();
+                ess.runTaskAsynchronously(() -> {
+                    try {
+                        try (final BufferedReader reader = new BufferedReader(new InputStreamReader(child.getInputStream()))) {
+                            String line;
+                            do {
+                                line = reader.readLine();
+                                if (line != null) {
+                                    LOGGER.log(Level.INFO, line);
+                                }
+                            } while (line != null);
+                        }
+                    } catch (final IOException ex) {
+                        LOGGER.log(Level.SEVERE, null, ex);
+                    }
+                });
+                child.waitFor();
+            } catch (final InterruptedException | IOException ex) {
+                LOGGER.log(Level.SEVERE, null, ex);
+            } finally {
+                class BackupEnableSaveTask implements Runnable {
+                    @Override
+                    public void run() {
+                        server.dispatchCommand(cs, "save-on");
+                        if (!ess.getSettings().isAlwaysRunBackup() && ess.getOnlinePlayers().isEmpty()) {
+                            stopTask();
+                        }
+                        active = false;
+                        taskLock.complete(new Object());
+                        LOGGER.log(Level.INFO, tl("backupFinished"));
+                    }
+                }
+
+                if (!pendingShutdown.get()) {
+                    ess.scheduleSyncDelayedTask(new BackupEnableSaveTask());
+                }
+            }
+        });
+    }
 }

Essentials/src/com/earth2me/essentials/ChargeException.java

@@ -1,15 +1,11 @@
 package com.earth2me.essentials;
 
+public class ChargeException extends Exception {
+    public ChargeException(final String message) {
+        super(message);
+    }
 
-public class ChargeException extends Exception
-{
-	public ChargeException(final String message)
-	{
-		super(message);
-	}
-
-	public ChargeException(final String message, final Throwable throwable)
-	{
-		super(message, throwable);
-	}
+    public ChargeException(final String message, final Throwable throwable) {
+        super(message, throwable);
+    }
 }

Essentials/src/com/earth2me/essentials/CommandSource.java

@@ -0,0 +1,56 @@
+package com.earth2me.essentials;
+
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+public class CommandSource {
+    protected CommandSender sender;
+
+    public CommandSource(final CommandSender base) {
+        this.sender = base;
+    }
+
+    public final CommandSender getSender() {
+        return sender;
+    }
+
+    public final Player getPlayer() {
+        if (sender instanceof Player) {
+            return (Player) sender;
+        }
+        return null;
+    }
+
+    public final net.ess3.api.IUser getUser(final IEssentials ess) {
+        if (sender instanceof Player) {
+            return ess.getUser((Player) sender);
+        }
+        return null;
+    }
+
+    public final boolean isPlayer() {
+        return sender instanceof Player;
+    }
+
+    public final CommandSender setSender(final CommandSender base) {
+        return this.sender = base;
+    }
+
+    public void sendMessage(final String message) {
+        if (!message.isEmpty()) {
+            sender.sendMessage(message);
+        }
+    }
+
+    public boolean isAuthorized(final String permission, final IEssentials ess) {
+        return !(sender instanceof Player) || getUser(ess).isAuthorized(permission);
+    }
+
+    public String getSelfSelector() {
+        return sender instanceof Player ? getPlayer().getName() : "*";
+    }
+
+    public String getDisplayName() {
+        return sender instanceof Player ? getPlayer().getDisplayName() : getSender().getName();
+    }
+}

Essentials/src/com/earth2me/essentials/Console.java

@@ -1,38 +1,89 @@
 package com.earth2me.essentials;
 
+import com.earth2me.essentials.messaging.IMessageRecipient;
+import com.earth2me.essentials.messaging.SimpleMessageRecipient;
 import org.bukkit.Server;
 import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
 
+public final class Console implements IMessageRecipient {
+    public static final String NAME = "Console";
+    private static Console instance; // Set in essentials
 
-public final class Console implements IReplyTo
-{
-	private static Console instance = new Console();
-	private CommandSender replyTo;
-	public final static String NAME = "Console";
+    private final IEssentials ess;
+    private final IMessageRecipient messageRecipient;
 
-	private Console()
-	{
-	}
+    private Console(final IEssentials ess) {
+        this.ess = ess;
+        this.messageRecipient = new SimpleMessageRecipient(ess, this);
+    }
 
-	public static CommandSender getCommandSender(Server server) throws Exception
-	{
-		return server.getConsoleSender();
-	}
+    public static Console getInstance() {
+        return instance;
+    }
 
-	@Override
-	public void setReplyTo(CommandSender user)
-	{
-		replyTo = user;
-	}
+    static void setInstance(final IEssentials ess) { // Called in Essentials#onEnable()
+        instance = new Console(ess);
+    }
 
-	@Override
-	public CommandSender getReplyTo()
-	{
-		return replyTo;
-	}
+    /**
+     * @deprecated Use {@link Console#getCommandSender()}
+     */
+    @Deprecated
+    public static CommandSender getCommandSender(final Server server) throws Exception {
+        return server.getConsoleSender();
+    }
 
-	public static Console getConsoleReplyTo()
-	{
-		return instance;
-	}
+    public CommandSender getCommandSender() {
+        return ess.getServer().getConsoleSender();
+    }
+
+    @Override
+    public String getName() {
+        return Console.NAME;
+    }
+
+    @Override
+    public String getDisplayName() {
+        return Console.NAME;
+    }
+
+    @Override
+    public void sendMessage(final String message) {
+        getCommandSender().sendMessage(message);
+    }
+
+    @Override
+    public boolean isReachable() {
+        return true;
+    }
+
+    /* ================================
+     * >> DELEGATE METHODS
+     * ================================ */
+
+    @Override
+    public MessageResponse sendMessage(final IMessageRecipient recipient, final String message) {
+        return this.messageRecipient.sendMessage(recipient, message);
+    }
+
+    @Override
+    public MessageResponse onReceiveMessage(final IMessageRecipient sender, final String message) {
+        return this.messageRecipient.onReceiveMessage(sender, message);
+    }
+
+    @Override
+    public IMessageRecipient getReplyRecipient() {
+        return this.messageRecipient.getReplyRecipient();
+    }
+
+    @Override
+    public void setReplyRecipient(final IMessageRecipient recipient) {
+        this.messageRecipient.setReplyRecipient(recipient);
+    }
+
+    @Override
+    public boolean isHiddenFrom(Player player) {
+        return false;
+    }
 }

Essentials/src/com/earth2me/essentials/Enchantments.java

@@ -1,166 +1,304 @@
 package com.earth2me.essentials;
 
-import com.earth2me.essentials.utils.NumberUtil;
+import org.bukkit.NamespacedKey;
+import org.bukkit.enchantments.Enchantment;
+
 import java.util.HashMap;
 import java.util.Locale;
 import java.util.Map;
 import java.util.Map.Entry;
 import java.util.Set;
-import org.bukkit.enchantments.Enchantment;
 
+public final class Enchantments {
+    private static final Map<String, Enchantment> ENCHANTMENTS = new HashMap<>();
+    private static final Map<String, Enchantment> ALIASENCHANTMENTS = new HashMap<>();
+    private static boolean isFlat;
 
-public class Enchantments
-{
-	private static final Map<String, Enchantment> ENCHANTMENTS = new HashMap<String, Enchantment>();
-	private static final Map<String, Enchantment> ALIASENCHANTMENTS = new HashMap<String, Enchantment>();
+    static {
+        ENCHANTMENTS.put("alldamage", Enchantment.DAMAGE_ALL);
+        ALIASENCHANTMENTS.put("alldmg", Enchantment.DAMAGE_ALL);
+        ENCHANTMENTS.put("sharpness", Enchantment.DAMAGE_ALL);
+        ALIASENCHANTMENTS.put("sharp", Enchantment.DAMAGE_ALL);
+        ALIASENCHANTMENTS.put("dal", Enchantment.DAMAGE_ALL);
 
-	static
-	{
-		ENCHANTMENTS.put("alldamage", Enchantment.DAMAGE_ALL);
-		ALIASENCHANTMENTS.put("alldmg", Enchantment.DAMAGE_ALL);
-		ENCHANTMENTS.put("sharpness", Enchantment.DAMAGE_ALL);
-		ALIASENCHANTMENTS.put("sharp", Enchantment.DAMAGE_ALL);
-		ALIASENCHANTMENTS.put("dal", Enchantment.DAMAGE_ALL);
+        ENCHANTMENTS.put("ardmg", Enchantment.DAMAGE_ARTHROPODS);
+        ENCHANTMENTS.put("baneofarthropods", Enchantment.DAMAGE_ARTHROPODS);
+        ALIASENCHANTMENTS.put("baneofarthropod", Enchantment.DAMAGE_ARTHROPODS);
+        ALIASENCHANTMENTS.put("arthropod", Enchantment.DAMAGE_ARTHROPODS);
+        ALIASENCHANTMENTS.put("dar", Enchantment.DAMAGE_ARTHROPODS);
 
-		ENCHANTMENTS.put("ardmg", Enchantment.DAMAGE_ARTHROPODS);
-		ENCHANTMENTS.put("baneofarthropods", Enchantment.DAMAGE_ARTHROPODS);
-		ALIASENCHANTMENTS.put("baneofarthropod", Enchantment.DAMAGE_ARTHROPODS);
-		ALIASENCHANTMENTS.put("arthropod", Enchantment.DAMAGE_ARTHROPODS);
-		ALIASENCHANTMENTS.put("dar", Enchantment.DAMAGE_ARTHROPODS);
+        ENCHANTMENTS.put("undeaddamage", Enchantment.DAMAGE_UNDEAD);
+        ENCHANTMENTS.put("smite", Enchantment.DAMAGE_UNDEAD);
+        ALIASENCHANTMENTS.put("du", Enchantment.DAMAGE_UNDEAD);
 
-		ENCHANTMENTS.put("undeaddamage", Enchantment.DAMAGE_UNDEAD);
-		ENCHANTMENTS.put("smite", Enchantment.DAMAGE_UNDEAD);
-		ALIASENCHANTMENTS.put("du", Enchantment.DAMAGE_UNDEAD);
+        ENCHANTMENTS.put("digspeed", Enchantment.DIG_SPEED);
+        ENCHANTMENTS.put("efficiency", Enchantment.DIG_SPEED);
+        ALIASENCHANTMENTS.put("minespeed", Enchantment.DIG_SPEED);
+        ALIASENCHANTMENTS.put("cutspeed", Enchantment.DIG_SPEED);
+        ALIASENCHANTMENTS.put("ds", Enchantment.DIG_SPEED);
+        ALIASENCHANTMENTS.put("eff", Enchantment.DIG_SPEED);
 
-		ENCHANTMENTS.put("digspeed", Enchantment.DIG_SPEED);
-		ENCHANTMENTS.put("efficiency", Enchantment.DIG_SPEED);
-		ALIASENCHANTMENTS.put("minespeed", Enchantment.DIG_SPEED);
-		ALIASENCHANTMENTS.put("cutspeed", Enchantment.DIG_SPEED);
-		ALIASENCHANTMENTS.put("ds", Enchantment.DIG_SPEED);
-		ALIASENCHANTMENTS.put("eff", Enchantment.DIG_SPEED);
+        ENCHANTMENTS.put("durability", Enchantment.DURABILITY);
+        ALIASENCHANTMENTS.put("dura", Enchantment.DURABILITY);
+        ENCHANTMENTS.put("unbreaking", Enchantment.DURABILITY);
+        ALIASENCHANTMENTS.put("d", Enchantment.DURABILITY);
 
-		ENCHANTMENTS.put("durability", Enchantment.DURABILITY);
-		ALIASENCHANTMENTS.put("dura", Enchantment.DURABILITY);
-		ENCHANTMENTS.put("unbreaking", Enchantment.DURABILITY);
-		ALIASENCHANTMENTS.put("d", Enchantment.DURABILITY);
+        ENCHANTMENTS.put("thorns", Enchantment.THORNS);
+        ENCHANTMENTS.put("highcrit", Enchantment.THORNS);
+        ALIASENCHANTMENTS.put("thorn", Enchantment.THORNS);
+        ALIASENCHANTMENTS.put("highercrit", Enchantment.THORNS);
+        ALIASENCHANTMENTS.put("t", Enchantment.THORNS);
 
-		ENCHANTMENTS.put("thorns", Enchantment.THORNS);
-		ENCHANTMENTS.put("highcrit", Enchantment.THORNS);
-		ALIASENCHANTMENTS.put("thorn", Enchantment.THORNS);
-		ALIASENCHANTMENTS.put("highercrit", Enchantment.THORNS);
-		ALIASENCHANTMENTS.put("t", Enchantment.THORNS);
+        ENCHANTMENTS.put("fireaspect", Enchantment.FIRE_ASPECT);
+        ENCHANTMENTS.put("fire", Enchantment.FIRE_ASPECT);
+        ALIASENCHANTMENTS.put("meleefire", Enchantment.FIRE_ASPECT);
+        ALIASENCHANTMENTS.put("meleeflame", Enchantment.FIRE_ASPECT);
+        ALIASENCHANTMENTS.put("fa", Enchantment.FIRE_ASPECT);
 
-		ENCHANTMENTS.put("fireaspect", Enchantment.FIRE_ASPECT);
-		ENCHANTMENTS.put("fire", Enchantment.FIRE_ASPECT);
-		ALIASENCHANTMENTS.put("meleefire", Enchantment.FIRE_ASPECT);
-		ALIASENCHANTMENTS.put("meleeflame", Enchantment.FIRE_ASPECT);
-		ALIASENCHANTMENTS.put("fa", Enchantment.FIRE_ASPECT);
+        ENCHANTMENTS.put("knockback", Enchantment.KNOCKBACK);
+        ALIASENCHANTMENTS.put("kback", Enchantment.KNOCKBACK);
+        ALIASENCHANTMENTS.put("kb", Enchantment.KNOCKBACK);
+        ALIASENCHANTMENTS.put("k", Enchantment.KNOCKBACK);
 
-		ENCHANTMENTS.put("knockback", Enchantment.KNOCKBACK);
-		ALIASENCHANTMENTS.put("kback", Enchantment.KNOCKBACK);
-		ALIASENCHANTMENTS.put("kb", Enchantment.KNOCKBACK);
-		ALIASENCHANTMENTS.put("k", Enchantment.KNOCKBACK);
+        ALIASENCHANTMENTS.put("blockslootbonus", Enchantment.LOOT_BONUS_BLOCKS);
+        ENCHANTMENTS.put("fortune", Enchantment.LOOT_BONUS_BLOCKS);
+        ALIASENCHANTMENTS.put("fort", Enchantment.LOOT_BONUS_BLOCKS);
+        ALIASENCHANTMENTS.put("lbb", Enchantment.LOOT_BONUS_BLOCKS);
 
-		ALIASENCHANTMENTS.put("blockslootbonus", Enchantment.LOOT_BONUS_BLOCKS);
-		ENCHANTMENTS.put("fortune", Enchantment.LOOT_BONUS_BLOCKS);
-		ALIASENCHANTMENTS.put("fort", Enchantment.LOOT_BONUS_BLOCKS);
-		ALIASENCHANTMENTS.put("lbb", Enchantment.LOOT_BONUS_BLOCKS);
+        ALIASENCHANTMENTS.put("mobslootbonus", Enchantment.LOOT_BONUS_MOBS);
+        ENCHANTMENTS.put("mobloot", Enchantment.LOOT_BONUS_MOBS);
+        ENCHANTMENTS.put("looting", Enchantment.LOOT_BONUS_MOBS);
+        ALIASENCHANTMENTS.put("lbm", Enchantment.LOOT_BONUS_MOBS);
 
-		ALIASENCHANTMENTS.put("mobslootbonus", Enchantment.LOOT_BONUS_MOBS);
-		ENCHANTMENTS.put("mobloot", Enchantment.LOOT_BONUS_MOBS);
-		ENCHANTMENTS.put("looting", Enchantment.LOOT_BONUS_MOBS);
-		ALIASENCHANTMENTS.put("lbm", Enchantment.LOOT_BONUS_MOBS);
+        ALIASENCHANTMENTS.put("oxygen", Enchantment.OXYGEN);
+        ENCHANTMENTS.put("respiration", Enchantment.OXYGEN);
+        ALIASENCHANTMENTS.put("breathing", Enchantment.OXYGEN);
+        ENCHANTMENTS.put("breath", Enchantment.OXYGEN);
+        ALIASENCHANTMENTS.put("o", Enchantment.OXYGEN);
 
-		ALIASENCHANTMENTS.put("oxygen", Enchantment.OXYGEN);
-		ENCHANTMENTS.put("respiration", Enchantment.OXYGEN);
-		ALIASENCHANTMENTS.put("breathing", Enchantment.OXYGEN);
-		ENCHANTMENTS.put("breath", Enchantment.OXYGEN);
-		ALIASENCHANTMENTS.put("o", Enchantment.OXYGEN);
+        ENCHANTMENTS.put("protection", Enchantment.PROTECTION_ENVIRONMENTAL);
+        ALIASENCHANTMENTS.put("prot", Enchantment.PROTECTION_ENVIRONMENTAL);
+        ENCHANTMENTS.put("protect", Enchantment.PROTECTION_ENVIRONMENTAL);
+        ALIASENCHANTMENTS.put("p", Enchantment.PROTECTION_ENVIRONMENTAL);
 
-		ENCHANTMENTS.put("protection", Enchantment.PROTECTION_ENVIRONMENTAL);
-		ALIASENCHANTMENTS.put("prot", Enchantment.PROTECTION_ENVIRONMENTAL);
-		ENCHANTMENTS.put("protect", Enchantment.PROTECTION_ENVIRONMENTAL);
-		ALIASENCHANTMENTS.put("p", Enchantment.PROTECTION_ENVIRONMENTAL);
+        ALIASENCHANTMENTS.put("explosionsprotection", Enchantment.PROTECTION_EXPLOSIONS);
+        ALIASENCHANTMENTS.put("explosionprotection", Enchantment.PROTECTION_EXPLOSIONS);
+        ALIASENCHANTMENTS.put("expprot", Enchantment.PROTECTION_EXPLOSIONS);
+        ALIASENCHANTMENTS.put("blastprotection", Enchantment.PROTECTION_EXPLOSIONS);
+        ALIASENCHANTMENTS.put("bprotection", Enchantment.PROTECTION_EXPLOSIONS);
+        ALIASENCHANTMENTS.put("bprotect", Enchantment.PROTECTION_EXPLOSIONS);
+        ENCHANTMENTS.put("blastprotect", Enchantment.PROTECTION_EXPLOSIONS);
+        ALIASENCHANTMENTS.put("pe", Enchantment.PROTECTION_EXPLOSIONS);
 
-		ALIASENCHANTMENTS.put("explosionsprotection", Enchantment.PROTECTION_EXPLOSIONS);
-		ALIASENCHANTMENTS.put("explosionprotection", Enchantment.PROTECTION_EXPLOSIONS);
-		ALIASENCHANTMENTS.put("expprot", Enchantment.PROTECTION_EXPLOSIONS);
-		ALIASENCHANTMENTS.put("blastprotection", Enchantment.PROTECTION_EXPLOSIONS);
-		ENCHANTMENTS.put("blastprotect", Enchantment.PROTECTION_EXPLOSIONS);
-		ALIASENCHANTMENTS.put("pe", Enchantment.PROTECTION_EXPLOSIONS);
+        ALIASENCHANTMENTS.put("fallprotection", Enchantment.PROTECTION_FALL);
+        ENCHANTMENTS.put("fallprot", Enchantment.PROTECTION_FALL);
+        ENCHANTMENTS.put("featherfall", Enchantment.PROTECTION_FALL);
+        ALIASENCHANTMENTS.put("featherfalling", Enchantment.PROTECTION_FALL);
+        ALIASENCHANTMENTS.put("pfa", Enchantment.PROTECTION_FALL);
 
-		ALIASENCHANTMENTS.put("fallprotection", Enchantment.PROTECTION_FALL);
-		ENCHANTMENTS.put("fallprot", Enchantment.PROTECTION_FALL);
-		ENCHANTMENTS.put("featherfall", Enchantment.PROTECTION_FALL);
-		ALIASENCHANTMENTS.put("featherfalling", Enchantment.PROTECTION_FALL);
-		ALIASENCHANTMENTS.put("pfa", Enchantment.PROTECTION_FALL);
+        ALIASENCHANTMENTS.put("fireprotection", Enchantment.PROTECTION_FIRE);
+        ALIASENCHANTMENTS.put("flameprotection", Enchantment.PROTECTION_FIRE);
+        ENCHANTMENTS.put("fireprotect", Enchantment.PROTECTION_FIRE);
+        ALIASENCHANTMENTS.put("flameprotect", Enchantment.PROTECTION_FIRE);
+        ENCHANTMENTS.put("fireprot", Enchantment.PROTECTION_FIRE);
+        ALIASENCHANTMENTS.put("flameprot", Enchantment.PROTECTION_FIRE);
+        ALIASENCHANTMENTS.put("pf", Enchantment.PROTECTION_FIRE);
 
-		ALIASENCHANTMENTS.put("fireprotection", Enchantment.PROTECTION_FIRE);
-		ALIASENCHANTMENTS.put("flameprotection", Enchantment.PROTECTION_FIRE);
-		ENCHANTMENTS.put("fireprotect", Enchantment.PROTECTION_FIRE);
-		ALIASENCHANTMENTS.put("flameprotect", Enchantment.PROTECTION_FIRE);
-		ENCHANTMENTS.put("fireprot", Enchantment.PROTECTION_FIRE);
-		ALIASENCHANTMENTS.put("flameprot", Enchantment.PROTECTION_FIRE);
-		ALIASENCHANTMENTS.put("pf", Enchantment.PROTECTION_FIRE);
+        ENCHANTMENTS.put("projectileprotection", Enchantment.PROTECTION_PROJECTILE);
+        ENCHANTMENTS.put("projprot", Enchantment.PROTECTION_PROJECTILE);
+        ALIASENCHANTMENTS.put("pp", Enchantment.PROTECTION_PROJECTILE);
 
-		ENCHANTMENTS.put("projectileprotection", Enchantment.PROTECTION_PROJECTILE);
-		ENCHANTMENTS.put("projprot", Enchantment.PROTECTION_PROJECTILE);
-		ALIASENCHANTMENTS.put("pp", Enchantment.PROTECTION_PROJECTILE);
+        ENCHANTMENTS.put("silktouch", Enchantment.SILK_TOUCH);
+        ALIASENCHANTMENTS.put("softtouch", Enchantment.SILK_TOUCH);
+        ALIASENCHANTMENTS.put("st", Enchantment.SILK_TOUCH);
 
-		ENCHANTMENTS.put("silktouch", Enchantment.SILK_TOUCH);
-		ALIASENCHANTMENTS.put("softtouch", Enchantment.SILK_TOUCH);
-		ALIASENCHANTMENTS.put("st", Enchantment.SILK_TOUCH);
+        ENCHANTMENTS.put("waterworker", Enchantment.WATER_WORKER);
+        ENCHANTMENTS.put("aquaaffinity", Enchantment.WATER_WORKER);
+        ALIASENCHANTMENTS.put("watermine", Enchantment.WATER_WORKER);
+        ALIASENCHANTMENTS.put("ww", Enchantment.WATER_WORKER);
 
-		ENCHANTMENTS.put("waterworker", Enchantment.WATER_WORKER);
-		ENCHANTMENTS.put("aquaaffinity", Enchantment.WATER_WORKER);
-		ALIASENCHANTMENTS.put("watermine", Enchantment.WATER_WORKER);
-		ALIASENCHANTMENTS.put("ww", Enchantment.WATER_WORKER);
+        ALIASENCHANTMENTS.put("firearrow", Enchantment.ARROW_FIRE);
+        ENCHANTMENTS.put("flame", Enchantment.ARROW_FIRE);
+        ENCHANTMENTS.put("flamearrow", Enchantment.ARROW_FIRE);
+        ALIASENCHANTMENTS.put("af", Enchantment.ARROW_FIRE);
 
-		ALIASENCHANTMENTS.put("firearrow", Enchantment.ARROW_FIRE);
-		ENCHANTMENTS.put("flame", Enchantment.ARROW_FIRE);
-		ENCHANTMENTS.put("flamearrow", Enchantment.ARROW_FIRE);
-		ALIASENCHANTMENTS.put("af", Enchantment.ARROW_FIRE);
+        ENCHANTMENTS.put("arrowdamage", Enchantment.ARROW_DAMAGE);
+        ENCHANTMENTS.put("power", Enchantment.ARROW_DAMAGE);
+        ALIASENCHANTMENTS.put("arrowpower", Enchantment.ARROW_DAMAGE);
+        ALIASENCHANTMENTS.put("ad", Enchantment.ARROW_DAMAGE);
 
-		ENCHANTMENTS.put("arrowdamage", Enchantment.ARROW_DAMAGE);
-		ENCHANTMENTS.put("power", Enchantment.ARROW_DAMAGE);
-		ALIASENCHANTMENTS.put("arrowpower", Enchantment.ARROW_DAMAGE);
-		ALIASENCHANTMENTS.put("ad", Enchantment.ARROW_DAMAGE);
+        ENCHANTMENTS.put("arrowknockback", Enchantment.ARROW_KNOCKBACK);
+        ALIASENCHANTMENTS.put("arrowkb", Enchantment.ARROW_KNOCKBACK);
+        ENCHANTMENTS.put("punch", Enchantment.ARROW_KNOCKBACK);
+        ALIASENCHANTMENTS.put("arrowpunch", Enchantment.ARROW_KNOCKBACK);
+        ALIASENCHANTMENTS.put("ak", Enchantment.ARROW_KNOCKBACK);
 
-		ENCHANTMENTS.put("arrowknockback", Enchantment.ARROW_KNOCKBACK);
-		ALIASENCHANTMENTS.put("arrowkb", Enchantment.ARROW_KNOCKBACK);
-		ENCHANTMENTS.put("punch", Enchantment.ARROW_KNOCKBACK);
-		ALIASENCHANTMENTS.put("arrowpunch", Enchantment.ARROW_KNOCKBACK);
-		ALIASENCHANTMENTS.put("ak", Enchantment.ARROW_KNOCKBACK);
+        ALIASENCHANTMENTS.put("infinitearrows", Enchantment.ARROW_INFINITE);
+        ENCHANTMENTS.put("infarrows", Enchantment.ARROW_INFINITE);
+        ENCHANTMENTS.put("infinity", Enchantment.ARROW_INFINITE);
+        ALIASENCHANTMENTS.put("infinite", Enchantment.ARROW_INFINITE);
+        ALIASENCHANTMENTS.put("unlimited", Enchantment.ARROW_INFINITE);
+        ALIASENCHANTMENTS.put("unlimitedarrows", Enchantment.ARROW_INFINITE);
+        ALIASENCHANTMENTS.put("ai", Enchantment.ARROW_INFINITE);
 
-		ALIASENCHANTMENTS.put("infinitearrows", Enchantment.ARROW_INFINITE);
-		ENCHANTMENTS.put("infarrows", Enchantment.ARROW_INFINITE);
-		ENCHANTMENTS.put("infinity", Enchantment.ARROW_INFINITE);
-		ALIASENCHANTMENTS.put("infinite", Enchantment.ARROW_INFINITE);
-		ALIASENCHANTMENTS.put("unlimited", Enchantment.ARROW_INFINITE);
-		ALIASENCHANTMENTS.put("unlimitedarrows", Enchantment.ARROW_INFINITE);
-		ALIASENCHANTMENTS.put("ai", Enchantment.ARROW_INFINITE);
-	}
+        ENCHANTMENTS.put("luck", Enchantment.LUCK);
+        ALIASENCHANTMENTS.put("luckofsea", Enchantment.LUCK);
+        ALIASENCHANTMENTS.put("luckofseas", Enchantment.LUCK);
+        ALIASENCHANTMENTS.put("rodluck", Enchantment.LUCK);
 
-	public static Enchantment getByName(String name) {
-		Enchantment enchantment;
-		if (NumberUtil.isInt(name)) {
-			enchantment = Enchantment.getById(Integer.parseInt(name));
-		} else {
-			enchantment = Enchantment.getByName(name.toUpperCase(Locale.ENGLISH));
-		}
-		if (enchantment == null)
-		{
-			enchantment = ENCHANTMENTS.get(name.toLowerCase(Locale.ENGLISH));
-		}
-		if (enchantment == null)
-		{
-			enchantment = ALIASENCHANTMENTS.get(name.toLowerCase(Locale.ENGLISH));
-		}
-		return enchantment;
-	}
+        ENCHANTMENTS.put("lure", Enchantment.LURE);
+        ALIASENCHANTMENTS.put("rodlure", Enchantment.LURE);
 
-	public static Set<Entry<String, Enchantment>> entrySet()
-	{
-		return ENCHANTMENTS.entrySet();
-	}
+        // 1.8
+        try {
+            final Enchantment depthStrider = Enchantment.getByName("DEPTH_STRIDER");
+            if (depthStrider != null) {
+                ENCHANTMENTS.put("depthstrider", depthStrider);
+                ALIASENCHANTMENTS.put("depth", depthStrider);
+                ALIASENCHANTMENTS.put("strider", depthStrider);
+            }
+        } catch (final IllegalArgumentException ignored) {
+        }
+
+        // 1.9
+        try {
+            final Enchantment frostWalker = Enchantment.getByName("FROST_WALKER");
+            if (frostWalker != null) {
+                ENCHANTMENTS.put("frostwalker", frostWalker);
+                ALIASENCHANTMENTS.put("frost", frostWalker);
+                ALIASENCHANTMENTS.put("walker", frostWalker);
+            }
+
+            final Enchantment mending = Enchantment.getByName("MENDING");
+            if (mending != null) {
+                ENCHANTMENTS.put("mending", mending);
+            }
+        } catch (final IllegalArgumentException ignored) {
+        }
+
+        // 1.11
+        try {
+            final Enchantment bindingCurse = Enchantment.getByName("BINDING_CURSE");
+            if (bindingCurse != null) {
+                ENCHANTMENTS.put("bindingcurse", bindingCurse);
+                ALIASENCHANTMENTS.put("bindcurse", bindingCurse);
+                ALIASENCHANTMENTS.put("binding", bindingCurse);
+                ALIASENCHANTMENTS.put("bind", bindingCurse);
+            }
+            final Enchantment vanishingCurse = Enchantment.getByName("VANISHING_CURSE");
+            if (vanishingCurse != null) {
+                ENCHANTMENTS.put("vanishingcurse", vanishingCurse);
+                ALIASENCHANTMENTS.put("vanishcurse", vanishingCurse);
+                ALIASENCHANTMENTS.put("vanishing", vanishingCurse);
+                ALIASENCHANTMENTS.put("vanish", vanishingCurse);
+            }
+            final Enchantment sweeping = Enchantment.getByName("SWEEPING_EDGE");
+            if (sweeping != null) {
+                ENCHANTMENTS.put("sweepingedge", sweeping);
+                ALIASENCHANTMENTS.put("sweepedge", sweeping);
+                ALIASENCHANTMENTS.put("sweeping", sweeping);
+            }
+        } catch (final IllegalArgumentException ignored) {
+        }
+
+        try { // 1.13
+            final Enchantment loyalty = Enchantment.getByName("LOYALTY");
+            if (loyalty != null) {
+                ENCHANTMENTS.put("loyalty", loyalty);
+                ALIASENCHANTMENTS.put("loyal", loyalty);
+                ALIASENCHANTMENTS.put("return", loyalty);
+            }
+            final Enchantment impaling = Enchantment.getByName("IMPALING");
+            if (impaling != null) {
+                ENCHANTMENTS.put("impaling", impaling);
+                ALIASENCHANTMENTS.put("impale", impaling);
+                ALIASENCHANTMENTS.put("oceandamage", impaling);
+                ALIASENCHANTMENTS.put("oceandmg", impaling);
+            }
+            final Enchantment riptide = Enchantment.getByName("RIPTIDE");
+            if (riptide != null) {
+                ENCHANTMENTS.put("riptide", riptide);
+                ALIASENCHANTMENTS.put("rip", riptide);
+                ALIASENCHANTMENTS.put("tide", riptide);
+                ALIASENCHANTMENTS.put("launch", riptide);
+            }
+            final Enchantment channelling = Enchantment.getByName("CHANNELING");
+            if (channelling != null) {
+                ENCHANTMENTS.put("channelling", channelling);
+                ALIASENCHANTMENTS.put("chanelling", channelling);
+                ALIASENCHANTMENTS.put("channeling", channelling);
+                ALIASENCHANTMENTS.put("chaneling", channelling);
+                ALIASENCHANTMENTS.put("channel", channelling);
+            }
+        } catch (final IllegalArgumentException ignored) {
+        }
+
+        try { // 1.14
+            final Enchantment multishot = Enchantment.getByName("MULTISHOT");
+            if (multishot != null) {
+                ENCHANTMENTS.put("multishot", multishot);
+                ALIASENCHANTMENTS.put("tripleshot", multishot);
+            }
+            final Enchantment quickCharge = Enchantment.getByName("QUICK_CHARGE");
+            if (quickCharge != null) {
+                ENCHANTMENTS.put("quickcharge", quickCharge);
+                ALIASENCHANTMENTS.put("quickdraw", quickCharge);
+                ALIASENCHANTMENTS.put("fastcharge", quickCharge);
+                ALIASENCHANTMENTS.put("fastdraw", quickCharge);
+            }
+            final Enchantment piercing = Enchantment.getByName("PIERCING");
+            if (piercing != null) {
+                ENCHANTMENTS.put("piercing", piercing);
+            }
+        } catch (final IllegalArgumentException ignored) {
+        }
+
+        try { // 1.16
+            final Enchantment soulspeed = Enchantment.getByName("SOUL_SPEED");
+            if (soulspeed != null) {
+                ENCHANTMENTS.put("soulspeed", soulspeed);
+                ALIASENCHANTMENTS.put("soilspeed", soulspeed);
+                ALIASENCHANTMENTS.put("sandspeed", soulspeed);
+            }
+        } catch (final IllegalArgumentException ignored) {
+        }
+
+        try {
+            final Class<?> namespacedKeyClass = Class.forName("org.bukkit.NamespacedKey");
+            final Class<?> enchantmentClass = Class.forName("org.bukkit.enchantments.Enchantment");
+            enchantmentClass.getDeclaredMethod("getByKey", namespacedKeyClass);
+            isFlat = true;
+        } catch (final ClassNotFoundException | NoSuchMethodException e) {
+            isFlat = false;
+        }
+    }
+
+    private Enchantments() {
+    }
+
+    public static Enchantment getByName(final String name) {
+        Enchantment enchantment = null;
+        if (isFlat) { // 1.13+ only
+            enchantment = Enchantment.getByKey(NamespacedKey.minecraft(name.toLowerCase()));
+        }
+
+        if (enchantment == null) {
+            enchantment = Enchantment.getByName(name.toUpperCase());
+        }
+        if (enchantment == null) {
+            enchantment = ENCHANTMENTS.get(name.toLowerCase(Locale.ENGLISH));
+        }
+        if (enchantment == null) {
+            enchantment = ALIASENCHANTMENTS.get(name.toLowerCase(Locale.ENGLISH));
+        }
+        return enchantment;
+    }
+
+    public static Set<Entry<String, Enchantment>> entrySet() {
+        return ENCHANTMENTS.entrySet();
+    }
+
+    public static Set<String> keySet() {
+        return ENCHANTMENTS.keySet();
+    }
 }

Essentials/src/com/earth2me/essentials/EssentialsBlockListener.java

@@ -1,46 +1,62 @@
 package com.earth2me.essentials;
 
 import com.earth2me.essentials.utils.LocationUtil;
+import com.earth2me.essentials.utils.MaterialUtil;
+import net.ess3.api.IEssentials;
 import org.bukkit.GameMode;
+import org.bukkit.block.BlockState;
+import org.bukkit.block.CreatureSpawner;
+import org.bukkit.entity.EntityType;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.EventPriority;
 import org.bukkit.event.Listener;
 import org.bukkit.event.block.BlockPlaceEvent;
 import org.bukkit.inventory.ItemStack;
 
+import java.util.Locale;
 
-public class EssentialsBlockListener implements Listener
-{
-	private final transient IEssentials ess;
+public class EssentialsBlockListener implements Listener {
+    private final transient IEssentials ess;
 
-	public EssentialsBlockListener(final IEssentials ess)
-	{
-		this.ess = ess;
-	}
+    public EssentialsBlockListener(final IEssentials ess) {
+        this.ess = ess;
+    }
 
-	@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-	public void onBlockPlace(final BlockPlaceEvent event)
-	{
-		// Do not rely on getItemInHand();
-		// http://leaky.bukkit.org/issues/663
-		final ItemStack is = LocationUtil.convertBlockToItem(event.getBlockPlaced());
-		if (is == null)
-		{
-			return;
-		}
-		final User user = ess.getUser(event.getPlayer());
-		if (user.hasUnlimited(is) && user.getGameMode() == GameMode.SURVIVAL)
-		{
-			ess.scheduleSyncDelayedTask(
-					new Runnable()
-					{
-						@Override
-						public void run()
-						{
-							user.getInventory().addItem(is);
-							user.updateInventory();
-						}
-					});
-		}
-	}
+    @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+    public void onBlockPlace(final BlockPlaceEvent event) {
+        // Do not rely on getItemInHand();
+        // http://leaky.bukkit.org/issues/663
+        final ItemStack is = LocationUtil.convertBlockToItem(event.getBlockPlaced());
+
+        if (is == null) {
+            return;
+        }
+
+        if (is.getType() == MaterialUtil.SPAWNER && event.getItemInHand() != null && event.getPlayer() != null && event.getItemInHand().getType() == MaterialUtil.SPAWNER) {
+            final BlockState blockState = event.getBlockPlaced().getState();
+            if (blockState instanceof CreatureSpawner) {
+                final CreatureSpawner spawner = (CreatureSpawner) blockState;
+                final EntityType type = ess.getSpawnerItemProvider().getEntityType(event.getItemInHand());
+                if (type != null && Mob.fromBukkitType(type) != null) {
+                    if (ess.getUser(event.getPlayer()).isAuthorized("essentials.spawnerconvert." + Mob.fromBukkitType(type).name().toLowerCase(Locale.ENGLISH))) {
+                        spawner.setSpawnedType(type);
+                        spawner.update();
+                    }
+                }
+            }
+        }
+
+        final User user = ess.getUser(event.getPlayer());
+        if (user.hasUnlimited(is) && user.getBase().getGameMode() == GameMode.SURVIVAL) {
+            class UnlimitedItemSpawnTask implements Runnable {
+                @Override
+                public void run() {
+                    user.getBase().getInventory().addItem(is);
+                    user.getBase().updateInventory();
+                }
+            }
+
+            ess.scheduleSyncDelayedTask(new UnlimitedItemSpawnTask());
+        }
+    }
 }

Essentials/src/com/earth2me/essentials/EssentialsEntityListener.java

@@ -1,222 +1,300 @@
 package com.earth2me.essentials;
 
-import static com.earth2me.essentials.I18n._;
+import com.earth2me.essentials.utils.VersionUtil;
+import net.ess3.api.IEssentials;
+import org.bukkit.Location;
+import org.bukkit.Material;
+import org.bukkit.enchantments.Enchantment;
+import org.bukkit.entity.Ageable;
+import org.bukkit.entity.Arrow;
+import org.bukkit.entity.Entity;
+import org.bukkit.entity.LivingEntity;
+import org.bukkit.entity.Player;
+import org.bukkit.entity.Projectile;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.EventPriority;
+import org.bukkit.event.Listener;
+import org.bukkit.event.entity.EntityCombustByEntityEvent;
+import org.bukkit.event.entity.EntityCombustEvent;
+import org.bukkit.event.entity.EntityDamageByEntityEvent;
+import org.bukkit.event.entity.EntityDamageEvent;
+import org.bukkit.event.entity.EntityRegainHealthEvent;
+import org.bukkit.event.entity.EntityRegainHealthEvent.RegainReason;
+import org.bukkit.event.entity.EntityShootBowEvent;
+import org.bukkit.event.entity.EntityTargetEvent;
+import org.bukkit.event.entity.FoodLevelChangeEvent;
+import org.bukkit.event.entity.PlayerDeathEvent;
+import org.bukkit.event.entity.PotionSplashEvent;
+import org.bukkit.inventory.ItemStack;
+
 import java.util.List;
 import java.util.logging.Level;
 import java.util.logging.Logger;
 import java.util.regex.Pattern;
-import org.bukkit.Material;
-import org.bukkit.entity.*;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.EventPriority;
-import org.bukkit.event.Listener;
-import org.bukkit.event.entity.*;
-import org.bukkit.event.entity.EntityRegainHealthEvent.RegainReason;
-import org.bukkit.inventory.ItemStack;
 
+import static com.earth2me.essentials.I18n.tl;
 
-public class EssentialsEntityListener implements Listener
-{
-	private static final Logger LOGGER = Logger.getLogger("Minecraft");
-	private final IEssentials ess;
-	private static final transient Pattern powertoolPlayer = Pattern.compile("\\{player\\}");
+public class EssentialsEntityListener implements Listener {
+    private static final Logger LOGGER = Logger.getLogger("Essentials");
+    private static final transient Pattern powertoolPlayer = Pattern.compile("\\{player\\}");
+    private final IEssentials ess;
 
-	public EssentialsEntityListener(IEssentials ess)
-	{
-		this.ess = ess;
-	}
+    public EssentialsEntityListener(final IEssentials ess) {
+        this.ess = ess;
+    }
 
-	// This method does something undocumented reguarding certain bucket types #EasterEgg
-	@EventHandler(priority = EventPriority.LOW)
-	public void onEntityDamage(final EntityDamageByEntityEvent event)
-	{
-		final Entity eAttack = event.getDamager();
-		final Entity eDefend = event.getEntity();
-		if (eAttack instanceof Player)
-		{
-			final User attacker = ess.getUser(eAttack);
-			if (eDefend instanceof Player)
-			{
-				onPlayerVsPlayerDamage(event, (Player)eDefend, attacker);
-			}
-			else if (eDefend instanceof Ageable)
-			{
-				final ItemStack hand = attacker.getItemInHand();
-				if (hand != null && hand.getType() == Material.MILK_BUCKET)
-				{
-					((Ageable)eDefend).setBaby();
-					hand.setType(Material.BUCKET);
-					attacker.setItemInHand(hand);
-					attacker.updateInventory();
-					event.setCancelled(true);
-				}
-			}
-			attacker.updateActivity(true);
-		}
-		else if (eAttack instanceof Projectile && eDefend instanceof Player)
-		{
-			Entity shooter = ((Projectile)event.getDamager()).getShooter();
-			if (shooter instanceof Player)
-			{
-				final User attacker = ess.getUser(shooter);
-				onPlayerVsPlayerDamage(event, (Player)eDefend, attacker);
-				attacker.updateActivity(true);
-			}
-		}
-	}
+    // This method does something undocumented reguarding certain bucket types #EasterEgg
+    @EventHandler(priority = EventPriority.LOW)
+    public void onEntityDamage(final EntityDamageByEntityEvent event) {
+        final Entity eAttack = event.getDamager();
+        final Entity eDefend = event.getEntity();
+        if (eAttack instanceof Player) {
+            final User attacker = ess.getUser((Player) eAttack);
+            if (eDefend instanceof Player) {
+                onPlayerVsPlayerDamage(event, (Player) eDefend, attacker);
+            } else if (eDefend instanceof Ageable) {
+                final ItemStack hand = attacker.getBase().getItemInHand();
+                if (ess.getSettings().isMilkBucketEasterEggEnabled()
+                    && hand != null && hand.getType() == Material.MILK_BUCKET) {
+                    ((Ageable) eDefend).setBaby();
+                    hand.setType(Material.BUCKET);
+                    attacker.getBase().setItemInHand(hand);
+                    attacker.getBase().updateInventory();
+                    event.setCancelled(true);
+                }
+            }
+            attacker.updateActivityOnInteract(true);
+        } else if (eAttack instanceof Projectile && eDefend instanceof Player) {
+            final Projectile projectile = (Projectile) event.getDamager();
+            //This should return a ProjectileSource on 1.7.3 beta +
+            final Object shooter = projectile.getShooter();
+            if (shooter instanceof Player) {
+                final User attacker = ess.getUser((Player) shooter);
+                onPlayerVsPlayerDamage(event, (Player) eDefend, attacker);
+                attacker.updateActivityOnInteract(true);
+            }
+        }
+    }
 
-	private void onPlayerVsPlayerDamage(final EntityDamageByEntityEvent event, final Player defender, final User attacker)
-	{
-		if (ess.getSettings().getLoginAttackDelay() > 0
-			&& (System.currentTimeMillis() < (attacker.getLastLogin() + ess.getSettings().getLoginAttackDelay()))
-			&& !attacker.isAuthorized("essentials.pvpdelay.exempt"))
-		{
-			event.setCancelled(true);
-		}
+    private void onPlayerVsPlayerDamage(final EntityDamageByEntityEvent event, final Player defender, final User attacker) {
+        if (ess.getSettings().getLoginAttackDelay() > 0 && (System.currentTimeMillis() < (attacker.getLastLogin() + ess.getSettings().getLoginAttackDelay())) && !attacker.isAuthorized("essentials.pvpdelay.exempt")) {
+            event.setCancelled(true);
+        }
 
-		if (!defender.equals(attacker.getBase()) && (attacker.hasInvulnerabilityAfterTeleport() || ess.getUser(defender).hasInvulnerabilityAfterTeleport()))
-		{
-			event.setCancelled(true);
-		}
+        if (!defender.equals(attacker.getBase()) && (attacker.hasInvulnerabilityAfterTeleport() || ess.getUser(defender).hasInvulnerabilityAfterTeleport())) {
+            event.setCancelled(true);
+        }
 
-		if (attacker.isGodModeEnabled() && !attacker.isAuthorized("essentials.god.pvp"))
-		{
-			event.setCancelled(true);
-		}
+        if (attacker.isGodModeEnabled() && !attacker.isAuthorized("essentials.god.pvp")) {
+            event.setCancelled(true);
+        }
 
-		if (attacker.isHidden() && !attacker.isAuthorized("essentials.vanish.pvp"))
-		{
-			event.setCancelled(true);
-		}
+        if (attacker.isHidden() && !attacker.isAuthorized("essentials.vanish.pvp")) {
+            event.setCancelled(true);
+        }
 
-		onPlayerVsPlayerPowertool(event, defender, attacker);
-	}
+        if (attacker.arePowerToolsEnabled()) {
+            onPlayerVsPlayerPowertool(event, defender, attacker);
+        }
+    }
 
-	private void onPlayerVsPlayerPowertool(final EntityDamageByEntityEvent event, final Player defender, final User attacker)
-	{
-		final List<String> commandList = attacker.getPowertool(attacker.getItemInHand());
-		if (commandList != null && !commandList.isEmpty())
-		{
-			for (final String tempCommand : commandList)
-			{
-				final String command = powertoolPlayer.matcher(tempCommand).replaceAll(defender.getName());
-				if (command != null && !command.isEmpty() && !command.equals(tempCommand))
-				{
-					ess.scheduleSyncDelayedTask(
-							new Runnable()
-							{
-								@Override
-								public void run()
-								{
-									attacker.getServer().dispatchCommand(attacker.getBase(), command);
-									LOGGER.log(Level.INFO, String.format("[PT] %s issued server command: /%s", attacker.getName(), command));
-								}
-							});
+    private void onPlayerVsPlayerPowertool(final EntityDamageByEntityEvent event, final Player defender, final User attacker) {
+        final List<String> commandList = attacker.getPowertool(attacker.getBase().getItemInHand());
+        if (commandList != null && !commandList.isEmpty()) {
+            for (final String tempCommand : commandList) {
+                final String command = powertoolPlayer.matcher(tempCommand).replaceAll(defender.getName());
+                if (command != null && !command.isEmpty() && !command.equals(tempCommand)) {
 
-					event.setCancelled(true);
-					return;
-				}
-			}
-		}
-	}
+                    class PowerToolInteractTask implements Runnable {
+                        @Override
+                        public void run() {
+                            attacker.getBase().chat("/" + command);
+                            LOGGER.log(Level.INFO, String.format("[PT] %s issued server command: /%s", attacker.getName(), command));
+                        }
+                    }
 
-	@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-	public void onEntityDamage(final EntityDamageEvent event)
-	{
-		if (event.getEntity() instanceof Player && ess.getUser(event.getEntity()).isGodModeEnabled())
-		{
-			final Player player = (Player)event.getEntity();
-			player.setFireTicks(0);
-			player.setRemainingAir(player.getMaximumAir());
-			event.setCancelled(true);
-		}
-	}
+                    ess.scheduleSyncDelayedTask(new PowerToolInteractTask());
 
-	@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-	public void onEntityCombust(final EntityCombustEvent event)
-	{
-		if (event.getEntity() instanceof Player && ess.getUser(event.getEntity()).isGodModeEnabled())
-		{
-			event.setCancelled(true);
-		}
-	}
+                    event.setCancelled(true);
+                    return;
+                }
+            }
+        }
+    }
 
-	@EventHandler(priority = EventPriority.LOWEST)
-	public void onPlayerDeathEvent(final PlayerDeathEvent event)
-	{
-		final User user = ess.getUser(event.getEntity());
-		if (user.isAuthorized("essentials.back.ondeath") && !ess.getSettings().isCommandDisabled("back"))
-		{
-			user.setLastLocation();
-			user.sendMessage(_("backAfterDeath"));
-		}
-		if (!ess.getSettings().areDeathMessagesEnabled())
-		{
-			event.setDeathMessage("");
-		}
-	}
+    @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+    public void onEntityDamage(final EntityDamageEvent event) {
+        if (event.getEntity() instanceof Player && ess.getUser((Player) event.getEntity()).isGodModeEnabled()) {
+            final Player player = (Player) event.getEntity();
+            player.setFireTicks(0);
+            player.setRemainingAir(player.getMaximumAir());
+            event.setCancelled(true);
+        }
+    }
 
-	@EventHandler(priority = EventPriority.LOW)
-	public void onPlayerDeathExpEvent(final PlayerDeathEvent event)
-	{
-		final User user = ess.getUser(event.getEntity());
-		if (user.isAuthorized("essentials.keepxp"))
-		{
-			event.setKeepLevel(true);
-			event.setDroppedExp(0);
-		}
-	}
+    @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+    public void onEntityCombust(final EntityCombustEvent event) {
+        if (event.getEntity() instanceof Player && ess.getUser((Player) event.getEntity()).isGodModeEnabled()) {
+            event.setCancelled(true);
+        }
+    }
 
-	@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-	public void onFoodLevelChange(final FoodLevelChangeEvent event)
-	{
-		if (event.getEntity() instanceof Player)
-		{
-			final User user = ess.getUser(event.getEntity());
-			if (user.isGodModeEnabled())
-			{
-				if (user.isGodModeEnabledRaw())
-				{
-					user.setFoodLevel(20);
-					user.setSaturation(10);
-				}
-				event.setCancelled(true);
-			}
-		}
-	}
+    @EventHandler(priority = EventPriority.MONITOR)
+    public void onEntityCombustByEntity(final EntityCombustByEntityEvent event) {
+        if (event.getCombuster() instanceof Arrow && event.getEntity() instanceof Player) {
+            final Arrow combuster = (Arrow) event.getCombuster();
+            if (combuster.getShooter() instanceof Player) {
+                final Player shooter = (Player) combuster.getShooter();
+                if (shooter.hasMetadata("NPC")) {
+                    return;
+                }
+                final User srcCombuster = ess.getUser(shooter.getUniqueId());
+                if (srcCombuster.isGodModeEnabled() && !srcCombuster.isAuthorized("essentials.god.pvp")) {
+                    event.setCancelled(true);
+                }
+                if (srcCombuster.isHidden() && !srcCombuster.isAuthorized("essentials.vanish.pvp")) {
+                    event.setCancelled(true);
+                }
+            }
+        }
+    }
 
-	@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-	public void onEntityRegainHealth(final EntityRegainHealthEvent event)
-	{
-		if (event.getRegainReason() == RegainReason.SATIATED && event.getEntity() instanceof Player
-			&& ess.getUser(event.getEntity()).isAfk() && ess.getSettings().getFreezeAfkPlayers())
-		{
-			event.setCancelled(true);
-		}
-	}
+    @EventHandler(priority = EventPriority.LOWEST)
+    public void onPlayerDeathEvent(final PlayerDeathEvent event) {
+        final Entity entity = event.getEntity();
+        if (entity.hasMetadata("NPC")) {
+            return;
+        }
+        final User user = ess.getUser(event.getEntity());
+        if (ess.getSettings().infoAfterDeath()) {
+            final Location loc = user.getLocation();
+            user.sendMessage(tl("infoAfterDeath", loc.getWorld().getName(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ()));
+        }
+        if (user.isAuthorized("essentials.back.ondeath") && !ess.getSettings().isCommandDisabled("back")) {
+            user.setLastLocation();
+            user.sendMessage(tl("backAfterDeath"));
+        }
+        if (!ess.getSettings().areDeathMessagesEnabled()) {
+            event.setDeathMessage("");
+        }
+    }
 
-	@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-	public void onPotionSplashEvent(final PotionSplashEvent event)
-	{
-		for (LivingEntity entity : event.getAffectedEntities())
-		{
-			if (entity instanceof Player && ess.getUser(entity).isGodModeEnabled())
-			{
-				event.setIntensity(entity, 0d);
-			}
-		}
-	}
+    @EventHandler(priority = EventPriority.LOW)
+    public void onPlayerDeathExpEvent(final PlayerDeathEvent event) {
+        final User user = ess.getUser(event.getEntity());
+        if (user.isAuthorized("essentials.keepxp")) {
+            event.setKeepLevel(true);
+            event.setDroppedExp(0);
+        }
+    }
 
-	@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-	public void onEntityShootBow(EntityShootBowEvent event)
-	{
-		if (event.getEntity() instanceof Player)
-		{
-			final User user = ess.getUser(event.getEntity());
-			if (user.isAfk())
-			{
-				user.updateActivity(true);
-			}
-		}
-	}
+    @EventHandler(priority = EventPriority.LOW)
+    public void onPlayerDeathInvEvent(final PlayerDeathEvent event) {
+        final User user = ess.getUser(event.getEntity());
+        if (user.isAuthorized("essentials.keepinv")) {
+            event.setKeepInventory(true);
+            event.getDrops().clear();
+            final ISettings.KeepInvPolicy vanish = ess.getSettings().getVanishingItemsPolicy();
+            final ISettings.KeepInvPolicy bind = ess.getSettings().getBindingItemsPolicy();
+            if (VersionUtil.getServerBukkitVersion().isHigherThanOrEqualTo(VersionUtil.v1_11_2_R01) && (vanish != ISettings.KeepInvPolicy.KEEP || bind != ISettings.KeepInvPolicy.KEEP)) {
+                for (final ItemStack stack : event.getEntity().getInventory()) {
+                    if (stack != null) {
+                        if (stack.getEnchantments().containsKey(Enchantment.VANISHING_CURSE)) {
+                            if (vanish == ISettings.KeepInvPolicy.DELETE) {
+                                event.getEntity().getInventory().remove(stack);
+                            } else if (vanish == ISettings.KeepInvPolicy.DROP) {
+                                event.getDrops().add(stack);
+                                event.getEntity().getInventory().remove(stack);
+                            }
+                        }
+                        if (stack.getEnchantments().containsKey(Enchantment.BINDING_CURSE)) {
+                            if (bind == ISettings.KeepInvPolicy.DELETE) {
+                                event.getEntity().getInventory().remove(stack);
+                            } else if (bind == ISettings.KeepInvPolicy.DROP) {
+                                event.getEntity().getInventory().remove(stack);
+                                event.getDrops().add(stack);
+                            }
+                        }
+                    }
+                }
+                final ItemStack[] armor = event.getEntity().getInventory().getArmorContents();
+                for (int i = 0; i < armor.length; i++) {
+                    final ItemStack stack = armor[i];
+                    if (stack != null) {
+                        if (stack.getEnchantments().containsKey(Enchantment.VANISHING_CURSE)) {
+                            if (vanish == ISettings.KeepInvPolicy.DELETE) {
+                                armor[i] = null;
+                            } else if (vanish == ISettings.KeepInvPolicy.DROP) {
+                                if (!event.getDrops().contains(stack)) {
+                                    event.getDrops().add(stack);
+                                }
+                                armor[i] = null;
+                            }
+                        }
+                        if (stack.getEnchantments().containsKey(Enchantment.BINDING_CURSE)) {
+                            if (bind == ISettings.KeepInvPolicy.DELETE) {
+                                armor[i] = null;
+                            } else if (bind == ISettings.KeepInvPolicy.DROP) {
+                                if (!event.getDrops().contains(stack)) {
+                                    event.getDrops().add(stack);
+                                }
+                                armor[i] = null;
+                            }
+                        }
+                    }
+                }
+                event.getEntity().getInventory().setArmorContents(armor);
+            }
+        }
+    }
+
+    @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+    public void onFoodLevelChange(final FoodLevelChangeEvent event) {
+        if (event.getEntity() instanceof Player) {
+            final User user = ess.getUser((Player) event.getEntity());
+            if (user.isGodModeEnabled()) {
+                if (user.isGodModeEnabledRaw()) {
+                    user.getBase().setFoodLevel(20);
+                    user.getBase().setSaturation(10);
+                }
+                event.setCancelled(true);
+            }
+        }
+    }
+
+    @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+    public void onEntityRegainHealth(final EntityRegainHealthEvent event) {
+        if (event.getRegainReason() == RegainReason.SATIATED && event.getEntity() instanceof Player && ess.getUser((Player) event.getEntity()).isAfk() && ess.getSettings().getFreezeAfkPlayers()) {
+            event.setCancelled(true);
+        }
+    }
+
+    @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+    public void onPotionSplashEvent(final PotionSplashEvent event) {
+        for (final LivingEntity entity : event.getAffectedEntities()) {
+            if (entity instanceof Player && ess.getUser((Player) entity).isGodModeEnabled()) {
+                event.setIntensity(entity, 0d);
+            }
+        }
+    }
+
+    @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+    public void onEntityShootBow(final EntityShootBowEvent event) {
+        if (event.getEntity() instanceof Player) {
+            final User user = ess.getUser((Player) event.getEntity());
+            if (user.isAfk()) {
+                user.updateActivityOnInteract(true);
+            }
+        }
+    }
+
+    @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+    public void onEntityTarget(final EntityTargetEvent event) {
+        if (event.getTarget() instanceof Player) {
+            final User user = ess.getUser((Player) event.getTarget());
+            if (user.isVanished()) {
+                event.setCancelled(true);
+            }
+        }
+    }
 }

Essentials/src/com/earth2me/essentials/EssentialsPluginListener.java

@@ -1,58 +1,50 @@
 package com.earth2me.essentials;
 
-import java.util.logging.Level;
+import com.earth2me.essentials.register.payment.Methods;
+import net.ess3.api.IEssentials;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.EventPriority;
 import org.bukkit.event.Listener;
 import org.bukkit.event.server.PluginDisableEvent;
 import org.bukkit.event.server.PluginEnableEvent;
 
+import java.util.logging.Level;
 
-public class EssentialsPluginListener implements Listener, IConf
-{
-	private final transient IEssentials ess;
+public class EssentialsPluginListener implements Listener, IConf {
+    private final transient IEssentials ess;
 
-	public EssentialsPluginListener(final IEssentials ess)
-	{
-		this.ess = ess;
-	}
+    public EssentialsPluginListener(final IEssentials ess) {
+        this.ess = ess;
+    }
 
-	@EventHandler(priority = EventPriority.MONITOR)
-	public void onPluginEnable(final PluginEnableEvent event)
-	{
-		if (event.getPlugin().getName().equals("EssentialsChat"))
-		{
-			ess.getSettings().setEssentialsChatActive(true);
-		}
-		ess.getPermissionsHandler().checkPermissions();
-		ess.getAlternativeCommandsHandler().addPlugin(event.getPlugin());
-		if (!ess.getPaymentMethod().hasMethod() && ess.getPaymentMethod().setMethod(ess.getServer().getPluginManager()))
-		{
-			ess.getLogger().log(Level.INFO, "Payment method found (" + ess.getPaymentMethod().getMethod().getLongName() + " version: " + ess.getPaymentMethod().getMethod().getVersion() + ")");
-		}
-	}
+    @EventHandler(priority = EventPriority.MONITOR)
+    public void onPluginEnable(final PluginEnableEvent event) {
+        if (event.getPlugin().getName().equals("EssentialsChat")) {
+            ess.getSettings().setEssentialsChatActive(true);
+        }
+        ess.getPermissionsHandler().setUseSuperperms(ess.getSettings().useBukkitPermissions());
+        ess.getPermissionsHandler().checkPermissions();
+        ess.getAlternativeCommandsHandler().addPlugin(event.getPlugin());
+        if (!Methods.hasMethod() && Methods.setMethod(ess.getServer().getPluginManager())) {
+            ess.getLogger().log(Level.INFO, "Payment method found (" + Methods.getMethod().getLongName() + " version: " + Methods.getMethod().getVersion() + ")");
+        }
+    }
 
-	@EventHandler(priority = EventPriority.MONITOR)
-	public void onPluginDisable(final PluginDisableEvent event)
-	{
-		if (event.getPlugin().getName().equals("EssentialsChat"))
-		{
-			ess.getSettings().setEssentialsChatActive(false);
-		}
-		ess.getPermissionsHandler().checkPermissions();
-		ess.getAlternativeCommandsHandler().removePlugin(event.getPlugin());
-		// Check to see if the plugin thats being disabled is the one we are using
-		if (ess.getPaymentMethod() != null && ess.getPaymentMethod().hasMethod() && ess.getPaymentMethod().checkDisabled(event.getPlugin()))
-		{
-			ess.getPaymentMethod().reset();
-			ess.getLogger().log(Level.INFO, "Payment method was disabled. No longer accepting payments.");
-		}
-	}
+    @EventHandler(priority = EventPriority.MONITOR)
+    public void onPluginDisable(final PluginDisableEvent event) {
+        if (event.getPlugin().getName().equals("EssentialsChat")) {
+            ess.getSettings().setEssentialsChatActive(false);
+        }
+        ess.getPermissionsHandler().checkPermissions();
+        ess.getAlternativeCommandsHandler().removePlugin(event.getPlugin());
+        // Check to see if the plugin thats being disabled is the one we are using
+        if (Methods.hasMethod() && Methods.checkDisabled(event.getPlugin())) {
+            Methods.reset();
+            ess.getLogger().log(Level.INFO, "Payment method was disabled. No longer accepting payments.");
+        }
+    }
 
-	@Override
-	public void reloadConfig()
-	{
-		ess.getPermissionsHandler().setUseSuperperms(ess.getSettings().useBukkitPermissions());
-		ess.getPermissionsHandler().checkPermissions();
-	}
+    @Override
+    public void reloadConfig() {
+    }
 }

Essentials/src/com/earth2me/essentials/EssentialsServerListener.java

@@ -0,0 +1,116 @@
+package com.earth2me.essentials;
+
+import net.ess3.api.IEssentials;
+import net.ess3.nms.refl.ReflUtil;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.EventPriority;
+import org.bukkit.event.Listener;
+import org.bukkit.event.server.ServerListPingEvent;
+
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.util.Arrays;
+import java.util.Iterator;
+import java.util.List;
+import java.util.logging.Level;
+
+public class EssentialsServerListener implements Listener {
+    private static final List<String> ignoredSLPECallers = Arrays.asList(
+        ".LegacyPingHandler.channelRead(", // CB responding to pings from pre-Netty clients
+        "de.dytanic.cloudnet.bridge.BukkitBootstrap", // CloudNet v2 doing... something
+        "de.dytanic.cloudnet.ext.bridge.bukkit.BukkitCloudNetBridgePlugin" // CloudNet v3 doing... something else
+    );
+
+    private final transient IEssentials ess;
+    private final boolean isPaperSample;
+    private boolean unsupportedLogged = false;
+    private boolean npeWarned = false;
+    private Method setSampleText;
+    private Method getSampleText;
+
+    public EssentialsServerListener(final IEssentials ess) {
+        this.ess = ess;
+
+        if (ReflUtil.getClassCached("com.destroystokyo.paper.event.server.PaperServerListPingEvent") == null) {
+            // This workaround is only necessary for older Paper builds
+            setSampleText = ReflUtil.getMethodCached(ServerListPingEvent.class, "setSampleText", List.class);
+            getSampleText = ReflUtil.getMethodCached(ServerListPingEvent.class, "getSampleText");
+            if (setSampleText != null && getSampleText != null) {
+                ess.getLogger().info("ServerListPingEvent: Paper 1.12.2 setSampleText API");
+                isPaperSample = true;
+                return;
+            }
+        }
+
+        ess.getLogger().info("ServerListPingEvent: Spigot iterator API");
+        isPaperSample = false;
+    }
+
+    @EventHandler(priority = EventPriority.LOWEST)
+    public void onServerListPing(final ServerListPingEvent event) throws Exception {
+        if (isPaperSample) {
+            try {
+                final List<String> playerNames = (List<String>) getSampleText.invoke(event, null);
+                playerNames.removeIf(player -> ess.getUser(player).isVanished());
+                setSampleText.invoke(event, playerNames);
+            } catch (final IllegalAccessException | InvocationTargetException | ClassCastException e) {
+                if (!unsupportedLogged && shouldWarnSLPECaller(e)) {
+                    ess.getLogger().log(Level.WARNING, "Unable to hide players from server list ping "
+                        + "using Paper 1.12 method!", e);
+                    unsupportedLogged = true;
+                }
+            } catch (final NullPointerException e) {
+                if (!npeWarned && shouldWarnSLPECaller(e)) {
+                    npeWarned = true;
+                    final Exception ex = new Exception("A plugin has fired a ServerListPingEvent "
+                        + "without implementing Paper's methods. Point the author to https://git.io/v7Xzl.");
+                    ex.setStackTrace(e.getStackTrace());
+                    throw ex;
+                }
+            }
+        } else {
+            try {
+                final Iterator<Player> iterator = event.iterator();
+                while (iterator.hasNext()) {
+                    final Player player = iterator.next();
+                    if (ess.getUser(player).isVanished()) {
+                        iterator.remove();
+                    }
+                }
+            } catch (final UnsupportedOperationException e) {
+                if (!unsupportedLogged && shouldWarnSLPECaller(e)) {
+                    ess.getLogger().log(Level.WARNING, "Could not hide vanished players while handling " + event.getClass().getName(), e);
+                    unsupportedLogged = true;
+                }
+            }
+        }
+    }
+
+    /**
+     * Should we warn about this SLPE caller, or should we silently ignore it?
+     * This checks against the ignoredSLPECallers strings, and if it matches one of those, we
+     * return false.
+     *
+     * @param throwable A throwable caught by a catch block
+     * @return Whether or not to send a warning about this particular caller
+     */
+    private boolean shouldWarnSLPECaller(final Throwable throwable) {
+        final int maxStackDepth = 20; // Limit the depth when searching through the stack trace
+        int depth = 0;
+        for (final StackTraceElement element : throwable.getStackTrace()) {
+            depth++;
+            if (depth > maxStackDepth) {
+                break;
+            }
+
+            for (final String ignoredString : ignoredSLPECallers) {
+                if (element.toString().contains(ignoredString)) {
+                    return false; // We know about this error and should ignore it, so don't warn
+                }
+            }
+        }
+
+        return true; // We don't know for certain that we can ignore this, so warn just to be safe
+    }
+}

Essentials/src/com/earth2me/essentials/EssentialsTimer.java

@@ -1,123 +1,111 @@
 package com.earth2me.essentials;
 
+import net.ess3.api.IEssentials;
+import org.bukkit.entity.Player;
+
 import java.util.HashSet;
 import java.util.Iterator;
 import java.util.LinkedList;
 import java.util.Set;
+import java.util.UUID;
 import java.util.logging.Level;
-import org.bukkit.entity.Player;
 
+public class EssentialsTimer implements Runnable {
+    private final transient IEssentials ess;
+    private final transient Set<UUID> onlineUsers = new HashSet<>(); // Field is necessary for hidden users
+    private final LinkedList<Double> history = new LinkedList<>();
+    @SuppressWarnings("FieldCanBeLocal")
+    private final long maxTime = 10 * 1000000;
+    @SuppressWarnings("FieldCanBeLocal")
+    private final long tickInterval = 50;
+    private transient long lastPoll = System.nanoTime();
+    private int skip1 = 0;
+    private int skip2 = 0;
 
-public class EssentialsTimer implements Runnable
-{
-	private final transient IEssentials ess;
-	private final transient Set<String> onlineUsers = new HashSet<String>();
-	private transient long lastPoll = System.nanoTime();
-	private final LinkedList<Double> history = new LinkedList<Double>();
-	private int skip1 = 0;
-	private int skip2 = 0;
-	private final long maxTime = 10 * 1000000;
-	private final long tickInterval = 50;
-	
-	EssentialsTimer(final IEssentials ess)
-	{
-		this.ess = ess;
-		history.add(20d);
-	}
-	
-	@Override
-	public void run()
-	{
-		final long startTime = System.nanoTime();
-		final long currentTime = System.currentTimeMillis();
-		long timeSpent = (startTime - lastPoll) / 1000;
-		if (timeSpent == 0)
-		{
-			timeSpent = 1;
-		}
-		if (history.size() > 10)
-		{
-			history.remove();
-		}
-		double tps = tickInterval * 1000000.0 / timeSpent;
-		if (tps <= 21)
-		{
-			history.add(tps);
-		}
-		lastPoll = startTime;
-		int count = 0;
-		for (Player player : ess.getServer().getOnlinePlayers())
-		{
-			count++;
-			if (skip1 > 0)
-			{
-				skip1--;
-				continue;
-			}
-			if (count % 10 == 0)
-			{
-				if (System.nanoTime() - startTime > maxTime / 2)
-				{
-					skip1 = count - 1;
-					break;
-				}
-			}
-			try
-			{
-				final User user = ess.getUser(player);
-				onlineUsers.add(user.getName());
-				user.setLastOnlineActivity(currentTime);
-				user.checkActivity();
-			}
-			catch (Exception e)
-			{
-				ess.getLogger().log(Level.WARNING, "EssentialsTimer Error:", e);
-			}
-		}
-		
-		count = 0;
-		final Iterator<String> iterator = onlineUsers.iterator();
-		while (iterator.hasNext())
-		{
-			count++;
-			if (skip2 > 0)
-			{
-				skip2--;
-				continue;
-			}
-			if (count % 10 == 0)
-			{
-				if (System.nanoTime() - startTime > maxTime)
-				{
-					skip2 = count - 1;
-					break;
-				}
-			}
-			final User user = ess.getUser(iterator.next());
-			if (user.getLastOnlineActivity() < currentTime && user.getLastOnlineActivity() > user.getLastLogout())
-			{
-				if (!user.isHidden()) {
-					user.setLastLogout(user.getLastOnlineActivity());
-				}
-				iterator.remove();
-				continue;
-			}
-			user.checkMuteTimeout(currentTime);
-			user.checkJailTimeout(currentTime);
-			user.resetInvulnerabilityAfterTeleport();
-		}
-	}
-	
-	public double getAverageTPS()
-	{
-		double avg = 0;
-		for (Double f : history)
-		{
-			if (f != null)
-			{
-				avg += f;
-			}
-		}		
-		return avg / history.size();
-	}
+    EssentialsTimer(final IEssentials ess) {
+        this.ess = ess;
+        history.add(20d);
+    }
+
+    @Override
+    public void run() {
+        final long startTime = System.nanoTime();
+        final long currentTime = System.currentTimeMillis();
+        long timeSpent = (startTime - lastPoll) / 1000;
+        if (timeSpent == 0) {
+            timeSpent = 1;
+        }
+        if (history.size() > 10) {
+            history.remove();
+        }
+        final double tps = tickInterval * 1000000.0 / timeSpent;
+        if (tps <= 21) {
+            history.add(tps);
+        }
+        lastPoll = startTime;
+        int count = 0;
+        for (final Player player : ess.getOnlinePlayers()) {
+            count++;
+            if (skip1 > 0) {
+                skip1--;
+                continue;
+            }
+            if (count % 10 == 0) {
+                if (System.nanoTime() - startTime > maxTime / 2) {
+                    skip1 = count - 1;
+                    break;
+                }
+            }
+            try {
+                final User user = ess.getUser(player);
+                onlineUsers.add(user.getBase().getUniqueId());
+                user.setLastOnlineActivity(currentTime);
+                user.checkActivity();
+            } catch (final Exception e) {
+                ess.getLogger().log(Level.WARNING, "EssentialsTimer Error:", e);
+            }
+        }
+
+        count = 0;
+        final Iterator<UUID> iterator = onlineUsers.iterator();
+        while (iterator.hasNext()) {
+            count++;
+            if (skip2 > 0) {
+                skip2--;
+                continue;
+            }
+            if (count % 10 == 0) {
+                if (System.nanoTime() - startTime > maxTime) {
+                    skip2 = count - 1;
+                    break;
+                }
+            }
+            final User user = ess.getUser(iterator.next());
+            // Not sure why this would happen, but it does
+            if (user == null) {
+                iterator.remove();
+                continue;
+            }
+            if (user.getLastOnlineActivity() < currentTime && user.getLastOnlineActivity() > user.getLastLogout()) {
+                if (!user.isHidden()) {
+                    user.setLastLogout(user.getLastOnlineActivity());
+                }
+                iterator.remove();
+                continue;
+            }
+            user.checkMuteTimeout(currentTime);
+            user.checkJailTimeout(currentTime);
+            user.resetInvulnerabilityAfterTeleport();
+        }
+    }
+
+    public double getAverageTPS() {
+        double avg = 0;
+        for (final Double f : history) {
+            if (f != null) {
+                avg += f;
+            }
+        }
+        return avg / history.size();
+    }
 }

Essentials/src/com/earth2me/essentials/EssentialsUserConf.java

@@ -0,0 +1,62 @@
+package com.earth2me.essentials;
+
+import com.google.common.base.Charsets;
+import com.google.common.io.Files;
+import org.bukkit.Bukkit;
+
+import java.io.File;
+import java.io.IOException;
+import java.util.Locale;
+import java.util.UUID;
+import java.util.logging.Level;
+
+public class EssentialsUserConf extends EssentialsConf {
+    public final String username;
+    public final UUID uuid;
+
+    public EssentialsUserConf(final String username, final UUID uuid, final File configFile) {
+        super(configFile);
+        this.username = username;
+        this.uuid = uuid;
+    }
+
+    @Override
+    public boolean legacyFileExists() {
+        final File file = new File(configFile.getParentFile(), username + ".yml");
+        return file.exists();
+    }
+
+    @Override
+    public void convertLegacyFile() {
+        final File file = new File(configFile.getParentFile(), username + ".yml");
+        try {
+            Files.move(file, new File(configFile.getParentFile(), uuid + ".yml"));
+        } catch (final IOException ex) {
+            Bukkit.getLogger().log(Level.WARNING, "Failed to migrate user: " + username, ex);
+        }
+
+        setProperty("lastAccountName", username);
+    }
+
+    private File getAltFile() {
+        final UUID fn = UUID.nameUUIDFromBytes(("OfflinePlayer:" + username.toLowerCase(Locale.ENGLISH)).getBytes(Charsets.UTF_8));
+        return new File(configFile.getParentFile(), fn.toString() + ".yml");
+    }
+
+    @Override
+    public boolean altFileExists() {
+        if (username.equals(username.toLowerCase())) {
+            return false;
+        }
+        return getAltFile().exists();
+    }
+
+    @Override
+    public void convertAltFile() {
+        try {
+            Files.move(getAltFile(), new File(configFile.getParentFile(), uuid + ".yml"));
+        } catch (final IOException ex) {
+            Bukkit.getLogger().log(Level.WARNING, "Failed to migrate user: " + username, ex);
+        }
+    }
+}

Essentials/src/com/earth2me/essentials/ExecuteTimer.java

@@ -6,84 +6,67 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.Locale;
 
+public class ExecuteTimer {
+    private final transient List<ExecuteRecord> times;
+    private final transient DecimalFormat decimalFormat = new DecimalFormat("#0.000", DecimalFormatSymbols.getInstance(Locale.US));
 
-public class ExecuteTimer
-{
-	private final transient List<ExecuteRecord> times;
-	private final transient DecimalFormat decimalFormat = new DecimalFormat("#0.000", DecimalFormatSymbols.getInstance(Locale.US));
+    public ExecuteTimer() {
+        times = new ArrayList<>();
+    }
 
+    public void start() {
+        times.clear();
+        mark("start");
 
-	public ExecuteTimer()
-	{
-		times = new ArrayList<ExecuteRecord>();
-	}
+    }
 
-	public void start()
-	{
-		times.clear();
-		mark("start");
+    public void mark(final String label) {
+        if (!times.isEmpty() || "start".equals(label)) {
+            times.add(new ExecuteRecord(label, System.nanoTime()));
+        }
+    }
 
-	}
+    public String end() {
+        final StringBuilder output = new StringBuilder();
+        output.append("execution time: ");
+        String mark;
+        long time0 = 0;
+        long time1 = 0;
+        long time2 = 0;
+        double duration;
 
-	public void mark(final String label)
-	{
-		if (!times.isEmpty() || "start".equals(label))
-		{
-			times.add(new ExecuteRecord(label, System.nanoTime()));
-		}
-	}
+        for (final ExecuteRecord pair : times) {
+            mark = pair.getMark();
+            time2 = pair.getTime();
+            if (time1 > 0) {
+                duration = (time2 - time1) / 1000000.0;
+                output.append(mark).append(": ").append(decimalFormat.format(duration)).append("ms - ");
+            } else {
+                time0 = time2;
+            }
+            time1 = time2;
+        }
+        duration = (time1 - time0) / 1000000.0;
+        output.append("Total: ").append(decimalFormat.format(duration)).append("ms");
+        times.clear();
+        return output.toString();
+    }
 
-	public String end()
-	{
-		final StringBuilder output = new StringBuilder();
-		output.append("execution time: ");
-		String mark;
-		long time0 = 0;
-		long time1 = 0;
-		long time2 = 0;
-		double duration;
+    private static class ExecuteRecord {
+        private final String mark;
+        private final long time;
 
-		for (ExecuteRecord pair : times)
-		{
-			mark = (String)pair.getMark();
-			time2 = (Long)pair.getTime();
-			if (time1 > 0)
-			{
-				duration = (time2 - time1)/1000000.0;
-				output.append(mark).append(": ").append(decimalFormat.format(duration)).append("ms - ");
-			}
-			else
-			{
-				time0 = time2;
-			}
-			time1 = time2;
-		}
-		duration = (time1 - time0)/1000000.0;
-		output.append("Total: ").append(decimalFormat.format(duration)).append("ms");
-		times.clear();
-		return output.toString();
-	}
+        ExecuteRecord(final String mark, final long time) {
+            this.mark = mark;
+            this.time = time;
+        }
 
+        public String getMark() {
+            return mark;
+        }
 
-	static private class ExecuteRecord
-	{
-		private final String mark;
-		private final long time;
-
-		public ExecuteRecord(final String mark, final long time)
-		{
-			this.mark = mark;
-			this.time = time;
-		}
-
-		public String getMark()
-		{
-			return mark;
-		}
-
-		public long getTime()
-		{
-			return time;
-		}
-	}
-}
+        public long getTime() {
+            return time;
+        }
+    }
+}

Essentials/src/com/earth2me/essentials/I18n.java

@@ -1,187 +1,210 @@
 package com.earth2me.essentials;
 
-import com.earth2me.essentials.api.II18n;
+import net.ess3.api.IEssentials;
+
 import java.io.File;
 import java.io.FileInputStream;
 import java.io.FileNotFoundException;
+import java.io.IOException;
 import java.io.InputStream;
+import java.io.InputStreamReader;
 import java.net.MalformedURLException;
 import java.net.URL;
+import java.net.URLConnection;
+import java.nio.charset.StandardCharsets;
 import java.text.MessageFormat;
-import java.util.*;
+import java.util.Enumeration;
+import java.util.HashMap;
+import java.util.Locale;
+import java.util.Map;
+import java.util.MissingResourceException;
+import java.util.PropertyResourceBundle;
+import java.util.ResourceBundle;
 import java.util.logging.Level;
 import java.util.logging.Logger;
+import java.util.regex.Pattern;
 
+public class I18n implements net.ess3.api.II18n {
+    private static final String MESSAGES = "messages";
+    private static final Pattern NODOUBLEMARK = Pattern.compile("''");
+    private static final ResourceBundle NULL_BUNDLE = new ResourceBundle() {
+        public Enumeration<String> getKeys() {
+            return null;
+        }
 
-public class I18n implements II18n
-{
-	private static I18n instance;
-	private static final String MESSAGES = "messages";
-	private final transient Locale defaultLocale = Locale.getDefault();
-	private transient Locale currentLocale = defaultLocale;
-	private transient ResourceBundle customBundle;
-	private transient ResourceBundle localeBundle;
-	private final transient ResourceBundle defaultBundle;
-	private final transient Map<String, MessageFormat> messageFormatCache = new HashMap<String, MessageFormat>();
-	private final transient IEssentials ess;
+        protected Object handleGetObject(final String key) {
+            return null;
+        }
+    };
+    private static I18n instance;
+    private final transient Locale defaultLocale = Locale.getDefault();
+    private final transient ResourceBundle defaultBundle;
+    private final transient IEssentials ess;
+    private transient Locale currentLocale = defaultLocale;
+    private transient ResourceBundle customBundle;
+    private transient ResourceBundle localeBundle;
+    private transient Map<String, MessageFormat> messageFormatCache = new HashMap<>();
 
-	public I18n(final IEssentials ess)
-	{
-		this.ess = ess;
-		customBundle = ResourceBundle.getBundle(MESSAGES, defaultLocale, new FileResClassLoader(I18n.class.getClassLoader(), ess));
-		localeBundle = ResourceBundle.getBundle(MESSAGES, defaultLocale);
-		defaultBundle = ResourceBundle.getBundle(MESSAGES, Locale.ENGLISH);
-	}
+    public I18n(final IEssentials ess) {
+        this.ess = ess;
+        defaultBundle = ResourceBundle.getBundle(MESSAGES, Locale.ENGLISH, new UTF8PropertiesControl());
+        localeBundle = defaultBundle;
+        customBundle = NULL_BUNDLE;
+    }
 
-	public void onEnable()
-	{
-		instance = this;
-	}
+    public static String tl(final String string, final Object... objects) {
+        if (instance == null) {
+            return "";
+        }
+        if (objects.length == 0) {
+            return NODOUBLEMARK.matcher(instance.translate(string)).replaceAll("'");
+        } else {
+            return instance.format(string, objects);
+        }
+    }
 
-	public void onDisable()
-	{
-		instance = null;
-	}
+    public static String capitalCase(final String input) {
+        return input == null || input.length() == 0 ? input : input.toUpperCase(Locale.ENGLISH).charAt(0) + input.toLowerCase(Locale.ENGLISH).substring(1);
+    }
 
-	@Override
-	public Locale getCurrentLocale()
-	{
-		return currentLocale;
-	}
+    public void onEnable() {
+        instance = this;
+    }
 
-	public String translate(final String string)
-	{
-		try
-		{
-			try
-			{
-				return customBundle.getString(string);
-			}
-			catch (MissingResourceException ex)
-			{
-				return localeBundle.getString(string);
-			}
-		}
-		catch (MissingResourceException ex)
-		{
-			Logger.getLogger("Minecraft").log(Level.WARNING, String.format("Missing translation key \"%s\" in translation file %s", ex.getKey(), localeBundle.getLocale().toString()), ex);
-			return defaultBundle.getString(string);
-		}
-	}
+    public void onDisable() {
+        instance = null;
+    }
 
-	public static String _(final String string, final Object... objects)
-	{
-		if (instance == null)
-		{
-			return "";
-		}
-		if (objects.length == 0)
-		{
-			return instance.translate(string);
-		}
-		else
-		{
-			return instance.format(string, objects);
-		}
-	}
+    @Override
+    public Locale getCurrentLocale() {
+        return currentLocale;
+    }
 
-	public String format(final String string, final Object... objects)
-	{
-		String format = translate(string);
-		MessageFormat messageFormat = messageFormatCache.get(format);
-		if (messageFormat == null)
-		{
-			try
-			{
-				messageFormat = new MessageFormat(format);
-			}
-			catch (IllegalArgumentException e)
-			{
-				ess.getLogger().log(Level.SEVERE, "Invalid Translation key for '" + string + "': " + e.getMessage());
-				format = format.replaceAll("\\{(\\D*?)\\}", "\\[$1\\]");
-				messageFormat = new MessageFormat(format);
-			}
-			messageFormatCache.put(format, messageFormat);
-		}
-		return messageFormat.format(objects);
-	}
+    private String translate(final String string) {
+        try {
+            try {
+                return customBundle.getString(string);
+            } catch (final MissingResourceException ex) {
+                return localeBundle.getString(string);
+            }
+        } catch (final MissingResourceException ex) {
+            Logger.getLogger("Essentials").log(Level.WARNING, String.format("Missing translation key \"%s\" in translation file %s", ex.getKey(), localeBundle.getLocale().toString()), ex);
+            return defaultBundle.getString(string);
+        }
+    }
 
-	public void updateLocale(final String loc)
-	{
-		if (loc == null || loc.isEmpty())
-		{
-			return;
-		}
-		final String[] parts = loc.split("[_\\.]");
-		if (parts.length == 1)
-		{
-			currentLocale = new Locale(parts[0]);
-		}
-		if (parts.length == 2)
-		{
-			currentLocale = new Locale(parts[0], parts[1]);
-		}
-		if (parts.length == 3)
-		{
-			currentLocale = new Locale(parts[0], parts[1], parts[2]);
-		}
-		ResourceBundle.clearCache();
-		Logger.getLogger("Minecraft").log(Level.INFO, String.format("Using locale %s", currentLocale.toString()));
-		customBundle = ResourceBundle.getBundle(MESSAGES, currentLocale, new FileResClassLoader(I18n.class.getClassLoader(), ess));
-		localeBundle = ResourceBundle.getBundle(MESSAGES, currentLocale);
-	}
+    public String format(final String string, final Object... objects) {
+        String format = translate(string);
+        MessageFormat messageFormat = messageFormatCache.get(format);
+        if (messageFormat == null) {
+            try {
+                messageFormat = new MessageFormat(format);
+            } catch (final IllegalArgumentException e) {
+                ess.getLogger().log(Level.SEVERE, "Invalid Translation key for '" + string + "': " + e.getMessage());
+                format = format.replaceAll("\\{(\\D*?)\\}", "\\[$1\\]");
+                messageFormat = new MessageFormat(format);
+            }
+            messageFormatCache.put(format, messageFormat);
+        }
+        return messageFormat.format(objects).replace(' ', ' '); // replace nbsp with a space
+    }
 
-	public static String capitalCase(final String input)
-	{
-		return input == null || input.length() == 0
-			   ? input
-			   : input.toUpperCase(Locale.ENGLISH).charAt(0)
-				 + input.toLowerCase(Locale.ENGLISH).substring(1);
-	}
+    public void updateLocale(final String loc) {
+        if (loc != null && !loc.isEmpty()) {
+            final String[] parts = loc.split("[_\\.]");
+            if (parts.length == 1) {
+                currentLocale = new Locale(parts[0]);
+            }
+            if (parts.length == 2) {
+                currentLocale = new Locale(parts[0], parts[1]);
+            }
+            if (parts.length == 3) {
+                currentLocale = new Locale(parts[0], parts[1], parts[2]);
+            }
+        }
+        ResourceBundle.clearCache();
+        messageFormatCache = new HashMap<>();
+        Logger.getLogger("Essentials").log(Level.INFO, String.format("Using locale %s", currentLocale.toString()));
 
+        try {
+            localeBundle = ResourceBundle.getBundle(MESSAGES, currentLocale, new UTF8PropertiesControl());
+        } catch (final MissingResourceException ex) {
+            localeBundle = NULL_BUNDLE;
+        }
 
-	private static class FileResClassLoader extends ClassLoader
-	{
-		private final transient File dataFolder;
+        try {
+            customBundle = ResourceBundle.getBundle(MESSAGES, currentLocale, new FileResClassLoader(I18n.class.getClassLoader(), ess), new UTF8PropertiesControl());
+        } catch (final MissingResourceException ex) {
+            customBundle = NULL_BUNDLE;
+        }
+    }
 
-		FileResClassLoader(final ClassLoader classLoader, final IEssentials ess)
-		{
-			super(classLoader);
-			this.dataFolder = ess.getDataFolder();
-		}
+    /**
+     * Attempts to load properties files from the plugin directory before falling back to the jar.
+     */
+    private static class FileResClassLoader extends ClassLoader {
+        private final transient File dataFolder;
 
-		@Override
-		public URL getResource(final String string)
-		{
-			final File file = new File(dataFolder, string);
-			if (file.exists())
-			{
-				try
-				{
-					return file.toURI().toURL();
-				}
-				catch (MalformedURLException ex)
-				{
-				}
-			}
-			return super.getResource(string);
-		}
+        FileResClassLoader(final ClassLoader classLoader, final IEssentials ess) {
+            super(classLoader);
+            this.dataFolder = ess.getDataFolder();
+        }
 
-		@Override
-		public InputStream getResourceAsStream(final String string)
-		{
-			final File file = new File(dataFolder, string);
-			if (file.exists())
-			{
-				try
-				{
-					return new FileInputStream(file);
-				}
-				catch (FileNotFoundException ex)
-				{
-				}
-			}
-			return super.getResourceAsStream(string);
-		}
-	}
+        @Override
+        public URL getResource(final String string) {
+            final File file = new File(dataFolder, string);
+            if (file.exists()) {
+                try {
+                    return file.toURI().toURL();
+                } catch (final MalformedURLException ignored) {
+                }
+            }
+            return null;
+        }
+
+        @Override
+        public InputStream getResourceAsStream(final String string) {
+            final File file = new File(dataFolder, string);
+            if (file.exists()) {
+                try {
+                    return new FileInputStream(file);
+                } catch (final FileNotFoundException ignored) {
+                }
+            }
+            return null;
+        }
+    }
+
+    /**
+     * Reads .properties files as UTF-8 instead of ISO-8859-1, which is the default on Java 8/below.
+     * Java 9 fixes this by defaulting to UTF-8 for .properties files.
+     */
+    private static class UTF8PropertiesControl extends ResourceBundle.Control {
+        public ResourceBundle newBundle(final String baseName, final Locale locale, final String format, final ClassLoader loader, final boolean reload) throws IOException {
+            final String resourceName = toResourceName(toBundleName(baseName, locale), "properties");
+            ResourceBundle bundle = null;
+            InputStream stream = null;
+            if (reload) {
+                final URL url = loader.getResource(resourceName);
+                if (url != null) {
+                    final URLConnection connection = url.openConnection();
+                    if (connection != null) {
+                        connection.setUseCaches(false);
+                        stream = connection.getInputStream();
+                    }
+                }
+            } else {
+                stream = loader.getResourceAsStream(resourceName);
+            }
+            if (stream != null) {
+                try {
+                    // use UTF-8 here, this is the important bit
+                    bundle = new PropertyResourceBundle(new InputStreamReader(stream, StandardCharsets.UTF_8));
+                } finally {
+                    stream.close();
+                }
+            }
+            return bundle;
+        }
+    }
 }

Essentials/src/com/earth2me/essentials/IConf.java

@@ -1,6 +1,5 @@
 package com.earth2me.essentials;
 
-public interface IConf
-{
-	public void reloadConfig();
+public interface IConf {
+    void reloadConfig();
 }

Essentials/src/com/earth2me/essentials/IEssentials.java

@@ -1,82 +1,121 @@
 package com.earth2me.essentials;
 
+import com.earth2me.essentials.api.IItemDb;
 import com.earth2me.essentials.api.IJails;
 import com.earth2me.essentials.api.IWarps;
-import com.earth2me.essentials.metrics.Metrics;
 import com.earth2me.essentials.perm.PermissionsHandler;
-import com.earth2me.essentials.register.payment.Methods;
-import java.util.List;
+import net.ess3.provider.ContainerProvider;
+import net.ess3.provider.KnownCommandsProvider;
+import net.ess3.provider.ServerStateProvider;
+import net.ess3.provider.SpawnerBlockProvider;
+import net.ess3.provider.SpawnerItemProvider;
 import org.bukkit.World;
 import org.bukkit.command.Command;
 import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
 import org.bukkit.plugin.Plugin;
 import org.bukkit.scheduler.BukkitScheduler;
 import org.bukkit.scheduler.BukkitTask;
 
+import java.util.Collection;
+import java.util.List;
+import java.util.UUID;
+import java.util.function.Predicate;
 
-public interface IEssentials extends Plugin
-{
-	void addReloadListener(IConf listener);
+public interface IEssentials extends Plugin {
+    void addReloadListener(IConf listener);
 
-	void reload();
+    void reload();
 
-	boolean onCommandEssentials(CommandSender sender, Command command, String commandLabel, String[] args, ClassLoader classLoader, String commandPath, String permissionPrefix, IEssentialsModule module);
+    List<String> onTabCompleteEssentials(CommandSender sender, Command command, String commandLabel, String[] args, ClassLoader classLoader, String commandPath, String permissionPrefix, IEssentialsModule module);
 
-	User getUser(Object base);
+    boolean onCommandEssentials(CommandSender sender, Command command, String commandLabel, String[] args, ClassLoader classLoader, String commandPath, String permissionPrefix, IEssentialsModule module);
 
-	I18n getI18n();
+    @Deprecated
+    User getUser(Object base);
 
-	User getOfflineUser(String name);
+    User getUser(UUID base);
 
-	World getWorld(String name);
+    User getUser(String base);
 
-	int broadcastMessage(String message);
+    User getUser(Player base);
 
-	int broadcastMessage(IUser sender, String message);
+    I18n getI18n();
 
-	int broadcastMessage(String permission, String message);
+    User getOfflineUser(String name);
 
-	ISettings getSettings();
+    World getWorld(String name);
 
-	BukkitScheduler getScheduler();
+    int broadcastMessage(String message);
 
-	IJails getJails();
+    int broadcastMessage(IUser sender, String message);
 
-	IWarps getWarps();
+    int broadcastMessage(IUser sender, String message, Predicate<IUser> shouldExclude);
 
-	Worth getWorth();
+    int broadcastMessage(String permission, String message);
 
-	Backup getBackup();
+    ISettings getSettings();
 
-	Methods getPaymentMethod();
+    BukkitScheduler getScheduler();
 
-	BukkitTask runTaskAsynchronously(Runnable run);
+    IJails getJails();
 
-	BukkitTask runTaskLaterAsynchronously(Runnable run, long delay);
+    IWarps getWarps();
 
-	int scheduleSyncDelayedTask(Runnable run);
+    Worth getWorth();
 
-	int scheduleSyncDelayedTask(Runnable run, long delay);
+    Backup getBackup();
 
-	int scheduleSyncRepeatingTask(final Runnable run, long delay, long period);
+    Kits getKits();
 
-	TNTExplodeListener getTNTListener();
+    RandomTeleport getRandomTeleport();
 
-	PermissionsHandler getPermissionsHandler();
+    BukkitTask runTaskAsynchronously(Runnable run);
 
-	AlternativeCommandsHandler getAlternativeCommandsHandler();
+    BukkitTask runTaskLaterAsynchronously(Runnable run, long delay);
 
-	void showError(final CommandSender sender, final Throwable exception, final String commandLabel);
+    BukkitTask runTaskTimerAsynchronously(Runnable run, long delay, long period);
 
-	ItemDb getItemDb();
+    int scheduleSyncDelayedTask(Runnable run);
 
-	UserMap getUserMap();
+    int scheduleSyncDelayedTask(Runnable run, long delay);
 
-	Metrics getMetrics();
+    int scheduleSyncRepeatingTask(Runnable run, long delay, long period);
 
-	void setMetrics(Metrics metrics);
+    TNTExplodeListener getTNTListener();
 
-	EssentialsTimer getTimer();
+    PermissionsHandler getPermissionsHandler();
 
-	List<String> getVanishedPlayers();
+    AlternativeCommandsHandler getAlternativeCommandsHandler();
+
+    void showError(CommandSource sender, Throwable exception, String commandLabel);
+
+    IItemDb getItemDb();
+
+    UserMap getUserMap();
+
+    EssentialsTimer getTimer();
+
+    /**
+     * Get a list of players who are vanished.
+     *
+     * @return A list of players who are vanished
+     * @deprecated Use {@link net.ess3.api.IEssentials#getVanishedPlayersNew()} where possible.
+     */
+    @Deprecated
+    List<String> getVanishedPlayers();
+
+    Collection<Player> getOnlinePlayers();
+
+    Iterable<User> getOnlineUsers();
+
+    SpawnerItemProvider getSpawnerItemProvider();
+
+    SpawnerBlockProvider getSpawnerBlockProvider();
+
+    ServerStateProvider getServerStateProvider();
+
+    ContainerProvider getContainerProvider();
+
+    KnownCommandsProvider getKnownCommandsProvider();
 }

Essentials/src/com/earth2me/essentials/IEssentialsModule.java

@@ -1,6 +1,4 @@
 package com.earth2me.essentials;
 
-
-public interface IEssentialsModule
-{
+public interface IEssentialsModule {
 }

Essentials/src/com/earth2me/essentials/IReplyTo.java

@@ -1,18 +0,0 @@
-package com.earth2me.essentials;
-
-import org.bukkit.command.CommandSender;
-
-public interface IReplyTo
-{
-	/**
-	 * Sets the user to reply to
-	 * @param user
-	 */
-	public void setReplyTo(CommandSender user);
-
-	/**
-	 * Gets the user the sender should reply to
-	 * @return
-	 */
-	public CommandSender getReplyTo();
-}

Essentials/src/com/earth2me/essentials/ISettings.java

@@ -3,195 +3,384 @@ package com.earth2me.essentials;
 import com.earth2me.essentials.commands.IEssentialsCommand;
 import com.earth2me.essentials.signs.EssentialsSign;
 import com.earth2me.essentials.textreader.IText;
-import java.math.BigDecimal;
-import java.text.MessageFormat;
-import java.util.List;
-import java.util.Map;
-import java.util.Set;
-import org.bukkit.ChatColor;
+import org.bukkit.Material;
 import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.event.EventPriority;
 
+import java.math.BigDecimal;
+import java.text.NumberFormat;
+import java.util.List;
+import java.util.Map;
+import java.util.Map.Entry;
+import java.util.Set;
+import java.util.function.Predicate;
+import java.util.regex.Pattern;
 
-public interface ISettings extends IConf
-{
-	boolean areSignsDisabled();
+public interface ISettings extends IConf {
+    boolean areSignsDisabled();
 
-	IText getAnnounceNewPlayerFormat();
+    IText getAnnounceNewPlayerFormat();
 
-	boolean getAnnounceNewPlayers();
+    boolean getAnnounceNewPlayers();
 
-	String getNewPlayerKit();
+    String getNewPlayerKit();
 
-	String getBackupCommand();
+    String getBackupCommand();
 
-	long getBackupInterval();
+    long getBackupInterval();
 
-	MessageFormat getChatFormat(String group);
+    boolean isAlwaysRunBackup();
 
-	int getChatRadius();
+    String getChatFormat(String group);
 
-	BigDecimal getCommandCost(IEssentialsCommand cmd);
+    int getChatRadius();
 
-	BigDecimal getCommandCost(String label);
+    int getNearRadius();
 
-	String getCurrencySymbol();
+    char getChatShout();
 
-	int getOversizedStackSize();
+    char getChatQuestion();
 
-	int getDefaultStackSize();
+    BigDecimal getCommandCost(IEssentialsCommand cmd);
 
-	double getHealCooldown();
+    BigDecimal getCommandCost(String label);
 
-	Set<String> getSocialSpyCommands();
+    String getCurrencySymbol();
 
-	Map<String, Object> getKit(String name);
+    boolean isCurrencySymbolSuffixed();
 
-	ConfigurationSection getKits();
+    int getOversizedStackSize();
 
-	String getLocale();
+    int getDefaultStackSize();
 
-	String getNewbieSpawn();
+    double getHealCooldown();
 
-	String getNicknamePrefix();
+    Set<String> getSocialSpyCommands();
 
-	ChatColor getOperatorColor() throws Exception;
+    boolean getSocialSpyListenMutedPlayers();
 
-	boolean getPerWarpPermission();
+    Set<String> getMuteCommands();
 
-	boolean getProtectBoolean(final String configName, boolean def);
+    /**
+     * @Deprecated in favor of {@link Kits#getKits()}
+     */
+    @Deprecated
+    ConfigurationSection getKits();
 
-	int getProtectCreeperMaxHeight();
+    /**
+     * @Deprecated in favor of {@link Kits#getKit(String)}
+     */
+    @Deprecated
+    Map<String, Object> getKit(String kit);
 
-	List<Integer> getProtectList(final String configName);
+    /**
+     * @Deprecated in favor of {@link Kits#addKit(String, List, long)}}
+     */
+    @Deprecated
+    void addKit(String name, List<String> lines, long delay);
 
-	boolean getProtectPreventSpawn(final String creatureName);
+    @Deprecated
+    ConfigurationSection getKitSection();
 
-	String getProtectString(final String configName);
+    boolean isSkippingUsedOneTimeKitsFromKitList();
 
-	boolean getRespawnAtHome();
+    String getLocale();
 
-	Set getMultipleHomes();
+    String getNewbieSpawn();
 
-	int getHomeLimit(String set);
+    String getNicknamePrefix();
 
-	int getHomeLimit(User user);
+    String getOperatorColor() throws Exception;
 
-	int getSpawnMobLimit();
+    boolean getPerWarpPermission();
 
-	BigDecimal getStartingBalance();
+    boolean getProtectBoolean(final String configName, boolean def);
 
-	double getTeleportCooldown();
+    int getProtectCreeperMaxHeight();
 
-	double getTeleportDelay();
+    List<Material> getProtectList(final String configName);
 
-	boolean hidePermissionlessHelp();
+    boolean getProtectPreventSpawn(final String creatureName);
 
-	boolean isCommandDisabled(final IEssentialsCommand cmd);
+    String getProtectString(final String configName);
 
-	boolean isCommandDisabled(String label);
+    boolean getRespawnAtHome();
 
-	boolean isCommandOverridden(String name);
+    boolean isRespawnAtAnchor();
 
-	boolean isDebug();
+    Set getMultipleHomes();
 
-	boolean isEcoDisabled();
+    int getHomeLimit(String set);
 
-	boolean isTradeInStacks(int id);
+    int getHomeLimit(User user);
 
-	List<Integer> itemSpawnBlacklist();
+    int getSpawnMobLimit();
 
-	List<EssentialsSign> enabledSigns();
+    BigDecimal getStartingBalance();
 
-	boolean permissionBasedItemSpawn();
+    boolean isTeleportSafetyEnabled();
 
-	boolean showNonEssCommandsInHelp();
+    boolean isForceDisableTeleportSafety();
 
-	boolean warnOnBuildDisallow();
+    boolean isAlwaysTeleportSafety();
 
-	boolean warnOnSmite();
+    boolean isTeleportPassengerDismount();
 
-	BigDecimal getMaxMoney();
+    boolean isForcePassengerTeleport();
 
-	BigDecimal getMinMoney();
+    double getTeleportCooldown();
 
-	boolean isEcoLogEnabled();
+    double getTeleportDelay();
 
-	boolean isEcoLogUpdateEnabled();
+    boolean hidePermissionlessHelp();
 
-	boolean removeGodOnDisconnect();
+    boolean isCommandDisabled(final IEssentialsCommand cmd);
 
-	boolean changeDisplayName();
+    boolean isCommandDisabled(String label);
 
-	boolean changePlayerListName();
+    boolean isCommandOverridden(String name);
 
-	boolean isPlayerCommand(String string);
+    boolean isDebug();
 
-	boolean useBukkitPermissions();
+    void setDebug(boolean debug);
 
-	boolean addPrefixSuffix();
+    boolean isEcoDisabled();
 
-	boolean disablePrefix();
+    @Deprecated
+    boolean isTradeInStacks(int id);
 
-	boolean disableSuffix();
+    boolean isTradeInStacks(Material type);
 
-	long getAutoAfk();
+    List<Material> itemSpawnBlacklist();
 
-	long getAutoAfkKick();
+    List<EssentialsSign> enabledSigns();
 
-	boolean getFreezeAfkPlayers();
+    boolean permissionBasedItemSpawn();
 
-	boolean cancelAfkOnMove();
+    boolean showNonEssCommandsInHelp();
 
-	boolean cancelAfkOnInteract();
+    boolean warnOnBuildDisallow();
 
-	boolean areDeathMessagesEnabled();
+    boolean warnOnSmite();
 
-	public void setDebug(boolean debug);
+    BigDecimal getMaxMoney();
 
-	Set<String> getNoGodWorlds();
+    BigDecimal getMinMoney();
 
-	boolean getUpdateBedAtDaytime();
+    boolean isEcoLogEnabled();
 
-	boolean allowUnsafeEnchantments();
+    boolean isEcoLogUpdateEnabled();
 
-	boolean getRepairEnchanted();
+    boolean realNamesOnList();
 
-	boolean isWorldTeleportPermissions();
+    boolean removeGodOnDisconnect();
 
-	boolean isWorldHomePermissions();
+    boolean changeDisplayName();
 
-	boolean registerBackInListener();
+    boolean changePlayerListName();
 
-	boolean getDisableItemPickupWhileAfk();
+    boolean isPlayerCommand(String string);
 
-	EventPriority getRespawnPriority();
+    boolean useBukkitPermissions();
 
-	long getTpaAcceptCancellation();
+    boolean addPrefixSuffix();
 
-	boolean isMetricsEnabled();
+    boolean disablePrefix();
 
-	void setMetricsEnabled(boolean metricsEnabled);
+    boolean disableSuffix();
 
-	long getTeleportInvulnerability();
+    long getAutoAfk();
 
-	boolean isTeleportInvulnerability();
+    long getAutoAfkKick();
 
-	long getLoginAttackDelay();
+    boolean getFreezeAfkPlayers();
 
-	int getSignUsePerSecond();
+    boolean cancelAfkOnMove();
 
-	double getMaxFlySpeed();
+    boolean cancelAfkOnInteract();
 
-	double getMaxWalkSpeed();
+    boolean sleepIgnoresAfkPlayers();
 
-	public int getMailsPerMinute();
+    boolean isAfkListName();
 
-	public long getEconomyLagWarning();
+    String getAfkListName();
 
-	public void setEssentialsChatActive(boolean b);
+    boolean broadcastAfkMessage();
 
-	long getMaxTempban();
+    boolean areDeathMessagesEnabled();
+
+    KeepInvPolicy getVanishingItemsPolicy();
+
+    KeepInvPolicy getBindingItemsPolicy();
+
+    int getJoinQuitMessagePlayerCount();
+
+    boolean hasJoinQuitMessagePlayerCount();
+
+    Set<String> getNoGodWorlds();
+
+    boolean getUpdateBedAtDaytime();
+
+    boolean allowUnsafeEnchantments();
+
+    boolean getRepairEnchanted();
+
+    boolean isWorldTeleportPermissions();
+
+    boolean isWorldHomePermissions();
+
+    boolean registerBackInListener();
+
+    boolean getDisableItemPickupWhileAfk();
+
+    EventPriority getRespawnPriority();
+
+    EventPriority getSpawnJoinPriority();
+
+    long getTpaAcceptCancellation();
+
+    long getTeleportInvulnerability();
+
+    boolean isTeleportInvulnerability();
+
+    long getLoginAttackDelay();
+
+    int getSignUsePerSecond();
+
+    double getMaxFlySpeed();
+
+    double getMaxWalkSpeed();
+
+    int getMailsPerMinute();
+
+    long getEconomyLagWarning();
+
+    long getPermissionsLagWarning();
+
+    void setEssentialsChatActive(boolean b);
+
+    long getMaxMute();
+
+    long getMaxTempban();
+
+    Map<String, Object> getListGroupConfig();
+
+    int getMaxNickLength();
+
+    boolean ignoreColorsInMaxLength();
+
+    boolean hideDisplayNameInVanish();
+
+    int getMaxUserCacheCount();
+
+    boolean allowSilentJoinQuit();
+
+    boolean isCustomJoinMessage();
+
+    String getCustomJoinMessage();
+
+    boolean isCustomQuitMessage();
+
+    String getCustomQuitMessage();
+
+    boolean isNotifyNoNewMail();
+
+    boolean isDropItemsIfFull();
+
+    boolean isLastMessageReplyRecipient();
+
+    boolean isReplyToVanished();
+
+    BigDecimal getMinimumPayAmount();
+
+    boolean isPayExcludesIgnoreList();
+
+    long getLastMessageReplyRecipientTimeout();
+
+    boolean isMilkBucketEasterEggEnabled();
+
+    boolean isSendFlyEnableOnJoin();
+
+    boolean isWorldTimePermissions();
+
+    boolean isSpawnOnJoin();
+
+    List<String> getSpawnOnJoinGroups();
+
+    boolean isUserInSpawnOnJoinGroup(IUser user);
+
+    boolean isTeleportToCenterLocation();
+
+    boolean isCommandCooldownsEnabled();
+
+    boolean isWorldChangeFlyResetEnabled();
+
+    boolean isWorldChangeSpeedResetEnabled();
+
+    long getCommandCooldownMs(String label);
+
+    Entry<Pattern, Long> getCommandCooldownEntry(String label);
+
+    boolean isCommandCooldownPersistent(String label);
+
+    boolean isNpcsInBalanceRanking();
+
+    NumberFormat getCurrencyFormat();
+
+    List<EssentialsSign> getUnprotectedSignNames();
+
+    boolean isPastebinCreateKit();
+
+    boolean isAllowBulkBuySell();
+
+    boolean isAllowSellNamedItems();
+
+    boolean isAddingPrefixInPlayerlist();
+
+    boolean isAddingSuffixInPlayerlist();
+
+    int getNotifyPlayerOfMailCooldown();
+
+    int getMotdDelay();
+
+    boolean isDirectHatAllowed();
+
+    List<String> getDefaultEnabledConfirmCommands();
+
+    boolean isConfirmCommandEnabledByDefault(String commandName);
+
+    boolean isTeleportBackWhenFreedFromJail();
+
+    boolean isCompassTowardsHomePerm();
+
+    boolean isAllowWorldInBroadcastworld();
+
+    String getItemDbType();
+
+    boolean allowOldIdSigns();
+
+    boolean isWaterSafe();
+
+    boolean isSafeUsermap();
+
+    boolean logCommandBlockCommands();
+
+    Set<Predicate<String>> getNickBlacklist();
+
+    double getMaxProjectileSpeed();
+
+    boolean isRemovingEffectsOnHeal();
+
+    boolean isSpawnIfNoHome();
+
+    boolean isConfirmHomeOverwrite();
+
+    boolean infoAfterDeath();
+
+    enum KeepInvPolicy {
+        KEEP,
+        DELETE,
+        DROP
+    }
 
-	public Map<String, Object> getListGroupConfig();
 }

Essentials/src/com/earth2me/essentials/ITarget.java

@@ -2,8 +2,6 @@ package com.earth2me.essentials;
 
 import org.bukkit.Location;
 
-
-public interface ITarget
-{
-	public Location getLocation();
-}
+public interface ITarget {
+    Location getLocation();
+}

Essentials/src/com/earth2me/essentials/IUser.java

@@ -1,88 +1,213 @@
 package com.earth2me.essentials;
 
-import com.earth2me.essentials.api.ITeleport;
+import com.earth2me.essentials.api.IAsyncTeleport;
 import com.earth2me.essentials.commands.IEssentialsCommand;
-import java.math.BigDecimal;
-import java.util.Map;
-import java.util.Set;
+import net.ess3.api.ITeleport;
+import net.ess3.api.MaxMoneyException;
+import net.ess3.api.events.AfkStatusChangeEvent;
 import org.bukkit.Location;
+import org.bukkit.Material;
+import org.bukkit.block.Block;
 import org.bukkit.entity.Player;
 
+import java.math.BigDecimal;
+import java.util.Date;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.regex.Pattern;
 
-public interface IUser extends Player
-{
-	long getLastTeleportTimestamp();
+/**
+ * Provides access to the user abstraction and stored data. Maintainers should add methods to <i>this interface</i>.
+ *
+ * @deprecated External plugins should use {@link net.ess3.api.IUser} instead of this interface, in case future APIs are added.
+ */
+@Deprecated
+public interface IUser {
+    boolean isAuthorized(String node);
 
-	boolean isAuthorized(String node);
+    boolean isAuthorized(IEssentialsCommand cmd);
 
-	boolean isAuthorized(IEssentialsCommand cmd);
+    boolean isAuthorized(IEssentialsCommand cmd, String permissionPrefix);
 
-	boolean isAuthorized(IEssentialsCommand cmd, String permissionPrefix);
+    boolean isPermissionSet(String node);
 
-	void setLastTeleportTimestamp(long time);
+    void healCooldown() throws Exception;
 
-	Location getLastLocation();
+    void giveMoney(BigDecimal value) throws MaxMoneyException;
 
-	Player getBase();
+    void giveMoney(final BigDecimal value, final CommandSource initiator) throws MaxMoneyException;
 
-	BigDecimal getMoney();
+    void payUser(final User reciever, final BigDecimal value) throws Exception;
 
-	void takeMoney(BigDecimal value);
+    void takeMoney(BigDecimal value);
 
-	void giveMoney(BigDecimal value);
+    void takeMoney(final BigDecimal value, final CommandSource initiator);
 
-	boolean canAfford(BigDecimal value);
+    boolean canAfford(BigDecimal value);
 
-	String getGroup();
+    Boolean canSpawnItem(final Material material);
 
-	void setLastLocation();
+    void setLastLocation();
 
-	Location getHome(String name) throws Exception;
+    void setLogoutLocation();
 
-	Location getHome(Location loc) throws Exception;
+    void requestTeleport(final User player, final boolean here);
 
-	/**
-	 * 'Hidden' Represents when a player is hidden from others. This status includes when the player is hidden via other
-	 * supported plugins. Use isVanished() if you want to check if a user is vanished by Essentials.
-	 *
-	 * @return If the user is hidden or not
-	 * @see isVanished
-	 */
-	boolean isHidden();
+    /**
+     * Returns whether this user has an outstanding teleport request to deal with.
+     *
+     * @return whether there is a teleport request
+     */
+    boolean hasOutstandingTeleportRequest();
 
-	void setHidden(boolean vanish);
+    /**
+     * @deprecated This API is not asynchronous. Use {@link com.earth2me.essentials.api.IAsyncTeleport IAsyncTeleport} with {@link IUser#getAsyncTeleport()}
+     */
+    @Deprecated
+    ITeleport getTeleport();
 
-	/**
-	 * 'Vanished' Represents when a player is hidden from others by Essentials. This status does NOT include when the
-	 * player is hidden via other plugins. Use isHidden() if you want to check if a user is vanished by any supported
-	 * plugin.
-	 *
-	 * @return If the user is vanished or not
-	 * @see isHidden
-	 */
-	boolean isVanished();
+    IAsyncTeleport getAsyncTeleport();
 
-	void setVanished(boolean vanish);
+    BigDecimal getMoney();
 
-	ITeleport getTeleport();
+    void setMoney(final BigDecimal value) throws MaxMoneyException;
 
-	void setJail(String jail);
+    void setAfk(final boolean set, final AfkStatusChangeEvent.Cause cause);
 
-	boolean isIgnoreExempt();
+    /**
+     * 'Hidden' Represents when a player is hidden from others. This status includes when the player is hidden via other
+     * supported plugins. Use isVanished() if you want to check if a user is vanished by Essentials.
+     *
+     * @return If the user is hidden or not
+     * @see IUser#isVanished()
+     */
+    boolean isHidden();
 
-	boolean isAfk();
+    void setHidden(boolean vanish);
 
-	void setAfk(final boolean set);
+    boolean isGodModeEnabled();
 
-	void setLogoutLocation();
+    String getGroup();
 
-	Location getLogoutLocation();
+    boolean inGroup(final String group);
 
-	void setConfigProperty(String node, Object object);
+    boolean canBuild();
 
-	Set<String> getConfigKeys();
+    long getTeleportRequestTime();
 
-	Map<String, Object> getConfigMap();
+    void enableInvulnerabilityAfterTeleport();
 
-	Map<String, Object> getConfigMap(String node);
+    void resetInvulnerabilityAfterTeleport();
+
+    boolean hasInvulnerabilityAfterTeleport();
+
+    /**
+     * 'Vanished' Represents when a player is hidden from others by Essentials. This status does NOT include when the
+     * player is hidden via other plugins. Use isHidden() if you want to check if a user is vanished by any supported
+     * plugin.
+     *
+     * @return If the user is vanished or not
+     * @see IUser#isHidden()
+     */
+    boolean isVanished();
+
+    void setVanished(boolean vanish);
+
+    boolean isIgnoreExempt();
+
+    void sendMessage(String message);
+
+    /*
+     * UserData
+     */
+    Location getHome(String name) throws Exception;
+
+    Location getHome(Location loc) throws Exception;
+
+    List<String> getHomes();
+
+    void setHome(String name, Location loc);
+
+    void delHome(String name) throws Exception;
+
+    boolean hasHome();
+
+    Location getLastLocation();
+
+    Location getLogoutLocation();
+
+    long getLastTeleportTimestamp();
+
+    void setLastTeleportTimestamp(long time);
+
+    String getJail();
+
+    void setJail(String jail);
+
+    List<String> getMails();
+
+    void addMail(String mail);
+
+    boolean isAfk();
+
+    @Deprecated
+    void setAfk(final boolean set);
+
+    boolean isIgnoreMsg();
+
+    void setIgnoreMsg(boolean ignoreMsg);
+
+    void setConfigProperty(String node, Object object);
+
+    Set<String> getConfigKeys();
+
+    Map<String, Object> getConfigMap();
+
+    Map<String, Object> getConfigMap(String node);
+
+    Map<Pattern, Long> getCommandCooldowns();
+
+    Date getCommandCooldownExpiry(String label);
+
+    void addCommandCooldown(Pattern pattern, Date expiresAt, boolean save);
+
+    boolean clearCommandCooldown(Pattern pattern);
+
+    /*
+     *  PlayerExtension
+     */
+    Player getBase();
+
+    CommandSource getSource();
+
+    String getName();
+
+    String getDisplayName();
+
+    String getAfkMessage();
+
+    void setAfkMessage(final String message);
+
+    long getAfkSince();
+
+    boolean isAcceptingPay();
+
+    void setAcceptingPay(boolean acceptingPay);
+
+    boolean isPromptingPayConfirm();
+
+    void setPromptingPayConfirm(boolean prompt);
+
+    boolean isPromptingClearConfirm();
+
+    void setPromptingClearConfirm(boolean prompt);
+
+    boolean isLastMessageReplyRecipient();
+
+    void setLastMessageReplyRecipient(boolean enabled);
+
+    Map<User, BigDecimal> getConfirmingPayments();
+
+    Block getTargetBlock(int maxDistance);
 }

Essentials/src/com/earth2me/essentials/ItemDb.java

@@ -1,225 +0,0 @@
-package com.earth2me.essentials;
-
-import com.earth2me.essentials.utils.StringUtil;
-import static com.earth2me.essentials.I18n._;
-import com.earth2me.essentials.api.IItemDb;
-import com.earth2me.essentials.utils.NumberUtil;
-import java.util.*;
-import java.util.regex.Pattern;
-import org.bukkit.Material;
-import org.bukkit.inventory.ItemStack;
-
-
-public class ItemDb implements IConf, IItemDb
-{
-	private final transient IEssentials ess;
-
-	public ItemDb(final IEssentials ess)
-	{
-		this.ess = ess;
-		file = new ManagedFile("items.csv", ess);
-	}
-	private final transient Map<String, Integer> items = new HashMap<String, Integer>();
-	private final transient Map<ItemData, List<String>> names = new HashMap<ItemData, List<String>>();
-	private final transient Map<String, Short> durabilities = new HashMap<String, Short>();
-	private final transient ManagedFile file;
-	private final transient Pattern splitPattern = Pattern.compile("[:+',;.]");
-
-	@Override
-	public void reloadConfig()
-	{
-		final List<String> lines = file.getLines();
-
-		if (lines.isEmpty())
-		{
-			return;
-		}
-
-		durabilities.clear();
-		items.clear();
-		names.clear();
-
-		for (String line : lines)
-		{
-			line = line.trim().toLowerCase(Locale.ENGLISH);
-			if (line.length() > 0 && line.charAt(0) == '#')
-			{
-				continue;
-			}
-
-			final String[] parts = line.split("[^a-z0-9]");
-			if (parts.length < 2)
-			{
-				continue;
-			}
-
-			final int numeric = Integer.parseInt(parts[1]);
-			final short data = parts.length > 2 && !parts[2].equals("0") ? Short.parseShort(parts[2]) : 0;
-			String itemName = parts[0].toLowerCase(Locale.ENGLISH);
-
-			durabilities.put(itemName, data);
-			items.put(itemName, numeric);
-
-			ItemData itemData = new ItemData(numeric, data);
-			if (names.containsKey(itemData))
-			{
-				List<String> nameList = names.get(itemData);
-				nameList.add(itemName);
-				Collections.sort(nameList, new LengthCompare());
-			}
-			else
-			{
-				List<String> nameList = new ArrayList<String>();
-				nameList.add(itemName);
-				names.put(itemData, nameList);
-			}
-		}
-	}
-
-	@Override
-	public ItemStack get(final String id, final int quantity) throws Exception
-	{
-		final ItemStack retval = get(id.toLowerCase(Locale.ENGLISH));
-		retval.setAmount(quantity);
-		return retval;
-	}
-
-	@Override
-	public ItemStack get(final String id) throws Exception
-	{
-		int itemid = 0;
-		String itemname = null;
-		short metaData = 0;
-		String[] parts = splitPattern.split(id);
-		if (id.matches("^\\d+[:+',;.]\\d+$"))
-		{
-			itemid = Integer.parseInt(parts[0]);
-			metaData = Short.parseShort(parts[1]);
-		}
-		else if (NumberUtil.isInt(id))
-		{
-			itemid = Integer.parseInt(id);
-		}
-		else if (id.matches("^[^:+',;.]+[:+',;.]\\d+$"))
-		{
-			itemname = parts[0].toLowerCase(Locale.ENGLISH);
-			metaData = Short.parseShort(parts[1]);
-		}
-		else
-		{
-			itemname = id.toLowerCase(Locale.ENGLISH);
-		}
-
-		if (itemname != null)
-		{
-			if (items.containsKey(itemname))
-			{
-				itemid = items.get(itemname);
-				if (durabilities.containsKey(itemname) && metaData == 0)
-				{
-					metaData = durabilities.get(itemname);
-				}
-			}
-			else if (Material.getMaterial(itemname.toUpperCase(Locale.ENGLISH)) != null)
-			{
-				itemid = Material.getMaterial(itemname.toUpperCase(Locale.ENGLISH)).getId();
-				metaData = 0;
-			}
-			else
-			{
-				throw new Exception(_("unknownItemName", id));
-			}
-		}
-
-		final Material mat = Material.getMaterial(itemid);
-		if (mat == null)
-		{
-			throw new Exception(_("unknownItemId", itemid));
-		}
-		final ItemStack retval = new ItemStack(mat);
-		retval.setAmount(mat.getMaxStackSize());
-		retval.setDurability(metaData);
-		return retval;
-	}
-
-	public String names(ItemStack item)
-	{
-		ItemData itemData = new ItemData(item.getTypeId(), item.getDurability());
-		List<String> nameList = names.get(itemData);
-		if (nameList == null)
-		{
-			itemData = new ItemData(item.getTypeId(), (short)0);
-			nameList = names.get(itemData);
-			if (nameList == null)
-			{
-				return null;
-			}
-		}
-
-		if (nameList.size() > 15)
-		{
-			nameList = nameList.subList(0, 14);
-		}
-		return StringUtil.joinList(", ", nameList);
-	}
-
-
-	static class ItemData
-	{
-		final private int itemNo;
-		final private short itemData;
-
-		ItemData(final int itemNo, final short itemData)
-		{
-			this.itemNo = itemNo;
-			this.itemData = itemData;
-		}
-
-		public int getItemNo()
-		{
-			return itemNo;
-		}
-
-		public short getItemData()
-		{
-			return itemData;
-		}
-
-		@Override
-		public int hashCode()
-		{
-			return (31 * itemNo) ^ itemData;
-		}
-
-		@Override
-		public boolean equals(Object o)
-		{
-			if (o == null)
-			{
-				return false;
-			}
-			if (!(o instanceof ItemData))
-			{
-				return false;
-			}
-			ItemData pairo = (ItemData)o;
-			return this.itemNo == pairo.getItemNo()
-				   && this.itemData == pairo.getItemData();
-		}
-	}
-
-
-	class LengthCompare implements java.util.Comparator<String>
-	{
-		public LengthCompare()
-		{
-			super();
-		}
-
-		@Override
-		public int compare(String s1, String s2)
-		{
-			return s1.length() - s2.length();
-		}
-	}
-}

Essentials/src/com/earth2me/essentials/Jails.java

@@ -1,16 +1,13 @@
 package com.earth2me.essentials;
 
-import static com.earth2me.essentials.I18n._;
-import com.earth2me.essentials.api.IJails;
 import com.earth2me.essentials.storage.AsyncStorageObjectHolder;
-import java.io.File;
-import java.util.*;
-import java.util.logging.Level;
-import java.util.logging.Logger;
+import net.ess3.api.IEssentials;
+import net.ess3.api.IUser;
 import org.bukkit.Bukkit;
 import org.bukkit.Location;
 import org.bukkit.entity.Entity;
 import org.bukkit.entity.EntityType;
+import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.EventPriority;
 import org.bukkit.event.Listener;
@@ -19,6 +16,7 @@ import org.bukkit.event.block.BlockDamageEvent;
 import org.bukkit.event.block.BlockPlaceEvent;
 import org.bukkit.event.entity.EntityDamageByEntityEvent;
 import org.bukkit.event.entity.EntityDamageEvent.DamageCause;
+import org.bukkit.event.player.PlayerGameModeChangeEvent;
 import org.bukkit.event.player.PlayerInteractEvent;
 import org.bukkit.event.player.PlayerJoinEvent;
 import org.bukkit.event.player.PlayerRespawnEvent;
@@ -26,313 +24,279 @@ import org.bukkit.event.player.PlayerTeleportEvent;
 import org.bukkit.event.player.PlayerTeleportEvent.TeleportCause;
 import org.bukkit.plugin.PluginManager;
 
+import java.io.File;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Locale;
+import java.util.concurrent.CompletableFuture;
+import java.util.logging.Level;
+import java.util.logging.Logger;
 
-public class Jails extends AsyncStorageObjectHolder<com.earth2me.essentials.settings.Jails> implements IJails
-{
-	private static final transient Logger LOGGER = Bukkit.getLogger();
-	private static transient boolean enabled = false;
+import static com.earth2me.essentials.I18n.tl;
 
-	public Jails(final IEssentials ess)
-	{
-		super(ess, com.earth2me.essentials.settings.Jails.class);
-		reloadConfig();
-	}
+public class Jails extends AsyncStorageObjectHolder<com.earth2me.essentials.settings.Jails> implements net.ess3.api.IJails {
+    private static final transient Logger LOGGER = Bukkit.getLogger();
+    private static transient boolean enabled = false;
 
-	private void registerListeners()
-	{
-		enabled = true;
-		final PluginManager pluginManager = ess.getServer().getPluginManager();
-		final JailListener blockListener = new JailListener();
-		pluginManager.registerEvents(blockListener, ess);
-		if (ess.getSettings().isDebug())
-		{
-			LOGGER.log(Level.INFO, "Registering Jail listener");
-		}
-	}
+    public Jails(final IEssentials ess) {
+        super(ess, com.earth2me.essentials.settings.Jails.class);
+        reloadConfig();
+    }
 
-	@Override
-	public File getStorageFile()
-	{
-		return new File(ess.getDataFolder(), "jail.yml");
-	}
+    private void registerListeners() {
+        enabled = true;
+        final PluginManager pluginManager = ess.getServer().getPluginManager();
+        final JailListener blockListener = new JailListener();
+        pluginManager.registerEvents(blockListener, ess);
+        if (ess.getSettings().isDebug()) {
+            LOGGER.log(Level.INFO, "Registering Jail listener");
+        }
+    }
 
-	@Override
-	public void finishRead()
-	{
-		checkRegister();
-	}
+    @Override
+    public File getStorageFile() {
+        return new File(ess.getDataFolder(), "jail.yml");
+    }
 
-	@Override
-	public void finishWrite()
-	{
-		checkRegister();
-	}
+    @Override
+    public void finishRead() {
+        checkRegister();
+    }
 
-	public void resetListener()
-	{
-		enabled = false;
-		checkRegister();
-	}
+    @Override
+    public void finishWrite() {
+        checkRegister();
+    }
 
-	private void checkRegister()
-	{
-		if (enabled == false && getCount() > 0)
-		{
-			registerListeners();
-		}
-	}
+    public void resetListener() {
+        enabled = false;
+        checkRegister();
+    }
 
-	@Override
-	public Location getJail(final String jailName) throws Exception
-	{
-		acquireReadLock();
-		try
-		{
-			if (getData().getJails() == null || jailName == null
-				|| !getData().getJails().containsKey(jailName.toLowerCase(Locale.ENGLISH)))
-			{
-				throw new Exception(_("jailNotExist"));
-			}
-			Location loc = getData().getJails().get(jailName.toLowerCase(Locale.ENGLISH));
-			if (loc == null || loc.getWorld() == null)
-			{
-				throw new Exception(_("jailNotExist"));
-			}
-			return loc;
-		}
-		finally
-		{
-			unlock();
-		}
-	}
+    private void checkRegister() {
+        if (!enabled && getCount() > 0) {
+            registerListeners();
+        }
+    }
 
-	@Override
-	public Collection<String> getList() throws Exception
-	{
-		acquireReadLock();
-		try
-		{
-			if (getData().getJails() == null)
-			{
-				return Collections.emptyList();
-			}
-			return new ArrayList<String>(getData().getJails().keySet());
-		}
-		finally
-		{
-			unlock();
-		}
-	}
+    @Override
+    public Location getJail(final String jailName) throws Exception {
+        acquireReadLock();
+        try {
+            if (getData().getJails() == null || jailName == null || !getData().getJails().containsKey(jailName.toLowerCase(Locale.ENGLISH))) {
+                throw new Exception(tl("jailNotExist"));
+            }
+            final Location loc = getData().getJails().get(jailName.toLowerCase(Locale.ENGLISH));
+            if (loc == null || loc.getWorld() == null) {
+                throw new Exception(tl("jailNotExist"));
+            }
+            return loc;
+        } finally {
+            unlock();
+        }
+    }
 
-	@Override
-	public void removeJail(final String jail) throws Exception
-	{
-		acquireWriteLock();
-		try
-		{
-			if (getData().getJails() == null)
-			{
-				return;
-			}
-			getData().getJails().remove(jail.toLowerCase(Locale.ENGLISH));
-		}
-		finally
-		{
-			unlock();
-		}
-	}
+    @Override
+    public Collection<String> getList() throws Exception {
+        acquireReadLock();
+        try {
+            if (getData().getJails() == null) {
+                return Collections.emptyList();
+            }
+            return new ArrayList<>(getData().getJails().keySet());
+        } finally {
+            unlock();
+        }
+    }
 
-	@Override
-	public void sendToJail(final IUser user, final String jail) throws Exception
-	{
-		acquireReadLock();
-		try
-		{
-			if (user.isOnline())
-			{
-				Location loc = getJail(jail);
-				user.getTeleport().now(loc, false, TeleportCause.COMMAND);
-			}
-			user.setJail(jail);
-		}
-		finally
-		{
-			unlock();
-		}
-	}
+    @Override
+    public void removeJail(final String jail) throws Exception {
+        acquireWriteLock();
+        try {
+            if (getData().getJails() == null) {
+                return;
+            }
+            getData().getJails().remove(jail.toLowerCase(Locale.ENGLISH));
+        } finally {
+            unlock();
+        }
+    }
 
-	@Override
-	public void setJail(final String jailName, final Location loc) throws Exception
-	{
-		acquireWriteLock();
-		try
-		{
-			if (getData().getJails() == null)
-			{
-				getData().setJails(new HashMap<String, Location>());
-			}
-			getData().getJails().put(jailName.toLowerCase(Locale.ENGLISH), loc);
-		}
-		finally
-		{
-			unlock();
-		}
-	}
+    /**
+     * @deprecated This method does not use asynchronous teleportation. Use {@link Jails#sendToJail(IUser, String, CompletableFuture)}
+     */
+    @Override
+    @Deprecated
+    public void sendToJail(final IUser user, final String jail) throws Exception {
+        acquireReadLock();
+        try {
+            if (user.getBase().isOnline()) {
+                final Location loc = getJail(jail);
+                user.getTeleport().now(loc, false, TeleportCause.COMMAND);
+            }
+            user.setJail(jail);
+        } finally {
+            unlock();
+        }
+    }
 
-	@Override
-	public int getCount()
-	{
-		try
-		{
-			return getList().size();
-		}
-		catch (Exception ex)
-		{
-			return 0;
-		}
-	}
+    @Override
+    public void sendToJail(final IUser user, final String jail, final CompletableFuture<Boolean> future) throws Exception {
+        acquireReadLock();
+        try {
+            if (user.getBase().isOnline()) {
+                final Location loc = getJail(jail);
+                user.getAsyncTeleport().now(loc, false, TeleportCause.COMMAND, future);
+                future.thenAccept(success -> user.setJail(jail));
+                return;
+            }
+            user.setJail(jail);
+        } finally {
+            unlock();
+        }
+    }
 
+    @Override
+    public void setJail(final String jailName, final Location loc) throws Exception {
+        acquireWriteLock();
+        try {
+            if (getData().getJails() == null) {
+                getData().setJails(new HashMap<>());
+            }
+            getData().getJails().put(jailName.toLowerCase(Locale.ENGLISH), loc);
+        } finally {
+            unlock();
+        }
+    }
 
-	private class JailListener implements Listener
-	{
-		@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-		public void onBlockBreak(final BlockBreakEvent event)
-		{
-			final User user = ess.getUser(event.getPlayer());
-			if (user.isJailed())
-			{
-				event.setCancelled(true);
-			}
-		}
+    @Override
+    public int getCount() {
+        try {
+            return getList().size();
+        } catch (final Exception ex) {
+            return 0;
+        }
+    }
 
-		@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-		public void onBlockPlace(final BlockPlaceEvent event)
-		{
-			final User user = ess.getUser(event.getPlayer());
-			if (user.isJailed())
-			{
-				event.setCancelled(true);
-			}
-		}
+    private class JailListener implements Listener {
+        @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+        public void onJailBlockBreak(final BlockBreakEvent event) {
+            final User user = ess.getUser(event.getPlayer());
+            if (user.isJailed() && !user.isAuthorized("essentials.jail.allow-break")) {
+                event.setCancelled(true);
+            }
+        }
 
-		@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-		public void onBlockDamage(final BlockDamageEvent event)
-		{
-			final User user = ess.getUser(event.getPlayer());
-			if (user.isJailed())
-			{
-				event.setCancelled(true);
-			}
-		}
+        @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+        public void onJailBlockPlace(final BlockPlaceEvent event) {
+            final User user = ess.getUser(event.getPlayer());
+            if (user.isJailed() && !user.isAuthorized("essentials.jail.allow-place")) {
+                event.setCancelled(true);
+            }
+        }
 
-		@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-		public void onEntityDamageByEntity(final EntityDamageByEntityEvent event)
-		{
-			if (event.getCause() != DamageCause.ENTITY_ATTACK || event.getEntity().getType() != EntityType.PLAYER)
-			{
-				return;
-			}
-			final Entity damager = event.getDamager();
-			if (damager.getType() == EntityType.PLAYER)
-			{
-				final User user = ess.getUser(damager);
-				if (user != null && user.isJailed())
-				{
-					event.setCancelled(true);
-				}
-			}
-		}
+        @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+        public void onJailBlockDamage(final BlockDamageEvent event) {
+            final User user = ess.getUser(event.getPlayer());
+            if (user.isJailed() && !user.isAuthorized("essentials.jail.allow-block-damage")) {
+                event.setCancelled(true);
+            }
+        }
 
-		@EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
-		public void onPlayerInteract(final PlayerInteractEvent event)
-		{
-			final User user = ess.getUser(event.getPlayer());
-			if (user.isJailed())
-			{
-				event.setCancelled(true);
-			}
-		}
+        @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+        public void onJailEntityDamageByEntity(final EntityDamageByEntityEvent event) {
+            if (event.getCause() != DamageCause.ENTITY_ATTACK || event.getEntity().getType() != EntityType.PLAYER) {
+                return;
+            }
+            final Entity damager = event.getDamager();
+            if (damager.getType() == EntityType.PLAYER) {
+                final User user = ess.getUser((Player) damager);
+                if (user != null && user.isJailed()) {
+                    event.setCancelled(true);
+                }
+            }
+        }
 
-		@EventHandler(priority = EventPriority.HIGHEST)
-		public void onPlayerRespawn(final PlayerRespawnEvent event)
-		{
-			final User user = ess.getUser(event.getPlayer());
-			if (!user.isJailed() || user.getJail() == null || user.getJail().isEmpty())
-			{
-				return;
-			}
+        @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+        public void onJailPlayerInteract(final PlayerInteractEvent event) {
+            final User user = ess.getUser(event.getPlayer());
+            if (user.isJailed() && !user.isAuthorized("essentials.jail.allow-interact")) {
+                event.setCancelled(true);
+            }
+        }
 
-			try
-			{
-				event.setRespawnLocation(getJail(user.getJail()));
-			}
-			catch (Exception ex)
-			{
-				if (ess.getSettings().isDebug())
-				{
-					LOGGER.log(Level.INFO, _("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()), ex);
-				}
-				else
-				{
-					LOGGER.log(Level.INFO, _("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()));
-				}
-			}
-		}
+        @EventHandler(priority = EventPriority.LOW, ignoreCancelled = true)
+        public void onJailPlayerGameModeChange(final PlayerGameModeChangeEvent event) {
+            final User user = ess.getUser(event.getPlayer());
+            if (user.isJailed()) {
+                event.setCancelled(true);
+            }
+        }
 
-		@EventHandler(priority = EventPriority.HIGH)
-		public void onPlayerTeleport(final PlayerTeleportEvent event)
-		{
-			final User user = ess.getUser(event.getPlayer());
-			if (!user.isJailed() || user.getJail() == null || user.getJail().isEmpty())
-			{
-				return;
-			}
+        @EventHandler(priority = EventPriority.HIGHEST)
+        public void onJailPlayerRespawn(final PlayerRespawnEvent event) {
+            final User user = ess.getUser(event.getPlayer());
+            if (!user.isJailed() || user.getJail() == null || user.getJail().isEmpty()) {
+                return;
+            }
 
-			try
-			{
-				event.setTo(getJail(user.getJail()));
-			}
-			catch (Exception ex)
-			{
-				if (ess.getSettings().isDebug())
-				{
-					LOGGER.log(Level.INFO, _("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()), ex);
-				}
-				else
-				{
-					LOGGER.log(Level.INFO, _("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()));
-				}
-			}
-			user.sendMessage(_("jailMessage"));
-		}
+            try {
+                event.setRespawnLocation(getJail(user.getJail()));
+            } catch (final Exception ex) {
+                if (ess.getSettings().isDebug()) {
+                    LOGGER.log(Level.INFO, tl("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()), ex);
+                } else {
+                    LOGGER.log(Level.INFO, tl("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()));
+                }
+            }
+        }
 
-		@EventHandler(priority = EventPriority.HIGHEST)
-		public void onPlayerJoin(final PlayerJoinEvent event)
-		{
-			final User user = ess.getUser(event.getPlayer());
-			final long currentTime = System.currentTimeMillis();
-			user.checkJailTimeout(currentTime);
-			if (!user.isJailed() || user.getJail() == null || user.getJail().isEmpty())
-			{
-				return;
-			}
+        @EventHandler(priority = EventPriority.HIGH)
+        public void onJailPlayerTeleport(final PlayerTeleportEvent event) {
+            final User user = ess.getUser(event.getPlayer());
+            if (!user.isJailed() || user.getJail() == null || user.getJail().isEmpty()) {
+                return;
+            }
 
-			try
-			{
-				sendToJail(user, user.getJail());
-			}
-			catch (Exception ex)
-			{
-				if (ess.getSettings().isDebug())
-				{
-					LOGGER.log(Level.INFO, _("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()), ex);
-				}
-				else
-				{
-					LOGGER.log(Level.INFO, _("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()));
-				}
-			}
-			user.sendMessage(_("jailMessage"));
-		}
-	}
+            try {
+                event.setTo(getJail(user.getJail()));
+            } catch (final Exception ex) {
+                if (ess.getSettings().isDebug()) {
+                    LOGGER.log(Level.INFO, tl("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()), ex);
+                } else {
+                    LOGGER.log(Level.INFO, tl("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()));
+                }
+            }
+            user.sendMessage(tl("jailMessage"));
+        }
+
+        @EventHandler(priority = EventPriority.HIGHEST)
+        public void onJailPlayerJoin(final PlayerJoinEvent event) {
+            final User user = ess.getUser(event.getPlayer());
+            final long currentTime = System.currentTimeMillis();
+            user.checkJailTimeout(currentTime);
+            if (!user.isJailed() || user.getJail() == null || user.getJail().isEmpty()) {
+                return;
+            }
+
+            final CompletableFuture<Boolean> future = new CompletableFuture<>();
+            future.exceptionally(ex -> {
+                if (ess.getSettings().isDebug()) {
+                    LOGGER.log(Level.INFO, tl("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()), ex);
+                } else {
+                    LOGGER.log(Level.INFO, tl("returnPlayerToJailError", user.getName(), ex.getLocalizedMessage()));
+                }
+                return false;
+            });
+            future.thenAccept(success -> user.sendMessage(tl("jailMessage")));
+
+            try {
+                sendToJail(user, user.getJail(), future);
+            } catch (final Exception ex) {
+                future.completeExceptionally(ex);
+            }
+        }
+    }
 }

Essentials/src/com/earth2me/essentials/Kit.java

@@ -1,224 +1,256 @@
 package com.earth2me.essentials;
 
-import static com.earth2me.essentials.I18n._;
-import static com.earth2me.essentials.I18n.capitalCase;
 import com.earth2me.essentials.Trade.OverflowType;
 import com.earth2me.essentials.commands.NoChargeException;
 import com.earth2me.essentials.craftbukkit.InventoryWorkaround;
 import com.earth2me.essentials.textreader.IText;
 import com.earth2me.essentials.textreader.KeywordReplacer;
 import com.earth2me.essentials.textreader.SimpleTextInput;
-import com.earth2me.essentials.utils.NumberUtil;
 import com.earth2me.essentials.utils.DateUtil;
-import java.math.BigDecimal;
-import java.util.*;
-import java.util.logging.Level;
-import org.bukkit.configuration.ConfigurationSection;
+import com.earth2me.essentials.utils.NumberUtil;
+import net.ess3.api.IEssentials;
+import net.ess3.api.events.KitClaimEvent;
+import org.bukkit.Bukkit;
+import org.bukkit.Material;
 import org.bukkit.inventory.ItemStack;
 
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Calendar;
+import java.util.GregorianCalendar;
+import java.util.List;
+import java.util.Map;
+import java.util.logging.Level;
 
-public class Kit
-{
-	//TODO: Convert this to use one of the new text classes?
-	public static String listKits(final IEssentials ess, final User user) throws Exception
-	{
-		try
-		{
-			final ConfigurationSection kits = ess.getSettings().getKits();
-			final StringBuilder list = new StringBuilder();
-			for (String kitItem : kits.getKeys(false))
-			{
-				if (user == null)
-				{
-					list.append(" ").append(capitalCase(kitItem));
-				}
-				else if (user.isAuthorized("essentials.kits." + kitItem.toLowerCase(Locale.ENGLISH)))
-				{
-					String cost = "";
-					String name = capitalCase(kitItem);
-					BigDecimal costPrice = new Trade("kit-" + kitItem.toLowerCase(Locale.ENGLISH), ess).getCommandCost(user);
-					if (costPrice.signum() > 0)
-					{
-						cost = _("kitCost", NumberUtil.displayCurrency(costPrice, ess));
-					}
-					final Map<String, Object> kit = ess.getSettings().getKit(kitItem);
+import static com.earth2me.essentials.I18n.tl;
 
-					if (Kit.getNextUse(user, kitItem, kit) != 0)
-					{
-						name = _("kitDelay", name);
-					}
+public class Kit {
+    final IEssentials ess;
+    final String kitName;
+    final Map<String, Object> kit;
+    final Trade charge;
 
-					list.append(" ").append(name).append(cost);
-				}
-			}
-			return list.toString().trim();
-		}
-		catch (Exception ex)
-		{
-			throw new Exception(_("kitError"), ex);
-		}
+    public Kit(final String kitName, final IEssentials ess) throws Exception {
+        this.kitName = kitName;
+        this.ess = ess;
+        this.kit = ess.getKits().getKit(kitName);
+        this.charge = new Trade("kit-" + kitName, new Trade("kit-kit", ess), ess);
 
-	}
+        if (kit == null) {
+            throw new Exception(tl("kitNotFound"));
+        }
+    }
 
-	public static void checkTime(final User user, final String kitName, final Map<String, Object> els) throws Exception
-	{
-		final Calendar time = new GregorianCalendar();
-		long nextUse = getNextUse(user, kitName, els);
+    public String getName() {
+        return kitName;
+    }
 
-		if (nextUse == 0L)
-		{
-			user.setKitTimestamp(kitName, time.getTimeInMillis());
-		}
-		else if (nextUse < 0L)
-		{
-			user.sendMessage(_("kitOnce"));
-			throw new NoChargeException();
-		}
-		else
-		{
-			user.sendMessage(_("kitTimed", DateUtil.formatDateDiff(nextUse)));
-			throw new NoChargeException();
-		}
-	}
+    public void checkPerms(final User user) throws Exception {
+        if (!user.isAuthorized("essentials.kits." + kitName)) {
+            throw new Exception(tl("noKitPermission", "essentials.kits." + kitName));
+        }
+    }
 
-	public static long getNextUse(final User user, final String kitName, final Map<String, Object> els) throws Exception
-	{
-		if (user.isAuthorized("essentials.kit.exemptdelay"))
-		{
-			return 0L;
-		}
+    public void checkDelay(final User user) throws Exception {
+        final long nextUse = getNextUse(user);
 
-		final Calendar time = new GregorianCalendar();
+        if (nextUse == 0L) {
+        } else if (nextUse < 0L) {
+            user.sendMessage(tl("kitOnce"));
+            throw new NoChargeException();
+        } else {
+            user.sendMessage(tl("kitTimed", DateUtil.formatDateDiff(nextUse)));
+            throw new NoChargeException();
+        }
+    }
 
-		double delay = 0;
-		try
-		{
-			// Make sure delay is valid
-			delay = els.containsKey("delay") ? ((Number)els.get("delay")).doubleValue() : 0.0d;
-		}
-		catch (Exception e)
-		{
-			throw new Exception(_("kitError2"));
-		}
+    public void checkAffordable(final User user) throws Exception {
+        charge.isAffordableFor(user);
+    }
 
-		// When was the last kit used?
-		final long lastTime = user.getKitTimestamp(kitName);
+    public void setTime(final User user) throws Exception {
+        final Calendar time = new GregorianCalendar();
+        user.setKitTimestamp(kitName, time.getTimeInMillis());
+    }
 
-		// When can be use the kit again?
-		final Calendar delayTime = new GregorianCalendar();
-		delayTime.setTimeInMillis(lastTime);
-		delayTime.add(Calendar.SECOND, (int)delay);
-		delayTime.add(Calendar.MILLISECOND, (int)((delay * 1000.0) % 1000.0));
+    public void chargeUser(final User user) throws Exception {
+        charge.charge(user);
+    }
 
-		if (lastTime == 0L || lastTime > time.getTimeInMillis())
-		{
-			// If we have no record of kit use, or its corrupted, give them benifit of the doubt.
-			return 0L;
-		}
-		else if (delay < 0d)
-		{
-			// If the kit has a negative kit time, it can only be used once.
-			return -1;
-		}
-		else if (delayTime.before(time))
-		{
-			// If the kit was used in the past, but outside the delay time, it can be used.
-			return 0L;
-		}
-		else
-		{
-			// If the kit has been used recently, return the next time it can be used.
-			return delayTime.getTimeInMillis();
-		}
-	}
+    public long getNextUse(final User user) throws Exception {
+        if (user.isAuthorized("essentials.kit.exemptdelay")) {
+            return 0L;
+        }
 
-	public static List<String> getItems(final IEssentials ess, final User user, final Map<String, Object> kit) throws Exception
-	{
-		if (kit == null)
-		{
-			throw new Exception(_("kitNotFound"));
-		}
-		try
-		{
-			final List<String> itemList = new ArrayList<String>();
-			final Object kitItems = kit.get("items");
-			if (kitItems instanceof List)
-			{
-				for (Object item : (List)kitItems)
-				{
-					if (item instanceof String)
-					{
-						itemList.add(item.toString());
-						continue;
-					}
-					throw new Exception("Error parsing kit item: " + item.toString());
-				}
-				return itemList;
-			}
-			throw new Exception("Error parsing kit: " + kitItems.toString());
-		}
-		catch (Exception e)
-		{
-			ess.getLogger().log(Level.WARNING, e.getMessage());
-			throw new Exception(_("kitError2"), e);
-		}
-	}
+        final Calendar time = new GregorianCalendar();
 
-	public static void expandItems(final IEssentials ess, final User user, final List<String> items) throws Exception
-	{
-		try
-		{
-			IText input = new SimpleTextInput(items);
-			IText output = new KeywordReplacer(input, user, ess);
+        double delay = 0;
+        try {
+            // Make sure delay is valid
+            delay = kit.containsKey("delay") ? ((Number) kit.get("delay")).doubleValue() : 0.0d;
+        } catch (final Exception e) {
+            throw new Exception(tl("kitError2"));
+        }
 
-			boolean spew = false;
-			final boolean allowUnsafe = ess.getSettings().allowUnsafeEnchantments();
-			for (String kitItem : output.getLines())
-			{
-				if (kitItem.startsWith(ess.getSettings().getCurrencySymbol()))
-				{
-					BigDecimal value = new BigDecimal(kitItem.substring(ess.getSettings().getCurrencySymbol().length()).trim());
-					Trade t = new Trade(value, ess);
-					t.pay(user, OverflowType.DROP);
-					continue;
-				}
+        // When was the last kit used?
+        final long lastTime = user.getKitTimestamp(kitName);
 
-				final String[] parts = kitItem.split(" +");
-				final ItemStack parseStack = ess.getItemDb().get(parts[0], parts.length > 1 ? Integer.parseInt(parts[1]) : 1);
-				final MetaItemStack metaStack = new MetaItemStack(parseStack);
+        // When can be use the kit again?
+        final Calendar delayTime = new GregorianCalendar();
+        delayTime.setTimeInMillis(lastTime);
+        delayTime.add(Calendar.SECOND, (int) delay);
+        delayTime.add(Calendar.MILLISECOND, (int) ((delay * 1000.0) % 1000.0));
 
-				if (parts.length > 2)
-				{
-					// We pass a null sender here because kits should not do perm checks
-					metaStack.parseStringMeta(null, allowUnsafe, parts, 2, ess);
-				}
+        if (lastTime == 0L || lastTime > time.getTimeInMillis()) {
+            // If we have no record of kit use, or its corrupted, give them benefit of the doubt.
+            return 0L;
+        } else if (delay < 0d) {
+            // If the kit has a negative kit time, it can only be used once.
+            return -1;
+        } else if (delayTime.before(time)) {
+            // If the kit was used in the past, but outside the delay time, it can be used.
+            return 0L;
+        } else {
+            // If the kit has been used recently, return the next time it can be used.
+            return delayTime.getTimeInMillis();
+        }
+    }
 
-				final Map<Integer, ItemStack> overfilled;
-				if (user.isAuthorized("essentials.oversizedstacks"))
-				{
-					overfilled = InventoryWorkaround.addOversizedItems(user.getInventory(), ess.getSettings().getOversizedStackSize(), metaStack.getItemStack());
-				}
-				else
-				{
-					overfilled = InventoryWorkaround.addItems(user.getInventory(), metaStack.getItemStack());
-				}
-				for (ItemStack itemStack : overfilled.values())
-				{
-					user.getWorld().dropItemNaturally(user.getLocation(), itemStack);
-					spew = true;
-				}
-			}
-			user.updateInventory();
-			if (spew)
-			{
-				user.sendMessage(_("kitInvFull"));
-			}
-		}
-		catch (Exception e)
-		{
-			user.updateInventory();
-			ess.getLogger().log(Level.WARNING, e.getMessage());
-			throw new Exception(_("kitError2"), e);
-		}
-	}
+    @Deprecated
+    public List<String> getItems(final User user) throws Exception {
+        return getItems();
+    }
+
+    public List<String> getItems() throws Exception {
+        if (kit == null) {
+            throw new Exception(tl("kitNotFound"));
+        }
+        try {
+            final List<String> itemList = new ArrayList<>();
+            final Object kitItems = kit.get("items");
+            if (kitItems instanceof List) {
+                for (final Object item : (List) kitItems) {
+                    if (item instanceof String) {
+                        itemList.add(item.toString());
+                        continue;
+                    }
+                    throw new Exception("Invalid kit item: " + item.toString());
+                }
+                return itemList;
+            }
+            throw new Exception("Invalid item list");
+        } catch (final Exception e) {
+            ess.getLogger().log(Level.WARNING, "Error parsing kit " + kitName + ": " + e.getMessage());
+            throw new Exception(tl("kitError2"), e);
+        }
+    }
+
+    public boolean expandItems(final User user) throws Exception {
+        return expandItems(user, getItems(user));
+    }
+
+    public boolean expandItems(final User user, final List<String> items) throws Exception {
+        try {
+            final IText input = new SimpleTextInput(items);
+            final IText output = new KeywordReplacer(input, user.getSource(), ess, true, true);
+
+            final KitClaimEvent event = new KitClaimEvent(user, this);
+            Bukkit.getPluginManager().callEvent(event);
+            if (event.isCancelled()) {
+                return false;
+            }
+
+            boolean spew = false;
+            final boolean allowUnsafe = ess.getSettings().allowUnsafeEnchantments();
+            final boolean currencyIsSuffix = ess.getSettings().isCurrencySymbolSuffixed();
+            final List<ItemStack> itemList = new ArrayList<>();
+            final List<String> commandQueue = new ArrayList<>();
+            final List<String> moneyQueue = new ArrayList<>();
+            for (final String kitItem : output.getLines()) {
+                if (!currencyIsSuffix ? kitItem.startsWith(ess.getSettings().getCurrencySymbol()) : kitItem.endsWith(ess.getSettings().getCurrencySymbol())) {
+                    moneyQueue.add(NumberUtil.sanitizeCurrencyString(kitItem, ess));
+                    continue;
+                }
+
+                if (kitItem.startsWith("/")) {
+                    String command = kitItem.substring(1);
+                    final String name = user.getName();
+                    command = command.replace("{player}", name);
+                    commandQueue.add(command);
+                    continue;
+                }
+
+                final String[] parts = kitItem.split(" +");
+                final ItemStack parseStack = ess.getItemDb().get(parts[0], parts.length > 1 ? Integer.parseInt(parts[1]) : 1);
+
+                if (parseStack.getType() == Material.AIR) {
+                    continue;
+                }
+
+                final MetaItemStack metaStack = new MetaItemStack(parseStack);
+
+                if (parts.length > 2) {
+                    // We pass a null sender here because kits should not do perm checks
+                    metaStack.parseStringMeta(null, allowUnsafe, parts, 2, ess);
+                }
+
+                itemList.add(metaStack.getItemStack());
+            }
+
+            final Map<Integer, ItemStack> overfilled;
+            final boolean allowOversizedStacks = user.isAuthorized("essentials.oversizedstacks");
+            final boolean isDropItemsIfFull = ess.getSettings().isDropItemsIfFull();
+            if (isDropItemsIfFull) {
+                if (allowOversizedStacks) {
+                    overfilled = InventoryWorkaround.addOversizedItems(user.getBase().getInventory(), ess.getSettings().getOversizedStackSize(), itemList.toArray(new ItemStack[0]));
+                } else {
+                    overfilled = InventoryWorkaround.addItems(user.getBase().getInventory(), itemList.toArray(new ItemStack[0]));
+                }
+                for (final ItemStack itemStack : overfilled.values()) {
+                    int spillAmount = itemStack.getAmount();
+                    if (!allowOversizedStacks) {
+                        itemStack.setAmount(Math.min(spillAmount, itemStack.getMaxStackSize()));
+                    }
+                    while (spillAmount > 0) {
+                        user.getWorld().dropItemNaturally(user.getLocation(), itemStack);
+                        spillAmount -= itemStack.getAmount();
+                    }
+                    spew = true;
+                }
+            } else {
+                if (allowOversizedStacks) {
+                    overfilled = InventoryWorkaround.addAllOversizedItems(user.getBase().getInventory(), ess.getSettings().getOversizedStackSize(), itemList.toArray(new ItemStack[0]));
+                } else {
+                    overfilled = InventoryWorkaround.addAllItems(user.getBase().getInventory(), itemList.toArray(new ItemStack[0]));
+                }
+                if (overfilled != null) {
+                    user.sendMessage(tl("kitInvFullNoDrop"));
+                    return false;
+                }
+            }
+            user.getBase().updateInventory();
+
+            // Process money & command queues
+            // Done after all items have been processed so commands are not run and money is not given if
+            // an error occurs during the item giving process
+            for (final String valueString : moneyQueue) {
+                final BigDecimal value = new BigDecimal(valueString.trim());
+                final Trade t = new Trade(value, ess);
+                t.pay(user, OverflowType.DROP);
+            }
+
+            for (final String cmd : commandQueue) {
+                Bukkit.dispatchCommand(Bukkit.getConsoleSender(), cmd);
+            }
+
+            if (spew) {
+                user.sendMessage(tl("kitInvFull"));
+            }
+        } catch (final Exception e) {
+            user.getBase().updateInventory();
+            ess.getLogger().log(Level.WARNING, e.getMessage());
+            throw new Exception(tl("kitError2"), e);
+        }
+        return true;
+    }
 }

Essentials/src/com/earth2me/essentials/Kits.java

@@ -0,0 +1,134 @@
+package com.earth2me.essentials;
+
+import com.earth2me.essentials.utils.NumberUtil;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.configuration.MemoryConfiguration;
+
+import java.io.File;
+import java.math.BigDecimal;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
+import static com.earth2me.essentials.I18n.capitalCase;
+import static com.earth2me.essentials.I18n.tl;
+
+public class Kits implements IConf {
+
+    private final EssentialsConf config;
+    private ConfigurationSection kits;
+
+    public Kits(final IEssentials essentials) {
+        config = new EssentialsConf(new File(essentials.getDataFolder(), "kits.yml"));
+        config.setTemplateName("/kits.yml");
+
+        reloadConfig();
+    }
+
+    @Override
+    public void reloadConfig() {
+        config.load();
+        kits = _getKits();
+    }
+
+    private ConfigurationSection _getKits() {
+        if (config.isConfigurationSection("kits")) {
+            final ConfigurationSection section = config.getConfigurationSection("kits");
+            final ConfigurationSection newSection = new MemoryConfiguration();
+            for (final String kitItem : section.getKeys(false)) {
+                if (section.isConfigurationSection(kitItem)) {
+                    newSection.set(kitItem.toLowerCase(Locale.ENGLISH), section.getConfigurationSection(kitItem));
+                }
+            }
+            return newSection;
+        }
+        return null;
+    }
+
+    public EssentialsConf getConfig() {
+        return config;
+    }
+
+    public ConfigurationSection getKits() {
+        return kits;
+    }
+
+    public Map<String, Object> getKit(String name) {
+        name = name.replace('.', '_').replace('/', '_');
+        if (getKits() != null) {
+            final ConfigurationSection kits = getKits();
+            // For some reason, YAML doesn't sees keys as always lowercase even if they aren't defined like that.
+            // Workaround is to toLowercase when getting from the config, but showing normally elsewhere.
+            // ODDLY ENOUGH when you get the configuration section for ALL kits, it will return the proper
+            // case of each kit. But when you check for each kit's configuration section, it won't return the kit
+            // you just found if you don't toLowercase it.
+            if (kits.isConfigurationSection(name.toLowerCase())) {
+                return kits.getConfigurationSection(name.toLowerCase()).getValues(true);
+            }
+        }
+
+        return null;
+    }
+
+    // Tries to find an existing kit name that matches the given name, ignoring case. Returns null if no match.
+    public String matchKit(final String name) {
+        if (config.isConfigurationSection("kits")) {
+            final ConfigurationSection section = config.getConfigurationSection("kits");
+            if (section != null) {
+                for (final String kitName : section.getKeys(false)) {
+                    if (kitName.equalsIgnoreCase(name)) {
+                        return kitName;
+                    }
+                }
+            }
+        }
+        return null;
+    }
+
+    public void addKit(final String name, final List<String> lines, final long delay) {
+        // Will overwrite but w/e
+        config.set("kits." + name + ".delay", delay);
+        config.set("kits." + name + ".items", lines);
+        kits = _getKits();
+        config.save();
+    }
+
+    public void removeKit(final String name) {
+        config.set("kits." + name, null);
+        kits = _getKits();
+        config.save();
+    }
+
+    public String listKits(final net.ess3.api.IEssentials ess, final User user) throws Exception {
+        try {
+            final ConfigurationSection kits = config.getConfigurationSection("kits");
+            final StringBuilder list = new StringBuilder();
+            for (final String kitItem : kits.getKeys(false)) {
+                if (user == null) {
+                    list.append(" ").append(capitalCase(kitItem));
+                } else if (user.isAuthorized("essentials.kits." + kitItem.toLowerCase(Locale.ENGLISH))) {
+                    String cost = "";
+                    String name = capitalCase(kitItem);
+                    final BigDecimal costPrice = new Trade("kit-" + kitItem.toLowerCase(Locale.ENGLISH), ess).getCommandCost(user);
+                    if (costPrice.signum() > 0) {
+                        cost = tl("kitCost", NumberUtil.displayCurrency(costPrice, ess));
+                    }
+
+                    final Kit kit = new Kit(kitItem, ess);
+                    final double nextUse = kit.getNextUse(user);
+                    if (nextUse == -1 && ess.getSettings().isSkippingUsedOneTimeKitsFromKitList()) {
+                        continue;
+                    } else if (nextUse != 0) {
+                        name = tl("kitDelay", name);
+                    }
+
+                    list.append(" ").append(name).append(cost);
+                }
+            }
+            return list.toString().trim();
+        } catch (final Exception ex) {
+            throw new Exception(tl("kitError"), ex);
+        }
+
+    }
+}

Essentials/src/com/earth2me/essentials/LocationTarget.java

@@ -2,19 +2,15 @@ package com.earth2me.essentials;
 
 import org.bukkit.Location;
 
+public class LocationTarget implements ITarget {
+    private final Location location;
 
-public class LocationTarget implements ITarget
-{
-	private final Location location;
+    LocationTarget(final Location location) {
+        this.location = location;
+    }
 
-	LocationTarget(Location location)
-	{
-		this.location = location;
-	}
-
-	@Override
-	public Location getLocation()
-	{
-		return location;
-	}
-}
+    @Override
+    public Location getLocation() {
+        return location;
+    }
+}

Essentials/src/com/earth2me/essentials/ManagedFile.java

@@ -1,7 +1,18 @@
 package com.earth2me.essentials;
 
-import static com.earth2me.essentials.I18n._;
-import java.io.*;
+import net.ess3.api.IEssentials;
+import org.bukkit.Bukkit;
+
+import java.io.BufferedInputStream;
+import java.io.BufferedReader;
+import java.io.ByteArrayInputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.io.FileReader;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.io.OutputStreamWriter;
 import java.math.BigInteger;
 import java.security.DigestInputStream;
 import java.security.DigestOutputStream;
@@ -11,217 +22,133 @@ import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 import java.util.logging.Level;
-import org.bukkit.Bukkit;
 
+import static com.earth2me.essentials.I18n.tl;
 
-public class ManagedFile
-{
-	private final static int BUFFERSIZE = 1024 * 8;
-	private final transient File file;
+public class ManagedFile {
+    private static final int BUFFERSIZE = 1024 * 8;
+    private final transient File file;
 
-	public ManagedFile(final String filename, final IEssentials ess)
-	{
-		file = new File(ess.getDataFolder(), filename);
+    public ManagedFile(final String filename, final IEssentials ess) {
+        file = new File(ess.getDataFolder(), filename);
 
-		if (file.exists())
-		{
-			try
-			{
-				if (checkForVersion(file, ess.getDescription().getVersion()) && !file.delete())
-				{
-					throw new IOException("Could not delete file " + file.toString());
-				}
-			}
-			catch (IOException ex)
-			{
-				Bukkit.getLogger().log(Level.SEVERE, ex.getMessage(), ex);
-			}
-		}
+        if (file.exists()) {
+            try {
+                if (checkForVersion(file, ess.getDescription().getVersion()) && !file.delete()) {
+                    throw new IOException("Could not delete file " + file.toString());
+                }
+            } catch (final IOException ex) {
+                Bukkit.getLogger().log(Level.SEVERE, ex.getMessage(), ex);
+            }
+        }
 
-		if (!file.exists())
-		{
-			try
-			{
-				copyResourceAscii("/" + filename, file);
-			}
-			catch (IOException ex)
-			{
-				Bukkit.getLogger().log(Level.SEVERE, _("itemsCsvNotLoaded"), ex);
-			}
-		}
-	}
+        if (!file.exists()) {
+            try {
+                copyResourceAscii("/" + filename, file);
+            } catch (final IOException ex) {
+                Bukkit.getLogger().log(Level.SEVERE, tl("itemsCsvNotLoaded", filename), ex);
+            }
+        }
+    }
 
-	public static void copyResourceAscii(final String resourceName, final File file) throws IOException
-	{
-		final InputStreamReader reader = new InputStreamReader(ManagedFile.class.getResourceAsStream(resourceName));
-		try
-		{
-			final MessageDigest digest = getDigest();
-			final DigestOutputStream digestStream = new DigestOutputStream(new FileOutputStream(file), digest);
-			try
-			{
-				final OutputStreamWriter writer = new OutputStreamWriter(digestStream);
-				try
-				{
-					final char[] buffer = new char[BUFFERSIZE];
-					do
-					{
-						final int length = reader.read(buffer);
-						if (length >= 0)
-						{
-							writer.write(buffer, 0, length);
-						}
-						else
-						{
-							break;
-						}
-					}
-					while (true);
-					writer.write("\n");
-					writer.flush();
-					final BigInteger hashInt = new BigInteger(1, digest.digest());
-					digestStream.on(false);
-					digestStream.write('#');
-					digestStream.write(hashInt.toString(16).getBytes());
-				}
-				finally
-				{
-					writer.close();
-				}
-			}
-			finally
-			{
-				digestStream.close();
-			}
-		}
-		finally
-		{
-			reader.close();
-		}
-	}
+    public static void copyResourceAscii(final String resourceName, final File file) throws IOException {
+        try (final InputStreamReader reader = new InputStreamReader(ManagedFile.class.getResourceAsStream(resourceName))) {
+            final MessageDigest digest = getDigest();
+            try (final DigestOutputStream digestStream = new DigestOutputStream(new FileOutputStream(file), digest)) {
+                try (final OutputStreamWriter writer = new OutputStreamWriter(digestStream)) {
+                    final char[] buffer = new char[BUFFERSIZE];
+                    do {
+                        final int length = reader.read(buffer);
+                        if (length >= 0) {
+                            writer.write(buffer, 0, length);
+                        } else {
+                            break;
+                        }
+                    } while (true);
+                    writer.write("\n");
+                    writer.flush();
+                    final BigInteger hashInt = new BigInteger(1, digest.digest());
+                    digestStream.on(false);
+                    digestStream.write('#');
+                    digestStream.write(hashInt.toString(16).getBytes());
+                }
+            }
+        }
+    }
 
-	public static boolean checkForVersion(final File file, final String version) throws IOException
-	{
-		if (file.length() < 33)
-		{
-			return false;
-		}
-		final BufferedInputStream bis = new BufferedInputStream(new FileInputStream(file));
-		try
-		{
-			final byte[] buffer = new byte[(int)file.length()];
-			int position = 0;
-			do
-			{
-				final int length = bis.read(buffer, position, Math.min((int)file.length() - position, BUFFERSIZE));
-				if (length < 0)
-				{
-					break;
-				}
-				position += length;
-			}
-			while (position < file.length());
-			final ByteArrayInputStream bais = new ByteArrayInputStream(buffer);
-			if (bais.skip(file.length() - 33) != file.length() - 33)
-			{
-				return false;
-			}
-			final BufferedReader reader = new BufferedReader(new InputStreamReader(bais));
-			try
-			{
-				String hash = reader.readLine();
-				if (hash != null && hash.matches("#[a-f0-9]{32}"))
-				{
-					hash = hash.substring(1);
-					bais.reset();
-					final String versionline = reader.readLine();
-					if (versionline != null && versionline.matches("#version: .+"))
-					{
-						final String versioncheck = versionline.substring(10);
-						if (!versioncheck.equalsIgnoreCase(version))
-						{
-							bais.reset();
-							final MessageDigest digest = getDigest();
-							final DigestInputStream digestStream = new DigestInputStream(bais, digest);
-							try
-							{
-								final byte[] bytes = new byte[(int)file.length() - 33];
-								digestStream.read(bytes);
-								final BigInteger correct = new BigInteger(hash, 16);
-								final BigInteger test = new BigInteger(1, digest.digest());
-								if (correct.equals(test))
-								{
-									return true;
-								}
-								else
-								{
-									Bukkit.getLogger().warning("File " + file.toString() + " has been modified by user and file version differs, please update the file manually.");
-								}
-							}
-							finally
-							{
-								digestStream.close();
-							}
-						}
-					}
-				}
-			}
-			finally
-			{
-				reader.close();
-			}
-		}
-		finally
-		{
-			bis.close();
-		}
-		return false;
-	}
+    public static boolean checkForVersion(final File file, final String version) throws IOException {
+        if (file.length() < 33) {
+            return false;
+        }
+        try (final BufferedInputStream bis = new BufferedInputStream(new FileInputStream(file))) {
+            final byte[] buffer = new byte[(int) file.length()];
+            int position = 0;
+            do {
+                final int length = bis.read(buffer, position, Math.min((int) file.length() - position, BUFFERSIZE));
+                if (length < 0) {
+                    break;
+                }
+                position += length;
+            } while (position < file.length());
+            final ByteArrayInputStream bais = new ByteArrayInputStream(buffer);
+            if (bais.skip(file.length() - 33) != file.length() - 33) {
+                return false;
+            }
+            try (final BufferedReader reader = new BufferedReader(new InputStreamReader(bais))) {
+                String hash = reader.readLine();
+                if (hash != null && hash.matches("#[a-f0-9]{32}")) {
+                    hash = hash.substring(1);
+                    bais.reset();
+                    final String versionline = reader.readLine();
+                    if (versionline != null && versionline.matches("#version: .+")) {
+                        final String versioncheck = versionline.substring(10);
+                        if (!versioncheck.equalsIgnoreCase(version)) {
+                            bais.reset();
+                            final MessageDigest digest = getDigest();
+                            try (final DigestInputStream digestStream = new DigestInputStream(bais, digest)) {
+                                final byte[] bytes = new byte[(int) file.length() - 33];
+                                digestStream.read(bytes);
+                                final BigInteger correct = new BigInteger(hash, 16);
+                                final BigInteger test = new BigInteger(1, digest.digest());
+                                if (correct.equals(test)) {
+                                    return true;
+                                } else {
+                                    Bukkit.getLogger().warning("File " + file.toString() + " has been modified by user and file version differs, please update the file manually.");
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return false;
+    }
 
-	public static MessageDigest getDigest() throws IOException
-	{
-		try
-		{
-			return MessageDigest.getInstance("MD5");
-		}
-		catch (NoSuchAlgorithmException ex)
-		{
-			throw new IOException(ex);
-		}
-	}
+    public static MessageDigest getDigest() throws IOException {
+        try {
+            return MessageDigest.getInstance("MD5");
+        } catch (final NoSuchAlgorithmException ex) {
+            throw new IOException(ex);
+        }
+    }
 
-	public List<String> getLines()
-	{
-		try
-		{
-			final BufferedReader reader = new BufferedReader(new FileReader(file));
-			try
-			{
-				final List<String> lines = new ArrayList<String>();
-				do
-				{
-					final String line = reader.readLine();
-					if (line == null)
-					{
-						break;
-					}
-					else
-					{
-						lines.add(line);
-					}
-				}
-				while (true);
-				return lines;
-			}
-			finally
-			{
-				reader.close();
-			}
-		}
-		catch (IOException ex)
-		{
-			Bukkit.getLogger().log(Level.SEVERE, ex.getMessage(), ex);
-			return Collections.emptyList();
-		}
-	}
+    public List<String> getLines() {
+        try {
+            try (final BufferedReader reader = new BufferedReader(new FileReader(file))) {
+                final List<String> lines = new ArrayList<>();
+                do {
+                    final String line = reader.readLine();
+                    if (line == null) {
+                        break;
+                    } else {
+                        lines.add(line);
+                    }
+                } while (true);
+                return lines;
+            }
+        } catch (final IOException ex) {
+            Bukkit.getLogger().log(Level.SEVERE, ex.getMessage(), ex);
+            return Collections.emptyList();
+        }
+    }
 }

Essentials/src/com/earth2me/essentials/Mob.java

@@ -1,135 +1,192 @@
 package com.earth2me.essentials;
 
-import static com.earth2me.essentials.I18n._;
-import java.util.*;
-import java.util.logging.Level;
-import java.util.logging.Logger;
+import com.earth2me.essentials.utils.EnumUtil;
 import org.bukkit.Location;
 import org.bukkit.Server;
 import org.bukkit.World;
 import org.bukkit.entity.Entity;
 import org.bukkit.entity.EntityType;
-import org.bukkit.entity.Player;
 
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+import static com.earth2me.essentials.I18n.tl;
 
 // Suffixes can be appended on the end of a mob name to make it plural
 // Entities without a suffix, will default to 's'
-public enum Mob
-{
-	CHICKEN("Chicken", Enemies.FRIENDLY, EntityType.CHICKEN),
-	COW("Cow", Enemies.FRIENDLY, EntityType.COW),
-	CREEPER("Creeper", Enemies.ENEMY, EntityType.CREEPER),
-	GHAST("Ghast", Enemies.ENEMY, EntityType.GHAST),
-	GIANT("Giant", Enemies.ENEMY, EntityType.GIANT),
-	PIG("Pig", Enemies.FRIENDLY, EntityType.PIG),
-	PIGZOMB("PigZombie", Enemies.NEUTRAL, EntityType.PIG_ZOMBIE),
-	SHEEP("Sheep", Enemies.FRIENDLY, "", EntityType.SHEEP),
-	SKELETON("Skeleton", Enemies.ENEMY, EntityType.SKELETON),
-	SLIME("Slime", Enemies.ENEMY, EntityType.SLIME),
-	SPIDER("Spider", Enemies.ENEMY, EntityType.SPIDER),
-	SQUID("Squid", Enemies.FRIENDLY, EntityType.SQUID),
-	ZOMBIE("Zombie", Enemies.ENEMY, EntityType.ZOMBIE),
-	WOLF("Wolf", Enemies.NEUTRAL, EntityType.WOLF),
-	CAVESPIDER("CaveSpider", Enemies.ENEMY, EntityType.CAVE_SPIDER),
-	ENDERMAN("Enderman", Enemies.ENEMY, "", EntityType.ENDERMAN),
-	SILVERFISH("Silverfish", Enemies.ENEMY, "", EntityType.SILVERFISH),
-	ENDERDRAGON("EnderDragon", Enemies.ENEMY, EntityType.ENDER_DRAGON),
-	VILLAGER("Villager", Enemies.FRIENDLY, EntityType.VILLAGER),
-	BLAZE("Blaze", Enemies.ENEMY, EntityType.BLAZE),
-	MUSHROOMCOW("MushroomCow", Enemies.FRIENDLY, EntityType.MUSHROOM_COW),
-	MAGMACUBE("MagmaCube", Enemies.ENEMY, EntityType.MAGMA_CUBE),
-	SNOWMAN("Snowman", Enemies.FRIENDLY, "", EntityType.SNOWMAN),
-	OCELOT("Ocelot", Enemies.NEUTRAL, EntityType.OCELOT),
-	IRONGOLEM("IronGolem", Enemies.NEUTRAL, EntityType.IRON_GOLEM),
-	WITHER("Wither", Enemies.ENEMY, EntityType.WITHER),
-	BAT("Bat", Enemies.FRIENDLY, EntityType.BAT),
-	WITCH("Witch", Enemies.ENEMY, EntityType.WITCH),
-	BOAT("Boat", Enemies.NEUTRAL, EntityType.BOAT),
-	MINECART("Minecart", Enemies.NEUTRAL, EntityType.MINECART),
-	MINECART_CHEST("ChestMinecart", Enemies.NEUTRAL, EntityType.MINECART_CHEST),
-	MINECART_FURNACE("FurnaceMinecart", Enemies.NEUTRAL, EntityType.MINECART_FURNACE),
-	MINECART_TNT("TNTMinecart", Enemies.NEUTRAL, EntityType.MINECART_TNT),
-	MINECART_HOPPER("HopperMinecart", Enemies.NEUTRAL, EntityType.MINECART_HOPPER),
-	ENDERCRYSTAL("EnderCrystal", Enemies.NEUTRAL, EntityType.ENDER_CRYSTAL),
-	EXPERIENCEORB("ExperienceOrb", Enemies.NEUTRAL, EntityType.EXPERIENCE_ORB);
-	public static final Logger logger = Logger.getLogger("Minecraft");
+public enum Mob {
+    CHICKEN("Chicken", Enemies.FRIENDLY, EntityType.CHICKEN),
+    COW("Cow", Enemies.FRIENDLY, EntityType.COW),
+    CREEPER("Creeper", Enemies.ENEMY, EntityType.CREEPER),
+    GHAST("Ghast", Enemies.ENEMY, EntityType.GHAST),
+    GIANT("Giant", Enemies.ENEMY, EntityType.GIANT),
+    HORSE("Horse", Enemies.FRIENDLY, EntityType.HORSE),
+    PIG("Pig", Enemies.FRIENDLY, EntityType.PIG),
+    PIGZOMB("PigZombie", Enemies.NEUTRAL, MobCompat.ZOMBIFIED_PIGLIN),
+    ZOMBIFIED_PIGLIN("ZombifiedPiglin", Enemies.NEUTRAL, MobCompat.ZOMBIFIED_PIGLIN),
+    SHEEP("Sheep", Enemies.FRIENDLY, "", EntityType.SHEEP),
+    SKELETON("Skeleton", Enemies.ENEMY, EntityType.SKELETON),
+    SLIME("Slime", Enemies.ENEMY, EntityType.SLIME),
+    SPIDER("Spider", Enemies.ENEMY, EntityType.SPIDER),
+    SQUID("Squid", Enemies.FRIENDLY, EntityType.SQUID),
+    ZOMBIE("Zombie", Enemies.ENEMY, EntityType.ZOMBIE),
+    WOLF("Wolf", Enemies.NEUTRAL, "", EntityType.WOLF),
+    CAVESPIDER("CaveSpider", Enemies.ENEMY, EntityType.CAVE_SPIDER),
+    ENDERMAN("Enderman", Enemies.ENEMY, "", EntityType.ENDERMAN),
+    SILVERFISH("Silverfish", Enemies.ENEMY, "", EntityType.SILVERFISH),
+    ENDERDRAGON("EnderDragon", Enemies.ENEMY, EntityType.ENDER_DRAGON),
+    VILLAGER("Villager", Enemies.FRIENDLY, EntityType.VILLAGER),
+    BLAZE("Blaze", Enemies.ENEMY, EntityType.BLAZE),
+    MUSHROOMCOW("MushroomCow", Enemies.FRIENDLY, EntityType.MUSHROOM_COW),
+    MAGMACUBE("MagmaCube", Enemies.ENEMY, EntityType.MAGMA_CUBE),
+    SNOWMAN("Snowman", Enemies.FRIENDLY, "", EntityType.SNOWMAN),
+    OCELOT("Ocelot", Enemies.NEUTRAL, EntityType.OCELOT),
+    IRONGOLEM("IronGolem", Enemies.NEUTRAL, EntityType.IRON_GOLEM),
+    WITHER("Wither", Enemies.ENEMY, EntityType.WITHER),
+    BAT("Bat", Enemies.FRIENDLY, EntityType.BAT),
+    WITCH("Witch", Enemies.ENEMY, EntityType.WITCH),
+    BOAT("Boat", Enemies.NEUTRAL, EntityType.BOAT),
+    MINECART("Minecart", Enemies.NEUTRAL, EntityType.MINECART),
+    MINECART_CHEST("ChestMinecart", Enemies.NEUTRAL, EntityType.MINECART_CHEST),
+    MINECART_FURNACE("FurnaceMinecart", Enemies.NEUTRAL, EntityType.MINECART_FURNACE),
+    MINECART_TNT("TNTMinecart", Enemies.NEUTRAL, EntityType.MINECART_TNT),
+    MINECART_HOPPER("HopperMinecart", Enemies.NEUTRAL, EntityType.MINECART_HOPPER),
+    MINECART_MOB_SPAWNER("SpawnerMinecart", Enemies.NEUTRAL, EntityType.MINECART_MOB_SPAWNER),
+    ENDERCRYSTAL("EnderCrystal", Enemies.NEUTRAL, EntityType.ENDER_CRYSTAL),
+    EXPERIENCEORB("ExperienceOrb", Enemies.NEUTRAL, "EXPERIENCE_ORB"),
+    ARMOR_STAND("ArmorStand", Enemies.NEUTRAL, "ARMOR_STAND"),
+    ENDERMITE("Endermite", Enemies.ENEMY, "ENDERMITE"),
+    GUARDIAN("Guardian", Enemies.ENEMY, "GUARDIAN"),
+    ELDER_GUARDIAN("ElderGuardian", Enemies.ENEMY, "ELDER_GUARDIAN"),
+    RABBIT("Rabbit", Enemies.FRIENDLY, "RABBIT"),
+    SHULKER("Shulker", Enemies.ENEMY, "SHULKER"),
+    POLAR_BEAR("PolarBear", Enemies.NEUTRAL, "POLAR_BEAR"),
+    WITHER_SKELETON("WitherSkeleton", Enemies.ENEMY, "WITHER_SKELETON"),
+    STRAY_SKELETON("StraySkeleton", Enemies.ENEMY, "STRAY"),
+    ZOMBIE_VILLAGER("ZombieVillager", Enemies.FRIENDLY, "ZOMBIE_VILLAGER"),
+    SKELETON_HORSE("SkeletonHorse", Enemies.FRIENDLY, "SKELETON_HORSE"),
+    ZOMBIE_HORSE("ZombieHorse", Enemies.FRIENDLY, "ZOMBIE_HORSE"),
+    DONKEY("Donkey", Enemies.FRIENDLY, "DONKEY"),
+    MULE("Mule", Enemies.FRIENDLY, "MULE"),
+    EVOKER("Evoker", Enemies.ENEMY, "EVOKER"),
+    VEX("Vex", Enemies.ENEMY, "VEX"),
+    VINDICATOR("Vindicator", Enemies.ENEMY, "VINDICATOR"),
+    LLAMA("Llama", Enemies.NEUTRAL, "LLAMA"),
+    HUSK("Husk", Enemies.ENEMY, "HUSK"),
+    ILLUSIONER("Illusioner", Enemies.ENEMY, "ILLUSIONER"),
+    PARROT("Parrot", Enemies.NEUTRAL, "PARROT"),
+    TURTLE("Turtle", Enemies.NEUTRAL, "TURTLE"),
+    PHANTOM("Phantom", Enemies.ENEMY, "PHANTOM"),
+    COD("Cod", Enemies.NEUTRAL, "", "COD"),
+    SALMON("Salmon", Enemies.NEUTRAL, "", "SALMON"),
+    PUFFERFISH("Pufferfish", Enemies.NEUTRAL, "", "PUFFERFISH"),
+    TROPICAL_FISH("TropicalFish", Enemies.NEUTRAL, "", "TROPICAL_FISH"),
+    DROWNED("Drowned", Enemies.ENEMY, "DROWNED"),
+    DOLPHIN("Dolphin", Enemies.NEUTRAL, "DOLPHIN"),
+    CAT("Cat", Enemies.FRIENDLY, "CAT"),
+    FOX("Fox", Enemies.FRIENDLY, "es", "FOX"),
+    PANDA("Panda", Enemies.NEUTRAL, "PANDA"),
+    PILLAGER("Pillager", Enemies.ENEMY, "PILLAGER"),
+    RAVAGER("Ravager", Enemies.ENEMY, "RAVAGER"),
+    TRADER_LLAMA("TraderLlama", Enemies.FRIENDLY, "TRADER_LLAMA"),
+    WANDERING_TRADER("WanderingTrader", Enemies.FRIENDLY, "WANDERING_TRADER"),
+    BEE("Bee", Enemies.NEUTRAL, "BEE"),
+    STRAY("Stray", Enemies.ENEMY, "STRAY"),
+    HOGLIN("Hoglin", Enemies.ADULT_ENEMY, "HOGLIN"),
+    PIGLIN("Piglin", Enemies.ADULT_ENEMY, "PIGLIN"),
+    STRIDER("Strider", Enemies.FRIENDLY, "STRIDER"),
+    ZOGLIN("Zoglin", Enemies.ENEMY, "ZOGLIN"),
+    PIGLIN_BRUTE("PiglinBrute", Enemies.ADULT_ENEMY, "PIGLIN_BRUTE"),
+    ;
 
-	private Mob(String n, Enemies en, String s, EntityType type)
-	{
-		this.suffix = s;
-		this.name = n;
-		this.type = en;
-		this.bukkitType = type;
-	}
+    public static final Logger logger = Logger.getLogger("Essentials");
+    private static final Map<String, Mob> hashMap = new HashMap<>();
+    private static final Map<EntityType, Mob> bukkitMap = new HashMap<>();
 
-	private Mob(String n, Enemies en, EntityType type)
-	{
-		this.name = n;
-		this.type = en;
-		this.bukkitType = type;
-	}
-	public String suffix = "s";
-	final public String name;
-	final public Enemies type;
-	final private EntityType bukkitType;
-	private static final Map<String, Mob> hashMap = new HashMap<String, Mob>();
+    static {
+        for (final Mob mob : Mob.values()) {
+            hashMap.put(mob.name.toLowerCase(Locale.ENGLISH), mob);
+            if (mob.bukkitType != null) {
+                bukkitMap.put(mob.bukkitType, mob);
+            }
+        }
+    }
 
-	static
-	{
-		for (Mob mob : Mob.values())
-		{
-			hashMap.put(mob.name.toLowerCase(Locale.ENGLISH), mob);
-		}
-	}
+    final public String name;
+    final public Enemies type;
+    final private EntityType bukkitType;
+    public String suffix = "s";
 
-	public static Set<String> getMobList()
-	{
-		return Collections.unmodifiableSet(hashMap.keySet());
-	}
+    Mob(final String n, final Enemies en, final String s, final EntityType type) {
+        this.suffix = s;
+        this.name = n;
+        this.type = en;
+        this.bukkitType = type;
+    }
 
-	public Entity spawn(final Player player, final Server server, final Location loc) throws MobException
-	{
-		return spawn(player.getWorld(), server, loc);
-	}
+    Mob(final String n, final Enemies en, final EntityType type) {
+        this.name = n;
+        this.type = en;
+        this.bukkitType = type;
+    }
 
-	public Entity spawn(final World world, final Server server, final Location loc) throws MobException
-	{
-		final Entity entity = world.spawn(loc, (Class<? extends Entity>)this.bukkitType.getEntityClass());
-		if (entity == null)
-		{
-			logger.log(Level.WARNING, _("unableToSpawnMob"));
-			throw new MobException();
-		}
-		return entity;
-	}
+    Mob(final String n, final Enemies en, final String s, final String typeName) {
+        this.suffix = s;
+        this.name = n;
+        this.type = en;
+        bukkitType = EnumUtil.getEntityType(typeName);
+    }
 
+    Mob(final String n, final Enemies en, final String typeName) {
+        this.name = n;
+        this.type = en;
+        bukkitType = EnumUtil.getEntityType(typeName);
+    }
 
-	public enum Enemies
-	{
-		FRIENDLY("friendly"),
-		NEUTRAL("neutral"),
-		ENEMY("enemy");
+    public static Set<String> getMobList() {
+        return Collections.unmodifiableSet(hashMap.keySet());
+    }
 
-		private Enemies(final String type)
-		{
-			this.type = type;
-		}
-		final protected String type;
-	}
+    public static Mob fromName(final String name) {
+        return hashMap.get(name.toLowerCase(Locale.ENGLISH));
+    }
 
-	public EntityType getType()
-	{
-		return bukkitType;
-	}
+    public static Mob fromBukkitType(final EntityType type) {
+        return bukkitMap.get(type);
+    }
 
-	public static Mob fromName(final String name)
-	{
-		return hashMap.get(name.toLowerCase(Locale.ENGLISH));
-	}
+    public Entity spawn(final World world, final Server server, final Location loc) throws MobException {
+        final Entity entity = world.spawn(loc, this.bukkitType.getEntityClass());
+        if (entity == null) {
+            logger.log(Level.WARNING, tl("unableToSpawnMob"));
+            throw new MobException();
+        }
+        return entity;
+    }
 
+    public EntityType getType() {
+        return bukkitType;
+    }
 
-	public static class MobException extends Exception
-	{
-		private static final long serialVersionUID = 1L;
-	}
+    public enum Enemies {
+        FRIENDLY("friendly"),
+        NEUTRAL("neutral"),
+        ENEMY("enemy"),
+        ADULT_ENEMY("adult_enemy");
+
+        final protected String type;
+
+        Enemies(final String type) {
+            this.type = type;
+        }
+    }
+
+    public static class MobException extends Exception {
+        private static final long serialVersionUID = 1L;
+    }
 }

Essentials/src/com/earth2me/essentials/MobCompat.java

@@ -0,0 +1,219 @@
+package com.earth2me.essentials;
+
+import com.earth2me.essentials.utils.EnumUtil;
+import com.earth2me.essentials.utils.VersionUtil;
+import net.ess3.nms.refl.ReflUtil;
+import org.bukkit.entity.Entity;
+import org.bukkit.entity.EntityType;
+import org.bukkit.entity.Fox;
+import org.bukkit.entity.Llama;
+import org.bukkit.entity.MushroomCow;
+import org.bukkit.entity.Ocelot;
+import org.bukkit.entity.Panda;
+import org.bukkit.entity.Parrot;
+import org.bukkit.entity.TropicalFish;
+import org.bukkit.entity.Villager;
+
+import java.lang.reflect.Method;
+
+import static com.earth2me.essentials.utils.EnumUtil.getEntityType;
+
+public final class MobCompat {
+
+    // Constants for mob interfaces added in later versions
+    @SuppressWarnings("rawtypes")
+    public static final Class RAIDER = ReflUtil.getClassCached("org.bukkit.entity.Raider");
+
+    // Constants for mobs added in later versions
+    public static final EntityType LLAMA = getEntityType("LLAMA");
+    public static final EntityType PARROT = getEntityType("PARROT");
+    public static final EntityType TROPICAL_FISH = getEntityType("TROPICAL_FISH");
+    public static final EntityType PANDA = getEntityType("PANDA");
+    public static final EntityType TRADER_LLAMA = getEntityType("TRADER_LLAMA");
+    public static final EntityType SHULKER = getEntityType("SHULKER");
+    public static final EntityType STRAY = getEntityType("STRAY");
+    public static final EntityType FOX = getEntityType("FOX");
+    public static final EntityType PHANTOM = getEntityType("PHANTOM");
+
+    // Constants for mobs that have changed since earlier versions
+    public static final EntityType CAT = getEntityType("CAT", "OCELOT");
+    public static final EntityType ZOMBIFIED_PIGLIN = getEntityType("ZOMBIFIED_PIGLIN", "PIG_ZOMBIE");
+
+    private MobCompat() {
+    }
+
+    // Older cats are Ocelots, whereas 1.14+ cats are Cats
+    public static void setCatType(final Entity entity, final CatType type) {
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_14_R01)) {
+            ((Ocelot) entity).setCatType(Ocelot.Type.valueOf(type.ocelotTypeName));
+        } else {
+            final Class cat = ReflUtil.getClassCached("org.bukkit.entity.Cat");
+            final Class catType = ReflUtil.getClassCached("org.bukkit.entity.Cat$Type");
+            final Method setCatType = ReflUtil.getMethodCached(cat, "setCatType", catType);
+            try {
+                setCatType.invoke(entity, EnumUtil.valueOf(catType, type.catTypeName));
+            } catch (final Exception e) {
+                e.printStackTrace();
+            }
+        }
+    }
+
+    // Older villagers have professions and careers, 1.14+ villagers only have professions
+    public static void setVillagerProfession(final Entity entity, final VillagerProfession profession) {
+        if (!(entity instanceof Villager)) {
+            return;
+        }
+        final Villager villager = (Villager) entity;
+        villager.setProfession(profession.asEnum());
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_14_R01)) {
+            final Class villagerCareer = ReflUtil.getClassCached("org.bukkit.entity.Villager$Career");
+            final Method setCareer = ReflUtil.getMethodCached(Villager.class, "setCareer", villagerCareer);
+            try {
+                setCareer.invoke(entity, EnumUtil.valueOf(villagerCareer, profession.oldCareer));
+            } catch (final Exception e) {
+                e.printStackTrace();
+            }
+        }
+    }
+
+    // Only 1.14+ villagers have biome variants
+    public static void setVillagerType(final Entity entity, final String type) {
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_14_R01)) {
+            return;
+        }
+        if (entity instanceof Villager) {
+            ((Villager) entity).setVillagerType(Villager.Type.valueOf(type));
+        }
+    }
+
+    // Llamas only exist in 1.11+
+    public static void setLlamaColor(final Entity entity, final String color) {
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_11_R01)) {
+            return;
+        }
+        if (entity instanceof Llama) {
+            ((Llama) entity).setColor(Llama.Color.valueOf(color));
+        }
+    }
+
+    // Parrots only exist in 1.12+
+    public static void setParrotVariant(final Entity entity, final String variant) {
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_12_0_R01)) {
+            return;
+        }
+        if (entity instanceof Parrot) {
+            ((Parrot) entity).setVariant(Parrot.Variant.valueOf(variant));
+        }
+    }
+
+    // Tropical fish only exist in 1.13+
+    public static void setTropicalFishPattern(final Entity entity, final String pattern) {
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_12_0_R01)) {
+            return;
+        }
+        if (entity instanceof TropicalFish) {
+            ((TropicalFish) entity).setPattern(TropicalFish.Pattern.valueOf(pattern));
+        }
+    }
+
+    // Mushroom cow variant API only exists in 1.14+
+    public static void setMooshroomVariant(final Entity entity, final String variant) {
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_14_R01)) {
+            return;
+        }
+        if (entity instanceof MushroomCow) {
+            ((MushroomCow) entity).setVariant(MushroomCow.Variant.valueOf(variant));
+        }
+    }
+
+    // Pandas only exists in 1.14+
+    public static void setPandaGene(final Entity entity, final String gene, final boolean mainGene) {
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_14_R01)) {
+            return;
+        }
+        if (entity instanceof Panda) {
+            final Panda panda = (Panda) entity;
+            final Panda.Gene pandaGene = Panda.Gene.valueOf(gene);
+            if (mainGene) {
+                panda.setMainGene(pandaGene);
+            } else {
+                panda.setHiddenGene(pandaGene);
+            }
+        }
+    }
+
+    // Foxes only exist in 1.14+
+    public static void setFoxType(final Entity entity, final String type) {
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_14_R01)) {
+            return;
+        }
+        if (entity instanceof Fox) {
+            ((Fox) entity).setFoxType(Fox.Type.valueOf(type));
+        }
+    }
+
+    public enum CatType {
+        // These are (loosely) Mojang names for the cats
+        SIAMESE("SIAMESE", "SIAMESE_CAT"),
+        WHITE("WHITE", "SIAMESE_CAT"),
+        RED("RED", "RED_CAT"),
+        TABBY("TABBY", "RED_CAT"),
+        TUXEDO("BLACK", "BLACK_CAT"),
+        BRITISH_SHORTHAIR("BRITISH_SHORTHAIR", "SIAMESE_CAT"),
+        CALICO("CALICO", "RED_CAT"),
+        PERSIAN("PERSIAN", "RED_CAT"),
+        RAGDOLL("RAGDOLL", "SIAMESE_CAT"),
+        JELLIE("JELLIE", "SIAMESE_CAT"),
+        BLACK("ALL_BLACK", "BLACK_CAT"),
+        ;
+
+        private final String catTypeName;
+        private final String ocelotTypeName;
+
+        CatType(final String catTypeName, final String ocelotTypeName) {
+            this.catTypeName = catTypeName;
+            this.ocelotTypeName = ocelotTypeName;
+        }
+    }
+
+    public enum VillagerProfession {
+        // These are 1.14+ villager professions mapped to their respective pre-V&P profession and career
+        NONE("FARMER", "FARMER", "NONE"),
+        ARMORER("BLACKSMITH", "ARMORER"),
+        BUTCHER("FARMER", "BUTCHER"),
+        CARTOGRAPHER("LIBRARIAN", "CARTOGRAPHER"),
+        CLERIC("PRIEST", "CLERIC"),
+        FARMER("FARMER", "FARMER"),
+        FISHERMAN("FARMER", "FISHERMAN"),
+        FLETCHER("FARMER", "FLETCHER"),
+        LEATHERWORKER("BUTCHER", "LEATHERWORKER"),
+        LIBRARIAN("LIBRARIAN", "LIBRARIAN"),
+        MASON(null, null, "MASON"),
+        NITWIT("NITWIT", "NITWIT"),
+        SHEPHERD("FARMER", "SHEPHERD"),
+        TOOLSMITH("BLACKSMITH", "TOOL_SMITH", "TOOLSMITH"),
+        WEAPONSMITH("BLACKSMITH", "WEAPON_SMITH", "WEAPONSMITH"),
+        ;
+
+        private final String oldProfession;
+        private final String oldCareer;
+        private final String newProfession;
+
+        VillagerProfession(final String oldProfession, final String career) {
+            this.oldProfession = oldProfession;
+            this.oldCareer = career;
+            this.newProfession = career;
+        }
+
+        VillagerProfession(final String oldProfession, final String oldCareer, final String newProfession) {
+            this.oldProfession = oldProfession;
+            this.oldCareer = oldCareer;
+            this.newProfession = newProfession;
+        }
+
+        private Villager.Profession asEnum() {
+            return EnumUtil.valueOf(Villager.Profession.class, newProfession, oldProfession);
+        }
+    }
+
+}

Essentials/src/com/earth2me/essentials/MobData.java

@@ -0,0 +1,404 @@
+package com.earth2me.essentials;
+
+import com.earth2me.essentials.craftbukkit.InventoryWorkaround;
+import com.earth2me.essentials.utils.EnumUtil;
+import com.earth2me.essentials.utils.StringUtil;
+import org.bukkit.DyeColor;
+import org.bukkit.Material;
+import org.bukkit.entity.Ageable;
+import org.bukkit.entity.Creeper;
+import org.bukkit.entity.Entity;
+import org.bukkit.entity.EntityType;
+import org.bukkit.entity.ExperienceOrb;
+import org.bukkit.entity.Horse;
+import org.bukkit.entity.LivingEntity;
+import org.bukkit.entity.Phantom;
+import org.bukkit.entity.Pig;
+import org.bukkit.entity.Player;
+import org.bukkit.entity.Raider;
+import org.bukkit.entity.Slime;
+import org.bukkit.entity.Tameable;
+import org.bukkit.entity.TropicalFish;
+import org.bukkit.entity.Wolf;
+import org.bukkit.entity.Zombie;
+import org.bukkit.inventory.EntityEquipment;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.material.Colorable;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Random;
+import java.util.logging.Logger;
+import java.util.stream.Collectors;
+
+import static com.earth2me.essentials.I18n.tl;
+
+public enum MobData {
+
+    BABY_AGEABLE("baby", Ageable.class, Data.BABY, true),
+    ADULT_AGEABLE("adult", Ageable.class, Data.ADULT, true),
+    BABY_CAT("kitten", MobCompat.CAT, Data.BABY, false),
+    BABY_PIG("piglet", EntityType.PIG, Data.BABY, false),
+    BABY_WOLF("puppy", EntityType.WOLF, Data.BABY, false),
+    BABY_CHICKEN("chick", EntityType.CHICKEN, Data.BABY, false),
+    BABY_HORSE("colt", EntityType.HORSE, Data.BABY, false),
+    BABY_OCELOT("kitten", EntityType.OCELOT, Data.BABY, false),
+    BABY_SHEEP("lamb", EntityType.SHEEP, Data.BABY, false),
+    BABY_COW("calf", EntityType.COW.getEntityClass(), Data.BABY, false),
+    BABY_VILLAGER("child", EntityType.VILLAGER, Data.BABY, false),
+    TAMED_TAMEABLE("tamed", Tameable.class, Data.TAMED, true),
+    TAME_TAMEABLE("tame", Tameable.class, Data.TAMED, false),
+    RANDOM_SHEEP("random", EntityType.SHEEP, Data.COLORABLE, true),
+    COLORABLE_SHEEP("", Arrays.stream(DyeColor.values()).map(color -> color.name().toLowerCase(Locale.ENGLISH)).collect(Collectors.toList()), EntityType.SHEEP, Data.COLORABLE, true),
+    POLKA_HORSE("polka", EntityType.HORSE, Horse.Style.BLACK_DOTS, true),
+    SOOTY_HORSE("sooty", EntityType.HORSE, Horse.Style.BLACK_DOTS, false),
+    BLAZE_HORSE("blaze", EntityType.HORSE, Horse.Style.WHITE, true),
+    SOCKS_HORSE("socks", EntityType.HORSE, Horse.Style.WHITE, false),
+    LEOPARD_HORSE("leopard", EntityType.HORSE, Horse.Style.WHITE_DOTS, true),
+    APPALOOSA_HORSE("appaloosa", EntityType.HORSE, Horse.Style.WHITE_DOTS, false),
+    PAINT_HORSE("paint", EntityType.HORSE, Horse.Style.WHITEFIELD, true),
+    MILKY_HORSE("milky", EntityType.HORSE, Horse.Style.WHITEFIELD, false),
+    SPLOTCHY_HORSE("splotchy", EntityType.HORSE, Horse.Style.WHITEFIELD, false),
+    BLACK_HORSE("black", EntityType.HORSE, Horse.Color.BLACK, true),
+    CHESTNUT_HORSE("chestnut", EntityType.HORSE, Horse.Color.CHESTNUT, true),
+    LIVER_HORSE("liver", EntityType.HORSE, Horse.Color.CHESTNUT, false),
+    CREAMY_HORSE("creamy", EntityType.HORSE, Horse.Color.CREAMY, true),
+    FLAXEN_HORSE("flaxen", EntityType.HORSE, Horse.Color.CREAMY, false),
+    GRAY_HORSE("gray", EntityType.HORSE, Horse.Color.GRAY, true),
+    DAPPLE_HORSE("dapple", EntityType.HORSE, Horse.Color.GRAY, false),
+    BUCKSKIN_HORSE("buckskin", EntityType.HORSE, Horse.Color.DARK_BROWN, true),
+    DARKBROWN_HORSE("darkbrown", EntityType.HORSE, Horse.Color.DARK_BROWN, false),
+    DARK_HORSE("dark", EntityType.HORSE, Horse.Color.DARK_BROWN, false),
+    DBROWN_HORSE("dbrown", EntityType.HORSE, Horse.Color.DARK_BROWN, false),
+    BAY_HORSE("bay", EntityType.HORSE, Horse.Color.BROWN, true),
+    BROWN_HORSE("brown", EntityType.HORSE, Horse.Color.BROWN, false),
+    SADDLE_HORSE("saddle", EntityType.HORSE, Data.HORSESADDLE, true),
+    GOLD_ARMOR_HORSE("goldarmor", EntityType.HORSE, EnumUtil.getMaterial("GOLDEN_HORSE_ARMOR", "GOLD_BARDING"), true),
+    DIAMOND_ARMOR_HORSE("diamondarmor", EntityType.HORSE, EnumUtil.getMaterial("DIAMOND_HORSE_ARMOR", "DIAMOND_BARDING"), true),
+    ARMOR_HORSE("armor", EntityType.HORSE, EnumUtil.getMaterial("IRON_HORSE_ARMOR", "IRON_BARDING"), true),
+    SIAMESE_CAT("siamese", MobCompat.CAT, MobCompat.CatType.SIAMESE, true),
+    WHITE_CAT("white", MobCompat.CAT, MobCompat.CatType.WHITE, false),
+    RED_CAT("red", MobCompat.CAT, MobCompat.CatType.RED, true),
+    ORANGE_CAT("orange", MobCompat.CAT, MobCompat.CatType.RED, false),
+    TABBY_CAT("tabby", MobCompat.CAT, MobCompat.CatType.TABBY, true),
+    BLACK_CAT("black", MobCompat.CAT, MobCompat.CatType.BLACK, true),
+    TUXEDO_CAT("tuxedo", MobCompat.CAT, MobCompat.CatType.TUXEDO, true),
+    BRITISH_SHORTHAIR_CAT("britishshorthair", MobCompat.CAT, MobCompat.CatType.BRITISH_SHORTHAIR, true),
+    CALICO_CAT("calico", MobCompat.CAT, MobCompat.CatType.CALICO, true),
+    PERSIAN_CAT("persian", MobCompat.CAT, MobCompat.CatType.PERSIAN, true),
+    RAGDOLL_CAT("ragdoll", MobCompat.CAT, MobCompat.CatType.RAGDOLL, true),
+    JELLIE_CAT("jellie", MobCompat.CAT, MobCompat.CatType.JELLIE, true),
+    ALL_BLACK_CAT("allblack", MobCompat.CAT, MobCompat.CatType.BLACK, true),
+    BABY_ZOMBIE("baby", EntityType.ZOMBIE.getEntityClass(), Data.BABYZOMBIE, true),
+    ADULT_ZOMBIE("adult", EntityType.ZOMBIE.getEntityClass(), Data.ADULTZOMBIE, true),
+    DIAMOND_SWORD_ZOMBIE("diamondsword", EntityType.ZOMBIE.getEntityClass(), Material.DIAMOND_SWORD, true),
+    GOLD_SWORD_ZOMBIE("goldsword", EntityType.ZOMBIE.getEntityClass(), EnumUtil.getMaterial("GOLDEN_SWORD", "GOLD_SWORD"), true),
+    IRON_SWORD_ZOMBIE("ironsword", EntityType.ZOMBIE.getEntityClass(), Material.IRON_SWORD, true),
+    STONE_SWORD_ZOMBIE("stonesword", EntityType.ZOMBIE.getEntityClass(), Material.STONE_SWORD, false),
+    SWORD_ZOMBIE("sword", EntityType.ZOMBIE.getEntityClass(), Material.STONE_SWORD, true),
+    DIAMOND_SWORD_SKELETON("diamondsword", EntityType.SKELETON, Material.DIAMOND_SWORD, true),
+    GOLD_SWORD_SKELETON("goldsword", EntityType.SKELETON, EnumUtil.getMaterial("GOLDEN_SWORD", "GOLD_SWORD"), true),
+    IRON_SWORD_SKELETON("ironsword", EntityType.SKELETON, Material.IRON_SWORD, true),
+    STONE_SWORD_SKELETON("stonesword", EntityType.SKELETON, Material.STONE_SWORD, false),
+    SWORD_SKELETON("sword", EntityType.SKELETON, Material.STONE_SWORD, true),
+    BOW_SKELETON("bow", EntityType.SKELETON, Material.BOW, true),
+    POWERED_CREEPER("powered", EntityType.CREEPER, Data.ELECTRIFIED, true),
+    ELECTRIC_CREEPER("electric", EntityType.CREEPER, Data.ELECTRIFIED, false),
+    CHARGED_CREEPER("charged", EntityType.CREEPER, Data.ELECTRIFIED, false),
+    SADDLE_PIG("saddle", EntityType.PIG, Data.PIGSADDLE, true),
+    ANGRY_WOLF("angry", EntityType.WOLF, Data.ANGRY, true),
+    RABID_WOLF("rabid", EntityType.WOLF, Data.ANGRY, false),
+    VILLAGER("villager", EntityType.VILLAGER, MobCompat.VillagerProfession.NONE, true),
+    ARMORER_VILLAGER("armorer", EntityType.VILLAGER, MobCompat.VillagerProfession.ARMORER, true),
+    BUTCHER_VILLAGER("butcher", EntityType.VILLAGER, MobCompat.VillagerProfession.BUTCHER, true),
+    CARTOGRAPHER_VILLAGER("cartographer", EntityType.VILLAGER, MobCompat.VillagerProfession.CARTOGRAPHER, true),
+    CLERIC_VILLAGER("cleric", EntityType.VILLAGER, MobCompat.VillagerProfession.CLERIC, true),
+    FARMER_VILLAGER("farmer", EntityType.VILLAGER, MobCompat.VillagerProfession.FARMER, true),
+    FISHERMAN_VILLAGER("fisherman", EntityType.VILLAGER, MobCompat.VillagerProfession.FISHERMAN, true),
+    FLETCHER_VILLAGER("fletcher", EntityType.VILLAGER, MobCompat.VillagerProfession.FLETCHER, true),
+    LEATHERWORKER_VILLAGER("leatherworker", EntityType.VILLAGER, MobCompat.VillagerProfession.LEATHERWORKER, true),
+    LIBRARIAN_VILLAGER("librarian", EntityType.VILLAGER, MobCompat.VillagerProfession.LIBRARIAN, true),
+    MASON_VILLAGER("mason", EntityType.VILLAGER, MobCompat.VillagerProfession.MASON, true),
+    NITWIT_VILLAGER("nitwit", EntityType.VILLAGER, MobCompat.VillagerProfession.NITWIT, true),
+    SHEPHERD_VILLAGER("shepherd", EntityType.VILLAGER, MobCompat.VillagerProfession.SHEPHERD, true),
+    TOOLSMITH_VILLAGER("toolsmith", EntityType.VILLAGER, MobCompat.VillagerProfession.TOOLSMITH, true),
+    WEAPONSMITH_VILLAGER("weaponsmith", EntityType.VILLAGER, MobCompat.VillagerProfession.WEAPONSMITH, true),
+    DESERT_VILLAGER("desert", EntityType.VILLAGER, "villagertype:DESERT", true),
+    JUNGLE_VILLAGER("jungle", EntityType.VILLAGER, "villagertype:JUNGLE", true),
+    PLAINS_VILLAGER("plains", EntityType.VILLAGER, "villagertype:PLAINS", true),
+    SAVANNA_VILLAGER("savanna", EntityType.VILLAGER, "villagertype:SAVANNA", true),
+    SNOWY_VILLAGER("snowy", EntityType.VILLAGER, "villagertype:SNOWY", true),
+    SWAMP_VILLAGER("swamp", EntityType.VILLAGER, "villagertype:SWAMP", true),
+    TAIGA_VILLAGER("taiga", EntityType.VILLAGER, "villagertype:TAIGA", true),
+    SIZE_SLIME("", Collections.singletonList("<1-100>"), EntityType.SLIME.getEntityClass(), Data.SIZE, true),
+    NUM_EXPERIENCE_ORB("", Collections.singletonList("<1-2000000000>"), EntityType.EXPERIENCE_ORB, Data.EXP, true),
+    RED_PARROT("red", MobCompat.PARROT, "parrot:RED", true),
+    GREEN_PARROT("green", MobCompat.PARROT, "parrot:GREEN", true),
+    BLUE_PARROT("blue", MobCompat.PARROT, "parrot:BLUE", true),
+    CYAN_PARROT("cyan", MobCompat.PARROT, "parrot:CYAN", true),
+    GRAY_PARROT("gray", MobCompat.PARROT, "parrot:GRAY", true),
+    KOB_TROPICAL_FISH("kob", MobCompat.TROPICAL_FISH, "tropicalfish:KOB", true),
+    SUNSTREAK_TROPICAL_FISH("sunstreak", MobCompat.TROPICAL_FISH, "tropicalfish:SUNSTREAK", true),
+    SNOOPER_TROPICAL_FISH("snooper", MobCompat.TROPICAL_FISH, "tropicalfish:SNOOPER", true),
+    DASHER_TROPICAL_FISH("dasher", MobCompat.TROPICAL_FISH, "tropicalfish:DASHER", true),
+    BRINELY_TROPICAL_FISH("brinely", MobCompat.TROPICAL_FISH, "tropicalfish:BRINELY", true),
+    SPOTTY_TROPICAL_FISH("spotty", MobCompat.TROPICAL_FISH, "tropicalfish:SPOTTY", true),
+    FLOPPER_TROPICAL_FISH("flopper", MobCompat.TROPICAL_FISH, "tropicalfish:FLOPPER", true),
+    STRIPEY_TROPICAL_FISH("stripey", MobCompat.TROPICAL_FISH, "tropicalfish:STRIPEY", true),
+    GLITTER_TROPICAL_FISH("glitter", MobCompat.TROPICAL_FISH, "tropicalfish:GLITTER", true),
+    BLOCKFISH_TROPICAL_FISH("blockfish", MobCompat.TROPICAL_FISH, "tropicalfish:BLOCKFISH", true),
+    BETTY_TROPICAL_FISH("betty", MobCompat.TROPICAL_FISH, "tropicalfish:BETTY", true),
+    CLAYFISH_TROPICAL_FISH("clayfish", MobCompat.TROPICAL_FISH, "tropicalfish:CLAYFISH", true),
+    BROWN_MUSHROOM_COW("brown", EntityType.MUSHROOM_COW, "mooshroom:BROWN", true),
+    RED_MUSHROOM_COW("red", EntityType.MUSHROOM_COW, "mooshroom:RED", true),
+    AGGRESSIVE_PANDA_MAIN("aggressive", MobCompat.PANDA, "pandamain:AGGRESSIVE", true),
+    LAZY_PANDA_MAIN("lazy", MobCompat.PANDA, "pandamain:LAZY", true),
+    WORRIED_PANDA_MAIN("worried", MobCompat.PANDA, "pandamain:WORRIED", true),
+    PLAYFUL_PANDA_MAIN("playful", MobCompat.PANDA, "pandamain:PLAYFUL", true),
+    BROWN_PANDA_MAIN("brown", MobCompat.PANDA, "pandamain:BROWN", true),
+    WEAK_PANDA_MAIN("weak", MobCompat.PANDA, "pandamain:WEAK", true),
+    AGGRESSIVE_PANDA_HIDDEN("aggressive_hidden", MobCompat.PANDA, "pandahidden:AGGRESSIVE", true),
+    LAZY_PANDA_HIDDEN("lazy_hidden", MobCompat.PANDA, "pandahidden:LAZY", true),
+    WORRIED_PANDA_HIDDEN("worried_hidden", MobCompat.PANDA, "pandahidden:WORRIED", true),
+    PLAYFUL_PANDA_HIDDEN("playful_hidden", MobCompat.PANDA, "pandahidden:PLAYFUL", true),
+    BROWN_PANDA_HIDDEN("brown_hidden", MobCompat.PANDA, "pandahidden:BROWN", true),
+    WEAK_PANDA_HIDDEN("weak_hidden", MobCompat.PANDA, "pandahidden:WEAK", true),
+    CREAMY_LLAMA("creamy", MobCompat.LLAMA, "llama:CREAMY", true),
+    WHITE_LLAMA("white", MobCompat.LLAMA, "llama:WHITE", true),
+    BROWN_LLAMA("brown", MobCompat.LLAMA, "llama:BROWN", true),
+    GRAY_LLAMA("gray", MobCompat.LLAMA, "llama:GRAY", true),
+    CREAMY_TRADER_LLAMA("creamy", MobCompat.TRADER_LLAMA, "llama:CREAMY", true),
+    WHITE_TRADER_LLAMA("white", MobCompat.TRADER_LLAMA, "llama:WHITE", true),
+    BROWN_TRADER_LLAMA("brown", MobCompat.TRADER_LLAMA, "llama:BROWN", true),
+    GRAY_TRADER_LLAMA("gray", MobCompat.TRADER_LLAMA, "llama:GRAY", true),
+    RANDOM_SHULKER("random", MobCompat.SHULKER, Data.COLORABLE, true),
+    COLORABLE_SHULKER("", Arrays.stream(DyeColor.values()).map(color -> color.name().toLowerCase(Locale.ENGLISH)).collect(Collectors.toList()), MobCompat.SHULKER, Data.COLORABLE, true),
+    RED_FOX("red", MobCompat.FOX, "fox:RED", true),
+    SNOW_FOX("snow", MobCompat.FOX, "fox:SNOW", true),
+    SIZE_PHANTOM("", Collections.singletonList("<1-100>"), MobCompat.PHANTOM, Data.SIZE, true),
+    RAID_LEADER("leader", MobCompat.RAIDER, Data.RAID_LEADER, true),
+    TROPICAL_FISH_BODY_COLOR("fish_body_color", Arrays.stream(DyeColor.values()).map(color -> color.name().toLowerCase(Locale.ENGLISH) + "body").collect(Collectors.toList()), MobCompat.TROPICAL_FISH, Data.FISH_BODY_COLOR, true),
+    TROPICAL_FISH_PATTERN_COLOR("fish_pattern_color", Arrays.stream(DyeColor.values()).map(color -> color.name().toLowerCase(Locale.ENGLISH) + "pattern").collect(Collectors.toList()), MobCompat.TROPICAL_FISH, Data.FISH_PATTERN_COLOR, true),
+    ;
+
+    public static final Logger logger = Logger.getLogger("Essentials");
+    final private String nickname;
+    final private List<String> suggestions;
+    final private Object type;
+    final private Object value;
+    final private boolean isPublic;
+    private String matched;
+
+    MobData(final String n, final Object type, final Object value, final boolean isPublic) {
+        this.nickname = n;
+        this.matched = n;
+        this.suggestions = Collections.singletonList(n);
+        this.type = type;
+        this.value = value;
+        this.isPublic = isPublic;
+    }
+
+    MobData(final String n, final List<String> s, final Object type, final Object value, final boolean isPublic) {
+        this.nickname = n;
+        this.matched = n;
+        this.suggestions = s;
+        this.type = type;
+        this.value = value;
+        this.isPublic = isPublic;
+    }
+
+    public static LinkedHashMap<String, MobData> getPossibleData(final Entity spawned, final boolean publicOnly) {
+        final LinkedHashMap<String, MobData> mobList = new LinkedHashMap<>();
+        for (final MobData data : MobData.values()) {
+            if (data.type == null || (publicOnly && !data.isPublic)) {
+                continue;
+            }
+            if (data.type instanceof EntityType && spawned.getType().equals(data.type)) {
+                mobList.put(data.nickname.toLowerCase(Locale.ENGLISH), data);
+            } else if (data.type instanceof Class && ((Class) data.type).isAssignableFrom(spawned.getClass())) {
+                mobList.put(data.nickname.toLowerCase(Locale.ENGLISH), data);
+            }
+        }
+
+        return mobList;
+    }
+
+    public static List<String> getValidHelp(final Entity spawned) {
+        final List<String> output = new ArrayList<>();
+        final LinkedHashMap<String, MobData> posData = getPossibleData(spawned, true);
+
+        for (final MobData data : posData.values()) {
+            output.add(StringUtil.joinList(data.suggestions));
+        }
+        return output;
+    }
+
+    public static MobData fromData(final Entity spawned, final String name) {
+        if (name.isEmpty()) {
+            return null;
+        }
+
+        final LinkedHashMap<String, MobData> posData = getPossibleData(spawned, false);
+        for (final MobData data : posData.values()) {
+            for (final String suggestion : data.suggestions) {
+                if (name.contains(suggestion)) {
+                    return data;
+                }
+            }
+        }
+        return null;
+    }
+
+    public String getMatched() {
+        return this.matched;
+    }
+
+    public void setData(final Entity spawned, final Player target, final String rawData) throws Exception {
+        if (this.value.equals(Data.ANGRY)) {
+            ((Wolf) spawned).setAngry(true);
+        } else if (this.value.equals(Data.ADULT)) {
+            ((Ageable) spawned).setAdult();
+        } else if (this.value.equals(Data.BABY)) {
+            ((Ageable) spawned).setBaby();
+        } else if (this.value.equals(Data.ADULTZOMBIE)) {
+            ((Zombie) spawned).setBaby(false);
+        } else if (this.value.equals(Data.BABYZOMBIE)) {
+            ((Zombie) spawned).setBaby(true);
+        } else if (this.value.equals(Data.ELECTRIFIED)) {
+            ((Creeper) spawned).setPowered(true);
+        } else if (this.value.equals(Data.HORSESADDLE)) {
+            final Horse horse = (Horse) spawned;
+            horse.setTamed(true);
+            horse.setOwner(target);
+            horse.getInventory().setSaddle(new ItemStack(Material.SADDLE, 1));
+        } else if (this.value.equals(Data.PIGSADDLE)) {
+            ((Pig) spawned).setSaddle(true);
+        } else if (this.value.equals(Data.TAMED)) {
+            final Tameable tameable = (Tameable) spawned;
+            tameable.setTamed(true);
+            tameable.setOwner(target);
+        } else if (this.value.equals(Data.COLORABLE)) {
+            final String color = rawData.toUpperCase(Locale.ENGLISH);
+            try {
+                if (color.equals("RANDOM")) {
+                    final Random rand = new Random();
+                    ((Colorable) spawned).setColor(DyeColor.values()[rand.nextInt(DyeColor.values().length)]);
+                } else if (!color.isEmpty()) {
+                    ((Colorable) spawned).setColor(DyeColor.valueOf(color));
+                }
+                this.matched = rawData;
+            } catch (final Exception e) {
+                throw new Exception(tl("sheepMalformedColor"), e);
+            }
+        } else if (this.value.equals(Data.EXP)) {
+            try {
+                ((ExperienceOrb) spawned).setExperience(Integer.parseInt(rawData));
+                this.matched = rawData;
+            } catch (final NumberFormatException e) {
+                throw new Exception(tl("invalidNumber"), e);
+            }
+        } else if (this.value.equals(Data.SIZE)) {
+            try {
+                final int size = Integer.parseInt(rawData);
+                if (spawned instanceof Slime) {
+                    ((Slime) spawned).setSize(size);
+                } else if (spawned.getType() == MobCompat.PHANTOM) {
+                    ((Phantom) spawned).setSize(size);
+                }
+                this.matched = rawData;
+            } catch (final NumberFormatException e) {
+                throw new Exception(tl("slimeMalformedSize"), e);
+            }
+        } else if (this.value instanceof Horse.Color) {
+            ((Horse) spawned).setColor((Horse.Color) this.value);
+        } else if (this.value instanceof Horse.Style) {
+            ((Horse) spawned).setStyle((Horse.Style) this.value);
+        } else if (this.value instanceof MobCompat.CatType) {
+            MobCompat.setCatType(spawned, (MobCompat.CatType) this.value);
+        } else if (this.value instanceof MobCompat.VillagerProfession) {
+            MobCompat.setVillagerProfession(spawned, (MobCompat.VillagerProfession) this.value);
+        } else if (this.value instanceof Material) {
+            if (this.type.equals(EntityType.HORSE)) {
+                ((Horse) spawned).setTamed(true);
+                ((Horse) spawned).getInventory().setArmor(new ItemStack((Material) this.value, 1));
+            } else if (this.type.equals(EntityType.ZOMBIE.getEntityClass()) || this.type.equals(EntityType.SKELETON)) {
+                final EntityEquipment invent = ((LivingEntity) spawned).getEquipment();
+                InventoryWorkaround.setItemInMainHand(invent, new ItemStack((Material) this.value, 1));
+                InventoryWorkaround.setItemInMainHandDropChance(invent, 0.1f);
+            }
+        } else if (this.value.equals(Data.RAID_LEADER)) {
+            ((Raider) spawned).setPatrolLeader(true);
+        } else if (this.value.equals(Data.FISH_BODY_COLOR)) {
+            for (final String match : TROPICAL_FISH_BODY_COLOR.suggestions) {
+                if (rawData.contains(match)) {
+                    this.matched = match;
+                    final String color = match.substring(0, match.indexOf("body")).toUpperCase(Locale.ENGLISH);
+                    ((TropicalFish) spawned).setBodyColor(DyeColor.valueOf(color));
+                    break;
+                }
+            }
+        } else if (this.value.equals(Data.FISH_PATTERN_COLOR)) {
+            for (final String match : TROPICAL_FISH_PATTERN_COLOR.suggestions) {
+                if (rawData.contains(match)) {
+                    this.matched = match;
+                    final String color = match.substring(0, match.indexOf("pattern")).toUpperCase(Locale.ENGLISH);
+                    ((TropicalFish) spawned).setPatternColor(DyeColor.valueOf(color));
+                    break;
+                }
+            }
+        } else if (this.value instanceof String) {
+            final String[] split = ((String) this.value).split(":");
+            switch (split[0]) {
+                case "parrot":
+                    MobCompat.setParrotVariant(spawned, split[1]);
+                    break;
+                case "tropicalfish":
+                    MobCompat.setTropicalFishPattern(spawned, split[1]);
+                    break;
+                case "mooshroom":
+                    MobCompat.setMooshroomVariant(spawned, split[1]);
+                    break;
+                case "pandamain":
+                    MobCompat.setPandaGene(spawned, split[1], true);
+                    break;
+                case "pandahidden":
+                    MobCompat.setPandaGene(spawned, split[1], false);
+                    break;
+                case "llama":
+                    MobCompat.setLlamaColor(spawned, split[1]);
+                    break;
+                case "villagertype":
+                    MobCompat.setVillagerType(spawned, split[1]);
+                    break;
+                case "fox":
+                    MobCompat.setFoxType(spawned, split[1]);
+                    break;
+            }
+        } else {
+            logger.warning("Unknown mob data type: " + this.toString());
+        }
+    }
+
+    public enum Data {
+        ADULT,
+        BABY,
+        CHEST,
+        ADULTZOMBIE,
+        BABYZOMBIE,
+        HORSESADDLE,
+        PIGSADDLE,
+        ELECTRIFIED,
+        ANGRY,
+        TAMED,
+        COLORABLE,
+        EXP,
+        SIZE,
+        RAID_LEADER,
+        FISH_BODY_COLOR,
+        FISH_PATTERN_COLOR,
+    }
+}

Essentials/src/com/earth2me/essentials/PlayerExtension.java

@@ -1,38 +1,34 @@
 package com.earth2me.essentials;
 
-import lombok.Delegate;
-import org.bukkit.command.CommandSender;
-import org.bukkit.configuration.serialization.ConfigurationSerializable;
-import org.bukkit.entity.Entity;
-import org.bukkit.entity.HumanEntity;
-import org.bukkit.entity.LivingEntity;
+import org.bukkit.Location;
+import org.bukkit.Server;
+import org.bukkit.World;
 import org.bukkit.entity.Player;
-import org.bukkit.permissions.Permissible;
-import org.bukkit.permissions.ServerOperator;
 
+public class PlayerExtension {
+    protected Player base;
 
-public class PlayerExtension implements Player
-{
-	@Delegate(types =
-	{
-		Player.class, Entity.class, CommandSender.class, ServerOperator.class,
-		HumanEntity.class, ConfigurationSerializable.class, LivingEntity.class,
-		Permissible.class
-	})
-	protected Player base;
+    public PlayerExtension(final Player base) {
+        this.base = base;
+    }
 
-	public PlayerExtension(final Player base)
-	{
-		this.base = base;
-	}
+    public final Player getBase() {
+        return base;
+    }
 
-	public final Player getBase()
-	{
-		return base;
-	}
+    public final Player setBase(final Player base) {
+        return this.base = base;
+    }
 
-	public final Player setBase(final Player base)
-	{
-		return this.base = base;
-	}
+    public Server getServer() {
+        return base.getServer();
+    }
+
+    public World getWorld() {
+        return base.getWorld();
+    }
+
+    public Location getLocation() {
+        return base.getLocation();
+    }
 }

Essentials/src/com/earth2me/essentials/PlayerList.java

@@ -0,0 +1,128 @@
+package com.earth2me.essentials;
+
+import com.earth2me.essentials.utils.FormatUtil;
+import org.bukkit.ChatColor;
+import org.bukkit.Server;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+
+import static com.earth2me.essentials.I18n.tl;
+
+public final class PlayerList {
+
+    private PlayerList() {
+    }
+
+    // Cosmetic list formatting
+    public static String listUsers(final IEssentials ess, final List<User> users, final String seperator) {
+        final StringBuilder groupString = new StringBuilder();
+        Collections.sort(users);
+        boolean needComma = false;
+        for (final User user : users) {
+            if (needComma) {
+                groupString.append(seperator);
+            }
+            needComma = true;
+            if (user.isAfk()) {
+                groupString.append(tl("listAfkTag"));
+            }
+            if (user.isHidden()) {
+                groupString.append(tl("listHiddenTag"));
+            }
+            user.setDisplayNick();
+            groupString.append(user.getDisplayName());
+            if (ess.getSettings().realNamesOnList() && !ChatColor.stripColor(user.getDisplayName()).equals(user.getName())) {
+                groupString.append(" (").append(user.getName()).append(")");
+            }
+            groupString.append("\u00a7f");
+        }
+        return groupString.toString();
+    }
+
+    // Produce a user summary: There are 5 out of maximum 10 players online.
+    public static String listSummary(final IEssentials ess, final User user, final boolean showHidden) {
+        final Server server = ess.getServer();
+        int playerHidden = 0;
+        int hiddenCount = 0;
+        for (final User onlinePlayer : ess.getOnlineUsers()) {
+            if (onlinePlayer.isHidden() || (user != null && !user.getBase().canSee(onlinePlayer.getBase()))) {
+                playerHidden++;
+                if (showHidden || user != null && user.getBase().canSee(onlinePlayer.getBase())) {
+                    hiddenCount++;
+                }
+            }
+        }
+        final String online;
+        if (hiddenCount > 0) {
+            online = tl("listAmountHidden", ess.getOnlinePlayers().size() - playerHidden, hiddenCount, server.getMaxPlayers());
+        } else {
+            online = tl("listAmount", ess.getOnlinePlayers().size() - playerHidden, server.getMaxPlayers());
+        }
+        return online;
+    }
+
+    // Build the basic player list, divided by groups.
+    public static Map<String, List<User>> getPlayerLists(final IEssentials ess, final IUser sender, final boolean showHidden) {
+        final Map<String, List<User>> playerList = new HashMap<>();
+        for (final User onlineUser : ess.getOnlineUsers()) {
+            if ((sender == null && !showHidden && onlineUser.isHidden()) || (sender != null && !showHidden && !sender.getBase().canSee(onlineUser.getBase()))) {
+                continue;
+            }
+            final String group = FormatUtil.stripFormat(FormatUtil.stripEssentialsFormat(onlineUser.getGroup().toLowerCase()));
+            final List<User> list = playerList.computeIfAbsent(group, k -> new ArrayList<>());
+            list.add(onlineUser);
+        }
+        return playerList;
+    }
+
+    // Handle the merging of groups
+    public static List<User> getMergedList(final IEssentials ess, final Map<String, List<User>> playerList, final String groupName) {
+        final Set<String> configGroups = ess.getSettings().getListGroupConfig().keySet();
+        final List<User> users = new ArrayList<>();
+        for (final String configGroup : configGroups) {
+            if (configGroup.equalsIgnoreCase(groupName)) {
+                final String[] groupValues = ess.getSettings().getListGroupConfig().get(configGroup).toString().trim().split(" ");
+                for (String groupValue : groupValues) {
+                    groupValue = groupValue.toLowerCase(Locale.ENGLISH);
+                    if (groupValue.isEmpty()) {
+                        continue;
+                    }
+                    final List<User> u = playerList.get(groupValue.trim());
+                    if (u == null || u.isEmpty()) {
+                        continue;
+                    }
+                    playerList.remove(groupValue);
+                    users.addAll(u);
+                }
+            }
+        }
+        return users;
+    }
+
+    // Output a playerlist of just a single group, /list <groupname>
+    public static String listGroupUsers(final IEssentials ess, final Map<String, List<User>> playerList, final String groupName) throws Exception {
+        final List<User> users = getMergedList(ess, playerList, groupName);
+        final List<User> groupUsers = playerList.get(groupName);
+        if (groupUsers != null && !groupUsers.isEmpty()) {
+            users.addAll(groupUsers);
+        }
+        if (users.isEmpty()) {
+            throw new Exception(tl("groupDoesNotExist"));
+        }
+        final String displayGroupName = Character.toTitleCase(groupName.charAt(0)) +
+            groupName.substring(1);
+        return outputFormat(displayGroupName, listUsers(ess, users, ", "));
+    }
+
+    // Build the output string
+    public static String outputFormat(final String group, final String message) {
+        return tl("listGroupTag", FormatUtil.replaceFormat(group)) +
+            message;
+    }
+}

Essentials/src/com/earth2me/essentials/PlayerTarget.java

@@ -4,19 +4,15 @@ import org.bukkit.Bukkit;
 import org.bukkit.Location;
 import org.bukkit.entity.Player;
 
+public class PlayerTarget implements ITarget {
+    private final String name;
 
-public class PlayerTarget implements ITarget
-{
-	private final String name;
+    public PlayerTarget(final Player entity) {
+        this.name = entity.getName();
+    }
 
-	PlayerTarget(Player entity)
-	{
-		this.name = entity.getName();
-	}
-
-	@Override
-	public Location getLocation()
-	{
-		return Bukkit.getServer().getPlayerExact(name).getLocation();
-	}
-}
+    @Override
+    public Location getLocation() {
+        return Bukkit.getServer().getPlayerExact(name).getLocation();
+    }
+}

Essentials/src/com/earth2me/essentials/Potions.java

@@ -1,131 +1,152 @@
 package com.earth2me.essentials;
 
 import com.earth2me.essentials.utils.NumberUtil;
+import org.bukkit.potion.PotionEffectType;
+
 import java.util.HashMap;
 import java.util.Locale;
 import java.util.Map;
 import java.util.Map.Entry;
 import java.util.Set;
-import org.bukkit.potion.PotionEffectType;
 
+public final class Potions {
+    private static final Map<String, PotionEffectType> POTIONS = new HashMap<>();
+    private static final Map<String, PotionEffectType> ALIASPOTIONS = new HashMap<>();
 
-public class Potions
-{
-	private static final Map<String, PotionEffectType> POTIONS = new HashMap<String, PotionEffectType>();
-	private static final Map<String, PotionEffectType> ALIASPOTIONS = new HashMap<String, PotionEffectType>();
+    static {
 
-	static
-	{
+        POTIONS.put("speed", PotionEffectType.SPEED);
+        ALIASPOTIONS.put("fast", PotionEffectType.SPEED);
+        ALIASPOTIONS.put("runfast", PotionEffectType.SPEED);
+        ALIASPOTIONS.put("sprint", PotionEffectType.SPEED);
+        ALIASPOTIONS.put("swift", PotionEffectType.SPEED);
 
-		POTIONS.put("speed", PotionEffectType.SPEED);
-		ALIASPOTIONS.put("fast", PotionEffectType.SPEED);
-		ALIASPOTIONS.put("runfast", PotionEffectType.SPEED);
-		ALIASPOTIONS.put("sprint", PotionEffectType.SPEED);
-		ALIASPOTIONS.put("swift", PotionEffectType.SPEED);
+        POTIONS.put("slowness", PotionEffectType.SLOW);
+        ALIASPOTIONS.put("slow", PotionEffectType.SLOW);
+        ALIASPOTIONS.put("sluggish", PotionEffectType.SLOW);
 
-		POTIONS.put("slowness", PotionEffectType.SLOW);
-		ALIASPOTIONS.put("slow", PotionEffectType.SLOW);
-		ALIASPOTIONS.put("sluggish", PotionEffectType.SLOW);
+        POTIONS.put("haste", PotionEffectType.FAST_DIGGING);
+        ALIASPOTIONS.put("superpick", PotionEffectType.FAST_DIGGING);
+        ALIASPOTIONS.put("quickmine", PotionEffectType.FAST_DIGGING);
+        ALIASPOTIONS.put("digspeed", PotionEffectType.FAST_DIGGING);
+        ALIASPOTIONS.put("digfast", PotionEffectType.FAST_DIGGING);
+        ALIASPOTIONS.put("sharp", PotionEffectType.FAST_DIGGING);
 
-		POTIONS.put("haste", PotionEffectType.FAST_DIGGING);
-		ALIASPOTIONS.put("superpick", PotionEffectType.FAST_DIGGING);
-		ALIASPOTIONS.put("quickmine", PotionEffectType.FAST_DIGGING);
-		ALIASPOTIONS.put("digspeed", PotionEffectType.FAST_DIGGING);
-		ALIASPOTIONS.put("digfast", PotionEffectType.FAST_DIGGING);
-		ALIASPOTIONS.put("sharp", PotionEffectType.FAST_DIGGING);
+        POTIONS.put("fatigue", PotionEffectType.SLOW_DIGGING);
+        ALIASPOTIONS.put("slow", PotionEffectType.SLOW_DIGGING);
+        ALIASPOTIONS.put("dull", PotionEffectType.SLOW_DIGGING);
 
-		POTIONS.put("fatigue", PotionEffectType.SLOW_DIGGING);
-		ALIASPOTIONS.put("slow", PotionEffectType.SLOW_DIGGING);
-		ALIASPOTIONS.put("dull", PotionEffectType.SLOW_DIGGING);
+        POTIONS.put("strength", PotionEffectType.INCREASE_DAMAGE);
+        ALIASPOTIONS.put("strong", PotionEffectType.INCREASE_DAMAGE);
+        ALIASPOTIONS.put("bull", PotionEffectType.INCREASE_DAMAGE);
+        ALIASPOTIONS.put("attack", PotionEffectType.INCREASE_DAMAGE);
 
-		POTIONS.put("strength", PotionEffectType.INCREASE_DAMAGE);
-		ALIASPOTIONS.put("strong", PotionEffectType.INCREASE_DAMAGE);
-		ALIASPOTIONS.put("bull", PotionEffectType.INCREASE_DAMAGE);
-		ALIASPOTIONS.put("attack", PotionEffectType.INCREASE_DAMAGE);
+        POTIONS.put("heal", PotionEffectType.HEAL);
+        ALIASPOTIONS.put("healthy", PotionEffectType.HEAL);
+        ALIASPOTIONS.put("instaheal", PotionEffectType.HEAL);
 
-		POTIONS.put("heal", PotionEffectType.HEAL);
-		ALIASPOTIONS.put("healthy", PotionEffectType.HEAL);
-		ALIASPOTIONS.put("instaheal", PotionEffectType.HEAL);
+        POTIONS.put("harm", PotionEffectType.HARM);
+        ALIASPOTIONS.put("harming", PotionEffectType.HARM);
+        ALIASPOTIONS.put("injure", PotionEffectType.HARM);
+        ALIASPOTIONS.put("damage", PotionEffectType.HARM);
+        ALIASPOTIONS.put("inflict", PotionEffectType.HARM);
 
-		POTIONS.put("harm", PotionEffectType.HARM);
-		ALIASPOTIONS.put("harming", PotionEffectType.HARM);
-		ALIASPOTIONS.put("injure", PotionEffectType.HARM);
-		ALIASPOTIONS.put("damage", PotionEffectType.HARM);
-		ALIASPOTIONS.put("inflict", PotionEffectType.HARM);
+        POTIONS.put("jump", PotionEffectType.JUMP);
+        ALIASPOTIONS.put("leap", PotionEffectType.JUMP);
 
-		POTIONS.put("jump", PotionEffectType.JUMP);
-		ALIASPOTIONS.put("leap", PotionEffectType.JUMP);
+        POTIONS.put("nausea", PotionEffectType.CONFUSION);
+        ALIASPOTIONS.put("sick", PotionEffectType.CONFUSION);
+        ALIASPOTIONS.put("sickness", PotionEffectType.CONFUSION);
+        ALIASPOTIONS.put("confusion", PotionEffectType.CONFUSION);
 
-		POTIONS.put("nausea", PotionEffectType.CONFUSION);
-		ALIASPOTIONS.put("sick", PotionEffectType.CONFUSION);
-		ALIASPOTIONS.put("sickness", PotionEffectType.CONFUSION);
-		ALIASPOTIONS.put("confusion", PotionEffectType.CONFUSION);
+        POTIONS.put("regeneration", PotionEffectType.REGENERATION);
+        ALIASPOTIONS.put("regen", PotionEffectType.REGENERATION);
 
-		POTIONS.put("regeneration", PotionEffectType.REGENERATION);
-		ALIASPOTIONS.put("regen", PotionEffectType.REGENERATION);
+        POTIONS.put("resistance", PotionEffectType.DAMAGE_RESISTANCE);
+        ALIASPOTIONS.put("dmgresist", PotionEffectType.DAMAGE_RESISTANCE);
+        ALIASPOTIONS.put("armor", PotionEffectType.DAMAGE_RESISTANCE);
 
-		POTIONS.put("resistance", PotionEffectType.DAMAGE_RESISTANCE);
-		ALIASPOTIONS.put("dmgresist", PotionEffectType.DAMAGE_RESISTANCE);
-		ALIASPOTIONS.put("armor", PotionEffectType.DAMAGE_RESISTANCE);
-		ALIASPOTIONS.put("dmgresist", PotionEffectType.DAMAGE_RESISTANCE);
+        POTIONS.put("fireresist", PotionEffectType.FIRE_RESISTANCE);
+        ALIASPOTIONS.put("fireresistance", PotionEffectType.FIRE_RESISTANCE);
+        ALIASPOTIONS.put("resistfire", PotionEffectType.FIRE_RESISTANCE);
 
-		POTIONS.put("fireresist", PotionEffectType.FIRE_RESISTANCE);
-		ALIASPOTIONS.put("fireresistance", PotionEffectType.FIRE_RESISTANCE);
-		ALIASPOTIONS.put("resistfire", PotionEffectType.FIRE_RESISTANCE);
+        POTIONS.put("waterbreath", PotionEffectType.WATER_BREATHING);
+        ALIASPOTIONS.put("waterbreathing", PotionEffectType.WATER_BREATHING);
 
-		POTIONS.put("waterbreath", PotionEffectType.WATER_BREATHING);
-		ALIASPOTIONS.put("waterbreathing", PotionEffectType.WATER_BREATHING);
+        POTIONS.put("invisibility", PotionEffectType.INVISIBILITY);
+        ALIASPOTIONS.put("invisible", PotionEffectType.INVISIBILITY);
+        ALIASPOTIONS.put("invis", PotionEffectType.INVISIBILITY);
+        ALIASPOTIONS.put("vanish", PotionEffectType.INVISIBILITY);
+        ALIASPOTIONS.put("disappear", PotionEffectType.INVISIBILITY);
 
-		POTIONS.put("invisibility", PotionEffectType.INVISIBILITY);
-		ALIASPOTIONS.put("invisible", PotionEffectType.INVISIBILITY);
-		ALIASPOTIONS.put("invis", PotionEffectType.INVISIBILITY);
-		ALIASPOTIONS.put("vanish", PotionEffectType.INVISIBILITY);
-		ALIASPOTIONS.put("disappear", PotionEffectType.INVISIBILITY);
+        POTIONS.put("blindness", PotionEffectType.BLINDNESS);
+        ALIASPOTIONS.put("blind", PotionEffectType.BLINDNESS);
 
-		POTIONS.put("blindness", PotionEffectType.BLINDNESS);
-		ALIASPOTIONS.put("blind", PotionEffectType.BLINDNESS);
+        POTIONS.put("nightvision", PotionEffectType.NIGHT_VISION);
+        ALIASPOTIONS.put("vision", PotionEffectType.NIGHT_VISION);
 
-		POTIONS.put("nightvision", PotionEffectType.NIGHT_VISION);
-		ALIASPOTIONS.put("vision", PotionEffectType.NIGHT_VISION);
+        POTIONS.put("hunger", PotionEffectType.HUNGER);
+        ALIASPOTIONS.put("hungry", PotionEffectType.HUNGER);
+        ALIASPOTIONS.put("starve", PotionEffectType.HUNGER);
 
-		POTIONS.put("hunger", PotionEffectType.HUNGER);
-		ALIASPOTIONS.put("hungry", PotionEffectType.HUNGER);
-		ALIASPOTIONS.put("starve", PotionEffectType.HUNGER);
+        POTIONS.put("weakness", PotionEffectType.WEAKNESS);
+        ALIASPOTIONS.put("weak", PotionEffectType.WEAKNESS);
 
-		POTIONS.put("weakness", PotionEffectType.WEAKNESS);
-		ALIASPOTIONS.put("weak", PotionEffectType.WEAKNESS);
+        POTIONS.put("poison", PotionEffectType.POISON);
+        ALIASPOTIONS.put("venom", PotionEffectType.POISON);
 
-		POTIONS.put("poison", PotionEffectType.POISON);
-		ALIASPOTIONS.put("venom", PotionEffectType.POISON);
+        POTIONS.put("wither", PotionEffectType.WITHER);
+        ALIASPOTIONS.put("decay", PotionEffectType.WITHER);
 
-		POTIONS.put("wither", PotionEffectType.WITHER);
-		ALIASPOTIONS.put("decay", PotionEffectType.WITHER);
-	}
+        POTIONS.put("healthboost", PotionEffectType.HEALTH_BOOST);
+        ALIASPOTIONS.put("boost", PotionEffectType.HEALTH_BOOST);
 
-	public static PotionEffectType getByName(String name)
-	{
-		PotionEffectType peffect;
-		if (NumberUtil.isInt(name))
-		{
-			peffect = PotionEffectType.getById(Integer.parseInt(name));
-		}
-		else
-		{
-			peffect = PotionEffectType.getByName(name.toUpperCase(Locale.ENGLISH));
-		}
-		if (peffect == null)
-		{
-			peffect = POTIONS.get(name.toLowerCase(Locale.ENGLISH));
-		}
-		if (peffect == null)
-		{
-			peffect = ALIASPOTIONS.get(name.toLowerCase(Locale.ENGLISH));
-		}
-		return peffect;
-	}
+        POTIONS.put("absorption", PotionEffectType.ABSORPTION);
+        ALIASPOTIONS.put("absorb", PotionEffectType.ABSORPTION);
 
-	public static Set<Entry<String, PotionEffectType>> entrySet()
-	{
-		return POTIONS.entrySet();
-	}
-}
+        POTIONS.put("saturation", PotionEffectType.SATURATION);
+        ALIASPOTIONS.put("food", PotionEffectType.SATURATION);
+
+        POTIONS.put("waterbreathing", PotionEffectType.WATER_BREATHING);
+        ALIASPOTIONS.put("underwaterbreathing", PotionEffectType.WATER_BREATHING);
+        ALIASPOTIONS.put("waterbreath", PotionEffectType.WATER_BREATHING);
+        ALIASPOTIONS.put("underwaterbreath", PotionEffectType.WATER_BREATHING);
+        ALIASPOTIONS.put("air", PotionEffectType.WATER_BREATHING);
+
+        // 1.9
+        try {
+            POTIONS.put("glowing", PotionEffectType.GLOWING);
+            ALIASPOTIONS.put("glow", PotionEffectType.GLOWING);
+
+            POTIONS.put("levitation", PotionEffectType.LEVITATION);
+            ALIASPOTIONS.put("levitate", PotionEffectType.LEVITATION);
+
+            POTIONS.put("luck", PotionEffectType.LUCK);
+            POTIONS.put("unluck", PotionEffectType.UNLUCK);
+        } catch (final Throwable ignored) {
+        }
+    }
+
+    private Potions() {
+    }
+
+    public static PotionEffectType getByName(final String name) {
+        PotionEffectType peffect;
+        if (NumberUtil.isInt(name)) {
+            peffect = PotionEffectType.getById(Integer.parseInt(name));
+        } else {
+            peffect = PotionEffectType.getByName(name.toUpperCase(Locale.ENGLISH));
+        }
+        if (peffect == null) {
+            peffect = POTIONS.get(name.toLowerCase(Locale.ENGLISH));
+        }
+        if (peffect == null) {
+            peffect = ALIASPOTIONS.get(name.toLowerCase(Locale.ENGLISH));
+        }
+        return peffect;
+    }
+
+    public static Set<Entry<String, PotionEffectType>> entrySet() {
+        return POTIONS.entrySet();
+    }
+}

Essentials/src/com/earth2me/essentials/RandomTeleport.java

@@ -0,0 +1,209 @@
+package com.earth2me.essentials;
+
+import com.earth2me.essentials.utils.LocationUtil;
+import com.earth2me.essentials.utils.VersionUtil;
+import io.papermc.lib.PaperLib;
+import net.ess3.api.InvalidWorldException;
+import org.bukkit.Location;
+import org.bukkit.World;
+import org.bukkit.block.Biome;
+
+import java.io.File;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Queue;
+import java.util.Random;
+import java.util.Set;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ConcurrentLinkedQueue;
+
+public class RandomTeleport implements IConf {
+    private static final Random RANDOM = new Random();
+    private static final int HIGHEST_BLOCK_Y_OFFSET = VersionUtil.getServerBukkitVersion().isHigherThanOrEqualTo(VersionUtil.v1_15_R01) ? 1 : 0;
+    private final IEssentials essentials;
+    private final EssentialsConf config;
+    private final ConcurrentLinkedQueue<Location> cachedLocations = new ConcurrentLinkedQueue<>();
+
+    public RandomTeleport(final IEssentials essentials) {
+        this.essentials = essentials;
+        final File file = new File(essentials.getDataFolder(), "tpr.yml");
+        config = new EssentialsConf(file);
+        config.setTemplateName("/tpr.yml");
+        config.options().copyHeader(true);
+        reloadConfig();
+    }
+
+    @Override
+    public void reloadConfig() {
+        config.load();
+        cachedLocations.clear();
+    }
+
+    public Location getCenter() {
+        try {
+            final Location center = config.getLocation("center", essentials.getServer());
+            if (center != null) {
+                return center;
+            }
+        } catch (final InvalidWorldException ignored) {
+        }
+        final Location center = essentials.getServer().getWorlds().get(0).getWorldBorder().getCenter();
+        center.setY(center.getWorld().getHighestBlockYAt(center) + 1);
+        setCenter(center);
+        return center;
+    }
+
+    public void setCenter(final Location center) {
+        config.setProperty("center", center);
+        config.save();
+    }
+
+    public double getMinRange() {
+        return config.getDouble("min-range", 0d);
+    }
+
+    public void setMinRange(final double minRange) {
+        config.setProperty("min-range", minRange);
+        config.save();
+    }
+
+    public double getMaxRange() {
+        return config.getDouble("max-range", getCenter().getWorld().getWorldBorder().getSize() / 2);
+    }
+
+    public void setMaxRange(final double maxRange) {
+        config.setProperty("max-range", maxRange);
+        config.save();
+    }
+
+    public Set<Biome> getExcludedBiomes() {
+        final List<String> biomeNames = config.getStringList("excluded-biomes");
+        final Set<Biome> excludedBiomes = new HashSet<>();
+        for (final String biomeName : biomeNames) {
+            try {
+                excludedBiomes.add(Biome.valueOf(biomeName.toUpperCase()));
+            } catch (final IllegalArgumentException ignored) {
+            }
+        }
+        return excludedBiomes;
+    }
+
+    public int getFindAttempts() {
+        return config.getInt("find-attempts", 10);
+    }
+
+    public int getCacheThreshold() {
+        return config.getInt("cache-threshold", 10);
+    }
+
+    public boolean getPreCache() {
+        return config.getBoolean("pre-cache", false);
+    }
+
+    public Queue<Location> getCachedLocations() {
+        return cachedLocations;
+    }
+
+    // Get a random location; cached if possible. Otherwise on demand.
+    public CompletableFuture<Location> getRandomLocation(final Location center, final double minRange, final double maxRange) {
+        final int findAttempts = this.getFindAttempts();
+        final Queue<Location> cachedLocations = this.getCachedLocations();
+        // Try to build up the cache if it is below the threshold
+        if (cachedLocations.size() < this.getCacheThreshold()) {
+            cacheRandomLocations(center, minRange, maxRange);
+        }
+        final CompletableFuture<Location> future = new CompletableFuture<>();
+        // Return a random location immediately if one is available, otherwise try to find one now
+        if (cachedLocations.isEmpty()) {
+            attemptRandomLocation(findAttempts, center, minRange, maxRange).thenAccept(future::complete);
+        } else {
+            future.complete(cachedLocations.poll());
+        }
+        return future;
+    }
+
+    // Prompts caching random valid locations, up to a maximum number of attempts
+    public void cacheRandomLocations(final Location center, final double minRange, final double maxRange) {
+        essentials.getServer().getScheduler().scheduleSyncDelayedTask(essentials, () -> {
+            for (int i = 0; i < this.getFindAttempts(); ++i) {
+                calculateRandomLocation(center, minRange, maxRange).thenAccept(location -> {
+                    if (isValidRandomLocation(location)) {
+                        this.getCachedLocations().add(location);
+                    }
+                });
+            }
+        });
+    }
+
+    // Recursively attempt to find a random location. After a maximum number of attempts, the center is returned.
+    private CompletableFuture<Location> attemptRandomLocation(final int attempts, final Location center, final double minRange, final double maxRange) {
+        final CompletableFuture<Location> future = new CompletableFuture<>();
+        if (attempts > 0) {
+            calculateRandomLocation(center, minRange, maxRange).thenAccept(location -> {
+                if (isValidRandomLocation(location)) {
+                    future.complete(location);
+                } else {
+                    attemptRandomLocation(attempts - 1, center, minRange, maxRange).thenAccept(future::complete);
+                }
+            });
+        } else {
+            future.complete(center);
+        }
+        return future;
+    }
+
+    // Calculates a random location asynchronously.
+    private CompletableFuture<Location> calculateRandomLocation(final Location center, final double minRange, final double maxRange) {
+        final CompletableFuture<Location> future = new CompletableFuture<>();
+        // Find an equally distributed offset by randomly rotating a point inside a rectangle about the origin
+        final double rectX = RANDOM.nextDouble() * (maxRange - minRange) + minRange;
+        final double rectZ = RANDOM.nextDouble() * (maxRange + minRange) - minRange;
+        final double offsetX;
+        final double offsetZ;
+        final int transform = RANDOM.nextInt(4);
+        if (transform == 0) {
+            offsetX = rectX;
+            offsetZ = rectZ;
+        } else if (transform == 1) {
+            offsetX = -rectZ;
+            offsetZ = rectX;
+        } else if (transform == 2) {
+            offsetX = -rectX;
+            offsetZ = -rectZ;
+        } else {
+            offsetX = rectZ;
+            offsetZ = -rectX;
+        }
+        final Location location = new Location(
+            center.getWorld(),
+            center.getX() + offsetX,
+            center.getWorld().getMaxHeight(),
+            center.getZ() + offsetZ,
+            360 * RANDOM.nextFloat() - 180,
+            0
+        );
+        PaperLib.getChunkAtAsync(location).thenAccept(chunk -> {
+            if (World.Environment.NETHER.equals(center.getWorld().getEnvironment())) {
+                location.setY(getNetherYAt(location));
+            } else {
+                location.setY(center.getWorld().getHighestBlockYAt(location) + HIGHEST_BLOCK_Y_OFFSET);
+            }
+            future.complete(location);
+        });
+        return future;
+    }
+
+    // Returns an appropriate elevation for a given location in the nether, or -1 if none is found
+    private double getNetherYAt(final Location location) {
+        for (int y = 32; y < location.getWorld().getMaxHeight() / 2; ++y) {
+            if (!LocationUtil.isBlockUnsafe(location.getWorld(), location.getBlockX(), y, location.getBlockZ())) {
+                return y;
+            }
+        }
+        return -1;
+    }
+
+    private boolean isValidRandomLocation(final Location location) {
+        return location.getBlockY() > 0 && !this.getExcludedBiomes().contains(location.getBlock().getBiome());
+    }
+}

Essentials/src/com/earth2me/essentials/SpawnMob.java

@@ -1,437 +1,278 @@
 package com.earth2me.essentials;
 
-import com.earth2me.essentials.utils.StringUtil;
-import static com.earth2me.essentials.I18n._;
 import com.earth2me.essentials.Mob.MobException;
+import com.earth2me.essentials.craftbukkit.InventoryWorkaround;
+import com.earth2me.essentials.utils.EnumUtil;
 import com.earth2me.essentials.utils.LocationUtil;
-import com.earth2me.essentials.utils.NumberUtil;
-import java.util.ArrayList;
-import java.util.HashSet;
-import java.util.List;
-import java.util.Locale;
-import java.util.Random;
-import java.util.Set;
-import org.bukkit.DyeColor;
+import com.earth2me.essentials.utils.StringUtil;
+import net.ess3.api.IEssentials;
 import org.bukkit.Location;
 import org.bukkit.Material;
 import org.bukkit.Server;
 import org.bukkit.block.Block;
-import org.bukkit.command.CommandSender;
-import org.bukkit.entity.*;
-import org.bukkit.entity.Skeleton.SkeletonType;
+import org.bukkit.entity.Ageable;
+import org.bukkit.entity.Entity;
+import org.bukkit.entity.EntityType;
+import org.bukkit.entity.Horse;
+import org.bukkit.entity.LivingEntity;
+import org.bukkit.entity.PigZombie;
+import org.bukkit.entity.Zombie;
 import org.bukkit.inventory.EntityEquipment;
 import org.bukkit.inventory.ItemStack;
-import org.bukkit.material.Colorable;
 
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Locale;
+import java.util.Set;
 
-public class SpawnMob
-{
-	public static String mobList(final User user)
-	{
-		final Set<String> mobList = Mob.getMobList();
-		final Set<String> availableList = new HashSet<String>();
-		for (String mob : mobList)
-		{
-			if (user.isAuthorized("essentials.spawnmob." + mob.toLowerCase(Locale.ENGLISH)))
-			{
-				availableList.add(mob);
-			}
-		}
-		if (availableList.isEmpty())
-		{
-			availableList.add(_("none"));
-		}
-		return StringUtil.joinList(availableList);
-	}
+import static com.earth2me.essentials.I18n.tl;
 
-	public static List<String> mobParts(final String mobString)
-	{
-		String[] mobParts = mobString.split(",");
+public final class SpawnMob {
 
-		List<String> mobs = new ArrayList<String>();
+    private static final Material GOLDEN_HELMET = EnumUtil.getMaterial("GOLDEN_HELMET", "GOLD_HELMET");
+    private static final Material GOLDEN_CHESTPLATE = EnumUtil.getMaterial("GOLDEN_CHESTPLATE", "GOLD_CHESTPLATE");
+    private static final Material GOLDEN_LEGGINGS = EnumUtil.getMaterial("GOLDEN_LEGGINGS", "GOLD_LEGGINGS");
+    private static final Material GOLDEN_BOOTS = EnumUtil.getMaterial("GOLDEN_BOOTS", "GOLD_BOOTS");
+    private static final Material GOLDEN_SWORD = EnumUtil.getMaterial("GOLDEN_SWORD", "GOLD_SWORD");
 
-		for (String mobPart : mobParts)
-		{
-			String[] mobDatas = mobPart.split(":");
-			mobs.add(mobDatas[0]);
-		}
-		return mobs;
-	}
+    private SpawnMob() {
+    }
 
-	public static List<String> mobData(final String mobString)
-	{
-		String[] mobParts = mobString.split(",");
+    public static String mobList(final User user) {
+        final Set<String> mobList = Mob.getMobList();
+        final Set<String> availableList = new HashSet<>();
+        for (final String mob : mobList) {
+            if (user.isAuthorized("essentials.spawnmob." + mob.toLowerCase(Locale.ENGLISH))) {
+                availableList.add(mob);
+            }
+        }
+        if (availableList.isEmpty()) {
+            availableList.add(tl("none"));
+        }
+        return StringUtil.joinList(availableList);
+    }
 
-		List<String> mobData = new ArrayList<String>();
+    public static List<String> mobParts(final String mobString) {
+        final String[] mobParts = mobString.split(",");
 
-		for (String mobPart : mobParts)
-		{
-			String[] mobDatas = mobPart.split(":");
-			if (mobDatas.length == 1)
-			{
-				mobData.add(null);
-			}
-			else
-			{
-				mobData.add(mobDatas[1]);
-			}
-		}
+        final List<String> mobs = new ArrayList<>();
 
-		return mobData;
-	}
+        for (final String mobPart : mobParts) {
+            final String[] mobDatas = mobPart.split(":");
+            mobs.add(mobDatas[0]);
+        }
+        return mobs;
+    }
 
-	// This method spawns a mob where the user is looking, owned by user
-	public static void spawnmob(final IEssentials ess, final Server server, final User user, final List<String> parts, final List<String> data, int mobCount) throws Exception
-	{
-		final Block block = LocationUtil.getTarget(user).getBlock();
-		if (block == null)
-		{
-			throw new Exception(_("unableToSpawnMob"));
-		}
-		spawnmob(ess, server, user, user, block.getLocation(), parts, data, mobCount);
-	}
+    public static List<String> mobData(final String mobString) {
+        final String[] mobParts = mobString.split(",");
 
-	// This method spawns a mob at loc, owned by noone
-	public static void spawnmob(final IEssentials ess, final Server server, final CommandSender sender, final Location loc, final List<String> parts, final List<String> data, int mobCount) throws Exception
-	{
-		spawnmob(ess, server, sender, null, loc, parts, data, mobCount);
-	}
+        final List<String> mobData = new ArrayList<>();
 
-	// This method spawns a mob at target, owned by target
-	public static void spawnmob(final IEssentials ess, final Server server, final CommandSender sender, final User target, final List<String> parts, final List<String> data, int mobCount) throws Exception
-	{
-		spawnmob(ess, server, sender, target, target.getLocation(), parts, data, mobCount);
-	}
+        for (final String mobPart : mobParts) {
+            final String[] mobDatas = mobPart.split(":");
+            if (mobDatas.length == 1) {
+                if (mobPart.contains(":")) {
+                    mobData.add("");
+                } else {
+                    mobData.add(null);
+                }
+            } else {
+                mobData.add(mobDatas[1]);
+            }
+        }
 
-	// This method spawns a mob at loc, owned by target
-	public static void spawnmob(final IEssentials ess, final Server server, final CommandSender sender, final User target, final Location loc, final List<String> parts, final List<String> data, int mobCount) throws Exception
-	{
-		final Location sloc = LocationUtil.getSafeDestination(loc);
+        return mobData;
+    }
 
-		for (int i = 0; i < parts.size(); i++)
-		{
-			Mob mob = Mob.fromName(parts.get(i));
-			checkSpawnable(ess, sender, mob);
-		}
+    // This method spawns a mob where the user is looking, owned by user
+    public static void spawnmob(final IEssentials ess, final Server server, final User user, final List<String> parts, final List<String> data, final int mobCount) throws Exception {
+        final Block block = LocationUtil.getTarget(user.getBase()).getBlock();
+        if (block == null) {
+            throw new Exception(tl("unableToSpawnMob"));
+        }
+        spawnmob(ess, server, user.getSource(), user, block.getLocation(), parts, data, mobCount);
+    }
 
-		final int serverLimit = ess.getSettings().getSpawnMobLimit();
-		int effectiveLimit = serverLimit / parts.size();
+    // This method spawns a mob at target, owned by target
+    public static void spawnmob(final IEssentials ess, final Server server, final CommandSource sender, final User target, final List<String> parts, final List<String> data, final int mobCount) throws Exception {
+        spawnmob(ess, server, sender, target, target.getLocation(), parts, data, mobCount);
+    }
 
-		if (effectiveLimit < 1)
-		{
-			effectiveLimit = 1;
-			while (parts.size() > serverLimit)
-			{
-				parts.remove(serverLimit);
-			}
-		}
+    // This method spawns a mob at loc, owned by target
+    public static void spawnmob(final IEssentials ess, final Server server, final CommandSource sender, final User target, final Location loc, final List<String> parts, final List<String> data, int mobCount) throws Exception {
+        final Location sloc = LocationUtil.getSafeDestination(loc);
 
-		if (mobCount > effectiveLimit)
-		{
-			mobCount = effectiveLimit;
-			sender.sendMessage(_("mobSpawnLimit"));
-		}
+        for (final String part : parts) {
+            final Mob mob = Mob.fromName(part);
+            checkSpawnable(ess, sender, mob);
+        }
 
-		Mob mob = Mob.fromName(parts.get(0)); // Get the first mob
-		try
-		{
-			for (int i = 0; i < mobCount; i++)
-			{
-				spawnMob(ess, server, sender, target, sloc, parts, data);
-			}
-			sender.sendMessage(mobCount * parts.size() + " " + mob.name.toLowerCase(Locale.ENGLISH) + mob.suffix + " " + _("spawned"));
-		}
-		catch (MobException e1)
-		{
-			throw new Exception(_("unableToSpawnMob"), e1);
-		}
-		catch (NumberFormatException e2)
-		{
-			throw new Exception(_("numberRequired"), e2);
-		}
-		catch (NullPointerException np)
-		{
-			throw new Exception(_("soloMob"), np);
-		}
-	}
+        final int serverLimit = ess.getSettings().getSpawnMobLimit();
+        int effectiveLimit = serverLimit / parts.size();
 
-	private static void spawnMob(final IEssentials ess, final Server server, final CommandSender sender, final User target, final Location sloc, List<String> parts, List<String> data) throws Exception
-	{
-		Mob mob;
-		Entity spawnedMob = null;
-		Entity spawnedMount;
+        if (effectiveLimit < 1) {
+            effectiveLimit = 1;
+            while (parts.size() > serverLimit) {
+                parts.remove(serverLimit);
+            }
+        }
 
-		for (int i = 0; i < parts.size(); i++)
-		{
-			if (i == 0)
-			{
-				mob = Mob.fromName(parts.get(i));
-				spawnedMob = mob.spawn(sloc.getWorld(), server, sloc);
-				defaultMobData(mob.getType(), spawnedMob);
+        if (mobCount > effectiveLimit) {
+            mobCount = effectiveLimit;
+            sender.sendMessage(tl("mobSpawnLimit"));
+        }
 
-				if (data.get(i) != null)
-				{
-					changeMobData(mob.getType(), spawnedMob, data.get(i), target);
-				}
-			}
+        final Mob mob = Mob.fromName(parts.get(0)); // Get the first mob
+        try {
+            for (int i = 0; i < mobCount; i++) {
+                spawnMob(ess, server, sender, target, sloc, parts, data);
+            }
+            sender.sendMessage(mobCount * parts.size() + " " + mob.name.toLowerCase(Locale.ENGLISH) + mob.suffix + " " + tl("spawned"));
+        } catch (final MobException e1) {
+            throw new Exception(tl("unableToSpawnMob"), e1);
+        } catch (final NumberFormatException e2) {
+            throw new Exception(tl("numberRequired"), e2);
+        } catch (final NullPointerException np) {
+            throw new Exception(tl("soloMob"), np);
+        }
+    }
 
-			int next = (i + 1);
-			if (next < parts.size()) //If it's the last mob in the list, don't set the mount
-			{
-				Mob mMob = Mob.fromName(parts.get(next));
-				spawnedMount = mMob.spawn(sloc.getWorld(), server, sloc);
-				defaultMobData(mMob.getType(), spawnedMount);
+    private static void spawnMob(final IEssentials ess, final Server server, final CommandSource sender, final User target, final Location sloc, final List<String> parts, final List<String> data) throws Exception {
+        Mob mob;
+        Entity spawnedMob = null;
+        Entity spawnedMount;
 
-				if (data.get(next) != null)
-				{
-					changeMobData(mMob.getType(), spawnedMount, data.get(next), target);
-				}
+        for (int i = 0; i < parts.size(); i++) {
+            if (i == 0) {
+                mob = Mob.fromName(parts.get(i));
+                spawnedMob = mob.spawn(sloc.getWorld(), server, sloc);
+                defaultMobData(mob.getType(), spawnedMob);
 
-				spawnedMob.setPassenger(spawnedMount);
+                if (data.get(i) != null) {
+                    changeMobData(sender, mob.getType(), spawnedMob, data.get(i).toLowerCase(Locale.ENGLISH), target);
+                }
+            }
 
-				spawnedMob = spawnedMount;
-			}
-		}
-	}
+            final int next = i + 1;
+            // If it's the last mob in the list, don't set the mount
+            if (next < parts.size()) {
+                final Mob mMob = Mob.fromName(parts.get(next));
+                spawnedMount = mMob.spawn(sloc.getWorld(), server, sloc);
+                defaultMobData(mMob.getType(), spawnedMount);
 
-	private static void checkSpawnable(IEssentials ess, CommandSender sender, Mob mob) throws Exception
-	{
-		if (mob == null)
-		{
-			throw new Exception(_("invalidMob"));
-		}
+                if (data.get(next) != null) {
+                    changeMobData(sender, mMob.getType(), spawnedMount, data.get(next).toLowerCase(Locale.ENGLISH), target);
+                }
 
-		if (ess.getSettings().getProtectPreventSpawn(mob.getType().toString().toLowerCase(Locale.ENGLISH)))
-		{
-			throw new Exception(_("disabledToSpawnMob"));
-		}
+                spawnedMob.setPassenger(spawnedMount);
 
-		if (sender instanceof User && !((User)sender).isAuthorized("essentials.spawnmob." + mob.name.toLowerCase(Locale.ENGLISH)))
-		{
-			throw new Exception(_("noPermToSpawnMob"));
-		}
-	}
+                spawnedMob = spawnedMount;
+            }
+        }
+    }
 
-	private static void changeMobData(final EntityType type, final Entity spawned, String data, final User target) throws Exception
-	{
-		data = data.toLowerCase(Locale.ENGLISH);
+    private static void checkSpawnable(final IEssentials ess, final CommandSource sender, final Mob mob) throws Exception {
+        if (mob == null || mob.getType() == null) {
+            throw new Exception(tl("invalidMob"));
+        }
 
-		if (spawned instanceof Zombie || type == EntityType.SKELETON)
-		{
-			//This should match all Living Entities but most mobs will just ignore the equipment.
-			if (data.contains("armor") || data.contains("armour"))
-			{
-				final EntityEquipment invent = ((LivingEntity)spawned).getEquipment();
-				if (data.contains("diamond"))
-				{
-					invent.setBoots(new ItemStack(Material.DIAMOND_BOOTS, 1));
-					invent.setLeggings(new ItemStack(Material.DIAMOND_BOOTS, 1));
-					invent.setChestplate(new ItemStack(Material.DIAMOND_BOOTS, 1));
-					invent.setHelmet(new ItemStack(Material.DIAMOND_BOOTS, 1));
-				}
-				else if (data.contains("gold"))
-				{
-					invent.setBoots(new ItemStack(Material.GOLD_BOOTS, 1));
-					invent.setLeggings(new ItemStack(Material.GOLD_BOOTS, 1));
-					invent.setChestplate(new ItemStack(Material.GOLD_BOOTS, 1));
-					invent.setHelmet(new ItemStack(Material.GOLD_BOOTS, 1));
-				}
-				else if (data.contains("leather"))
-				{
-					invent.setBoots(new ItemStack(Material.LEATHER_BOOTS, 1));
-					invent.setLeggings(new ItemStack(Material.LEATHER_BOOTS, 1));
-					invent.setChestplate(new ItemStack(Material.LEATHER_BOOTS, 1));
-					invent.setHelmet(new ItemStack(Material.LEATHER_BOOTS, 1));
-				}
-				else if (data.contains("no"))
-				{
-					invent.clear();
-				}
-				else
-				{
-					invent.setBoots(new ItemStack(Material.IRON_BOOTS, 1));
-					invent.setLeggings(new ItemStack(Material.IRON_BOOTS, 1));
-					invent.setChestplate(new ItemStack(Material.IRON_BOOTS, 1));
-					invent.setHelmet(new ItemStack(Material.IRON_BOOTS, 1));
-				}
-				invent.setBootsDropChance(0f);
-				invent.setLeggingsDropChance(0f);
-				invent.setChestplateDropChance(0f);
-				invent.setHelmetDropChance(0f);
-			}
+        if (ess.getSettings().getProtectPreventSpawn(mob.getType().toString().toLowerCase(Locale.ENGLISH))) {
+            throw new Exception(tl("disabledToSpawnMob"));
+        }
 
-		}
-		
-		if (spawned instanceof Slime)
-		{
-			try
-			{
-				((Slime)spawned).setSize(Integer.parseInt(data));
-			}
-			catch (Exception e)
-			{
-				throw new Exception(_("slimeMalformedSize"), e);
-			}
-		}
+        if (sender.isPlayer() && !ess.getUser(sender.getPlayer()).isAuthorized("essentials.spawnmob." + mob.name.toLowerCase(Locale.ENGLISH))) {
+            throw new Exception(tl("noPermToSpawnMob"));
+        }
+    }
 
-		if ((spawned instanceof Ageable) && data.contains("baby"))
-		{
-			((Ageable)spawned).setBaby();
-			data = data.replace("baby", "");
-		}
+    private static void changeMobData(final CommandSource sender, final EntityType type, final Entity spawned, final String inputData, final User target) throws Exception {
+        String data = inputData;
 
-		if (spawned instanceof Colorable)
-		{
-			final String color = data.toUpperCase(Locale.ENGLISH);
-			try
-			{
-				if (color.equals("RANDOM"))
-				{
-					final Random rand = new Random();
-					((Colorable)spawned).setColor(DyeColor.values()[rand.nextInt(DyeColor.values().length)]);
-				}
-				else if (color.length() > 1)
-				{
-					((Colorable)spawned).setColor(DyeColor.valueOf(color));
-				}
-			}
-			catch (Exception e)
-			{
-				throw new Exception(_("sheepMalformedColor"), e);
-			}
-		}
+        if (data.isEmpty()) {
+            sender.sendMessage(tl("mobDataList", StringUtil.joinList(MobData.getValidHelp(spawned))));
+        }
 
-		if (spawned instanceof Tameable && data.contains("tamed") && target != null)
-		{
-			final Tameable tameable = ((Tameable)spawned);
-			tameable.setTamed(true);
-			tameable.setOwner(target.getBase());
-			data = data.replace("tamed", "");
-		}
+        if (spawned instanceof Zombie) {
+            ((Zombie) spawned).setBaby(false);
+        } else if (spawned instanceof Ageable) {
+            ((Ageable) spawned).setAdult();
+        }
 
-		if (type == EntityType.WOLF)
-		{
-			if (data.contains("angry"))
-			{
-				((Wolf)spawned).setAngry(true);
-			}
-		}
+        if (spawned instanceof Zombie || type == EntityType.SKELETON) {
+            if (inputData.contains("armor") || inputData.contains("armour")) {
+                final EntityEquipment invent = ((LivingEntity) spawned).getEquipment();
+                if (inputData.contains("noarmor") || inputData.contains("noarmour")) {
+                    invent.clear();
+                } else if (inputData.contains("diamond")) {
+                    invent.setBoots(new ItemStack(Material.DIAMOND_BOOTS, 1));
+                    invent.setLeggings(new ItemStack(Material.DIAMOND_LEGGINGS, 1));
+                    invent.setChestplate(new ItemStack(Material.DIAMOND_CHESTPLATE, 1));
+                    invent.setHelmet(new ItemStack(Material.DIAMOND_HELMET, 1));
+                } else if (inputData.contains("gold")) {
+                    invent.setBoots(new ItemStack(GOLDEN_BOOTS, 1));
+                    invent.setLeggings(new ItemStack(GOLDEN_LEGGINGS, 1));
+                    invent.setChestplate(new ItemStack(GOLDEN_CHESTPLATE, 1));
+                    invent.setHelmet(new ItemStack(GOLDEN_HELMET, 1));
+                } else if (inputData.contains("leather")) {
+                    invent.setBoots(new ItemStack(Material.LEATHER_BOOTS, 1));
+                    invent.setLeggings(new ItemStack(Material.LEATHER_LEGGINGS, 1));
+                    invent.setChestplate(new ItemStack(Material.LEATHER_CHESTPLATE, 1));
+                    invent.setHelmet(new ItemStack(Material.LEATHER_HELMET, 1));
+                } else if (inputData.contains("iron")) {
+                    invent.setBoots(new ItemStack(Material.IRON_BOOTS, 1));
+                    invent.setLeggings(new ItemStack(Material.IRON_LEGGINGS, 1));
+                    invent.setChestplate(new ItemStack(Material.IRON_CHESTPLATE, 1));
+                    invent.setHelmet(new ItemStack(Material.IRON_HELMET, 1));
+                }
+                invent.setBootsDropChance(0f);
+                invent.setLeggingsDropChance(0f);
+                invent.setChestplateDropChance(0f);
+                invent.setHelmetDropChance(0f);
+            }
 
-		if (type == EntityType.CREEPER && data.contains("powered"))
-		{
-			((Creeper)spawned).setPowered(true);
-		}
+        }
 
-		if (type == EntityType.OCELOT)
-		{
-			if (data.contains("siamese") || data.contains("white"))
-			{
-				((Ocelot)spawned).setCatType(Ocelot.Type.SIAMESE_CAT);
-			}
-			else if (data.contains("red") || data.contains("orange") || data.contains("tabby"))
-			{
-				((Ocelot)spawned).setCatType(Ocelot.Type.RED_CAT);
-			}
-			else if (data.contains("black") || data.contains("tuxedo"))
-			{
-				((Ocelot)spawned).setCatType(Ocelot.Type.BLACK_CAT);
-			}
-		}
+        MobData newData = MobData.fromData(spawned, data);
+        while (newData != null) {
+            newData.setData(spawned, target.getBase(), data);
+            data = data.replace(newData.getMatched(), "");
+            newData = MobData.fromData(spawned, data);
+        }
+    }
 
-		if (type == EntityType.VILLAGER)
-		{
-			for (Villager.Profession prof : Villager.Profession.values())
-			{
-				if (data.contains(prof.toString().toLowerCase(Locale.ENGLISH)))
-				{
-					((Villager)spawned).setProfession(prof);
-				}
-			}
-		}
+    private static void defaultMobData(final EntityType type, final Entity spawned) {
+        if (type == EntityType.SKELETON) {
+            final EntityEquipment invent = ((LivingEntity) spawned).getEquipment();
+            InventoryWorkaround.setItemInMainHand(invent, new ItemStack(Material.BOW, 1));
+            InventoryWorkaround.setItemInMainHandDropChance(invent, 0.1f);
+        }
 
-		if (spawned instanceof Zombie)
-		{
-			if (data.contains("villager"))
-			{
-				((Zombie)spawned).setVillager(true);
-			}
-			if (data.contains("baby"))
-			{
-				((Zombie)spawned).setBaby(true);
-			}
-		}
-		
-		if (spawned instanceof Zombie || type == EntityType.SKELETON)
-		{
-			if (data.contains("sword"))
-			{
-				final EntityEquipment invent = ((LivingEntity)spawned).getEquipment();
-				if (data.contains("diamond"))
-				{
-					invent.setItemInHand(new ItemStack(Material.DIAMOND_SWORD, 1));
-				}
-				else if (data.contains("gold"))
-				{
-					invent.setItemInHand(new ItemStack(Material.GOLD_SWORD, 1));
-				}
-				else if (data.contains("iron"))
-				{
-					invent.setItemInHand(new ItemStack(Material.IRON_SWORD, 1));
-				}
-				else
-				{
-					invent.setItemInHand(new ItemStack(Material.STONE_SWORD, 1));
-				}
-				invent.setItemInHandDropChance(0.1f);
-			}
-		}
+        if (type == MobCompat.ZOMBIFIED_PIGLIN) {
+            final PigZombie zombie = (PigZombie) spawned;
+            setVillager(zombie, false);
 
-		if (type == EntityType.SKELETON)
-		{
-			if (data.contains("wither"))
-			{
-				((Skeleton)spawned).setSkeletonType(SkeletonType.WITHER);
-			}
-		}
+            final EntityEquipment invent = zombie.getEquipment();
+            InventoryWorkaround.setItemInMainHand(invent, new ItemStack(GOLDEN_SWORD, 1));
+            InventoryWorkaround.setItemInMainHandDropChance(invent, 0.1f);
+        }
 
-		if (type == EntityType.EXPERIENCE_ORB)
-		{
-			if (NumberUtil.isInt(data))
-			{
-				((ExperienceOrb)spawned).setExperience(Integer.parseInt(data));
+        if (type == EntityType.ZOMBIE) {
+            final Zombie zombie = (Zombie) spawned;
+            setVillager(zombie, false);
+        }
 
-			}
-		}
-	}
+        if (type == EntityType.HORSE) {
+            ((Horse) spawned).setJumpStrength(1.2);
+        }
+    }
 
-	private static void defaultMobData(final EntityType type, final Entity spawned)
-	{
-		if (type == EntityType.SKELETON)
-		{
-			final EntityEquipment invent = ((LivingEntity)spawned).getEquipment();
-			invent.setItemInHand(new ItemStack(Material.BOW, 1));
-			invent.setItemInHandDropChance(0.1f);
-
-			invent.setBoots(new ItemStack(Material.GOLD_BOOTS, 1));
-			invent.setBootsDropChance(0.0f);
-		}
-
-		if (type == EntityType.PIG_ZOMBIE)
-		{
-			final EntityEquipment invent = ((LivingEntity)spawned).getEquipment();
-			invent.setItemInHand(new ItemStack(Material.GOLD_SWORD, 1));
-			invent.setItemInHandDropChance(0.1f);
-
-			invent.setBoots(new ItemStack(Material.GOLD_BOOTS, 1));
-			invent.setBootsDropChance(0.0f);
-		}
-
-		if (type == EntityType.ZOMBIE)
-		{
-			final EntityEquipment invent = ((LivingEntity)spawned).getEquipment();
-			invent.setBoots(new ItemStack(Material.GOLD_BOOTS, 1));
-			invent.setBootsDropChance(0.0f);
-		}
-
-	}
+    @SuppressWarnings("deprecation")
+    private static void setVillager(final Zombie zombie, final boolean villager) {
+        try {
+            zombie.setVillager(villager);
+        } catch (final Exception ignored) {
+        }
+    }
 }

Essentials/src/com/earth2me/essentials/TNTExplodeListener.java

@@ -1,61 +1,51 @@
 package com.earth2me.essentials;
 
+import net.ess3.api.IEssentials;
 import org.bukkit.entity.LivingEntity;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.EventPriority;
 import org.bukkit.event.Listener;
 import org.bukkit.event.entity.EntityExplodeEvent;
 
+public class TNTExplodeListener implements Listener, Runnable {
+    private final transient IEssentials ess;
+    private transient boolean enabled = false;
+    private transient int timer = -1;
 
-public class TNTExplodeListener implements Listener, Runnable
-{
-	private final transient IEssentials ess;
-	private transient boolean enabled = false;
-	private transient int timer = -1;
+    public TNTExplodeListener(final IEssentials ess) {
+        super();
+        this.ess = ess;
+    }
 
-	public TNTExplodeListener(final IEssentials ess)
-	{
-		super();
-		this.ess = ess;
-	}
+    public void enable() {
+        if (!enabled) {
+            enabled = true;
+            timer = ess.scheduleSyncDelayedTask(this, 200);
+            return;
+        }
+        if (timer != -1) {
+            ess.getScheduler().cancelTask(timer);
+            timer = ess.scheduleSyncDelayedTask(this, 200);
+        }
+    }
 
-	public void enable()
-	{
-		if (!enabled)
-		{
-			enabled = true;
-			timer = ess.scheduleSyncDelayedTask(this, 200);
-			return;
-		}
-		if (timer != -1)
-		{
-			ess.getScheduler().cancelTask(timer);
-			timer = ess.scheduleSyncDelayedTask(this, 200);
-		}
-	}
+    @EventHandler(priority = EventPriority.LOW)
+    public void onEntityExplode(final EntityExplodeEvent event) {
+        if (!enabled) {
+            return;
+        }
+        if (event.getEntity() instanceof LivingEntity) {
+            return;
+        }
+        if (event.blockList().size() < 1) {
+            return;
+        }
+        event.setCancelled(true);
+        event.getLocation().getWorld().createExplosion(event.getLocation(), 0F);
+    }
 
-	@EventHandler(priority = EventPriority.LOW)
-	public void onEntityExplode(final EntityExplodeEvent event)
-	{
-		if (!enabled)
-		{
-			return;
-		}
-		if (event.getEntity() instanceof LivingEntity)
-		{
-			return;
-		}
-		if (event.blockList().size() < 1)
-		{
-			return;
-		}
-		event.setCancelled(true);
-		event.getLocation().getWorld().createExplosion(event.getLocation(), 0F);
-	}
-
-	@Override
-	public void run()
-	{
-		enabled = false;
-	}
+    @Override
+    public void run() {
+        enabled = false;
+    }
 }

Essentials/src/com/earth2me/essentials/Teleport.java

@@ -1,257 +1,403 @@
 package com.earth2me.essentials;
 
-import static com.earth2me.essentials.I18n._;
-import com.earth2me.essentials.api.ITeleport;
 import com.earth2me.essentials.utils.DateUtil;
 import com.earth2me.essentials.utils.LocationUtil;
-import java.util.Calendar;
-import java.util.GregorianCalendar;
+import io.papermc.lib.PaperLib;
+import net.ess3.api.IEssentials;
+import net.ess3.api.ITeleport;
+import net.ess3.api.IUser;
+import net.ess3.api.events.UserWarpEvent;
+import net.ess3.api.events.teleport.PreTeleportEvent;
+import net.ess3.api.events.teleport.TeleportWarmupEvent;
+import org.bukkit.Bukkit;
 import org.bukkit.Location;
 import org.bukkit.entity.Player;
 import org.bukkit.event.player.PlayerRespawnEvent;
 import org.bukkit.event.player.PlayerTeleportEvent.TeleportCause;
 
+import java.math.BigDecimal;
+import java.util.Calendar;
+import java.util.GregorianCalendar;
 
-public class Teleport implements ITeleport
-{	
-	private final IUser teleportOwner;
-	private final IEssentials ess;
-	private TimedTeleport timedTeleport;
+import static com.earth2me.essentials.I18n.tl;
 
-	public Teleport(IUser user, IEssentials ess)
-	{
-		this.teleportOwner = user;
-		this.ess = ess;
-	}
+/**
+ * @deprecated This API is not asynchronous. Use {@link com.earth2me.essentials.AsyncTeleport AsyncTeleport}
+ */
+@Deprecated
+public class Teleport implements ITeleport {
+    private final IUser teleportOwner;
+    private final IEssentials ess;
+    private TimedTeleport timedTeleport;
 
-	public void cooldown(boolean check) throws Exception
-	{
-		final Calendar time = new GregorianCalendar();
-		if (teleportOwner.getLastTeleportTimestamp() > 0)
-		{
-			// Take the current time, and remove the delay from it.
-			final double cooldown = ess.getSettings().getTeleportCooldown();
-			final Calendar earliestTime = new GregorianCalendar();
-			earliestTime.add(Calendar.SECOND, -(int)cooldown);
-			earliestTime.add(Calendar.MILLISECOND, -(int)((cooldown * 1000.0) % 1000.0));
-			// This value contains the most recent time a teleportPlayer could have been used that would allow another use.
-			final long earliestLong = earliestTime.getTimeInMillis();
+    private TeleportType tpType;
 
-			// When was the last teleportPlayer used?
-			final Long lastTime = teleportOwner.getLastTeleportTimestamp();
+    @Deprecated
+    public Teleport(final IUser user, final IEssentials ess) {
+        this.teleportOwner = user;
+        this.ess = ess;
+        tpType = TeleportType.NORMAL;
+    }
 
-			if (lastTime > time.getTimeInMillis())
-			{
-				// This is to make sure time didn't get messed up on last teleportPlayer use.
-				// If this happens, let's give the user the benifit of the doubt.
-				teleportOwner.setLastTeleportTimestamp(time.getTimeInMillis());
-				return;
-			}
-			else if (lastTime > earliestLong && !teleportOwner.isAuthorized("essentials.teleport.cooldown.bypass"))
-			{
-				time.setTimeInMillis(lastTime);
-				time.add(Calendar.SECOND, (int)cooldown);
-				time.add(Calendar.MILLISECOND, (int)((cooldown * 1000.0) % 1000.0));
-				throw new Exception(_("timeBeforeTeleport", DateUtil.formatDateDiff(time.getTimeInMillis())));
-			}
-		}
-		// if justCheck is set, don't update lastTeleport; we're just checking
-		if (!check)
-		{
-			teleportOwner.setLastTeleportTimestamp(time.getTimeInMillis());
-		}
-	}
+    @Deprecated
+    public void cooldown(final boolean check) throws Exception {
+        final Calendar time = new GregorianCalendar();
+        if (teleportOwner.getLastTeleportTimestamp() > 0) {
+            // Take the current time, and remove the delay from it.
+            final double cooldown = ess.getSettings().getTeleportCooldown();
+            final Calendar earliestTime = new GregorianCalendar();
+            earliestTime.add(Calendar.SECOND, -(int) cooldown);
+            earliestTime.add(Calendar.MILLISECOND, -(int) ((cooldown * 1000.0) % 1000.0));
+            // This value contains the most recent time a teleportPlayer could have been used that would allow another use.
+            final long earliestLong = earliestTime.getTimeInMillis();
 
-	private void warnUser(final IUser user, final double delay)
-	{
-		Calendar c = new GregorianCalendar();
-		c.add(Calendar.SECOND, (int)delay);
-		c.add(Calendar.MILLISECOND, (int)((delay * 1000.0) % 1000.0));
-		user.sendMessage(_("dontMoveMessage", DateUtil.formatDateDiff(c.getTimeInMillis())));
-	}
+            // When was the last teleportPlayer used?
+            final long lastTime = teleportOwner.getLastTeleportTimestamp();
 
-	//The now function is used when you want to skip tp delay when teleporting someone to a location or player.
-	@Override
-	public void now(Location loc, boolean cooldown, TeleportCause cause) throws Exception
-	{
-		if (cooldown)
-		{
-			cooldown(false);
-		}
-		now(teleportOwner, new LocationTarget(loc), cause);
-	}
+            if (lastTime > time.getTimeInMillis()) {
+                // This is to make sure time didn't get messed up on last teleportPlayer use.
+                // If this happens, let's give the user the benifit of the doubt.
+                teleportOwner.setLastTeleportTimestamp(time.getTimeInMillis());
+                return;
+            } else if (lastTime > earliestLong
+                && cooldownApplies()) {
+                time.setTimeInMillis(lastTime);
+                time.add(Calendar.SECOND, (int) cooldown);
+                time.add(Calendar.MILLISECOND, (int) ((cooldown * 1000.0) % 1000.0));
+                throw new Exception(tl("timeBeforeTeleport", DateUtil.formatDateDiff(time.getTimeInMillis())));
+            }
+        }
+        // if justCheck is set, don't update lastTeleport; we're just checking
+        if (!check) {
+            teleportOwner.setLastTeleportTimestamp(time.getTimeInMillis());
+        }
+    }
 
-	@Override
-	public void now(Player entity, boolean cooldown, TeleportCause cause) throws Exception
-	{
-		if (cooldown)
-		{
-			cooldown(false);
-		}
-		now(teleportOwner, new PlayerTarget(entity), cause);
-	}
+    @Deprecated
+    private boolean cooldownApplies() {
+        boolean applies = true;
+        final String globalBypassPerm = "essentials.teleport.cooldown.bypass";
+        switch (tpType) {
+            case NORMAL:
+                applies = !teleportOwner.isAuthorized(globalBypassPerm);
+                break;
+            case BACK:
+                applies = !(teleportOwner.isAuthorized(globalBypassPerm) &&
+                    teleportOwner.isAuthorized("essentials.teleport.cooldown.bypass.back"));
+                break;
+            case TPA:
+                applies = !(teleportOwner.isAuthorized(globalBypassPerm) &&
+                    teleportOwner.isAuthorized("essentials.teleport.cooldown.bypass.tpa"));
+                break;
+        }
+        return applies;
+    }
 
-	protected void now(IUser teleportee, ITarget target, TeleportCause cause) throws Exception
-	{
-		cancel(false);
-		teleportee.setLastLocation();
-		teleportee.getBase().teleport(LocationUtil.getSafeDestination(target.getLocation()), cause);
-	}
+    @Deprecated
+    private void warnUser(final IUser user, final double delay) {
+        final Calendar c = new GregorianCalendar();
+        c.add(Calendar.SECOND, (int) delay);
+        c.add(Calendar.MILLISECOND, (int) ((delay * 1000.0) % 1000.0));
+        user.sendMessage(tl("dontMoveMessage", DateUtil.formatDateDiff(c.getTimeInMillis())));
+    }
 
-	//The teleportPlayer function is used when you want to normally teleportPlayer someone to a location or player.
-	//This method is nolonger used internally and will be removed.
-	@Deprecated
-	public void teleport(Location loc, Trade chargeFor) throws Exception
-	{
-		teleport(loc, chargeFor, TeleportCause.PLUGIN);
-	}
+    //The now function is used when you want to skip tp delay when teleporting someone to a location or player.
+    @Override
+    @Deprecated
+    public void now(final Location loc, final boolean cooldown, final TeleportCause cause) throws Exception {
+        if (cooldown) {
+            cooldown(false);
+        }
+        final ITarget target = new LocationTarget(loc);
+        now(teleportOwner, target, cause);
+    }
 
-	@Override
-	public void teleport(Location loc, Trade chargeFor, TeleportCause cause) throws Exception
-	{
-		teleport(teleportOwner, new LocationTarget(loc), chargeFor, cause);
-	}
+    @Override
+    @Deprecated
+    public void now(final Player entity, final boolean cooldown, final TeleportCause cause) throws Exception {
+        if (cooldown) {
+            cooldown(false);
+        }
+        final ITarget target = new PlayerTarget(entity);
+        now(teleportOwner, target, cause);
+        teleportOwner.sendMessage(tl("teleporting", target.getLocation().getWorld().getName(), target.getLocation().getBlockX(), target.getLocation().getBlockY(), target.getLocation().getBlockZ()));
+    }
 
-	@Override
-	public void teleport(Player entity, Trade chargeFor, TeleportCause cause) throws Exception
-	{
-		teleport(teleportOwner, new PlayerTarget(entity), chargeFor, cause);
-	}
+    @Deprecated
+    protected void now(final IUser teleportee, final ITarget target, final TeleportCause cause) throws Exception {
+        cancel(false);
+        Location loc = target.getLocation();
 
-	@Override
-	public void teleportPlayer(IUser teleportee, Location loc, Trade chargeFor, TeleportCause cause) throws Exception
-	{
-		teleport(teleportee, new LocationTarget(loc), chargeFor, cause);
-	}
+        final PreTeleportEvent event = new PreTeleportEvent(teleportee, cause, target);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
 
-	@Override
-	public void teleportPlayer(IUser teleportee, Player entity, Trade chargeFor, TeleportCause cause) throws Exception
-	{
-		teleport(teleportee, new PlayerTarget(entity), chargeFor, cause);
-	}
+        if (teleportee.isAuthorized("essentials.back.onteleport")) {
+            teleportee.setLastLocation();
+        }
 
-	private void teleport(IUser teleportee, ITarget target, Trade chargeFor, TeleportCause cause) throws Exception
-	{
-		double delay = ess.getSettings().getTeleportDelay();
+        if (!teleportee.getBase().isEmpty()) {
+            if (!ess.getSettings().isTeleportPassengerDismount()) {
+                throw new Exception(tl("passengerTeleportFail"));
+            }
+            teleportee.getBase().eject();
+        }
 
-		if (chargeFor != null)
-		{
-			chargeFor.isAffordableFor(teleportOwner);
-		}
-		cooldown(true);
-		if (delay <= 0 || teleportOwner.isAuthorized("essentials.teleport.timer.bypass")
-			|| teleportee.isAuthorized("essentials.teleport.timer.bypass"))
-		{
-			cooldown(false);
-			now(teleportee, target, cause);
-			if (chargeFor != null)
-			{
-				chargeFor.charge(teleportOwner);
-			}
-			return;
-		}
+        if (LocationUtil.isBlockUnsafeForUser(teleportee, loc.getWorld(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ())) {
+            if (ess.getSettings().isTeleportSafetyEnabled()) {
+                if (ess.getSettings().isForceDisableTeleportSafety()) {
+                    PaperLib.teleportAsync(teleportee.getBase(), loc, cause);
+                } else {
+                    PaperLib.teleportAsync(teleportee.getBase(), LocationUtil.getSafeDestination(ess, teleportee, loc), cause);
+                }
+            } else {
+                throw new Exception(tl("unsafeTeleportDestination", loc.getWorld().getName(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ()));
+            }
+        } else {
+            if (ess.getSettings().isForceDisableTeleportSafety()) {
+                PaperLib.teleportAsync(teleportee.getBase(), loc, cause);
+            } else {
+                if (ess.getSettings().isTeleportToCenterLocation()) {
+                    loc = LocationUtil.getRoundedDestination(loc);
+                }
+                PaperLib.teleportAsync(teleportee.getBase(), loc, cause);
+            }
+        }
+    }
 
-		cancel(false);
-		warnUser(teleportee, delay);
-		initTimer((long)(delay * 1000.0), teleportee, target, chargeFor, cause, false);
-	}
+    //The teleportPlayer function is used when you want to normally teleportPlayer someone to a location or player.
+    //This method is nolonger used internally and will be removed.
+    @Deprecated
+    @Override
+    public void teleport(final Location loc, final Trade chargeFor) throws Exception {
+        teleport(loc, chargeFor, TeleportCause.PLUGIN);
+    }
 
-	//The teleportToMe function is a wrapper used to handle teleporting players to them, like /tphere
-	@Override
-	public void teleportToMe(IUser otherUser, Trade chargeFor, TeleportCause cause) throws Exception
-	{
-		ITarget target = new PlayerTarget(teleportOwner);
-		teleport(otherUser, target, chargeFor, cause);
-	}
+    @Override
+    @Deprecated
+    public void teleport(final Location loc, final Trade chargeFor, final TeleportCause cause) throws Exception {
+        teleport(teleportOwner, new LocationTarget(loc), chargeFor, cause);
+    }
 
-	//The respawn function is a wrapper used to handle tp fallback, on /jail and /home
-	@Override
-	public void respawn(final Trade chargeFor, TeleportCause cause) throws Exception
-	{
-		double delay = ess.getSettings().getTeleportDelay();
-		if (chargeFor != null)
-		{
-			chargeFor.isAffordableFor(teleportOwner);
-		}
-		cooldown(true);
-		if (delay <= 0 || teleportOwner.isAuthorized("essentials.teleport.timer.bypass"))
-		{
-			cooldown(false);
-			respawnNow(teleportOwner, cause);
-			if (chargeFor != null)
-			{
-				chargeFor.charge(teleportOwner);
-			}
-			return;
-		}
+    //This is used when teleporting to a player
+    @Override
+    @Deprecated
+    public void teleport(final Player entity, final Trade chargeFor, final TeleportCause cause) throws Exception {
+        final ITarget target = new PlayerTarget(entity);
+        teleportOwner.sendMessage(tl("teleportToPlayer", entity.getDisplayName()));
+        teleport(teleportOwner, target, chargeFor, cause);
+    }
 
-		cancel(false);
-		warnUser(teleportOwner, delay);
-		initTimer((long)(delay * 1000.0), teleportOwner, null, chargeFor, cause, true);
-	}
+    //This is used when teleporting to stored location
+    @Override
+    @Deprecated
+    public void teleportPlayer(final IUser teleportee, final Location loc, final Trade chargeFor, final TeleportCause cause) throws Exception {
+        teleport(teleportee, new LocationTarget(loc), chargeFor, cause);
+    }
 
-	protected void respawnNow(IUser teleportee, TeleportCause cause) throws Exception
-	{
-		final Player player = teleportee.getBase();
-		Location bed = player.getBedSpawnLocation();
-		if (bed != null)
-		{
-			now(teleportee, new LocationTarget(bed), cause);
-		}
-		else
-		{
-			if (ess.getSettings().isDebug())
-			{
-				ess.getLogger().info("Could not find bed spawn, forcing respawn event.");
-			}
-			final PlayerRespawnEvent pre = new PlayerRespawnEvent(player, player.getWorld().getSpawnLocation(), false);
-			ess.getServer().getPluginManager().callEvent(pre);
-			now(teleportee, new LocationTarget(pre.getRespawnLocation()), cause);
-		}
-	}
+    //This is used on /tphere
+    @Override
+    @Deprecated
+    public void teleportPlayer(final IUser teleportee, final Player entity, final Trade chargeFor, final TeleportCause cause) throws Exception {
+        final ITarget target = new PlayerTarget(entity);
+        teleport(teleportee, target, chargeFor, cause);
+        teleportee.sendMessage(tl("teleporting", target.getLocation().getWorld().getName(), target.getLocation().getBlockX(), target.getLocation().getBlockY(), target.getLocation().getBlockZ()));
+        teleportOwner.sendMessage(tl("teleporting", target.getLocation().getWorld().getName(), target.getLocation().getBlockX(), target.getLocation().getBlockY(), target.getLocation().getBlockZ()));
+    }
 
-	//The warp function is a wrapper used to teleportPlayer a player to a /warp
-	@Override
-	public void warp(IUser teleportee, String warp, Trade chargeFor, TeleportCause cause) throws Exception
-	{
-		Location loc = ess.getWarps().getWarp(warp);
-		teleportee.sendMessage(_("warpingTo", warp));
-		teleport(teleportee, new LocationTarget(loc), chargeFor, cause);
-	}
+    @Deprecated
+    private void teleport(final IUser teleportee, final ITarget target, final Trade chargeFor, final TeleportCause cause) throws Exception {
+        double delay = ess.getSettings().getTeleportDelay();
 
-	//The back function is a wrapper used to teleportPlayer a player /back to their previous location.
-	@Override
-	public void back(Trade chargeFor) throws Exception
-	{
-		teleport(teleportOwner, new LocationTarget(teleportOwner.getLastLocation()), chargeFor, TeleportCause.COMMAND);
-	}
+        final TeleportWarmupEvent event = new TeleportWarmupEvent(teleportee, cause, target, delay);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
+        delay = event.getDelay();
 
-	//This function is used to throw a user back after a jail sentence
-	@Override
-	public void back() throws Exception
-	{
-		now(teleportOwner, new LocationTarget(teleportOwner.getLastLocation()), TeleportCause.COMMAND);
-	}
+        Trade cashCharge = chargeFor;
 
-	//This function handles teleporting to /home
-	@Override
-	public void home(Location loc, Trade chargeFor) throws Exception
-	{
-		teleport(teleportOwner, new LocationTarget(loc), chargeFor, TeleportCause.COMMAND);
-	}
+        if (chargeFor != null) {
+            chargeFor.isAffordableFor(teleportOwner);
 
-	//If we need to cancelTimer a pending teleportPlayer call this method
-	private void cancel(boolean notifyUser)
-	{
-		if (timedTeleport != null)
-		{
-			timedTeleport.cancelTimer(notifyUser);
-			timedTeleport = null;
-		}
-	}
+            //This code is to make sure that commandcosts are checked in the initial world, and not in the resulting world.
+            if (!chargeFor.getCommandCost(teleportOwner).equals(BigDecimal.ZERO)) {
+                //By converting a command cost to a regular cost, the command cost permission isn't checked when executing the charge after teleport.
+                cashCharge = new Trade(chargeFor.getCommandCost(teleportOwner), ess);
+            }
+        }
 
-	private void initTimer(long delay, IUser teleportUser, ITarget target, Trade chargeFor, TeleportCause cause, boolean respawn)
-	{
-		timedTeleport = new TimedTeleport(teleportOwner, ess, this, delay, teleportUser, target, chargeFor, cause, respawn);
-	}
+        cooldown(true);
+        if (delay <= 0 || teleportOwner.isAuthorized("essentials.teleport.timer.bypass") || teleportee.isAuthorized("essentials.teleport.timer.bypass")) {
+            cooldown(false);
+            now(teleportee, target, cause);
+            if (cashCharge != null) {
+                cashCharge.charge(teleportOwner);
+            }
+            return;
+        }
+
+        cancel(false);
+        warnUser(teleportee, delay);
+        initTimer((long) (delay * 1000.0), teleportee, target, cashCharge, cause, false);
+    }
+
+    @Deprecated
+    private void teleportOther(final IUser teleporter, final IUser teleportee, final ITarget target, final Trade chargeFor, final TeleportCause cause) throws Exception {
+        double delay = ess.getSettings().getTeleportDelay();
+
+        final TeleportWarmupEvent event = new TeleportWarmupEvent(teleporter, teleportee, cause, target, delay);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
+        delay = event.getDelay();
+
+        Trade cashCharge = chargeFor;
+
+        if (teleporter != null && chargeFor != null) {
+            chargeFor.isAffordableFor(teleporter);
+
+            //This code is to make sure that commandcosts are checked in the initial world, and not in the resulting world.
+            if (!chargeFor.getCommandCost(teleporter).equals(BigDecimal.ZERO)) {
+                //By converting a command cost to a regular cost, the command cost permission isn't checked when executing the charge after teleport.
+                cashCharge = new Trade(chargeFor.getCommandCost(teleporter), ess);
+            }
+        }
+
+        cooldown(true);
+        if (delay <= 0 || teleporter == null
+            || teleporter.isAuthorized("essentials.teleport.timer.bypass")
+            || teleportOwner.isAuthorized("essentials.teleport.timer.bypass")
+            || teleportee.isAuthorized("essentials.teleport.timer.bypass")) {
+            cooldown(false);
+            now(teleportee, target, cause);
+            if (teleporter != null && cashCharge != null) {
+                cashCharge.charge(teleporter);
+            }
+            return;
+        }
+
+        cancel(false);
+        warnUser(teleportee, delay);
+        initTimer((long) (delay * 1000.0), teleportee, target, cashCharge, cause, false);
+    }
+
+    //The respawn function is a wrapper used to handle tp fallback, on /jail and /home
+    @Override
+    @Deprecated
+    public void respawn(final Trade chargeFor, final TeleportCause cause) throws Exception {
+        double delay = ess.getSettings().getTeleportDelay();
+
+        final TeleportWarmupEvent event = new TeleportWarmupEvent(teleportOwner, cause, null, delay);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
+        delay = event.getDelay();
+
+        if (chargeFor != null) {
+            chargeFor.isAffordableFor(teleportOwner);
+        }
+        cooldown(true);
+        if (delay <= 0 || teleportOwner.isAuthorized("essentials.teleport.timer.bypass")) {
+            cooldown(false);
+            respawnNow(teleportOwner, cause);
+            if (chargeFor != null) {
+                chargeFor.charge(teleportOwner);
+            }
+            return;
+        }
+
+        cancel(false);
+        warnUser(teleportOwner, delay);
+        initTimer((long) (delay * 1000.0), teleportOwner, null, chargeFor, cause, true);
+    }
+
+    @Deprecated
+    void respawnNow(final IUser teleportee, final TeleportCause cause) throws Exception {
+        final Player player = teleportee.getBase();
+        final Location bed = player.getBedSpawnLocation();
+        if (bed != null) {
+            now(teleportee, new LocationTarget(bed), cause);
+        } else {
+            if (ess.getSettings().isDebug()) {
+                ess.getLogger().info("Could not find bed spawn, forcing respawn event.");
+            }
+            final PlayerRespawnEvent pre = new PlayerRespawnEvent(player, player.getWorld().getSpawnLocation(), false);
+            ess.getServer().getPluginManager().callEvent(pre);
+            now(teleportee, new LocationTarget(pre.getRespawnLocation()), cause);
+        }
+    }
+
+    //The warp function is a wrapper used to teleportPlayer a player to a /warp
+    @Override
+    @Deprecated
+    public void warp(final IUser teleportee, String warp, final Trade chargeFor, final TeleportCause cause) throws Exception {
+        final UserWarpEvent event = new UserWarpEvent(teleportee, warp, chargeFor);
+        Bukkit.getServer().getPluginManager().callEvent(event);
+        if (event.isCancelled()) {
+            return;
+        }
+
+        warp = event.getWarp();
+        final Location loc = ess.getWarps().getWarp(warp);
+        teleportee.sendMessage(tl("warpingTo", warp, loc.getWorld().getName(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ()));
+        if (!teleportee.equals(teleportOwner)) {
+            teleportOwner.sendMessage(tl("warpingTo", warp, loc.getWorld().getName(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ()));
+        }
+        teleport(teleportee, new LocationTarget(loc), chargeFor, cause);
+    }
+
+    //The back function is a wrapper used to teleportPlayer a player /back to their previous location.
+    @Override
+    @Deprecated
+    public void back(final Trade chargeFor) throws Exception {
+        back(teleportOwner, chargeFor);
+    }
+
+    //This function is a wrapper over the other back function for cases where another player performs back for them
+    @Override
+    @Deprecated
+    public void back(final IUser teleporter, final Trade chargeFor) throws Exception {
+        tpType = TeleportType.BACK;
+        final Location loc = teleportOwner.getLastLocation();
+        teleportOwner.sendMessage(tl("backUsageMsg", loc.getWorld().getName(), loc.getBlockX(), loc.getBlockY(), loc.getBlockZ()));
+        teleportOther(teleporter, teleportOwner, new LocationTarget(loc), chargeFor, TeleportCause.COMMAND);
+    }
+
+    //This function is used to throw a user back after a jail sentence
+    @Override
+    @Deprecated
+    public void back() throws Exception {
+        now(teleportOwner, new LocationTarget(teleportOwner.getLastLocation()), TeleportCause.COMMAND);
+    }
+
+    @Deprecated
+    public void setTpType(final TeleportType tpType) {
+        this.tpType = tpType;
+    }
+
+    //If we need to cancelTimer a pending teleportPlayer call this method
+    @Deprecated
+    private void cancel(final boolean notifyUser) {
+        if (timedTeleport != null) {
+            timedTeleport.cancelTimer(notifyUser);
+            timedTeleport = null;
+        }
+    }
+
+    @Deprecated
+    private void initTimer(final long delay, final IUser teleportUser, final ITarget target, final Trade chargeFor, final TeleportCause cause, final boolean respawn) {
+        timedTeleport = new TimedTeleport(teleportOwner, ess, this, delay, teleportUser, target, chargeFor, cause, respawn);
+    }
+
+    public enum TeleportType {
+        TPA,
+        BACK,
+        NORMAL
+    }
 }

Essentials/src/com/earth2me/essentials/TimedTeleport.java

@@ -1,153 +1,140 @@
 package com.earth2me.essentials;
 
-import static com.earth2me.essentials.I18n._;
+import net.ess3.api.IEssentials;
+import net.ess3.api.IUser;
 import org.bukkit.Location;
 import org.bukkit.event.player.PlayerTeleportEvent.TeleportCause;
 
+import java.util.UUID;
 
-public class TimedTeleport implements Runnable
-{
-	private static final double MOVE_CONSTANT = 0.3;
-	private final IUser teleportOwner;
-	private final IEssentials ess;
-	private final Teleport teleport;
-	private String timer_teleportee;
-	private int timer_task = -1;
-	private long timer_started;	// time this task was initiated
-	private long timer_delay;		// how long to delay the teleportPlayer
-	private int timer_health;
-	// note that I initially stored a clone of the location for reference, but...
-	// when comparing locations, I got incorrect mismatches (rounding errors, looked like)
-	// so, the X/Y/Z values are stored instead and rounded off
-	private long timer_initX;
-	private long timer_initY;
-	private long timer_initZ;
-	private ITarget timer_teleportTarget;
-	private boolean timer_respawn;
-	private boolean timer_canMove;
-	private Trade timer_chargeFor;
-	private TeleportCause timer_cause;
+import static com.earth2me.essentials.I18n.tl;
 
-	public TimedTeleport(IUser user, IEssentials ess, Teleport teleport, long delay, IUser teleportUser, ITarget target, Trade chargeFor, TeleportCause cause, boolean respawn)
-	{
+@Deprecated
+public class TimedTeleport implements Runnable {
+    private static final double MOVE_CONSTANT = 0.3;
+    private final IUser teleportOwner;
+    private final IEssentials ess;
+    private final Teleport teleport;
+    private final UUID timer_teleportee;
+    private final long timer_started; // time this task was initiated
+    private final long timer_delay; // how long to delay the teleportPlayer
+    // note that I initially stored a clone of the location for reference, but...
+    // when comparing locations, I got incorrect mismatches (rounding errors, looked like)
+    // so, the X/Y/Z values are stored instead and rounded off
+    private final long timer_initX;
+    private final long timer_initY;
+    private final long timer_initZ;
+    private final ITarget timer_teleportTarget;
+    private final boolean timer_respawn;
+    private final boolean timer_canMove;
+    private final Trade timer_chargeFor;
+    private final TeleportCause timer_cause;
+    private int timer_task;
+    private double timer_health;
 
-		this.teleportOwner = user;
-		this.ess = ess;
-		this.teleport = teleport;
-		this.timer_started = System.currentTimeMillis();
-		this.timer_delay = delay;
-		this.timer_health = teleportUser.getHealth();
-		this.timer_initX = Math.round(teleportUser.getLocation().getX() * MOVE_CONSTANT);
-		this.timer_initY = Math.round(teleportUser.getLocation().getY() * MOVE_CONSTANT);
-		this.timer_initZ = Math.round(teleportUser.getLocation().getZ() * MOVE_CONSTANT);
-		this.timer_teleportee = teleportUser.getName();
-		this.timer_teleportTarget = target;
-		this.timer_chargeFor = chargeFor;
-		this.timer_cause = cause;
-		this.timer_respawn = respawn;
-		this.timer_canMove = user.isAuthorized("essentials.teleport.timer.move");
+    TimedTeleport(final IUser user, final IEssentials ess, final Teleport teleport, final long delay, final IUser teleportUser, final ITarget target, final Trade chargeFor, final TeleportCause cause, final boolean respawn) {
+        this.teleportOwner = user;
+        this.ess = ess;
+        this.teleport = teleport;
+        this.timer_started = System.currentTimeMillis();
+        this.timer_delay = delay;
+        this.timer_health = teleportUser.getBase().getHealth();
+        this.timer_initX = Math.round(teleportUser.getBase().getLocation().getX() * MOVE_CONSTANT);
+        this.timer_initY = Math.round(teleportUser.getBase().getLocation().getY() * MOVE_CONSTANT);
+        this.timer_initZ = Math.round(teleportUser.getBase().getLocation().getZ() * MOVE_CONSTANT);
+        this.timer_teleportee = teleportUser.getBase().getUniqueId();
+        this.timer_teleportTarget = target;
+        this.timer_chargeFor = chargeFor;
+        this.timer_cause = cause;
+        this.timer_respawn = respawn;
+        this.timer_canMove = user.isAuthorized("essentials.teleport.timer.move");
 
-		timer_task = ess.scheduleSyncRepeatingTask(this, 20, 20);
-	}
+        timer_task = ess.runTaskTimerAsynchronously(this, 20, 20).getTaskId();
+    }
 
-	@Override
-	public void run()
-	{
+    @Override
+    public void run() {
 
-		if (teleportOwner == null || !teleportOwner.isOnline() || teleportOwner.getLocation() == null)
-		{
-			cancelTimer(false);
-			return;
-		}
+        if (teleportOwner == null || !teleportOwner.getBase().isOnline() || teleportOwner.getBase().getLocation() == null) {
+            cancelTimer(false);
+            return;
+        }
 
-		IUser teleportUser = ess.getUser(this.timer_teleportee);
+        final IUser teleportUser = ess.getUser(this.timer_teleportee);
 
-		if (teleportUser == null || !teleportUser.isOnline())
-		{
-			cancelTimer(false);
-			return;
-		}
+        if (teleportUser == null || !teleportUser.getBase().isOnline()) {
+            cancelTimer(false);
+            return;
+        }
 
-		final Location currLocation = teleportUser.getLocation();
-		if (currLocation == null)
-		{
-			cancelTimer(false);
-			return;
-		}
+        final Location currLocation = teleportUser.getBase().getLocation();
+        if (currLocation == null) {
+            cancelTimer(false);
+            return;
+        }
 
-		if (!timer_canMove
-			&& (Math.round(currLocation.getX() * MOVE_CONSTANT) != timer_initX
-				|| Math.round(currLocation.getY() * MOVE_CONSTANT) != timer_initY
-				|| Math.round(currLocation.getZ() * MOVE_CONSTANT) != timer_initZ
-				|| teleportUser.getHealth() < timer_health))
-		{
-			// user moved, cancelTimer teleportPlayer
-			cancelTimer(true);
-			return;
-		}
+        if (!timer_canMove && (Math.round(currLocation.getX() * MOVE_CONSTANT) != timer_initX || Math.round(currLocation.getY() * MOVE_CONSTANT) != timer_initY || Math.round(currLocation.getZ() * MOVE_CONSTANT) != timer_initZ || teleportUser.getBase().getHealth() < timer_health)) {
+            // user moved, cancelTimer teleportPlayer
+            cancelTimer(true);
+            return;
+        }
 
-		timer_health = teleportUser.getHealth();  // in case user healed, then later gets injured
-		final long now = System.currentTimeMillis();
-		if (now > timer_started + timer_delay)
-		{
-			try
-			{
-				teleport.cooldown(false);
-				teleportUser.sendMessage(_("teleportationCommencing"));
-				try
-				{
-					if (timer_respawn)
-					{
-						teleport.respawnNow(teleportUser, timer_cause);
-					}
-					else
-					{
-						teleport.now(teleportUser, timer_teleportTarget, timer_cause);
-					}
-					cancelTimer(false);
-					if (timer_chargeFor != null)
-					{
-						timer_chargeFor.charge(teleportOwner);
-					}
-				}
-				catch (Throwable ex)
-				{
-					ess.showError(teleportOwner.getBase(), ex, "teleport");
-				}
-			}
-			catch (Exception ex)
-			{
-				teleportOwner.sendMessage(_("cooldownWithMessage", ex.getMessage()));
-				if (teleportOwner != teleportUser)
-				{
-					teleportUser.sendMessage(_("cooldownWithMessage", ex.getMessage()));
-				}
-			}
-		}
-	}
+        class DelayedTeleportTask implements Runnable {
+            @Override
+            public void run() {
 
-	//If we need to cancelTimer a pending teleportPlayer call this method
-	public void cancelTimer(boolean notifyUser)
-	{
-		if (timer_task == -1)
-		{
-			return;
-		}
-		try
-		{
-			ess.getServer().getScheduler().cancelTask(timer_task);
-			if (notifyUser)
-			{
-				teleportOwner.sendMessage(_("pendingTeleportCancelled"));
-				if (timer_teleportee != null && !timer_teleportee.equals(teleportOwner.getName()))
-				{
-					ess.getUser(timer_teleportee).sendMessage(_("pendingTeleportCancelled"));
-				}
-			}
-		}
-		finally
-		{
-			timer_task = -1;
-		}
-	}
+                timer_health = teleportUser.getBase().getHealth(); // in case user healed, then later gets injured
+                final long now = System.currentTimeMillis();
+                if (now > timer_started + timer_delay) {
+                    try {
+                        teleport.cooldown(false);
+                    } catch (final Exception ex) {
+                        teleportOwner.sendMessage(tl("cooldownWithMessage", ex.getMessage()));
+                        if (teleportOwner != teleportUser) {
+                            teleportUser.sendMessage(tl("cooldownWithMessage", ex.getMessage()));
+                        }
+                    }
+                    try {
+                        cancelTimer(false);
+                        teleportUser.sendMessage(tl("teleportationCommencing"));
+
+                        if (timer_chargeFor != null) {
+                            timer_chargeFor.isAffordableFor(teleportOwner);
+                        }
+                        if (timer_respawn) {
+                            teleport.respawnNow(teleportUser, timer_cause);
+                        } else {
+                            teleport.now(teleportUser, timer_teleportTarget, timer_cause);
+                        }
+                        if (timer_chargeFor != null) {
+                            timer_chargeFor.charge(teleportOwner);
+                        }
+
+                    } catch (final Exception ex) {
+                        ess.showError(teleportOwner.getSource(), ex, "\\ teleport");
+                    }
+                }
+            }
+        }
+
+        ess.scheduleSyncDelayedTask(new DelayedTeleportTask());
+    }
+
+    //If we need to cancelTimer a pending teleportPlayer call this method
+    void cancelTimer(final boolean notifyUser) {
+        if (timer_task == -1) {
+            return;
+        }
+        try {
+            ess.getServer().getScheduler().cancelTask(timer_task);
+            if (notifyUser) {
+                teleportOwner.sendMessage(tl("pendingTeleportCancelled"));
+                if (timer_teleportee != null && !timer_teleportee.equals(teleportOwner.getBase().getUniqueId())) {
+                    ess.getUser(timer_teleportee).sendMessage(tl("pendingTeleportCancelled"));
+                }
+            }
+        } finally {
+            timer_task = -1;
+        }
+    }
 }

Essentials/src/com/earth2me/essentials/Trade.java

@@ -1,8 +1,15 @@
 package com.earth2me.essentials;
 
-import static com.earth2me.essentials.I18n._;
 import com.earth2me.essentials.craftbukkit.InventoryWorkaround;
 import com.earth2me.essentials.craftbukkit.SetExpFix;
+import com.earth2me.essentials.utils.NumberUtil;
+import net.ess3.api.IEssentials;
+import net.ess3.api.IUser;
+import net.ess3.api.MaxMoneyException;
+import org.bukkit.Location;
+import org.bukkit.entity.Item;
+import org.bukkit.inventory.ItemStack;
+
 import java.io.File;
 import java.io.FileWriter;
 import java.io.IOException;
@@ -11,438 +18,374 @@ import java.text.DateFormat;
 import java.util.Date;
 import java.util.Locale;
 import java.util.Map;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ExecutionException;
 import java.util.logging.Level;
 import java.util.logging.Logger;
-import org.bukkit.Location;
-import org.bukkit.entity.Item;
-import org.bukkit.inventory.ItemStack;
 
+import static com.earth2me.essentials.I18n.tl;
 
-public class Trade
-{
-	private final transient String command;
-	private final transient Trade fallbackTrade;
-	private final transient BigDecimal money;
-	private final transient ItemStack itemStack;
-	private final transient Integer exp;
-	private final transient IEssentials ess;
+public class Trade {
+    private static FileWriter fw = null;
+    private final transient String command;
+    private final transient Trade fallbackTrade;
+    private final transient BigDecimal money;
+    private final transient ItemStack itemStack;
+    private final transient Integer exp;
+    private final transient IEssentials ess;
 
+    public Trade(final String command, final IEssentials ess) {
+        this(command, null, null, null, null, ess);
+    }
 
-	public enum TradeType
-	{
-		MONEY,
-		EXP,
-		ITEM
-	}
+    public Trade(final String command, final Trade fallback, final IEssentials ess) {
+        this(command, fallback, null, null, null, ess);
+    }
 
+    @Deprecated
+    public Trade(final double money, final com.earth2me.essentials.IEssentials ess) {
+        this(null, null, BigDecimal.valueOf(money), null, null, (IEssentials) ess);
+    }
 
-	public enum OverflowType
-	{
-		ABORT,
-		DROP,
-		RETURN
-	}
+    public Trade(final BigDecimal money, final IEssentials ess) {
+        this(null, null, money, null, null, ess);
+    }
 
-	public Trade(final String command, final IEssentials ess)
-	{
-		this(command, null, null, null, null, ess);
-	}
+    public Trade(final ItemStack items, final IEssentials ess) {
+        this(null, null, null, items, null, ess);
+    }
 
-	public Trade(final String command, final Trade fallback, final IEssentials ess)
-	{
-		this(command, fallback, null, null, null, ess);
-	}
+    public Trade(final int exp, final IEssentials ess) {
+        this(null, null, null, null, exp, ess);
+    }
 
-	@Deprecated
-	public Trade(final double money, final IEssentials ess)
-	{
-		this(null, null, BigDecimal.valueOf(money), null, null, ess);
-	}
+    private Trade(final String command, final Trade fallback, final BigDecimal money, final ItemStack item, final Integer exp, final IEssentials ess) {
+        this.command = command;
+        this.fallbackTrade = fallback;
+        this.money = money;
+        this.itemStack = item;
+        this.exp = exp;
+        this.ess = ess;
+    }
 
-	public Trade(final BigDecimal money, final IEssentials ess)
-	{
-		this(null, null, money, null, null, ess);
-	}
+    public static void log(final String type, final String subtype, final String event, final String sender, final Trade charge, final String receiver, final Trade pay, final Location loc, final IEssentials ess) {
+        //isEcoLogUpdateEnabled() - This refers to log entries with no location, ie API updates #EasterEgg
+        //isEcoLogEnabled() - This refers to log entries with with location, ie /pay /sell and eco signs.
 
-	public Trade(final ItemStack items, final IEssentials ess)
-	{
-		this(null, null, null, items, null, ess);
-	}
+        if ((loc == null && !ess.getSettings().isEcoLogUpdateEnabled()) || (loc != null && !ess.getSettings().isEcoLogEnabled())) {
+            return;
+        }
+        if (fw == null) {
+            try {
+                fw = new FileWriter(new File(ess.getDataFolder(), "trade.log"), true);
+            } catch (final IOException ex) {
+                Logger.getLogger("Essentials").log(Level.SEVERE, null, ex);
+            }
+        }
+        final StringBuilder sb = new StringBuilder();
+        sb.append(type).append(",").append(subtype).append(",").append(event).append(",\"");
+        sb.append(DateFormat.getDateTimeInstance(DateFormat.FULL, DateFormat.FULL).format(new Date()));
+        sb.append("\",\"");
+        if (sender != null) {
+            sb.append(sender);
+        }
+        sb.append("\",");
+        if (charge == null) {
+            sb.append("\"\",\"\",\"\"");
+        } else {
+            if (charge.getItemStack() != null) {
+                sb.append(charge.getItemStack().getAmount()).append(",");
+                sb.append(charge.getItemStack().getType().toString()).append(",");
+                sb.append(charge.getItemStack().getDurability());
+            }
+            if (charge.getMoney() != null) {
+                sb.append(charge.getMoney()).append(",");
+                sb.append("money").append(",");
+                sb.append(ess.getSettings().getCurrencySymbol());
+            }
+            if (charge.getExperience() != null) {
+                sb.append(charge.getExperience()).append(",");
+                sb.append("exp").append(",");
+                sb.append("\"\"");
+            }
+        }
+        sb.append(",\"");
+        if (receiver != null) {
+            sb.append(receiver);
+        }
+        sb.append("\",");
+        if (pay == null) {
+            sb.append("\"\",\"\",\"\"");
+        } else {
+            if (pay.getItemStack() != null) {
+                sb.append(pay.getItemStack().getAmount()).append(",");
+                sb.append(pay.getItemStack().getType().toString()).append(",");
+                sb.append(pay.getItemStack().getDurability());
+            }
+            if (pay.getMoney() != null) {
+                sb.append(pay.getMoney()).append(",");
+                sb.append("money").append(",");
+                sb.append(ess.getSettings().getCurrencySymbol());
+            }
+            if (pay.getExperience() != null) {
+                sb.append(pay.getExperience()).append(",");
+                sb.append("exp").append(",");
+                sb.append("\"\"");
+            }
+        }
+        if (loc == null) {
+            sb.append(",\"\",\"\",\"\",\"\"");
+        } else {
+            sb.append(",\"");
+            sb.append(loc.getWorld().getName()).append("\",");
+            sb.append(loc.getBlockX()).append(",");
+            sb.append(loc.getBlockY()).append(",");
+            sb.append(loc.getBlockZ()).append(",");
+        }
+        sb.append("\n");
+        try {
+            fw.write(sb.toString());
+            fw.flush();
+        } catch (final IOException ex) {
+            Logger.getLogger("Essentials").log(Level.SEVERE, null, ex);
+        }
+    }
 
-	public Trade(final int exp, final IEssentials ess)
-	{
-		this(null, null, null, null, exp, ess);
-	}
+    public static void closeLog() {
+        if (fw != null) {
+            try {
+                fw.close();
+            } catch (final IOException ex) {
+                Logger.getLogger("Essentials").log(Level.SEVERE, null, ex);
+            }
+            fw = null;
+        }
+    }
 
-	private Trade(final String command, final Trade fallback, final BigDecimal money, final ItemStack item, final Integer exp, final IEssentials ess)
-	{
-		this.command = command;
-		this.fallbackTrade = fallback;
-		this.money = money;
-		this.itemStack = item;
-		this.exp = exp;
-		this.ess = ess;
-	}
+    public void isAffordableFor(final IUser user) throws ChargeException {
+        final CompletableFuture<Boolean> future = new CompletableFuture<>();
+        isAffordableFor(user, future);
+        if (future.isCompletedExceptionally()) {
+            try {
+                future.get();
+            } catch (final InterruptedException e) { //If this happens, we have bigger problems...
+                e.printStackTrace();
+            } catch (final ExecutionException e) {
+                throw (ChargeException) e.getCause();
+            }
+        }
+    }
 
-	public void isAffordableFor(final IUser user) throws ChargeException
-	{
+    public void isAffordableFor(final IUser user, final CompletableFuture<Boolean> future) {
+        if (ess.getSettings().isDebug()) {
+            ess.getLogger().log(Level.INFO, "checking if " + user.getName() + " can afford charge.");
+        }
 
-		if (ess.getSettings().isDebug())
-		{
-			ess.getLogger().log(Level.INFO, "checking if " + user.getName() + " can afford charge.");
-		}
+        if (getMoney() != null && getMoney().signum() > 0 && !user.canAfford(getMoney())) {
+            future.completeExceptionally(new ChargeException(tl("notEnoughMoney", NumberUtil.displayCurrency(getMoney(), ess))));
+            return;
+        }
 
-		if (getMoney() != null
-			&& getMoney().signum() > 0
-			&& !user.canAfford(getMoney()))
-		{
-			throw new ChargeException(_("notEnoughMoney"));
-		}
+        if (getItemStack() != null && !user.getBase().getInventory().containsAtLeast(itemStack, itemStack.getAmount())) {
+            future.completeExceptionally(new ChargeException(tl("missingItems", getItemStack().getAmount(), ess.getItemDb().name(getItemStack()))));
+            return;
+        }
 
-		if (getItemStack() != null
-			&& !user.getInventory().containsAtLeast(itemStack, itemStack.getAmount()))
-		{
-			throw new ChargeException(_("missingItems", getItemStack().getAmount(), getItemStack().getType().toString().toLowerCase(Locale.ENGLISH).replace("_", " ")));
-		}
+        final BigDecimal money;
+        if (command != null && !command.isEmpty() && (money = getCommandCost(user)).signum() > 0 && !user.canAfford(money)) {
+            future.completeExceptionally(new ChargeException(tl("notEnoughMoney", NumberUtil.displayCurrency(money, ess))));
+            return;
+        }
 
-		BigDecimal money;
-		if (command != null && !command.isEmpty()
-			&& (money = getCommandCost(user)).signum() > 0
-			&& !user.canAfford(money))
-		{
-			throw new ChargeException(_("notEnoughMoney"));
-		}
+        if (exp != null && exp > 0 && SetExpFix.getTotalExperience(user.getBase()) < exp) {
+            future.completeExceptionally(new ChargeException(tl("notEnoughExperience")));
+        }
+    }
 
-		if (exp != null && exp > 0
-			&& SetExpFix.getTotalExperience(user) < exp)
-		{
-			throw new ChargeException(_("notEnoughExperience"));
-		}
-	}
+    public boolean pay(final IUser user) throws MaxMoneyException {
+        return pay(user, OverflowType.ABORT) == null;
+    }
 
-	public boolean pay(final IUser user)
-	{
-		return pay(user, OverflowType.ABORT) == null;
-	}
+    public Map<Integer, ItemStack> pay(final IUser user, final OverflowType type) throws MaxMoneyException {
+        if (getMoney() != null && getMoney().signum() > 0) {
+            if (ess.getSettings().isDebug()) {
+                ess.getLogger().log(Level.INFO, "paying user " + user.getName() + " via trade " + getMoney().toPlainString());
+            }
+            user.giveMoney(getMoney());
+        }
+        if (getItemStack() != null) {
+            // This stores the would be overflow
+            final Map<Integer, ItemStack> overFlow = InventoryWorkaround.addAllItems(user.getBase().getInventory(), getItemStack());
 
-	public Map<Integer, ItemStack> pay(final IUser user, final OverflowType type)
-	{
-		if (getMoney() != null && getMoney().signum() > 0)
-		{
-			if (ess.getSettings().isDebug())
-			{
-				ess.getLogger().log(Level.INFO, "paying user " + user.getName() + " via trade " + getMoney().toPlainString());
-			}
-			user.giveMoney(getMoney());
-		}
-		if (getItemStack() != null)
-		{
-			// This stores the would be overflow
-			Map<Integer, ItemStack> overFlow = InventoryWorkaround.addAllItems(user.getInventory(), getItemStack());
+            if (overFlow != null) {
+                switch (type) {
+                    case ABORT:
+                        if (ess.getSettings().isDebug()) {
+                            ess.getLogger().log(Level.INFO, "abort paying " + user.getName() + " itemstack " + getItemStack().toString() + " due to lack of inventory space ");
+                        }
 
-			if (overFlow != null)
-			{
-				switch (type)
-				{
-				case ABORT:
-					if (ess.getSettings().isDebug())
-					{
-						ess.getLogger().log(Level.INFO, "abort paying " + user.getName() + " itemstack " + getItemStack().toString() + " due to lack of inventory space ");
-					}
+                        return overFlow;
 
-					return overFlow;
+                    case RETURN:
+                        // Pay the user the items, and return overflow
+                        final Map<Integer, ItemStack> returnStack = InventoryWorkaround.addItems(user.getBase().getInventory(), getItemStack());
+                        user.getBase().updateInventory();
 
-				case RETURN:
-					// Pay the user the items, and return overflow
-					final Map<Integer, ItemStack> returnStack = InventoryWorkaround.addItems(user.getInventory(), getItemStack());
-					user.updateInventory();
+                        if (ess.getSettings().isDebug()) {
+                            ess.getLogger().log(Level.INFO, "paying " + user.getName() + " partial itemstack " + getItemStack().toString() + " with overflow " + returnStack.get(0).toString());
+                        }
 
-					if (ess.getSettings().isDebug())
-					{
-						ess.getLogger().log(Level.INFO, "paying " + user.getName() + " partial itemstack " + getItemStack().toString() + " with overflow " + returnStack.get(0).toString());
-					}
+                        return returnStack;
+                    case DROP:
+                        // Pay the users the items directly, and drop the rest, will always return no overflow.
+                        final Map<Integer, ItemStack> leftOver = InventoryWorkaround.addItems(user.getBase().getInventory(), getItemStack());
+                        final Location loc = user.getBase().getLocation();
+                        for (final ItemStack loStack : leftOver.values()) {
+                            final int maxStackSize = loStack.getType().getMaxStackSize();
+                            final int stacks = loStack.getAmount() / maxStackSize;
+                            final int leftover = loStack.getAmount() % maxStackSize;
+                            final Item[] itemStacks = new Item[stacks + (leftover > 0 ? 1 : 0)];
+                            for (int i = 0; i < stacks; i++) {
+                                final ItemStack stack = loStack.clone();
+                                stack.setAmount(maxStackSize);
+                                itemStacks[i] = loc.getWorld().dropItem(loc, stack);
+                            }
+                            if (leftover > 0) {
+                                final ItemStack stack = loStack.clone();
+                                stack.setAmount(leftover);
+                                itemStacks[stacks] = loc.getWorld().dropItem(loc, stack);
+                            }
+                        }
+                        if (ess.getSettings().isDebug()) {
+                            ess.getLogger().log(Level.INFO, "paying " + user.getName() + " partial itemstack " + getItemStack().toString() + " and dropping overflow " + leftOver.get(0).toString());
+                        }
+                        break;
+                }
+            } else if (ess.getSettings().isDebug()) {
+                ess.getLogger().log(Level.INFO, "paying " + user.getName() + " itemstack " + getItemStack().toString());
+            }
+            user.getBase().updateInventory();
+        }
+        if (getExperience() != null) {
+            SetExpFix.setTotalExperience(user.getBase(), SetExpFix.getTotalExperience(user.getBase()) + getExperience());
+        }
+        return null;
+    }
 
-					return returnStack;
+    public void charge(final IUser user) throws ChargeException {
+        final CompletableFuture<Boolean> future = new CompletableFuture<>();
+        charge(user, future);
+        if (future.isCompletedExceptionally()) {
+            try {
+                future.get();
+            } catch (final InterruptedException e) { //If this happens, we have bigger problems...
+                e.printStackTrace();
+            } catch (final ExecutionException e) {
+                throw (ChargeException) e.getCause();
+            }
+        }
+    }
 
-				case DROP:
-					// Pay the users the items directly, and drop the rest, will always return no overflow.
-					final Map<Integer, ItemStack> leftOver = InventoryWorkaround.addItems(user.getInventory(), getItemStack());
-					final Location loc = user.getLocation();
-					for (ItemStack loStack : leftOver.values())
-					{
-						final int maxStackSize = loStack.getType().getMaxStackSize();
-						final int stacks = loStack.getAmount() / maxStackSize;
-						final int leftover = loStack.getAmount() % maxStackSize;
-						final Item[] itemStacks = new Item[stacks + (leftover > 0 ? 1 : 0)];
-						for (int i = 0; i < stacks; i++)
-						{
-							final ItemStack stack = loStack.clone();
-							stack.setAmount(maxStackSize);
-							itemStacks[i] = loc.getWorld().dropItem(loc, stack);
-						}
-						if (leftover > 0)
-						{
-							final ItemStack stack = loStack.clone();
-							stack.setAmount(leftover);
-							itemStacks[stacks] = loc.getWorld().dropItem(loc, stack);
-						}
-					}
-					if (ess.getSettings().isDebug())
-					{
-						ess.getLogger().log(Level.INFO, "paying " + user.getName() + " partial itemstack " + getItemStack().toString() + " and dropping overflow " + leftOver.get(0).toString());
-					}
-				}
-			}
-			else if (ess.getSettings().isDebug())
-			{
-				ess.getLogger().log(Level.INFO, "paying " + user.getName() + " itemstack " + getItemStack().toString());
-			}
-			user.updateInventory();
-		}
-		if (getExperience() != null)
-		{
-			SetExpFix.setTotalExperience(user, SetExpFix.getTotalExperience(user) + getExperience());
-		}
-		return null;
-	}
+    public void charge(final IUser user, final CompletableFuture<Boolean> future) {
+        if (ess.getSettings().isDebug()) {
+            ess.getLogger().log(Level.INFO, "attempting to charge user " + user.getName());
+        }
+        if (getMoney() != null) {
+            if (ess.getSettings().isDebug()) {
+                ess.getLogger().log(Level.INFO, "charging user " + user.getName() + " money " + getMoney().toPlainString());
+            }
+            if (!user.canAfford(getMoney()) && getMoney().signum() > 0) {
+                future.completeExceptionally(new ChargeException(tl("notEnoughMoney", NumberUtil.displayCurrency(getMoney(), ess))));
+                return;
+            }
+            user.takeMoney(getMoney());
+        }
+        if (getItemStack() != null) {
+            if (ess.getSettings().isDebug()) {
+                ess.getLogger().log(Level.INFO, "charging user " + user.getName() + " itemstack " + getItemStack().toString());
+            }
+            if (!user.getBase().getInventory().containsAtLeast(getItemStack(), getItemStack().getAmount())) {
+                future.completeExceptionally(new ChargeException(tl("missingItems", getItemStack().getAmount(), getItemStack().getType().toString().toLowerCase(Locale.ENGLISH).replace("_", " "))));
+                return;
+            }
+            user.getBase().getInventory().removeItem(getItemStack());
+            user.getBase().updateInventory();
+        }
+        if (command != null) {
+            final BigDecimal cost = getCommandCost(user);
+            if (!user.canAfford(cost) && cost.signum() > 0) {
+                future.completeExceptionally(new ChargeException(tl("notEnoughMoney", NumberUtil.displayCurrency(cost, ess))));
+                return;
+            }
+            user.takeMoney(cost);
+        }
+        if (getExperience() != null) {
+            if (ess.getSettings().isDebug()) {
+                ess.getLogger().log(Level.INFO, "charging user " + user.getName() + " exp " + getExperience());
+            }
+            final int experience = SetExpFix.getTotalExperience(user.getBase());
+            if (experience < getExperience() && getExperience() > 0) {
+                future.completeExceptionally(new ChargeException(tl("notEnoughExperience")));
+                return;
+            }
+            SetExpFix.setTotalExperience(user.getBase(), experience - getExperience());
+        }
+        if (ess.getSettings().isDebug()) {
+            ess.getLogger().log(Level.INFO, "charge user " + user.getName() + " completed");
+        }
+    }
 
-	public void charge(final IUser user) throws ChargeException
-	{
-		if (ess.getSettings().isDebug())
-		{
-			ess.getLogger().log(Level.INFO, "attempting to charge user " + user.getName());
-		}
-		if (getMoney() != null)
-		{
-			if (ess.getSettings().isDebug())
-			{
-				ess.getLogger().log(Level.INFO, "charging user " + user.getName() + " money " + getMoney().toPlainString());
-			}
-			if (!user.canAfford(getMoney()) && getMoney().signum() > 0)
-			{
-				throw new ChargeException(_("notEnoughMoney"));
-			}
-			user.takeMoney(getMoney());
-		}
-		if (getItemStack() != null)
-		{
-			if (ess.getSettings().isDebug())
-			{
-				ess.getLogger().log(Level.INFO, "charging user " + user.getName() + " itemstack " + getItemStack().toString());
-			}
-			if (!user.getInventory().containsAtLeast(getItemStack(), getItemStack().getAmount()))
-			{
-				throw new ChargeException(_("missingItems", getItemStack().getAmount(), getItemStack().getType().toString().toLowerCase(Locale.ENGLISH).replace("_", " ")));
-			}
-			user.getInventory().removeItem(getItemStack());
-			user.updateInventory();
-		}
-		if (command != null)
-		{
-			final BigDecimal cost = getCommandCost(user);
-			if (!user.canAfford(cost) && cost.signum() > 0)
-			{
-				throw new ChargeException(_("notEnoughMoney"));
-			}
-			user.takeMoney(cost);
-		}
-		if (getExperience() != null)
-		{
-			if (ess.getSettings().isDebug())
-			{
-				ess.getLogger().log(Level.INFO, "charging user " + user.getName() + " exp " + getExperience());
-			}
-			final int experience = SetExpFix.getTotalExperience(user);
-			if (experience < getExperience() && getExperience() > 0)
-			{
-				throw new ChargeException(_("notEnoughExperience"));
-			}
-			SetExpFix.setTotalExperience(user, experience - getExperience());
-		}
-		if (ess.getSettings().isDebug())
-		{
-			ess.getLogger().log(Level.INFO, "charge user " + user.getName() + " completed");
-		}
-	}
+    public BigDecimal getMoney() {
+        return money;
+    }
 
-	public BigDecimal getMoney()
-	{
-		return money;
-	}
+    public ItemStack getItemStack() {
+        return itemStack;
+    }
 
-	public ItemStack getItemStack()
-	{
-		return itemStack;
-	}
+    public Integer getExperience() {
+        return exp;
+    }
 
-	public Integer getExperience()
-	{
-		return exp;
-	}
+    public TradeType getType() {
+        if (getExperience() != null) {
+            return TradeType.EXP;
+        }
 
-	public TradeType getType()
-	{
-		if (getExperience() != null)
-		{
-			return TradeType.EXP;
-		}
+        if (getItemStack() != null) {
+            return TradeType.ITEM;
+        }
 
-		if (getItemStack() != null)
-		{
-			return TradeType.ITEM;
-		}
+        return TradeType.MONEY;
+    }
 
-		return TradeType.MONEY;
-	}
+    public BigDecimal getCommandCost(final IUser user) {
+        BigDecimal cost = BigDecimal.ZERO;
+        if (command != null && !command.isEmpty()) {
+            cost = ess.getSettings().getCommandCost(command.charAt(0) == '/' ? command.substring(1) : command);
+            if (cost.signum() == 0 && fallbackTrade != null) {
+                cost = fallbackTrade.getCommandCost(user);
+            }
 
-	public BigDecimal getCommandCost(final IUser user)
-	{
-		BigDecimal cost = BigDecimal.ZERO;
-		if (command != null && !command.isEmpty())
-		{
-			cost = ess.getSettings().getCommandCost(command.charAt(0) == '/' ? command.substring(1) : command);
-			if (cost.signum() == 0 && fallbackTrade != null)
-			{
-				cost = fallbackTrade.getCommandCost(user);
-			}
+            if (ess.getSettings().isDebug()) {
+                ess.getLogger().log(Level.INFO, "calculated command (" + command + ") cost for " + user.getName() + " as " + cost);
+            }
+        }
+        if (cost.signum() != 0 && (user.isAuthorized("essentials.nocommandcost.all") || user.isAuthorized("essentials.nocommandcost." + command))) {
+            return BigDecimal.ZERO;
+        }
+        return cost;
+    }
 
-			if (ess.getSettings().isDebug())
-			{
-				ess.getLogger().log(Level.INFO, "calculated command (" + command + ") cost for " + user.getName() + " as " + cost);
-			}
-		}
-		if (cost.signum() != 0 && (user.isAuthorized("essentials.nocommandcost.all")
-								   || user.isAuthorized("essentials.nocommandcost." + command)))
-		{
-			return BigDecimal.ZERO;
-		}
-		return cost;
-	}
-	private static FileWriter fw = null;
+    public enum TradeType {
+        MONEY,
+        EXP,
+        ITEM
+    }
 
-	public static void log(String type, String subtype, String event, String sender, Trade charge, String receiver, Trade pay, Location loc, IEssentials ess)
-	{
-		//isEcoLogUpdateEnabled() - This refers to log entries with no location, ie API updates #EasterEgg
-		//isEcoLogEnabled() - This refers to log entries with with location, ie /pay /sell and eco signs.
-
-		if ((loc == null && !ess.getSettings().isEcoLogUpdateEnabled())
-			|| (loc != null && !ess.getSettings().isEcoLogEnabled()))
-		{
-			return;
-		}
-		if (fw == null)
-		{
-			try
-			{
-				fw = new FileWriter(new File(ess.getDataFolder(), "trade.log"), true);
-			}
-			catch (IOException ex)
-			{
-				Logger.getLogger("Minecraft").log(Level.SEVERE, null, ex);
-			}
-		}
-		StringBuilder sb = new StringBuilder();
-		sb.append(type).append(",").append(subtype).append(",").append(event).append(",\"");
-		sb.append(DateFormat.getDateTimeInstance(DateFormat.FULL, DateFormat.FULL).format(new Date()));
-		sb.append("\",\"");
-		if (sender != null)
-		{
-			sb.append(sender);
-		}
-		sb.append("\",");
-		if (charge == null)
-		{
-			sb.append("\"\",\"\",\"\"");
-		}
-		else
-		{
-			if (charge.getItemStack() != null)
-			{
-				sb.append(charge.getItemStack().getAmount()).append(",");
-				sb.append(charge.getItemStack().getType().toString()).append(",");
-				sb.append(charge.getItemStack().getDurability());
-			}
-			if (charge.getMoney() != null)
-			{
-				sb.append(charge.getMoney()).append(",");
-				sb.append("money").append(",");
-				sb.append(ess.getSettings().getCurrencySymbol());
-			}
-			if (charge.getExperience() != null)
-			{
-				sb.append(charge.getExperience()).append(",");
-				sb.append("exp").append(",");
-				sb.append("\"\"");
-			}
-		}
-		sb.append(",\"");
-		if (receiver != null)
-		{
-			sb.append(receiver);
-		}
-		sb.append("\",");
-		if (pay == null)
-		{
-			sb.append("\"\",\"\",\"\"");
-		}
-		else
-		{
-			if (pay.getItemStack() != null)
-			{
-				sb.append(pay.getItemStack().getAmount()).append(",");
-				sb.append(pay.getItemStack().getType().toString()).append(",");
-				sb.append(pay.getItemStack().getDurability());
-			}
-			if (pay.getMoney() != null)
-			{
-				sb.append(pay.getMoney()).append(",");
-				sb.append("money").append(",");
-				sb.append(ess.getSettings().getCurrencySymbol());
-			}
-			if (pay.getExperience() != null)
-			{
-				sb.append(pay.getExperience()).append(",");
-				sb.append("exp").append(",");
-				sb.append("\"\"");
-			}
-		}
-		if (loc == null)
-		{
-			sb.append(",\"\",\"\",\"\",\"\"");
-		}
-		else
-		{
-			sb.append(",\"");
-			sb.append(loc.getWorld().getName()).append("\",");
-			sb.append(loc.getBlockX()).append(",");
-			sb.append(loc.getBlockY()).append(",");
-			sb.append(loc.getBlockZ()).append(",");
-		}
-		sb.append("\n");
-		try
-		{
-			fw.write(sb.toString());
-			fw.flush();
-		}
-		catch (IOException ex)
-		{
-			Logger.getLogger("Minecraft").log(Level.SEVERE, null, ex);
-		}
-	}
-
-	public static void closeLog()
-	{
-		if (fw != null)
-		{
-			try
-			{
-				fw.close();
-			}
-			catch (IOException ex)
-			{
-				Logger.getLogger("Minecraft").log(Level.SEVERE, null, ex);
-			}
-			fw = null;
-		}
-	}
+    public enum OverflowType {
+        ABORT,
+        DROP,
+        RETURN
+    }
 }

Essentials/src/com/earth2me/essentials/UUIDMap.java

@@ -0,0 +1,156 @@
+package com.earth2me.essentials;
+
+import com.google.common.io.Files;
+import org.bukkit.Bukkit;
+
+import java.io.BufferedReader;
+import java.io.BufferedWriter;
+import java.io.File;
+import java.io.FileReader;
+import java.io.FileWriter;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentSkipListMap;
+import java.util.concurrent.Executors;
+import java.util.concurrent.ScheduledExecutorService;
+import java.util.concurrent.TimeUnit;
+import java.util.logging.Level;
+import java.util.regex.Pattern;
+
+public class UUIDMap {
+    private static final ScheduledExecutorService writeScheduler = Executors.newScheduledThreadPool(1);
+    private static boolean pendingWrite;
+    private static boolean loading = false;
+    private final transient net.ess3.api.IEssentials ess;
+    private final File userList;
+    private final transient Pattern splitPattern = Pattern.compile(",");
+    private final Runnable writeTaskRunnable;
+
+    public UUIDMap(final net.ess3.api.IEssentials ess) {
+        this.ess = ess;
+        userList = new File(ess.getDataFolder(), "usermap.csv");
+        pendingWrite = false;
+        writeTaskRunnable = () -> {
+            if (pendingWrite) {
+                try {
+                    new WriteRunner(ess.getDataFolder(), userList, ess.getUserMap().getNames()).run();
+                } catch (final Throwable t) { // bad code to prevent task from being suppressed
+                    t.printStackTrace();
+                }
+            }
+        };
+        writeScheduler.scheduleWithFixedDelay(writeTaskRunnable, 5, 5, TimeUnit.SECONDS);
+    }
+
+    public void loadAllUsers(final ConcurrentSkipListMap<String, UUID> names, final ConcurrentSkipListMap<UUID, ArrayList<String>> history) {
+        try {
+            if (!userList.exists()) {
+                userList.createNewFile();
+            }
+
+            if (ess.getSettings().isDebug()) {
+                ess.getLogger().log(Level.INFO, "Reading usermap from disk");
+            }
+
+            if (loading) {
+                return;
+            }
+
+            names.clear();
+            history.clear();
+            loading = true;
+
+            try (final BufferedReader reader = new BufferedReader(new FileReader(userList))) {
+                while (true) {
+                    final String line = reader.readLine();
+                    if (line == null) {
+                        break;
+                    } else {
+                        final String[] values = splitPattern.split(line);
+                        if (values.length == 2) {
+                            final String name = values[0];
+                            final UUID uuid = UUID.fromString(values[1]);
+                            names.put(name, uuid);
+                            if (!history.containsKey(uuid)) {
+                                final ArrayList<String> list = new ArrayList<>();
+                                list.add(name);
+                                history.put(uuid, list);
+                            } else {
+                                final ArrayList<String> list = history.get(uuid);
+                                if (!list.contains(name)) {
+                                    list.add(name);
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            loading = false;
+        } catch (final IOException ex) {
+            Bukkit.getLogger().log(Level.SEVERE, ex.getMessage(), ex);
+        }
+    }
+
+    public void writeUUIDMap() {
+        pendingWrite = true;
+    }
+
+    public void forceWriteUUIDMap() {
+        if (ess.getSettings().isDebug()) {
+            ess.getLogger().log(Level.INFO, "Forcing usermap write to disk");
+        }
+        pendingWrite = true;
+        writeTaskRunnable.run();
+    }
+
+    public void shutdown() {
+        writeScheduler.submit(writeTaskRunnable);
+        writeScheduler.shutdown();
+    }
+
+    private static final class WriteRunner implements Runnable {
+        private final File location;
+        private final File endFile;
+        private final Map<String, UUID> names;
+
+        private WriteRunner(final File location, final File endFile, final Map<String, UUID> names) {
+            this.location = location;
+            this.endFile = endFile;
+            this.names = new HashMap<>(names);
+        }
+
+        @Override
+        public void run() {
+            pendingWrite = false;
+            if (loading || names.isEmpty()) {
+                return;
+            }
+            File configFile = null;
+
+            try {
+                configFile = File.createTempFile("usermap", ".tmp.csv", location);
+
+                final BufferedWriter bWriter = new BufferedWriter(new FileWriter(configFile));
+                for (final Map.Entry<String, UUID> entry : names.entrySet()) {
+                    bWriter.write(entry.getKey() + "," + entry.getValue().toString());
+                    bWriter.newLine();
+                }
+
+                bWriter.close();
+                Files.move(configFile, endFile);
+            } catch (final IOException ex) {
+                try {
+                    if (configFile != null && configFile.exists()) {
+                        Files.move(configFile, new File(endFile.getParentFile(), "usermap.bak.csv"));
+                    }
+                } catch (final Exception ex2) {
+                    Bukkit.getLogger().log(Level.SEVERE, ex2.getMessage(), ex2);
+                }
+                Bukkit.getLogger().log(Level.WARNING, ex.getMessage(), ex);
+            }
+        }
+    }
+}

Essentials/src/com/earth2me/essentials/UserMap.java

@@ -1,143 +1,313 @@
 package com.earth2me.essentials;
 
 import com.earth2me.essentials.utils.StringUtil;
+import com.google.common.base.Charsets;
 import com.google.common.cache.Cache;
 import com.google.common.cache.CacheBuilder;
 import com.google.common.cache.CacheLoader;
+import com.google.common.cache.LoadingCache;
 import com.google.common.util.concurrent.UncheckedExecutionException;
-import java.io.File;
-import java.util.Collections;
-import java.util.Set;
-import java.util.concurrent.ConcurrentSkipListSet;
-import java.util.concurrent.ExecutionException;
+import net.ess3.api.IEssentials;
 import org.bukkit.entity.Player;
 
+import java.io.File;
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Set;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentSkipListMap;
+import java.util.concurrent.ConcurrentSkipListSet;
+import java.util.concurrent.ExecutionException;
+import java.util.regex.Pattern;
 
-public class UserMap extends CacheLoader<String, User> implements IConf
-{
-	private final transient IEssentials ess;
-	private final transient Cache<String, User> users = CacheBuilder.newBuilder().softValues().build(this);
-	private final transient ConcurrentSkipListSet<String> keys = new ConcurrentSkipListSet<String>();
+public class UserMap extends CacheLoader<String, User> implements IConf {
+    private static boolean legacy = false;
+    private static Method getLegacy;
+    private final transient IEssentials ess;
+    private final transient ConcurrentSkipListSet<UUID> keys = new ConcurrentSkipListSet<>();
+    private final transient ConcurrentSkipListMap<String, UUID> names = new ConcurrentSkipListMap<>();
+    private final transient ConcurrentSkipListMap<UUID, ArrayList<String>> history = new ConcurrentSkipListMap<>();
+    private final UUIDMap uuidMap;
+    private final transient Cache<String, User> users;
+    private final Pattern validUserPattern = Pattern.compile("^[a-zA-Z0-9_]{2,16}$");
 
-	public UserMap(final IEssentials ess)
-	{
-		super();
-		this.ess = ess;
-		loadAllUsersAsync(ess);
-	}
+    public UserMap(final IEssentials ess) {
+        super();
+        this.ess = ess;
+        uuidMap = new UUIDMap(ess);
+        //RemovalListener<UUID, User> remListener = new UserMapRemovalListener();
+        //users = CacheBuilder.newBuilder().maximumSize(ess.getSettings().getMaxUserCacheCount()).softValues().removalListener(remListener).build(this);
+        final CacheBuilder<Object, Object> cacheBuilder = CacheBuilder.newBuilder();
+        final int maxCount = ess.getSettings().getMaxUserCacheCount();
+        try {
+            cacheBuilder.maximumSize(maxCount);
+        } catch (final NoSuchMethodError nsme) {
+            legacy = true;
+            legacyMaximumSize(cacheBuilder, maxCount);
+        }
+        cacheBuilder.softValues();
+        if (!legacy) {
+            users = cacheBuilder.build(this);
+        } else {
+            users = legacyBuild(cacheBuilder);
+        }
+    }
 
-	private void loadAllUsersAsync(final IEssentials ess)
-	{
-		ess.runTaskAsynchronously(new Runnable()
-		{
-			@Override
-			public void run()
-			{
-				final File userdir = new File(ess.getDataFolder(), "userdata");
-				if (!userdir.exists())
-				{
-					return;
-				}
-				keys.clear();
-				users.invalidateAll();
-				for (String string : userdir.list())
-				{
-					if (!string.endsWith(".yml"))
-					{
-						continue;
-					}
-					final String name = string.substring(0, string.length() - 4);
-					keys.add(StringUtil.sanitizeFileName(name));
-				}
-			}
-		});
-	}
+    private void loadAllUsersAsync(final IEssentials ess) {
+        ess.runTaskAsynchronously(() -> {
+            synchronized (users) {
+                final File userdir = new File(ess.getDataFolder(), "userdata");
+                if (!userdir.exists()) {
+                    return;
+                }
+                keys.clear();
+                users.invalidateAll();
+                for (final String string : userdir.list()) {
+                    if (!string.endsWith(".yml")) {
+                        continue;
+                    }
+                    final String name = string.substring(0, string.length() - 4);
+                    try {
+                        keys.add(UUID.fromString(name));
+                    } catch (final IllegalArgumentException ex) {
+                        //Ignore these users till they rejoin.
+                    }
+                }
+                uuidMap.loadAllUsers(names, history);
+            }
+        });
+    }
 
-	public boolean userExists(final String name)
-	{
-		return keys.contains(StringUtil.sanitizeFileName(name));
-	}
+    public boolean userExists(final UUID uuid) {
+        return keys.contains(uuid);
+    }
 
-	public User getUser(final String name)
-	{
-		try
-		{
-			return users.get(name);
-		}
-		catch (ExecutionException ex)
-		{
-			return null;
-		}
-		catch (UncheckedExecutionException ex)
-		{
-			return null;
-		}
-	}
+    public User getUser(final String name) {
+        try {
+            final String sanitizedName = StringUtil.safeString(name);
+            if (names.containsKey(sanitizedName)) {
+                final UUID uuid = names.get(sanitizedName);
+                return getUser(uuid);
+            }
 
-	@Override
-	public User load(final String name) throws Exception
-	{
-		String sanitizedName = StringUtil.sanitizeFileName(name);
-		if (!sanitizedName.equals(name))
-		{
-			User user = getUser(sanitizedName);
-			if (user == null)
-			{
-				throw new Exception("User not found!");
-			}
-			else
-			{
-				return user;
-			}
-		}
-		for (Player player : ess.getServer().getOnlinePlayers())
-		{
-			if (player.getName().equalsIgnoreCase(name))
-			{
-				keys.add(sanitizedName);
-				return new User(player, ess);
-			}
-		}
-		final File userFile = getUserFile2(sanitizedName);
-		if (userFile.exists())
-		{
-			keys.add(sanitizedName);
-			return new User(new OfflinePlayer(name, ess), ess);
-		}
-		throw new Exception("User not found!");
-	}
+            final File userFile = getUserFileFromString(sanitizedName);
+            if (userFile.exists()) {
+                ess.getLogger().info("Importing user " + name + " to usermap.");
+                final User user = new User(new OfflinePlayer(sanitizedName, ess.getServer()), ess);
+                trackUUID(user.getBase().getUniqueId(), user.getName(), true);
+                return user;
+            }
+            return null;
+        } catch (final UncheckedExecutionException ex) {
+            return null;
+        }
+    }
 
-	@Override
-	public void reloadConfig()
-	{
-		loadAllUsersAsync(ess);
-	}
+    public User getUser(final UUID uuid) {
+        try {
+            if (!legacy) {
+                return ((LoadingCache<String, User>) users).get(uuid.toString());
+            } else {
+                return legacyCacheGet(uuid);
+            }
+        } catch (final ExecutionException | UncheckedExecutionException ex) {
+            return null;
+        }
+    }
 
-	public void removeUser(final String name)
-	{
-		keys.remove(StringUtil.sanitizeFileName(name));
-		users.invalidate(StringUtil.sanitizeFileName(name));
-		users.invalidate(name);
-	}
+    public void trackUUID(final UUID uuid, final String name, final boolean replace) {
+        if (uuid != null) {
+            keys.add(uuid);
+            if (name != null && name.length() > 0) {
+                final String keyName = ess.getSettings().isSafeUsermap() ? StringUtil.safeString(name) : name;
+                if (!names.containsKey(keyName)) {
+                    names.put(keyName, uuid);
+                    uuidMap.writeUUIDMap();
+                } else if (!names.get(keyName).equals(uuid)) {
+                    if (replace) {
+                        ess.getLogger().info("Found new UUID for " + name + ". Replacing " + names.get(keyName).toString() + " with " + uuid.toString());
+                        names.put(keyName, uuid);
+                        uuidMap.writeUUIDMap();
+                    } else {
+                        if (ess.getSettings().isDebug()) {
+                            ess.getLogger().info("Found old UUID for " + name + " (" + uuid.toString() + "). Not adding to usermap.");
+                        }
+                    }
+                }
+            }
+        }
+    }
 
-	public Set<String> getAllUniqueUsers()
-	{
-		return Collections.unmodifiableSet(keys);
-	}
+    @Override
+    public User load(final String stringUUID) throws Exception {
+        final UUID uuid = UUID.fromString(stringUUID);
+        Player player = ess.getServer().getPlayer(uuid);
+        if (player != null) {
+            final User user = new User(player, ess);
+            trackUUID(uuid, user.getName(), true);
+            return user;
+        }
 
-	public int getUniqueUsers()
-	{
-		return keys.size();
-	}
+        final File userFile = getUserFileFromID(uuid);
 
-	public File getUserFile(final String name)
-	{
-		return getUserFile2(StringUtil.sanitizeFileName(name));
-	}
+        if (userFile.exists()) {
+            player = new OfflinePlayer(uuid, ess.getServer());
+            final User user = new User(player, ess);
+            ((OfflinePlayer) player).setName(user.getLastAccountName());
+            trackUUID(uuid, user.getName(), false);
+            return user;
+        }
 
-	private File getUserFile2(final String name)
-	{
-		final File userFolder = new File(ess.getDataFolder(), "userdata");
-		return new File(userFolder, name + ".yml");
-	}
+        throw new Exception("User not found!");
+    }
+
+    @Override
+    public void reloadConfig() {
+        getUUIDMap().forceWriteUUIDMap();
+        loadAllUsersAsync(ess);
+    }
+
+    public void invalidateAll() {
+        users.invalidateAll();
+    }
+
+    public void removeUser(final String name) {
+        if (names == null) {
+            ess.getLogger().warning("Name collection is null, cannot remove user.");
+            return;
+        }
+        final UUID uuid = names.get(name);
+        if (uuid != null) {
+            keys.remove(uuid);
+            users.invalidate(uuid.toString());
+        }
+        names.remove(name);
+        names.remove(StringUtil.safeString(name));
+    }
+
+    public Set<UUID> getAllUniqueUsers() {
+        return Collections.unmodifiableSet(keys);
+    }
+
+    public int getUniqueUsers() {
+        return keys.size();
+    }
+
+    protected ConcurrentSkipListMap<String, UUID> getNames() {
+        return names;
+    }
+
+    protected ConcurrentSkipListMap<UUID, ArrayList<String>> getHistory() {
+        return history;
+    }
+
+    public List<String> getUserHistory(final UUID uuid) {
+        return history.get(uuid);
+    }
+
+    public UUIDMap getUUIDMap() {
+        return uuidMap;
+    }
+    //  class UserMapRemovalListener implements RemovalListener
+    //  {
+    //      @Override
+    //      public void onRemoval(final RemovalNotification notification)
+    //      {
+    //          Object value = notification.getValue();
+    //          if (value != null)
+    //          {
+    //              ((User)value).cleanup();
+    //          }
+    //      }
+    //  }
+
+    private File getUserFileFromID(final UUID uuid) {
+        final File userFolder = new File(ess.getDataFolder(), "userdata");
+        return new File(userFolder, uuid.toString() + ".yml");
+    }
+
+    public File getUserFileFromString(final String name) {
+        final File userFolder = new File(ess.getDataFolder(), "userdata");
+        return new File(userFolder, StringUtil.sanitizeFileName(name) + ".yml");
+    }
+
+    @SuppressWarnings("deprecation")
+    public User getUserFromBukkit(String name) {
+        name = StringUtil.safeString(name);
+        if (ess.getSettings().isDebug()) {
+            ess.getLogger().warning("Using potentially blocking Bukkit UUID lookup for: " + name);
+        }
+        // Don't attempt to look up entirely invalid usernames
+        if (name == null || !validUserPattern.matcher(name).matches()) {
+            return null;
+        }
+        final org.bukkit.OfflinePlayer offlinePlayer = ess.getServer().getOfflinePlayer(name);
+        if (offlinePlayer == null) {
+            return null;
+        }
+        final UUID uuid;
+        try {
+            uuid = offlinePlayer.getUniqueId();
+        } catch (final UnsupportedOperationException | NullPointerException e) {
+            return null;
+        }
+        // This is how Bukkit generates fake UUIDs
+        if (UUID.nameUUIDFromBytes(("OfflinePlayer:" + name).getBytes(Charsets.UTF_8)).equals(uuid)) {
+            return null;
+        } else {
+            names.put(name, uuid);
+            return getUser(uuid);
+        }
+    }
+
+    private User legacyCacheGet(final UUID uuid) {
+        if (getLegacy == null) {
+            final Class<?> usersClass = users.getClass();
+            for (final Method m : usersClass.getDeclaredMethods()) {
+                if (m.getName().equals("get")) {
+                    getLegacy = m;
+                    getLegacy.setAccessible(true);
+                    break;
+                }
+            }
+        }
+        try {
+            return (User) getLegacy.invoke(users, uuid.toString());
+        } catch (final IllegalAccessException | InvocationTargetException e) {
+            return null;
+        }
+    }
+
+    private void legacyMaximumSize(final CacheBuilder builder, final int maxCount) {
+        try {
+            final Method maxSizeLegacy = builder.getClass().getDeclaredMethod("maximumSize", Integer.TYPE);
+            maxSizeLegacy.setAccessible(true);
+            maxSizeLegacy.invoke(builder, maxCount);
+        } catch (final NoSuchMethodException | InvocationTargetException | IllegalAccessException e) {
+            e.printStackTrace();
+        }
+    }
+
+    @SuppressWarnings("unchecked")
+    private Cache<String, User> legacyBuild(final CacheBuilder builder) {
+        Method build = null;
+        for (final Method method : builder.getClass().getDeclaredMethods()) {
+            if (method.getName().equals("build")) {
+                build = method;
+                break;
+            }
+        }
+        Cache<String, User> legacyUsers;
+        try {
+            assert build != null;
+            build.setAccessible(true);
+            legacyUsers = (Cache<String, User>) build.invoke(builder, this);
+        } catch (final IllegalAccessException | InvocationTargetException e) {
+            legacyUsers = null;
+        }
+        return legacyUsers;
+    }
 }

Essentials/src/com/earth2me/essentials/Warps.java

@@ -1,181 +1,177 @@
 package com.earth2me.essentials;
 
-import com.earth2me.essentials.utils.StringUtil;
-import static com.earth2me.essentials.I18n._;
-import com.earth2me.essentials.api.IWarps;
-import com.earth2me.essentials.api.InvalidNameException;
-import com.earth2me.essentials.api.InvalidWorldException;
 import com.earth2me.essentials.commands.WarpNotFoundException;
-import java.io.File;
-import java.io.IOException;
-import java.util.*;
-import java.util.logging.Level;
-import java.util.logging.Logger;
+import com.earth2me.essentials.utils.StringUtil;
+import net.ess3.api.InvalidNameException;
+import net.ess3.api.InvalidWorldException;
 import org.bukkit.Location;
 import org.bukkit.Server;
 
+import java.io.File;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.UUID;
+import java.util.logging.Level;
+import java.util.logging.Logger;
 
-public class Warps implements IConf, IWarps
-{
-	private static final Logger logger = Logger.getLogger("Minecraft");
-	private final Map<StringIgnoreCase, EssentialsConf> warpPoints = new HashMap<StringIgnoreCase, EssentialsConf>();
-	private final File warpsFolder;
-	private final Server server;
+import static com.earth2me.essentials.I18n.tl;
 
-	public Warps(Server server, File dataFolder)
-	{
-		this.server = server;
-		warpsFolder = new File(dataFolder, "warps");
-		if (!warpsFolder.exists())
-		{
-			warpsFolder.mkdirs();
-		}
-		reloadConfig();
-	}
+public class Warps implements IConf, net.ess3.api.IWarps {
+    private static final Logger logger = Logger.getLogger("Essentials");
+    private final Map<StringIgnoreCase, EssentialsConf> warpPoints = new HashMap<>();
+    private final File warpsFolder;
+    private final Server server;
 
-	@Override
-	public boolean isEmpty()
-	{
-		return warpPoints.isEmpty();
-	}
+    public Warps(final Server server, final File dataFolder) {
+        this.server = server;
+        warpsFolder = new File(dataFolder, "warps");
+        if (!warpsFolder.exists()) {
+            warpsFolder.mkdirs();
+        }
+        reloadConfig();
+    }
 
-	@Override
-	public Collection<String> getList()
-	{
-		final List<String> keys = new ArrayList<String>();
-		for (StringIgnoreCase stringIgnoreCase : warpPoints.keySet())
-		{
-			keys.add(stringIgnoreCase.getString());
-		}
-		Collections.sort(keys, String.CASE_INSENSITIVE_ORDER);
-		return keys;
-	}
+    @Override
+    public boolean isEmpty() {
+        return warpPoints.isEmpty();
+    }
 
-	@Override
-	public Location getWarp(String warp) throws WarpNotFoundException, InvalidWorldException
-	{
-		EssentialsConf conf = warpPoints.get(new StringIgnoreCase(warp));
-		if (conf == null)
-		{
-			throw new WarpNotFoundException();
-		}
-		return conf.getLocation(null, server);
-	}
+    @Override
+    public Collection<String> getList() {
+        final List<String> keys = new ArrayList<>();
+        for (final StringIgnoreCase stringIgnoreCase : warpPoints.keySet()) {
+            keys.add(stringIgnoreCase.getString());
+        }
+        keys.sort(String.CASE_INSENSITIVE_ORDER);
+        return keys;
+    }
 
-	@Override
-	public void setWarp(String name, Location loc) throws Exception
-	{
-		String filename = StringUtil.sanitizeFileName(name);
-		EssentialsConf conf = warpPoints.get(new StringIgnoreCase(name));
-		if (conf == null)
-		{
-			File confFile = new File(warpsFolder, filename + ".yml");
-			if (confFile.exists())
-			{
-				throw new Exception(_("similarWarpExist"));
-			}
-			conf = new EssentialsConf(confFile);
-			warpPoints.put(new StringIgnoreCase(name), conf);
-		}
-		conf.setProperty(null, loc);
-		conf.setProperty("name", name);
-		try
-		{
-			conf.saveWithError();
-		}
-		catch (IOException ex)
-		{
-			throw new IOException(_("invalidWarpName"));
-		}
-	}
+    @Override
+    public Location getWarp(final String warp) throws WarpNotFoundException, InvalidWorldException {
+        final EssentialsConf conf = warpPoints.get(new StringIgnoreCase(warp));
+        if (conf == null) {
+            throw new WarpNotFoundException();
+        }
+        return conf.getLocation(null, server);
+    }
 
-	@Override
-	public void removeWarp(String name) throws Exception
-	{
-		EssentialsConf conf = warpPoints.get(new StringIgnoreCase(name));
-		if (conf == null)
-		{
-			throw new Exception(_("warpNotExist"));
-		}
-		if (!conf.getFile().delete())
-		{
-			throw new Exception(_("warpDeleteError"));
-		}
-		warpPoints.remove(new StringIgnoreCase(name));
-	}
+    @Override
+    public void setWarp(final String name, final Location loc) throws Exception {
+        setWarp(null, name, loc);
+    }
 
-	@Override
-	public final void reloadConfig()
-	{
-		warpPoints.clear();
-		File[] listOfFiles = warpsFolder.listFiles();
-		if (listOfFiles.length >= 1)
-		{
-			for (int i = 0; i < listOfFiles.length; i++)
-			{
-				String filename = listOfFiles[i].getName();
-				if (listOfFiles[i].isFile() && filename.endsWith(".yml"))
-				{
-					try
-					{
-						EssentialsConf conf = new EssentialsConf(listOfFiles[i]);
-						conf.load();
-						String name = conf.getString("name");
-						if (name != null)
-						{
-							warpPoints.put(new StringIgnoreCase(name), conf);
-						}
-					}
-					catch (Exception ex)
-					{
-						logger.log(Level.WARNING, _("loadWarpError", filename), ex);
-					}
-				}
-			}
-		}
-	}
+    @Override
+    public void setWarp(final IUser user, final String name, final Location loc) throws Exception {
+        final String filename = StringUtil.sanitizeFileName(name);
+        EssentialsConf conf = warpPoints.get(new StringIgnoreCase(name));
+        if (conf == null) {
+            final File confFile = new File(warpsFolder, filename + ".yml");
+            if (confFile.exists()) {
+                throw new Exception(tl("similarWarpExist"));
+            }
+            conf = new EssentialsConf(confFile);
+            warpPoints.put(new StringIgnoreCase(name), conf);
+        }
+        conf.setProperty(null, loc);
+        conf.setProperty("name", name);
+        if (user != null) conf.setProperty("lastowner", user.getBase().getUniqueId().toString());
+        try {
+            conf.saveWithError();
+        } catch (final IOException ex) {
+            throw new IOException(tl("invalidWarpName"));
+        }
+    }
 
-	//This is here for future 3.x api support. Not implemented here becasue storage is handled differently
-	@Override
-	public File getWarpFile(String name) throws InvalidNameException
-	{
-		throw new UnsupportedOperationException("Not supported yet.");
-	}
+    @Override
+    public UUID getLastOwner(final String warp) throws WarpNotFoundException {
+        final EssentialsConf conf = warpPoints.get(new StringIgnoreCase(warp));
+        if (conf == null) {
+            throw new WarpNotFoundException();
+        }
+        UUID uuid = null;
+        try {
+            uuid = UUID.fromString(conf.getString("lastowner"));
+        } catch (final Exception ignored) {
+        }
+        return uuid;
+    }
 
-	@Override
-	public int getCount()
-	{
-		return getList().size();
-	}
+    @Override
+    public void removeWarp(final String name) throws Exception {
+        final EssentialsConf conf = warpPoints.get(new StringIgnoreCase(name));
+        if (conf == null) {
+            throw new Exception(tl("warpNotExist"));
+        }
+        if (!conf.getFile().delete()) {
+            throw new Exception(tl("warpDeleteError"));
+        }
+        warpPoints.remove(new StringIgnoreCase(name));
+    }
 
-	private static class StringIgnoreCase
-	{
-		private final String string;
+    @Override
+    public final void reloadConfig() {
+        warpPoints.clear();
+        final File[] listOfFiles = warpsFolder.listFiles();
+        if (listOfFiles.length >= 1) {
+            for (final File listOfFile : listOfFiles) {
+                final String filename = listOfFile.getName();
+                if (listOfFile.isFile() && filename.endsWith(".yml")) {
+                    try {
+                        final EssentialsConf conf = new EssentialsConf(listOfFile);
+                        conf.load();
+                        final String name = conf.getString("name");
+                        if (name != null) {
+                            warpPoints.put(new StringIgnoreCase(name), conf);
+                        }
+                    } catch (final Exception ex) {
+                        logger.log(Level.WARNING, tl("loadWarpError", filename), ex);
+                    }
+                }
+            }
+        }
+    }
 
-		public StringIgnoreCase(String string)
-		{
-			this.string = string;
-		}
+    /**
+     * @deprecated This method relates to the abandoned 3.x storage refactor and is not implemented.
+     */
+    @Override
+    @Deprecated
+    public File getWarpFile(final String name) throws InvalidNameException {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
 
-		@Override
-		public int hashCode()
-		{
-			return getString().toLowerCase(Locale.ENGLISH).hashCode();
-		}
+    @Override
+    public int getCount() {
+        return getList().size();
+    }
 
-		@Override
-		public boolean equals(Object o)
-		{
-			if (o instanceof StringIgnoreCase)
-			{
-				return getString().equalsIgnoreCase(((StringIgnoreCase)o).getString());
-			}
-			return false;
-		}
+    private static class StringIgnoreCase {
+        private final String string;
 
-		public String getString()
-		{
-			return string;
-		}
-	}
+        StringIgnoreCase(final String string) {
+            this.string = string;
+        }
+
+        @Override
+        public int hashCode() {
+            return getString().toLowerCase(Locale.ENGLISH).hashCode();
+        }
+
+        @Override
+        public boolean equals(final Object o) {
+            if (o instanceof StringIgnoreCase) {
+                return getString().equalsIgnoreCase(((StringIgnoreCase) o).getString());
+            }
+            return false;
+        }
+
+        public String getString() {
+            return string;
+        }
+    }
 }

Essentials/src/com/earth2me/essentials/Worth.java

@@ -1,66 +1,155 @@
 package com.earth2me.essentials;
 
+import com.earth2me.essentials.commands.NotEnoughArgumentsException;
+import com.earth2me.essentials.utils.VersionUtil;
+import org.bukkit.Material;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.inventory.ItemStack;
+
 import java.io.File;
 import java.math.BigDecimal;
 import java.util.Locale;
-import java.util.logging.Logger;
-import org.bukkit.inventory.ItemStack;
 
+import static com.earth2me.essentials.I18n.tl;
 
-public class Worth implements IConf
-{
-	private static final Logger logger = Logger.getLogger("Minecraft");
-	private final EssentialsConf config;
+public class Worth implements IConf {
+    private final EssentialsConf config;
 
-	public Worth(File dataFolder)
-	{
-		config = new EssentialsConf(new File(dataFolder, "worth.yml"));
-		config.setTemplateName("/worth.yml");
-		config.load();
-	}
+    public Worth(final File dataFolder) {
+        config = new EssentialsConf(new File(dataFolder, "worth.yml"));
+        config.setTemplateName("/worth.yml");
+        config.load();
+    }
 
-	public BigDecimal getPrice(ItemStack itemStack)
-	{
-		String itemname = itemStack.getType().toString().toLowerCase(Locale.ENGLISH).replace("_", "");
-		BigDecimal result;
-		result = config.getBigDecimal("worth." + itemname + "." + itemStack.getDurability(), BigDecimal.ONE.negate());
-		if (result.signum() < 0)
-		{
-			result = config.getBigDecimal("worth." + itemname + ".0", BigDecimal.ONE.negate());
-		}
-		if (result.signum() < 0)
-		{
-			result = config.getBigDecimal("worth." + itemname, BigDecimal.ONE.negate());
-		}
-		if (result.signum() < 0)
-		{
-			result = config.getBigDecimal("worth-" + itemStack.getTypeId(), BigDecimal.ONE.negate());
-		}
-		if (result.signum() < 0)
-		{
-			return null;
-		}
-		return result;
-	}
+    /**
+     * Get the value of an item stack from the config.
+     *
+     * @param ess       The Essentials instance.
+     * @param itemStack The item stack to look up in the config.
+     * @return The price from the config.
+     */
+    public BigDecimal getPrice(final IEssentials ess, final ItemStack itemStack) {
+        BigDecimal result;
 
-	public void setPrice(ItemStack itemStack, double price)
-	{
-		if (itemStack.getType().getData() == null)
-		{
-			config.setProperty("worth." + itemStack.getType().toString().toLowerCase(Locale.ENGLISH).replace("_", ""), price);
-		}
-		else
-		{
-			// Bukkit-bug: getDurability still contains the correct value, while getData().getData() is 0.
-			config.setProperty("worth." + itemStack.getType().toString().toLowerCase(Locale.ENGLISH).replace("_", "") + "." + itemStack.getDurability(), price);
-		}
-		config.removeProperty("worth-" + itemStack.getTypeId());
-		config.save();
-	}
+        final String itemname = itemStack.getType().toString().toLowerCase(Locale.ENGLISH).replace("_", "");
 
-	@Override
-	public void reloadConfig()
-	{
-		config.load();
-	}
+        // Check for matches with data value from stack
+        // Note that we always default to BigDecimal.ONE.negate(), equivalent to -1
+        result = config.getBigDecimal("worth." + itemname + "." + itemStack.getDurability(), BigDecimal.ONE.negate());
+
+        // Check for matches with data value 0
+        if (result.signum() < 0) {
+            final ConfigurationSection itemNameMatch = config.getConfigurationSection("worth." + itemname);
+            if (itemNameMatch != null && itemNameMatch.getKeys(false).size() == 1) {
+                result = config.getBigDecimal("worth." + itemname + ".0", BigDecimal.ONE.negate());
+            }
+        }
+
+        // Check for matches with data value wildcard
+        if (result.signum() < 0) {
+            result = config.getBigDecimal("worth." + itemname + ".*", BigDecimal.ONE.negate());
+        }
+
+        // Check for matches with item name alone
+        if (result.signum() < 0) {
+            result = config.getBigDecimal("worth." + itemname, BigDecimal.ONE.negate());
+        }
+
+        if (result.signum() < 0) {
+            return null;
+        }
+        return result;
+    }
+
+    /**
+     * Get the amount of items to be sold from a player's inventory.
+     *
+     * @param ess        The Essentials instance.
+     * @param user       The user attempting to sell the item.
+     * @param is         A stack of the item to search the inventory for.
+     * @param args       The amount to try to sell.
+     * @param isBulkSell Whether or not to try and bulk sell all items.
+     * @return The amount of items to sell from the player's inventory.
+     * @throws Exception Thrown if trying to sell air or an invalid amount.
+     */
+    public int getAmount(final IEssentials ess, final User user, final ItemStack is, final String[] args, final boolean isBulkSell) throws Exception {
+        if (is == null || is.getType() == Material.AIR) {
+            throw new Exception(tl("itemSellAir"));
+        }
+
+        int amount = 0;
+
+        if (args.length > 1) {
+            try {
+                amount = Integer.parseInt(args[1].replaceAll("[^0-9]", ""));
+            } catch (final NumberFormatException ex) {
+                throw new NotEnoughArgumentsException(ex);
+            }
+            if (args[1].startsWith("-")) {
+                amount = -amount;
+            }
+        }
+
+        final boolean stack = args.length > 1 && args[1].endsWith("s");
+        final boolean requireStack = ess.getSettings().isTradeInStacks(is.getType());
+
+        if (requireStack && !stack) {
+            throw new Exception(tl("itemMustBeStacked"));
+        }
+
+        int max = 0;
+        for (final ItemStack s : user.getBase().getInventory().getContents()) {
+            if (s == null || !s.isSimilar(is)) {
+                continue;
+            }
+            max += s.getAmount();
+        }
+
+        if (stack) {
+            amount *= is.getType().getMaxStackSize();
+        }
+        if (amount < 1) {
+            amount += max;
+        }
+
+        if (requireStack) {
+            amount -= amount % is.getType().getMaxStackSize();
+        }
+        if (amount > max || amount < 1) {
+            if (!isBulkSell) {
+                user.sendMessage(tl("itemNotEnough2"));
+                user.sendMessage(tl("itemNotEnough3"));
+                throw new Exception(tl("itemNotEnough1"));
+            } else {
+                return amount;
+            }
+        }
+
+        return amount;
+    }
+
+    /**
+     * Set the price of an item and save it to the config.
+     *
+     * @param ess       The Essentials instance.
+     * @param itemStack A stack of the item to save.
+     * @param price     The new price of the item.
+     */
+    public void setPrice(final IEssentials ess, final ItemStack itemStack, final double price) {
+        String path = "worth." + itemStack.getType().toString().toLowerCase(Locale.ENGLISH).replace("_", "");
+
+        // Spigot 1.13+ throws an exception if a 1.13+ plugin even *attempts* to do set data.
+        if (VersionUtil.getServerBukkitVersion().isLowerThan(VersionUtil.v1_13_0_R01) && itemStack.getType().getData() == null) {
+            // Bukkit-bug: getDurability still contains the correct value, while getData().getData() is 0.
+            path = path + "." + itemStack.getDurability();
+        }
+
+        config.setProperty(path, price);
+        config.save();
+    }
+
+    @Override
+    public void reloadConfig() {
+        config.load();
+    }
 }

Essentials/src/com/earth2me/essentials/api/IAsyncTeleport.java

@@ -0,0 +1,126 @@
+package com.earth2me.essentials.api;
+
+import com.earth2me.essentials.Trade;
+import net.ess3.api.IUser;
+import org.bukkit.Location;
+import org.bukkit.entity.Player;
+import org.bukkit.event.player.PlayerTeleportEvent;
+
+import java.util.concurrent.CompletableFuture;
+
+/**
+ * Manages EssentialsX's teleport functionality for a player.
+ * Use this if you want to access EssentialsX's async/safe teleport functionality and teleport warmups and cooldowns.
+ */
+public interface IAsyncTeleport {
+
+    /**
+     * Used to skip teleportPlayer delay when teleporting someone to a location or player.
+     *
+     * @param loc      - Where should the player end up
+     * @param cooldown - If cooldown should be enforced
+     * @param cause    - The reported teleportPlayer cause
+     * @param future   - Future which is completed with the success status of the execution
+     */
+    void now(Location loc, boolean cooldown, PlayerTeleportEvent.TeleportCause cause, CompletableFuture<Boolean> future);
+
+    /**
+     * Used to skip teleportPlayer delay when teleporting someone to a location or player.
+     *
+     * @param entity   - Where should the player end up
+     * @param cooldown - If cooldown should be enforced
+     * @param cause    - The reported teleportPlayer cause
+     * @param future   - Future which is completed with the success status of the execution
+     */
+    void now(Player entity, boolean cooldown, PlayerTeleportEvent.TeleportCause cause, CompletableFuture<Boolean> future);
+
+    /**
+     * Teleport a player to a specific location
+     *
+     * @param loc       - Where should the player end up
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause.
+     * @param future    - Future which is completed with the success status of the execution
+     */
+    void teleport(Location loc, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause, CompletableFuture<Boolean> future);
+
+    /**
+     * Teleport a player to a specific player
+     *
+     * @param entity    - Where should the player end up
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @param future    - Future which is completed with the success status of the execution
+     */
+    void teleport(Player entity, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause, CompletableFuture<Boolean> future);
+
+    /**
+     * Teleport a player to a specific location
+     *
+     * @param otherUser - Which user will be teleported
+     * @param loc       - Where should the player end up
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @param future    - Future which is completed with the success status of the execution
+     */
+    void teleportPlayer(IUser otherUser, Location loc, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause, CompletableFuture<Boolean> future);
+
+    /**
+     * Teleport a player to a specific player
+     *
+     * @param otherUser - Which user will be teleported
+     * @param entity    - Where should the player end up
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @param future    - Future which is completed with the success status of the execution
+     */
+    void teleportPlayer(IUser otherUser, Player entity, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause, CompletableFuture<Boolean> future);
+
+    /**
+     * Teleport wrapper used to handle tp fallback on /jail and /home
+     *
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @param future    - Future which is completed with the success status of the execution
+     */
+    void respawn(final Trade chargeFor, PlayerTeleportEvent.TeleportCause cause, CompletableFuture<Boolean> future);
+
+    /**
+     * Teleport wrapper used to handle /warp teleports
+     *
+     * @param otherUser - Which user will be teleported
+     * @param warp      - The name of the warp the user will be teleported too.
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @param future    - Future which is completed with the success status of the execution
+     */
+    void warp(IUser otherUser, String warp, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause, CompletableFuture<Boolean> future);
+
+    /**
+     * Teleport wrapper used to handle /back teleports
+     *
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param future    - Future which is completed with the success status of the execution
+     */
+    void back(Trade chargeFor, CompletableFuture<Boolean> future);
+
+    /**
+     * Teleport wrapper used to handle /back teleports that
+     * are executed by a different player with this
+     * instance of teleport as a target.
+     *
+     * @param teleporter - The user performing the /back command.
+     *                   This value may be {@code null} to indicate console.
+     * @param chargeFor  - What the {@code teleporter} will be charged if teleportPlayer is successful
+     * @param future     - Future which is completed with the success status of the execution
+     */
+    void back(IUser teleporter, Trade chargeFor, CompletableFuture<Boolean> future);
+
+    /**
+     * Teleport wrapper used to handle throwing user home after a jail sentence
+     *
+     * @param future - Future which is completed with the success status of the execution
+     */
+    void back(CompletableFuture<Boolean> future);
+
+}

Essentials/src/com/earth2me/essentials/api/II18n.java

@@ -1,13 +1,21 @@
 package com.earth2me.essentials.api;
 
+import org.bukkit.entity.Player;
+
 import java.util.Locale;
 
-
-public interface II18n
-{
-	/**
-	 * Gets the current locale setting
-	 * @return the current locale, if not set it will return the default locale
-	 */
-	Locale getCurrentLocale();
+/**
+ * Provides access to the current locale in use.
+ *
+ * @deprecated External plugins should prefer to use either the player's client language ({@link Player#getLocale()} or
+ *             {@link net.ess3.api.II18n} in case of future additions.
+ */
+@Deprecated
+public interface II18n {
+    /**
+     * Gets the current locale setting
+     *
+     * @return the current locale, if not set it will return the default locale
+     */
+    Locale getCurrentLocale();
 }

Essentials/src/com/earth2me/essentials/api/IItemDb.java

@@ -1,11 +1,171 @@
 package com.earth2me.essentials.api;
 
+import com.earth2me.essentials.User;
+import com.earth2me.essentials.utils.MaterialUtil;
+import com.earth2me.essentials.utils.NumberUtil;
+import com.earth2me.essentials.utils.StringUtil;
+import org.bukkit.Material;
 import org.bukkit.inventory.ItemStack;
 
+import java.util.Collection;
+import java.util.List;
+import java.util.Locale;
 
-public interface IItemDb
-{
-	ItemStack get(final String name, final int quantity) throws Exception;
+/**
+ * Provides access to the current item alias registry.
+ *
+ * @deprecated External plugins should use {@link net.ess3.api.IItemDb} instead, which includes access to {@link net.ess3.api.IItemDb.ItemResolver}
+ *             APIs.
+ */
+@Deprecated
+public interface IItemDb {
 
-	ItemStack get(final String name) throws Exception;
+    /**
+     * Create a stack from the given name with the given quantity.
+     *
+     * @param name     Item name to look up in the database
+     * @param quantity Quantity of the item stack
+     * @return The requested item stack
+     * @throws Exception if the item stack cannot be created
+     */
+    default ItemStack get(final String name, final int quantity) throws Exception {
+        final ItemStack stack = get(name.toLowerCase(Locale.ENGLISH));
+        stack.setAmount(quantity);
+        return stack;
+    }
+
+    /**
+     * Create a stack from the given name with the maximum stack size for that material.
+     * <p>
+     * Note that this will always check against resolver functions from other plugins as well.
+     * To avoid this behaviour, use net.ess3.api.IItemDb#get(String name, boolean useResolvers).
+     *
+     * @param name Item name to look up in the database
+     * @return The requested item stack with the maximum stack size
+     * @throws Exception if the item stack cannot be created
+     */
+    ItemStack get(final String name) throws Exception;
+
+    /**
+     * Get a comma-separated string list of up to 15 aliases for the given stack.
+     *
+     * @param item Item stack whose names to find
+     * @return Comma-separated list of up to 15 item names
+     */
+    default String names(final ItemStack item) {
+        List<String> nameList = nameList(item);
+
+        if (nameList.size() > 15) {
+            nameList = nameList.subList(0, 14);
+        }
+        return StringUtil.joinList(", ", nameList);
+    }
+
+    /**
+     * Get a List of all aliases for the given item stack.
+     *
+     * @param item Item stack whose names to find
+     * @return List of all names
+     */
+    List<String> nameList(ItemStack item);
+
+    /**
+     * Get the primary name for the given item stack.
+     *
+     * @param item Item stack whose name to find
+     * @return Primary name of the item
+     */
+    String name(ItemStack item);
+
+    /**
+     * Get all stacks in a given User's inventory that matches the given arguments.
+     *
+     * @param user The user with the player inventory to search
+     * @param args Either an item name, or one of the following:
+     *             hand (default), inventory/invent/all, blocks
+     * @return A List of all matching ItemStacks
+     * @throws Exception if the given args are invalid or no blocks are found
+     */
+    List<ItemStack> getMatching(User user, String[] args) throws Exception;
+
+    /**
+     * Converts the given {@link ItemStack} to a string representation that can be saved.
+     * This is typically used for /createkit but can be used by other plugins for various purposes too.
+     * Note that this will try registered resolvers first - to avoid this, use {@link net.ess3.api.IItemDb#serialize(ItemStack, boolean)} instead.
+     *
+     * @param is The stack to serialize
+     * @return A string representing the given stack
+     */
+    String serialize(ItemStack is);
+
+    /**
+     * Return names recognised by the database, intended for tab-completion.
+     *
+     * @return Collection of all item names
+     */
+    Collection<String> listNames();
+
+    /**
+     * Get the material matching the given legacy ID. Used for conversion from item IDs to
+     * modern names.
+     *
+     * @param id Legacy ID of material to find
+     * @return Updated material
+     */
+    @Deprecated
+    default Material getFromLegacyId(final int id) {
+        return getFromLegacy(id, (byte) 0);
+    }
+
+    /**
+     * Get the legacy ID for the given material.
+     *
+     * @param material Material to look up
+     * @return Legacy ID of given material
+     * @throws Exception if the ID cannot be looked up
+     * @deprecated Item IDs are no longer supported.
+     */
+    @Deprecated
+    int getLegacyId(Material material) throws Exception;
+
+    /**
+     * Convert colon syntax (eg. "13", "1:5") legacy IDs to Material. Used for conversion from
+     * item IDs to modern names.
+     *
+     * @param item Legacy ID in colon syntax.
+     * @return Material if an appropriate material exists, else null.
+     */
+    default Material getFromLegacy(final String item) {
+        final String[] split = item.split(":");
+
+        if (!NumberUtil.isInt(split[0])) return null;
+
+        final int id = Integer.parseInt(split[0]);
+        byte damage = 0;
+
+        if (split.length > 1 && NumberUtil.isInt(split[1])) {
+            damage = Byte.parseByte(split[1]);
+        }
+
+        return getFromLegacy(id, damage);
+    }
+
+    /**
+     * Convert legacy ID and damage value to Material. Used for conversion from item IDs to
+     * modern names.
+     *
+     * @param id     Legacy ID
+     * @param damage Damage value
+     * @return Material
+     */
+    default Material getFromLegacy(final int id, final byte damage) {
+        return MaterialUtil.convertFromLegacy(id, damage);
+    }
+
+    /**
+     * Check whether the item database is loaded and ready for use.
+     *
+     * @return Whether items have finished loading
+     */
+    boolean isReady();
 }

Essentials/src/com/earth2me/essentials/api/IJails.java

@@ -1,52 +1,77 @@
 package com.earth2me.essentials.api;
 
-import java.util.Collection;
+import net.ess3.api.IUser;
 import org.bukkit.Location;
 
+import java.util.Collection;
+import java.util.concurrent.CompletableFuture;
 
-public interface IJails extends IReload
-{
-	/**
-	 * Gets the location of the jail with the given name
-	 * @param jailName The name of the jail
-	 * @return the location of the jail
-	 * @throws Exception if the jail does not exist
-	 */
-	Location getJail(String jailName) throws Exception;
+/**
+ * Provides access to the storage of jail locations. Maintainers should add methods to <i>this interface</i>.
+ *
+ * @deprecated External plugins should use {@link net.ess3.api.IJails} instead of this interface in case future APIs are added.
+ */
+@Deprecated
+public interface IJails extends IReload {
+    /**
+     * Gets the location of the jail with the given name
+     *
+     * @param jailName The name of the jail
+     * @return the location of the jail
+     * @throws Exception if the jail does not exist
+     */
+    Location getJail(String jailName) throws Exception;
 
-	/**
-	 * Gets a list of jails by names
-	 * @return a list of jails, if there are none the list will be empty
-	 * @throws Exception
-	 */
-	Collection<String> getList() throws Exception;
+    /**
+     * Gets a list of jails by names
+     *
+     * @return a list of jails, if there are none the list will be empty
+     * @throws Exception
+     */
+    Collection<String> getList() throws Exception;
 
-	/**
-	 * Gets the number of jails
-	 * @return the size of the list of jails
-	 */
-	int getCount();
+    /**
+     * Gets the number of jails
+     *
+     * @return the size of the list of jails
+     */
+    int getCount();
 
-	/**
-	 * Remove the jail with the given name
-	 * @param jail the jail to remove
-	 * @throws Exception if the jail does not exist
-	 */
-	void removeJail(String jail) throws Exception;
+    /**
+     * Remove the jail with the given name
+     *
+     * @param jail the jail to remove
+     * @throws Exception if the jail does not exist
+     */
+    void removeJail(String jail) throws Exception;
 
-	/**
-	 * Attempts to send the given user to the given jail
-	 * @param user the user to send to jail
-	 * @param jail the jail to send the user to
-	 * @throws Exception if the user is offline or jail does not exist
-	 */
-	void sendToJail(com.earth2me.essentials.IUser user, String jail) throws Exception;
+    /**
+     * Attempts to send the given user to the given jail
+     *
+     * @param user the user to send to jail
+     * @param jail the jail to send the user to
+     * @throws Exception if the user is offline or jail does not exist
+     * @deprecated Use {@link IJails#sendToJail(IUser, String, CompletableFuture)}
+     */
+    @Deprecated
+    void sendToJail(IUser user, String jail) throws Exception;
 
-	/**
-	 * Set a new jail with the given name and location
-	 * @param jailName the name of the jail being set
-	 * @param loc the location of the jail being set
-	 * @throws Exception
-	 */
-	void setJail(String jailName, Location loc) throws Exception;
+    /**
+     * Attempts to send the given user to the given jail
+     *
+     * @param user   the user to send to jail
+     * @param jail   the jail to send the user to
+     * @param future Future which is completed with the success status of the execution
+     * @throws Exception if the user is offline or jail does not exist
+     */
+    void sendToJail(IUser user, String jail, CompletableFuture<Boolean> future) throws Exception;
+
+    /**
+     * Set a new jail with the given name and location
+     *
+     * @param jailName the name of the jail being set
+     * @param loc      the location of the jail being set
+     * @throws Exception
+     */
+    void setJail(String jailName, Location loc) throws Exception;
 }

Essentials/src/com/earth2me/essentials/api/IReload.java

@@ -1,7 +1,15 @@
 package com.earth2me.essentials.api;
 
-
-public interface IReload
-{
-	void onReload();
+/**
+ * Represents a storage object that is reloadable.
+ *
+ * @deprecated This is a remnant of the abandoned 3.x storage system. Neither future 2.x code nor external plugins
+ *             should use this interface.
+ */
+@Deprecated
+public interface IReload {
+    /**
+     * Reloads the given storage object.
+     */
+    void onReload();
 }

Essentials/src/com/earth2me/essentials/api/ITeleport.java

@@ -1,130 +1,143 @@
 package com.earth2me.essentials.api;
 
-import com.earth2me.essentials.IUser;
 import com.earth2me.essentials.Trade;
+import net.ess3.api.IUser;
 import org.bukkit.Location;
 import org.bukkit.entity.Player;
-import org.bukkit.event.player.PlayerTeleportEvent.TeleportCause;
+import org.bukkit.event.player.PlayerTeleportEvent;
 
+/**
+ * @deprecated This API is not asynchronous and is no longer maintained. Use {@link com.earth2me.essentials.api.IAsyncTeleport IAsyncTeleport}.
+ */
+public interface ITeleport {
+    /**
+     * Used to skip teleportPlayer delay when teleporting someone to a location or player.
+     *
+     * @param loc      - Where should the player end up
+     * @param cooldown - If cooldown should be enforced
+     * @param cause    - The reported teleportPlayer cause
+     * @throws Exception
+     */
+    @Deprecated
+    void now(Location loc, boolean cooldown, PlayerTeleportEvent.TeleportCause cause) throws Exception;
 
-public interface ITeleport
-{		
-	/**
-	 * Used to skip teleportPlayer delay when teleporting someone to a location or player.
-	 *
-	 * @param loc - Where should the player end up
-	 * @param cooldown - If cooldown should be enforced
-	 * @param cause - The reported teleportPlayer cause
-	 * @throws Exception
-	 */
-	void now(Location loc, boolean cooldown, TeleportCause cause) throws Exception;
+    /**
+     * Used to skip teleportPlayer delay when teleporting someone to a location or player.
+     *
+     * @param entity   - Where should the player end up
+     * @param cooldown - If cooldown should be enforced
+     * @param cause    - The reported teleportPlayer cause
+     * @throws Exception
+     */
+    @Deprecated
+    void now(Player entity, boolean cooldown, PlayerTeleportEvent.TeleportCause cause) throws Exception;
 
-	/**
-	 * Used to skip teleportPlayer delay when teleporting someone to a location or player.
-	 *
-	 * @param entity - Where should the player end up
-	 * @param cooldown - If cooldown should be enforced
-	 * @param cause - The reported teleportPlayer cause
-	 * @throws Exception
-	 */
-	void now(Player entity, boolean cooldown, TeleportCause cause) throws Exception;
+    /**
+     * Teleport a player to a specific location
+     *
+     * @param loc       - Where should the player end up
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @throws Exception
+     */
+    @Deprecated
+    void teleport(Location loc, Trade chargeFor) throws Exception;
 
-	@Deprecated
-	void teleport(Location loc, Trade chargeFor) throws Exception;
-	
-	/**
-	 * Teleport a player to a specific location
-	 *
-	 * @param loc - Where should the player end up
-	 * @param chargeFor - What the user will be charged if teleportPlayer is successful
-	 * @param cause - The reported teleportPlayer cause
-	 * @throws Exception
-	 */
-	void teleport(Location loc, Trade chargeFor, TeleportCause cause) throws Exception;
+    /**
+     * Teleport a player to a specific location
+     *
+     * @param loc       - Where should the player end up
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @throws Exception
+     */
+    @Deprecated
+    void teleport(Location loc, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause) throws Exception;
 
-	/**
-	 * Teleport a player to a specific player
-	 *
-	 * @param entity - Where should the player end up
-	 * @param chargeFor - What the user will be charged if teleportPlayer is successful
-	 * @param cause - The reported teleportPlayer cause
-	 * @throws Exception
-	 */
-	void teleport(Player entity, Trade chargeFor, TeleportCause cause) throws Exception;
-	
-		/**
-	 * Teleport a player to a specific location
-	 *
-	 * @param otherUser - Which user will be teleported
-	 * @param loc - Where should the player end up
-	 * @param chargeFor - What the user will be charged if teleportPlayer is successful
-	 * @param cause - The reported teleportPlayer cause
-	 * @throws Exception
-	 */
-	void teleportPlayer(IUser otherUser, Location loc, Trade chargeFor, TeleportCause cause) throws Exception;
+    /**
+     * Teleport a player to a specific player
+     *
+     * @param entity    - Where should the player end up
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @throws Exception
+     */
+    @Deprecated
+    void teleport(Player entity, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause) throws Exception;
 
-	/**
-	 * Teleport a player to a specific player
-	 *
-	 * @param otherUser - Which user will be teleported
-	 * @param entity - Where should the player end up
-	 * @param chargeFor - What the user will be charged if teleportPlayer is successful
-	 * @param cause - The reported teleportPlayer cause
-	 * @throws Exception
-	 */
-	void teleportPlayer(IUser otherUser, Player entity, Trade chargeFor, TeleportCause cause) throws Exception;
+    /**
+     * Teleport a player to a specific location
+     *
+     * @param otherUser - Which user will be teleported
+     * @param loc       - Where should the player end up
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @throws Exception
+     */
+    @Deprecated
+    void teleportPlayer(IUser otherUser, Location loc, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause) throws Exception;
 
-	/**
-	 * Teleport wrapper used to handle teleporting players to them, like /tphere
-	 *
-	 * @param otherUser - Which user will be teleported
-	 * @param chargeFor - What the user will be charged if teleportPlayer is successful
-	 * @param cause - The reported teleportPlayer cause
-	 * @throws Exception
-	 */
-	public void teleportToMe(IUser otherUser, Trade chargeFor, TeleportCause cause) throws Exception;
+    /**
+     * Teleport a player to a specific player
+     *
+     * @param otherUser - Which user will be teleported
+     * @param entity    - Where should the player end up
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @throws Exception
+     */
+    @Deprecated
+    void teleportPlayer(IUser otherUser, Player entity, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause) throws Exception;
 
-	/**
-	 * Teleport wrapper used to handle tp fallback on /jail and /home
-	 *
-	 * @param chargeFor - What the user will be charged if teleportPlayer is successful
-	 * @param cause - The reported teleportPlayer cause
-	 * @throws Exception
-	 */
-	public void respawn(final Trade chargeFor, TeleportCause cause) throws Exception;
+    /**
+     * Teleport wrapper used to handle tp fallback on /jail and /home
+     *
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @throws Exception
+     */
+    @Deprecated
+    void respawn(final Trade chargeFor, PlayerTeleportEvent.TeleportCause cause) throws Exception;
 
-	/**
-	 * Teleport wrapper used to handle /warp teleports
-	 *
-	 * @param otherUser - Which user will be teleported
-	 * @param warp - The name of the warp the user will be teleported too.
-	 * @param chargeFor - What the user will be charged if teleportPlayer is successful
-	 * @param cause - The reported teleportPlayer cause
-	 * @throws Exception
-	 */
-	public void warp(IUser otherUser, String warp, Trade chargeFor, TeleportCause cause) throws Exception;
+    /**
+     * Teleport wrapper used to handle /warp teleports
+     *
+     * @param otherUser - Which user will be teleported
+     * @param warp      - The name of the warp the user will be teleported too.
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @param cause     - The reported teleportPlayer cause
+     * @throws Exception
+     */
+    @Deprecated
+    void warp(IUser otherUser, String warp, Trade chargeFor, PlayerTeleportEvent.TeleportCause cause) throws Exception;
 
-	/**
-	 * Teleport wrapper used to handle /back teleports
-	 *
-	 * @param chargeFor - What the user will be charged if teleportPlayer is successful
-	 * @throws Exception
-	 */
-	public void back(Trade chargeFor) throws Exception;
+    /**
+     * Teleport wrapper used to handle /back teleports
+     *
+     * @param chargeFor - What the user will be charged if teleportPlayer is successful
+     * @throws Exception
+     */
+    @Deprecated
+    void back(Trade chargeFor) throws Exception;
 
-	/**
-	 * Teleport wrapper used to handle throwing user home after a jail sentence
-	 *
-	 * @throws Exception
-	 */
-	public void back() throws Exception;
+    /**
+     * Teleport wrapper used to handle /back teleports that
+     * are executed by a different player with this
+     * instance of teleport as a target.
+     *
+     * @param teleporter - The user performing the /back command.
+     *                   This value may be {@code null} to indicate console.
+     * @param chargeFor  - What the {@code teleporter} will be charged if teleportPlayer is successful
+     * @throws Exception
+     */
+    @Deprecated
+    void back(IUser teleporter, Trade chargeFor) throws Exception;
+
+    /**
+     * Teleport wrapper used to handle throwing user home after a jail sentence
+     *
+     * @throws Exception
+     */
+    @Deprecated
+    void back() throws Exception;
 
-	/**
-	 * Teleport wrapper used to handle /home teleports
-	 *
-	 * @param loc - Location where player will be teleported too
-	 * @param chargeFor - What the user will be charged if teleportPlayer is successful
-	 * @throws Exception
-	 */
-	public void home(Location loc, Trade chargeFor) throws Exception;
 }

Essentials/src/com/earth2me/essentials/api/IWarps.java

@@ -1,69 +1,90 @@
 package com.earth2me.essentials.api;
 
 import com.earth2me.essentials.IConf;
-import java.io.File;
-import java.util.Collection;
-
+import com.earth2me.essentials.IUser;
 import com.earth2me.essentials.commands.WarpNotFoundException;
 import org.bukkit.Location;
 
+import java.io.File;
+import java.util.Collection;
+import java.util.UUID;
 
-public interface IWarps extends IConf
-{
-	/**
-	 * Get a warp by name
-	 *
-	 * @param warp - Warp name
-	 * @return - Location the warp is set to
-	 * @throws WarpNotFoundException When the warp is not found
-	 * @throws InvalidWorldException When the world the warp is in is not found
-	 */
-	Location getWarp(String warp) throws WarpNotFoundException, InvalidWorldException;
+/**
+ * Provides access to the storage of warp locations. Maintainers should add methods to <i>this interface</i>.
+ *
+ * @deprecated External plugins should use {@link net.ess3.api.IWarps} instead of this interface, in case future APIs are added.
+ */
+@Deprecated
+public interface IWarps extends IConf {
+    /**
+     * Get a warp by name
+     *
+     * @param warp - Warp name
+     * @return - Location the warp is set to
+     * @throws WarpNotFoundException When the warp is not found
+     * @throws net.ess3.api.InvalidWorldException When the world the warp is in is not found
+     */
+    Location getWarp(String warp) throws WarpNotFoundException, net.ess3.api.InvalidWorldException;
 
-	/**
-	 * Gets a list of warps
-	 *
-	 * @return - A {@link Collection} of warps
-	 */
-	Collection<String> getList();
+    /**
+     * Gets a list of warps
+     *
+     * @return - A {@link Collection} of warps
+     */
+    Collection<String> getList();
 
-	/**
-	 * Gets the number of warps
-	 *
-	 * @return the size of the list of warps
-	 */
-	int getCount();
+    /**
+     * Gets the number of warps
+     *
+     * @return the size of the list of warps
+     */
+    int getCount();
 
-	/**
-	 * Delete a warp from the warp DB
-	 *
-	 * @param name - Name of warp
-	 * @throws Exception
-	 */
-	void removeWarp(String name) throws Exception;
+    /**
+     * Delete a warp from the warp DB
+     *
+     * @param name - Name of warp
+     * @throws Exception
+     */
+    void removeWarp(String name) throws Exception;
 
-	/**
-	 * Set a warp
-	 *
-	 * @param name - Name of warp
-	 * @param loc - Location of warp
-	 * @throws Exception
-	 */
-	void setWarp(String name, Location loc) throws Exception;
+    /**
+     * Set a warp
+     *
+     * @param name - Name of warp
+     * @param loc  - Location of warp
+     * @throws Exception
+     */
+    void setWarp(String name, Location loc) throws Exception;
 
-	/**
-	 * Check to see if the file is empty
-	 *
-	 * @return
-	 */
-	boolean isEmpty();
+    /**
+     * Set a warp
+     *
+     * @param user - User of warp
+     * @param name - Name of warp
+     * @param loc  - Location of warp
+     * @throws Exception
+     */
+    void setWarp(IUser user, String name, Location loc) throws Exception;
 
-	/**
-	 * Get a warp file note: this is not yet implemented, as 3.x uses different storage methods
-	 *
-	 * @param name - name of file
-	 * @return - an instance of the file
-	 * @throws InvalidNameException - When the file is not found
-	 */
-	File getWarpFile(String name) throws InvalidNameException;
+    /**
+     * Gets Lastowner UUID
+     *
+     * @param warp - Name of warp
+     * @throws WarpNotFoundException
+     */
+    UUID getLastOwner(String warp) throws WarpNotFoundException;
+
+    /**
+     * Check to see if the file is empty
+     *
+     * @return
+     */
+    boolean isEmpty();
+
+    /**
+     * @deprecated This method relates to the abandoned 3.x storage refactor and is not implemented.
+     */
+    @Deprecated
+    File getWarpFile(String name) throws net.ess3.api.InvalidNameException;
 }

Essentials/src/com/earth2me/essentials/api/InvalidNameException.java

@@ -1,16 +1,17 @@
 package com.earth2me.essentials.api;
 
+/**
+ * @deprecated This exception relates to the abandoned 3.x storage refactor and is not implemented.
+ */
+@Deprecated
+public class InvalidNameException extends Exception {
+    /**
+     * NOTE: This is not implemented yet, just here for future 3.x api support Allow serialization of the
+     * InvalidNameException exception
+     */
+    private static final long serialVersionUID = 1485321420293663139L;
 
-public class InvalidNameException extends Exception
-{
-	/**
-	 * NOTE: This is not implemented yet, just here for future 3.x api support
-	 * Allow serialization of the InvalidNameException exception
-	 */
-	private static final long serialVersionUID = 1485321420293663139L;
-
-	public InvalidNameException(Throwable thrwbl)
-	{
-		super(thrwbl);
-	}
+    public InvalidNameException(final Throwable thrwbl) {
+        super(thrwbl);
+    }
 }

Essentials/src/com/earth2me/essentials/api/InvalidWorldException.java

@@ -1,20 +1,20 @@
 package com.earth2me.essentials.api;
 
-import static com.earth2me.essentials.I18n._;
+import static com.earth2me.essentials.I18n.tl;
 
+/**
+ * @deprecated This exception is unused. Use {@link net.ess3.api.InvalidWorldException} instead.
+ */
+@Deprecated
+public class InvalidWorldException extends Exception {
+    private final String world;
 
-public class InvalidWorldException extends Exception
-{
-	private final String world;
+    public InvalidWorldException(final String world) {
+        super(tl("invalidWorld"));
+        this.world = world;
+    }
 
-	public InvalidWorldException(final String world)
-	{
-		super(_("invalidWorld"));
-		this.world = world;
-	}
-
-	public String getWorld()
-	{
-		return this.world;
-	}
+    public String getWorld() {
+        return this.world;
+    }
 }

Essentials/src/com/earth2me/essentials/api/NoLoanPermittedException.java

@@ -1,12 +1,8 @@
 package com.earth2me.essentials.api;
 
-import static com.earth2me.essentials.I18n._;
+/**
+ * Thrown when a user does not have the balance for a transaction and cannot take a loan.
+ */
+public class NoLoanPermittedException extends net.ess3.api.NoLoanPermittedException {
 
-
-public class NoLoanPermittedException extends Exception
-{
-	public NoLoanPermittedException()
-	{
-		super(_("negativeBalanceError"));
-	}
 }

Essentials/src/com/earth2me/essentials/api/UserDoesNotExistException.java

@@ -1,12 +1,18 @@
 package com.earth2me.essentials.api;
 
-import static com.earth2me.essentials.I18n._;
+import java.util.UUID;
 
+import static com.earth2me.essentials.I18n.tl;
 
-public class UserDoesNotExistException extends Exception
-{
-	public UserDoesNotExistException(String name)
-	{
-		super(_("userDoesNotExist", name));
-	}
+/**
+ * Thrown when the requested user does not exist.
+ */
+public class UserDoesNotExistException extends Exception {
+    public UserDoesNotExistException(final String name) {
+        super(tl("userDoesNotExist", name));
+    }
+
+    public UserDoesNotExistException(final UUID uuid) {
+        super(tl("uuidDoesNotExist", uuid.toString()));
+    }
 }

Essentials/src/com/earth2me/essentials/commands/Commandafk.java

@@ -1,71 +1,101 @@
 package com.earth2me.essentials.commands;
 
-import static com.earth2me.essentials.I18n._;
+import com.earth2me.essentials.CommandSource;
 import com.earth2me.essentials.User;
-import org.bukkit.command.CommandSender;
+import com.earth2me.essentials.utils.DateUtil;
+import net.ess3.api.events.AfkStatusChangeEvent;
 import org.bukkit.Server;
 
+import java.util.Collections;
+import java.util.List;
 
-public class Commandafk extends EssentialsCommand
-{
-	public Commandafk()
-	{
-		super("afk");
-	}
+import static com.earth2me.essentials.I18n.tl;
 
-	@Override
-	public void run(Server server, User user, String commandLabel, String[] args) throws Exception
-	{
-		if (args.length > 0 && user.isAuthorized("essentials.afk.others"))
-		{
-			User afkUser = getPlayer(server, user, args, 0);
-			toggleAfk(afkUser);
-		}
-		else
-		{
-			toggleAfk(user);
-		}
-	}
-	
-	@Override
-	public void run(Server server, CommandSender sender, String commandLabel, String[] args) throws Exception
-	{
-		if (args.length > 0)
-		{
-			User afkUser = getPlayer(server, args, 0, true, false);
-			toggleAfk(afkUser);
-		}
-		else
-		{
-			throw new NotEnoughArgumentsException();
-		}
-	}
+public class Commandafk extends EssentialsCommand {
+    public Commandafk() {
+        super("afk");
+    }
 
-	private void toggleAfk(User user)
-	{
-		user.setDisplayNick();
-		String msg = "";
-		if (!user.toggleAfk())
-		{
-			//user.sendMessage(_("markedAsNotAway"));
-			if (!user.isHidden())
-			{
-				msg = _("userIsNotAway", user.getDisplayName());
-			}
-			user.updateActivity(false);
-		}
-		else
-		{
-			//user.sendMessage(_("markedAsAway"));
-			if (!user.isHidden())
-			{
-				msg = _("userIsAway", user.getDisplayName());
-			}
-		}
-		if (!msg.isEmpty())
-		{
-			ess.broadcastMessage(user, msg);
-		}
-	}
+    @Override
+    public void run(final Server server, final User user, final String commandLabel, final String[] args) throws Exception {
+        if (args.length > 0 && user.isAuthorized("essentials.afk.others")) {
+            User afkUser = user; // if no player found, but message specified, set command executor to target user
+            String message;
+            try {
+                afkUser = getPlayer(server, user, args, 0);
+                message = args.length > 1 ? getFinalArg(args, 1) : null;
+            } catch (final PlayerNotFoundException e) {
+                message = getFinalArg(args, 0);
+            }
+            toggleAfk(user, afkUser, message);
+        } else {
+            final String message = args.length > 0 ? getFinalArg(args, 0) : null;
+            toggleAfk(user, user, message);
+        }
+    }
+
+    @Override
+    public void run(final Server server, final CommandSource sender, final String commandLabel, final String[] args) throws Exception {
+        if (args.length > 0) {
+            final User afkUser = getPlayer(server, args, 0, true, false);
+            final String message = args.length > 1 ? getFinalArg(args, 1) : null;
+            toggleAfk(null, afkUser, message);
+        } else {
+            throw new NotEnoughArgumentsException();
+        }
+    }
+
+    private void toggleAfk(final User sender, final User user, final String message) throws Exception {
+        if (message != null && sender != null) {
+            if (sender.isMuted()) {
+                final String dateDiff = sender.getMuteTimeout() > 0 ? DateUtil.formatDateDiff(sender.getMuteTimeout()) : null;
+                if (dateDiff == null) {
+                    throw new Exception(sender.hasMuteReason() ? tl("voiceSilencedReason", sender.getMuteReason()) : tl("voiceSilenced"));
+                }
+                throw new Exception(sender.hasMuteReason() ? tl("voiceSilencedReasonTime", dateDiff, sender.getMuteReason()) : tl("voiceSilencedTime", dateDiff));
+            }
+            if (!sender.isAuthorized("essentials.afk.message")) {
+                throw new Exception(tl("noPermToAFKMessage"));
+            }
+        }
+        user.setDisplayNick();
+        String msg = "";
+        String selfmsg = "";
+        if (!user.toggleAfk(AfkStatusChangeEvent.Cause.COMMAND)) {
+            if (!user.isHidden()) {
+                msg = tl("userIsNotAway", user.getDisplayName());
+                selfmsg = tl("userIsNotAwaySelf", user.getDisplayName());
+            }
+            user.updateActivity(false, AfkStatusChangeEvent.Cause.COMMAND);
+        } else {
+            if (!user.isHidden()) {
+                if (message != null) {
+                    msg = tl("userIsAwayWithMessage", user.getDisplayName(), message);
+                    selfmsg = tl("userIsAwaySelfWithMessage", user.getDisplayName(), message);
+                } else {
+                    msg = tl("userIsAway", user.getDisplayName());
+                    selfmsg = tl("userIsAwaySelf", user.getDisplayName());
+                }
+            }
+            user.setAfkMessage(message);
+        }
+        if (!msg.isEmpty() && ess.getSettings().broadcastAfkMessage()) {
+            // exclude user from receiving general AFK announcement in favor of personal message
+            ess.broadcastMessage(user, msg, u -> u == user);
+        }
+        if (!selfmsg.isEmpty()) {
+            user.sendMessage(selfmsg);
+        }
+        user.setDisplayNick(); // Set this again after toggling
+    }
+
+    @Override
+    protected List<String> getTabCompleteOptions(final Server server, final CommandSource sender, final String commandLabel, final String[] args) {
+        if (args.length == 1 && sender.isAuthorized("essentials.afk.others", ess)) {
+            return getPlayers(server, sender);
+        } else {
+            return Collections.emptyList();
+        }
+    }
 }
 

Essentials/src/com/earth2me/essentials/commands/Commandantioch.java

@@ -7,23 +7,19 @@ import org.bukkit.Server;
 import org.bukkit.entity.TNTPrimed;
 
 // This command has a in theme message that only shows if you supply a parameter #EasterEgg
-public class Commandantioch extends EssentialsCommand
-{
-	public Commandantioch()
-	{
-		super("antioch");
-	}
+public class Commandantioch extends EssentialsCommand {
+    public Commandantioch() {
+        super("antioch");
+    }
 
-	@Override
-	public void run(final Server server, final User user, final String commandLabel, final String[] args) throws Exception
-	{
-		if (args.length > 0)
-		{
-			ess.broadcastMessage(user, "...lobbest thou thy Holy Hand Grenade of Antioch towards thy foe,");
-			ess.broadcastMessage(user, "who being naughty in My sight, shall snuff it.");
-		}
+    @Override
+    public void run(final Server server, final User user, final String commandLabel, final String[] args) throws Exception {
+        if (args.length > 0) {
+            ess.broadcastMessage(user, "...lobbest thou thy Holy Hand Grenade of Antioch towards thy foe,");
+            ess.broadcastMessage(user, "who being naughty in My sight, shall snuff it.");
+        }
 
-		final Location loc = LocationUtil.getTarget(user);
-		loc.getWorld().spawn(loc, TNTPrimed.class);
-	}
+        final Location loc = LocationUtil.getTarget(user.getBase());
+        loc.getWorld().spawn(loc, TNTPrimed.class);
+    }
 }

Essentials/src/com/earth2me/essentials/commands/Commandanvil.java

@@ -0,0 +1,23 @@
+package com.earth2me.essentials.commands;
+
+import com.earth2me.essentials.User;
+import org.bukkit.Server;
+
+import static com.earth2me.essentials.I18n.tl;
+
+public class Commandanvil extends EssentialsCommand {
+
+    public Commandanvil() {
+        super("anvil");
+    }
+
+    @Override
+    protected void run(Server server, User user, String commandLabel, String[] args) throws Exception {
+        if (ess.getContainerProvider() == null) {
+            user.sendMessage(tl("unsupportedBrand"));
+            return;
+        }
+
+        ess.getContainerProvider().openAnvil(user.getBase());
+    }
+}