Merge remote-tracking branch 'origin/master'

# Conflicts:
#	eco-api/src/main/java/com/willfp/eco/internal/arrows/ArrowDataListener.java
#	eco-api/src/main/java/com/willfp/eco/internal/items/AbstractItemStackBuilder.java
#	eco-api/src/main/java/com/willfp/eco/util/TeamUtils.java

.github/workflows/publish-release.yml

@@ -0,0 +1,38 @@
+name: Publish release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish-release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout latest code
+        uses: actions/checkout@v2
+
+      - name: Set up JDK 16
+        uses: actions/setup-java@v2
+        with:
+          distribution: 'adopt'
+          java-version: 16
+
+      - name: Setup build cache
+        uses: actions/cache@v2.1.6
+        with:
+          path: ~/.gradle/caches
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle.kts') }}
+          restore-keys: |
+            ${{ runner.os }}-gradle-
+      - name: Publish artifact
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+        # The GITHUB_REF tag comes in the format 'refs/tags/xxx'.
+        # So if we split on '/' and take the 3rd value, we can get the release name.
+        run: |
+          NEW_VERSION=$(echo "${GITHUB_REF}" | cut -d "/" -f3)
+          echo "New version: ${NEW_VERSION}"
+          echo "Github username: ${GITHUB_ACTOR}"
+          ./gradlew -Pversion=${NEW_VERSION} publish

.gitignore

@@ -14,7 +14,7 @@ bin/
 # Gradle
 .gradle
 **/build/
-!src/**/build/
+!eco-api/src/**/build/
 .gradletasknamecache
 !gradle-wrapper.jar
 gradle-app.setting

CONTRIBUTING.md

@@ -6,7 +6,7 @@
 - Every method and field must have a javadoc attached.
 
 2. Use lombok wherever possible.
-- @Getter, @Setter, @ToString, @EqualsAndHashCode, @UtilityClass are the most important.
+- @Getter, @Setter, @UtilityClass only.
 
 3. Use JetBrains annotations
 - Every parameter should be annotated with @NotNull or @Nullable
@@ -24,4 +24,4 @@
 
 ## Other
 - All drops **must** be sent through a DropQueue - calls to World#dropItem will get your PR rejected.
-- eco is built with java 8. Usage of J9+ will get your PR rejected.
+- eco is built with java 16.

README.md

@@ -1 +1,165 @@
-## eco - Library for spigot plugin development.
+<h1 align="center">
+  <br>
+  <img src="https://i.imgur.com/p5uR2Qp.png" alt="eco logo" width="256">
+  <br>
+</h1>
+
+<h4 align="center">eco - Simplify spigot development.</h4>
+
+### Plugin Information
+- Requires ProtocolLib to be installed: get the latest version [here](https://www.spigotmc.org/resources/protocollib.1997/)
+- Supports 1.16.5+
+
+### bStats
+<img src="https://bstats.org/signatures/bukkit/eco.svg" width="512">
+
+# Information for development
+
+## Javadoc
+The 6.0.0 Javadoc can be found [here](https://javadoc.jitpack.io/com/willfp/eco/6.0.0/javadoc/)
+
+## Plugin Information
+
+eco is a standalone plugin, so you will need to install it on any servers that have plugins which depend on it,
+and specify it as a dependency in your plugin.yml:
+
+```yaml
+depend:
+  - eco
+```
+
+eco is available from any of these places:
+
+- [GitHub](https://github.com/Auxilor/eco/releases)
+- [Spigot](https://www.spigotmc.org/resources/eco.87955/)
+- [Polymart](https://polymart.org/resource/eco.773)
+- [Build it locally](https://github.com/Auxilor/eco#build-locally).
+
+## Get from JitPack:
+
+Gradle:
+
+```groovy
+repositories {
+        maven { url 'https://jitpack.io' }
+}
+
+```
+
+```groovy
+dependencies {
+        compileOnly 'com.willfp:eco:Tag'
+}
+```
+
+Replace `Tag` with a release tag for eco, eg `6.0.0`.
+
+Maven:
+
+```xml
+<repository>
+        <id>jitpack.io</id>
+        <url>https://jitpack.io</url>
+</repository>
+```
+
+```xml
+<dependency>
+        <groupId>com.willfp</groupId>
+        <artifactId>eco</artifactId>
+        <version>Tag</version>
+        <scope>provided</scope>
+</dependency>
+```
+
+Replace `Tag` with a release tag for eco, eg `6.0.0`.
+
+## Build locally:
+
+Run the following commands in your terminal of choice.
+
+If you're on windows, you will need to have git bash installed.
+```
+git clone https://github.com/Auxilor/eco
+cd eco
+./gradlew build
+```
+
+# Features
+
+Here's a list of some (not all) of the features of eco:
+
+- Command system with subcommands
+- Reworked config system
+- JSON Config Support
+- Client-Side item display
+- World drop system
+- Event manager
+    - PlayerJumpEvent
+    - ArmorEquipEvent
+    - EntityDeathByEntityEvent
+    - NaturalExpGainEvent
+- Plugin extensions (Plugins for plugins)
+- GUI System
+- Integration system for external plugins
+    - Anticheat support
+        - AAC
+        - Matrix
+        - NCP
+        - Spartan
+        - Vulcan
+    - Antigrief/Combat support
+        - CombatLogX (V10 + V11)
+        - FactionsUUID
+        - GriefPrevention
+        - Kingdoms
+        - Lands
+        - Towny
+        - WorldGuard
+    - mcMMO support
+    - Custom Items support
+        - Oraxen
+    - PlaceholderAPI support
+- NMS Proxy / Wrapper system built in
+- Custom Items system
+- Crafting Recipe handler
+- Tuples
+- Support uploading to / downloading from hastebin
+- Packet System (via ProtocolLib)
+- Dependency Injection systems
+- Prerequisite system
+- API additions (via utility classes)
+    - Get bow from arrow
+    - Break a block as a player
+    - Get a vein of blocks
+    - Create 2D lists
+    - Create NamespacedKeys safely
+    - Random number, distribution, roman numerals
+    - Set skull texture
+    - Format all strings
+        - Hex Support
+        - Gradient Support
+        - Placeholder Support
+    - Get a scoreboard team from any color
+    - Telekinesis (Drops straight to inventory) system
+    - More vector options
+- Update checker
+- bStats integration
+- Reworked systems for:
+    - NamespacedKey
+    - MetadataValue
+    - Runnables / Scheduling
+
+... and a lot more!
+
+## License
+
+*Click here to read [the entire license](https://github.com/Auxilor/eco/blob/master/LICENSE.md).*
+
+<h1 align="center">
+  <br>
+    <a href="https://dedimc.promo/Auxilor" target="_blank">
+      <img src="https://i.imgur.com/zdDLhFA.png" alt="dedimc banner">
+    </a>
+  <br>
+</h1>

build.gradle

@@ -1,102 +1,103 @@
 plugins {
     id 'java-library'
-    id 'com.github.johnrengelman.shadow' version '5.2.0'
+    id 'com.github.johnrengelman.shadow' version '7.0.0'
     id 'maven-publish'
     id 'java'
 }
 
 dependencies {
-    implementation 'org.apache.maven:maven-artifact:3.0.3'
-    implementation 'org.bstats:bstats-bukkit:1.7'
-    compileOnly 'org.spigotmc:spigot-api:1.16.4-R0.1-SNAPSHOT'
-    compileOnly 'me.clip:placeholderapi:2.10.9'
-    compileOnly 'com.comphenix.protocol:ProtocolLib:4.6.0-SNAPSHOT'
-    compileOnly 'com.sk89q.worldguard:worldguard-bukkit:7.0.4-SNAPSHOT'
-    compileOnly 'com.github.TechFortress:GriefPrevention:16.14.0'
-    compileOnly 'com.massivecraft:Factions:1.6.9.5-U0.5.10'
-    compileOnly 'com.github.cryptomorin:kingdoms:1.10.3.1'
-    compileOnly 'com.github.TownyAdvanced:Towny:0.96.2.0'
-    compileOnly 'com.github.angeschossen:LandsAPI:4.7.3'
-    compileOnly 'fr.neatmonster:nocheatplus:3.16.1-SNAPSHOT'
-    compileOnly 'com.github.jiangdashao:matrix-api-repo:317d4635fd'
-    compileOnly 'org.jetbrains:annotations:19.0.0'
-    compileOnly fileTree(dir: 'lib', include: ['*.jar'])
-
-    // Lombok
-    compileOnly 'org.projectlombok:lombok:1.18.16'
-    annotationProcessor 'org.projectlombok:lombok:1.18.16'
-    testCompileOnly 'org.projectlombok:lombok:1.18.16'
-    testAnnotationProcessor 'org.projectlombok:lombok:1.18.16'
+    implementation project(":eco-api")
+    implementation project(":eco-core").getSubprojects()
 }
 
+allprojects {
+    apply plugin: 'java'
+    apply plugin: 'java-library'
+    apply plugin: 'maven-publish'
+    apply plugin: 'com.github.johnrengelman.shadow'
 
-repositories {
-    mavenCentral()
-    jcenter()
-    mavenLocal()
-    maven { url 'https://jitpack.io' }
+    repositories {
+        mavenCentral()
+        mavenLocal()
+        maven { url 'https://jitpack.io' }
 
-    // NMS (for jitpack compilation)
-    maven { url 'https://repo.codemc.org/repository/nms/' }
+        // NMS (for jitpack compilation)
+        maven { url 'https://repo.codemc.org/repository/nms/' }
 
-    // bStats
-    maven { url 'https://repo.codemc.org/repository/maven-public' }
+        // bStats, mcMMO
+        maven { url 'https://repo.codemc.org/repository/maven-public' }
 
-    // Spigot API
-    maven { url 'https://hub.spigotmc.org/nexus/content/repositories/snapshots/' }
+        // Spigot API
+        maven { url 'https://hub.spigotmc.org/nexus/content/repositories/snapshots/' }
 
-    // PlaceholderAPI
-    maven { url 'https://repo.extendedclip.com/content/repositories/placeholderapi/' }
+        // PlaceholderAPI
+        maven { url 'https://repo.extendedclip.com/content/repositories/placeholderapi/' }
 
-    // ProtocolLib
-    maven { url 'https://repo.dmulloy2.net/nexus/repository/public/' }
+        // ProtocolLib
+        maven { url 'https://repo.dmulloy2.net/nexus/repository/public/' }
 
-    // WorldGuard
-    maven { url 'https://maven.enginehub.org/repo/' }
+        // WorldGuard
+        maven { url 'https://maven.enginehub.org/repo/' }
 
-    // FactionsUUID
-    maven { url 'https://ci.ender.zone/plugin/repository/everything/' }
+        // FactionsUUID
+        maven { url 'https://ci.ender.zone/plugin/repository/everything/' }
 
-    // NoCheatPlus
-    maven { url 'https://repo.md-5.net/content/repositories/snapshots/' }
-}
+        // NoCheatPlus
+        maven { url 'https://repo.md-5.net/content/repositories/snapshots/' }
 
-tasks.withType(JavaCompile) {
-    options.deprecation = true
-    options.encoding = 'UTF-8'
-}
-
-configurations.all {
-    exclude group: "org.codehaus.plexus", module: "plexus-utils"
-    exclude group: "com.mojang", module: "brigadier"
-    exclude group: "org.kitteh", module: "paste-gg-api"
-    exclude group: "org.spongepowered", module: "configurate-hocon"
-    exclude group: "com.darkblade12", module: "particleeffect"
-}
-
-shadowJar {
-    relocate('org.bstats.bukkit', 'com.willfp.eco.util.shaded.bstats')
-    relocate('org.apache.maven', 'com.willfp.eco.util.shaded.maven')
-}
-
-publishing {
-    publications {
-        shadow(MavenPublication) {
-            from components.java
-            artifact shadowJar
-        }
+        // CombatLogX
+        maven { url 'https://nexus.sirblobman.xyz/repository/public/' }
     }
+
+    dependencies {
+        compileOnly 'org.jetbrains:annotations:19.0.0'
+
+        // Lombok
+        compileOnly 'org.projectlombok:lombok:1.18.20'
+        annotationProcessor 'org.projectlombok:lombok:1.18.20'
+        testCompileOnly 'org.projectlombok:lombok:1.18.20'
+        testAnnotationProcessor 'org.projectlombok:lombok:1.18.20'
+    }
+
+    tasks.withType(JavaCompile) {
+        options.deprecation = true
+        options.encoding = 'UTF-8'
+    }
+
+    configurations.all {
+        exclude group: "org.codehaus.plexus", module: "plexus-utils"
+        exclude group: "com.mojang", module: "brigadier"
+        exclude group: "org.kitteh", module: "paste-gg-api"
+        exclude group: "org.kitteh", module: "pastegg"
+        exclude group: "org.spongepowered", module: "configurate-hocon"
+        exclude group: "com.darkblade12", module: "particleeffect"
+        exclude group: "com.github.cryptomorin", module: "XSeries"
+    }
+
+    shadowJar {
+        relocate('org.bstats.bukkit', 'com.willfp.eco.shaded.bstats')
+    }
+
+    jar {
+        onlyIf { !sourceSets.main.allSource.files.isEmpty() }
+    }
+
+    compileJava {
+        onlyIf { !sourceSets.main.allSource.files.isEmpty() }
+    }
+
+    java {
+        sourceCompatibility = JavaVersion.VERSION_16
+        targetCompatibility = JavaVersion.VERSION_16
+        withSourcesJar()
+    }
+
+    compileJava.options.encoding = 'UTF-8'
+    compileJava.dependsOn clean
+
+    build.dependsOn shadowJar
 }
 
-compileJava.options.encoding = 'UTF-8'
-compileJava.dependsOn clean
-
-publishToMavenLocal.dependsOn shadowJar
-
-build.dependsOn shadowJar
-build.dependsOn publishToMavenLocal
-
 group = 'com.willfp'
 archivesBaseName = project.name
-version = '3.0.1'
-java.sourceCompatibility = JavaVersion.VERSION_1_8
+version = findProperty("version")

config/checkstyle/checkstyle.xml

@@ -115,7 +115,6 @@
         <!-- Checks for imports                              -->
         <!-- See https://checkstyle.org/config_imports.html -->
         <module name="AvoidStarImport"/>
-        <module name="IllegalImport"/> <!-- defaults to sun.* packages -->
         <module name="RedundantImport"/>
         <module name="UnusedImports">
             <property name="processJavadoc" value="true"/>

config/checkstyle/suppression.xml

@@ -5,6 +5,14 @@
         "http://www.puppycrawl.com/dtds/suppressions_1_1.dtd">
 
 <suppressions>
+    <!-- Internals don't need javadoc. -->
+    <suppress files="[\\/]internal[\\/]" checks="MissingJavadocMethod"/>
+    <suppress files="[\\/]internal[\\/]" checks="JavadocVariable"/>
+    <suppress files="[\\/]eco[\\/]spigot[\\/]" checks="MissingJavadocMethod"/>
+    <suppress files="[\\/]eco[\\/]spigot[\\/]" checks="JavadocVariable"/>
+    <suppress files="[\\/]eco[\\/]proxy[\\/]" checks="MissingJavadocMethod"/>
+    <suppress files="[\\/]eco[\\/]proxy[\\/]" checks="JavadocVariable"/>
+
     <!-- Modified version of library -->
     <suppress files="ArmorEquipEvent.java" checks="JavadocVariable"/>
     <suppress files="ArmorEquipEvent.java" checks="MissingJavadocMethod"/>

eco-api/build.gradle

@@ -0,0 +1,43 @@
+plugins {
+    id 'com.github.johnrengelman.shadow'
+}
+
+group 'com.willfp'
+version rootProject.version
+
+dependencies {
+    compileOnly 'org.spigotmc:spigot-api:1.17-R0.1-SNAPSHOT'
+    compileOnly 'org.apache.maven:maven-artifact:3.0.3'
+    compileOnly 'org.bstats:bstats-bukkit:1.7'
+    compileOnly 'com.comphenix.protocol:ProtocolLib:4.6.0-SNAPSHOT'
+    compileOnly 'com.google.code.gson:gson:2.8.7'
+}
+
+java {
+    withJavadocJar()
+}
+
+compileJava.options.encoding = 'UTF-8'
+compileJava.dependsOn clean
+
+build.dependsOn publishToMavenLocal
+
+publishing {
+    publications {
+        shadow(MavenPublication) {
+            from components.java
+            artifactId 'eco'
+        }
+    }
+
+    repositories {
+        maven {
+            name = "GitHubPackages"
+            url = uri("https://maven.pkg.github.com/Auxilor/eco")
+            credentials {
+                username = System.getenv("GITHUB_ACTOR")
+                password = System.getenv("GITHUB_TOKEN")
+            }
+        }
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/AbstractPacketAdapter.java

@@ -1,4 +1,4 @@
-package com.willfp.eco.util.protocollib;
+package com.willfp.eco.core;
 
 import com.comphenix.protocol.PacketType;
 import com.comphenix.protocol.ProtocolLibrary;
@@ -6,13 +6,15 @@ import com.comphenix.protocol.events.ListenerPriority;
 import com.comphenix.protocol.events.PacketAdapter;
 import com.comphenix.protocol.events.PacketContainer;
 import com.comphenix.protocol.events.PacketEvent;
-import com.willfp.eco.util.plugin.AbstractEcoPlugin;
 import lombok.Getter;
 import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
 import java.util.Collections;
 
+/**
+ * Wrapper class for ProtocolLib packets.
+ */
 public abstract class AbstractPacketAdapter extends PacketAdapter {
     /**
      * The packet type to listen for.
@@ -35,7 +37,7 @@ public abstract class AbstractPacketAdapter extends PacketAdapter {
      * @param priority The priority at which the adapter should be ran on packet send/receive.
      * @param postLoad If the packet adapter should be registered after the server has loaded.
      */
-    protected AbstractPacketAdapter(@NotNull final AbstractEcoPlugin plugin,
+    protected AbstractPacketAdapter(@NotNull final EcoPlugin plugin,
                                     @NotNull final PacketType type,
                                     @NotNull final ListenerPriority priority,
                                     final boolean postLoad) {
@@ -51,7 +53,7 @@ public abstract class AbstractPacketAdapter extends PacketAdapter {
      * @param type     The {@link PacketType} to listen for.
      * @param postLoad If the packet adapter should be registered after the server has loaded.
      */
-    protected AbstractPacketAdapter(@NotNull final AbstractEcoPlugin plugin,
+    protected AbstractPacketAdapter(@NotNull final EcoPlugin plugin,
                                     @NotNull final PacketType type,
                                     final boolean postLoad) {
         this(plugin, type, ListenerPriority.NORMAL, postLoad);
@@ -62,9 +64,11 @@ public abstract class AbstractPacketAdapter extends PacketAdapter {
      *
      * @param packet The packet.
      * @param player The player.
+     * @param event  The event.
      */
     public void onReceive(@NotNull final PacketContainer packet,
-                          @NotNull final Player player) {
+                          @NotNull final Player player,
+                          @NotNull final PacketEvent event) {
         // Empty rather than abstract as implementations don't need both
     }
 
@@ -73,9 +77,11 @@ public abstract class AbstractPacketAdapter extends PacketAdapter {
      *
      * @param packet The packet.
      * @param player The player.
+     * @param event  The event.
      */
     public void onSend(@NotNull final PacketContainer packet,
-                       @NotNull final Player player) {
+                       @NotNull final Player player,
+                       @NotNull final PacketEvent event) {
         // Empty rather than abstract as implementations don't need both
     }
 
@@ -94,7 +100,7 @@ public abstract class AbstractPacketAdapter extends PacketAdapter {
             return;
         }
 
-        onReceive(event.getPacket(), event.getPlayer());
+        onReceive(event.getPacket(), event.getPlayer(), event);
     }
 
     /**
@@ -112,7 +118,12 @@ public abstract class AbstractPacketAdapter extends PacketAdapter {
             return;
         }
 
-        onSend(event.getPacket(), event.getPlayer());
+        onSend(event.getPacket(), event.getPlayer(), event);
+    }
+
+    @Override
+    public final EcoPlugin getPlugin() {
+        return (EcoPlugin) super.getPlugin();
     }
 
     /**

eco-api/src/main/java/com/willfp/eco/core/Eco.java

@@ -0,0 +1,40 @@
+package com.willfp.eco.core;
+
+import lombok.Getter;
+import lombok.experimental.UtilityClass;
+import org.apache.commons.lang.Validate;
+import org.jetbrains.annotations.ApiStatus;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Base class to hold the handler.
+ *
+ * @see Handler
+ */
+@UtilityClass
+public class Eco {
+    /**
+     * Instance of eco handler.
+     * <p>
+     * The handler is, in essence, a way to interface between the eco-api
+     * frontend module, and the eco-backend implementations.
+     * <p>
+     * There shouldn't really be any reason to ever use the handler
+     * in your own plugins, but if you want to then you can - it's
+     * just a part of the API like any other.
+     */
+    @Getter
+    private Handler handler;
+
+    /**
+     * Set the handler.
+     *
+     * @param handler The handler.
+     */
+    @ApiStatus.Internal
+    public void setHandler(@NotNull final Handler handler) {
+        Validate.isTrue(Eco.handler == null, "Already initialized!");
+
+        Eco.handler = handler;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/EcoPlugin.java

@@ -0,0 +1,683 @@
+package com.willfp.eco.core;
+
+import com.willfp.eco.core.command.impl.PluginCommand;
+import com.willfp.eco.core.config.base.ConfigYml;
+import com.willfp.eco.core.config.base.LangYml;
+import com.willfp.eco.core.config.updating.ConfigHandler;
+import com.willfp.eco.core.display.Display;
+import com.willfp.eco.core.display.DisplayModule;
+import com.willfp.eco.core.events.EventManager;
+import com.willfp.eco.core.extensions.ExtensionLoader;
+import com.willfp.eco.core.factory.MetadataValueFactory;
+import com.willfp.eco.core.factory.NamespacedKeyFactory;
+import com.willfp.eco.core.factory.RunnableFactory;
+import com.willfp.eco.core.integrations.IntegrationLoader;
+import com.willfp.eco.core.integrations.placeholder.PlaceholderManager;
+import com.willfp.eco.core.proxy.AbstractProxy;
+import com.willfp.eco.core.proxy.ProxyFactory;
+import com.willfp.eco.core.scheduling.Scheduler;
+import com.willfp.eco.core.web.UpdateChecker;
+import lombok.Getter;
+import org.apache.commons.lang.Validate;
+import org.apache.maven.artifact.versioning.DefaultArtifactVersion;
+import org.bstats.bukkit.Metrics;
+import org.bukkit.Bukkit;
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.event.Listener;
+import org.bukkit.plugin.Plugin;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+import java.util.logging.Logger;
+import java.util.stream.Collectors;
+
+/**
+ * EcoPlugin is the base plugin class for eco-based plugins.
+ * <p>
+ * It functions as a replacement for {@link JavaPlugin}.
+ * <p>
+ * EcoPlugin is a lot more powerful than {@link JavaPlugin} and
+ * contains many methods to reduce boilerplate code and reduce
+ * plugin complexity.
+ * <p>
+ * It is recommended to view the source code for this class to
+ * gain a better understanding of how it works.
+ * <p>
+ * <b>IMPORTANT: When reloading a plugin, all runnables / tasks will
+ * be cancelled.</b>
+ */
+public abstract class EcoPlugin extends JavaPlugin {
+    /**
+     * The spigot resource ID of the plugin.
+     */
+    @Getter
+    private final int resourceId;
+
+    /**
+     * The bStats resource ID of the plugin.
+     */
+    @Getter
+    private final int bStatsId;
+
+    /**
+     * The package where proxy implementations are.
+     */
+    @Getter
+    private final String proxyPackage;
+
+    /**
+     * The color of the plugin, used in messages.
+     */
+    @Getter
+    private final String color;
+
+    /**
+     * Loaded integrations.
+     */
+    @Getter
+    private final Set<String> loadedIntegrations = new HashSet<>();
+
+    /**
+     * The internal plugin scheduler.
+     */
+    @Getter
+    private final Scheduler scheduler;
+
+    /**
+     * The internal plugin Event Manager.
+     */
+    @Getter
+    private final EventManager eventManager;
+
+    /**
+     * Config.yml.
+     */
+    @Getter
+    private final ConfigYml configYml;
+
+    /**
+     * Lang.yml.
+     */
+    @Getter
+    private final LangYml langYml;
+
+    /**
+     * The internal factory to produce {@link org.bukkit.NamespacedKey}s.
+     */
+    @Getter
+    private final NamespacedKeyFactory namespacedKeyFactory;
+
+    /**
+     * The internal factory to produce {@link org.bukkit.metadata.FixedMetadataValue}s.
+     */
+    @Getter
+    private final MetadataValueFactory metadataValueFactory;
+
+    /**
+     * The internal factory to produce {@link com.willfp.eco.core.scheduling.RunnableTask}s.
+     */
+    @Getter
+    private final RunnableFactory runnableFactory;
+
+    /**
+     * The loader for all plugin extensions.
+     *
+     * @see com.willfp.eco.core.extensions.Extension
+     */
+    @Getter
+    private final ExtensionLoader extensionLoader;
+
+    /**
+     * The handler class for updatable classes.
+     */
+    @Getter
+    private final ConfigHandler configHandler;
+
+    /**
+     * The display module for the plugin.
+     */
+    @Getter
+    private DisplayModule displayModule;
+
+    /**
+     * The logger for the plugin.
+     */
+    private final Logger logger;
+
+    /**
+     * If the server is running an outdated version of the plugin.
+     */
+    @Getter
+    private boolean outdated = false;
+
+    /**
+     * If the plugin supports extensions.
+     */
+    @Getter
+    private final boolean supportingExtensions;
+
+    /**
+     * The proxy factory.
+     */
+    @Getter
+    private final ProxyFactory proxyFactory;
+
+    /**
+     * Create a new plugin without a specified color, proxy support, spigot, or bStats.
+     */
+    protected EcoPlugin() {
+        this("&f");
+    }
+
+    /**
+     * Create a new plugin without proxy support, spigot, or bStats.
+     *
+     * @param color The color.
+     */
+    protected EcoPlugin(@NotNull final String color) {
+        this("", color);
+    }
+
+
+    /**
+     * Create a new plugin unlinked to spigot and bStats.
+     *
+     * @param proxyPackage The package where proxy implementations are stored.
+     * @param color        The color of the plugin (used in messages, using standard formatting)
+     */
+    protected EcoPlugin(@NotNull final String proxyPackage,
+                        @NotNull final String color) {
+        this(0, 0, proxyPackage, color);
+    }
+
+    /**
+     * Create a new plugin without proxy or extension support.
+     *
+     * @param resourceId The spigot resource ID for the plugin.
+     * @param bStatsId   The bStats resource ID for the plugin.
+     * @param color      The color of the plugin (used in messages, using standard formatting)
+     */
+    protected EcoPlugin(final int resourceId,
+                        final int bStatsId,
+                        @NotNull final String color) {
+        this(resourceId, bStatsId, "", color);
+    }
+
+    /**
+     * Create a new plugin without proxy support.
+     *
+     * @param resourceId           The spigot resource ID for the plugin.
+     * @param bStatsId             The bStats resource ID for the plugin.
+     * @param color                The color of the plugin (used in messages, using standard formatting)
+     * @param supportingExtensions If the plugin supports extensions.
+     */
+    protected EcoPlugin(final int resourceId,
+                        final int bStatsId,
+                        @NotNull final String color,
+                        final boolean supportingExtensions) {
+        this(resourceId, bStatsId, "", color, supportingExtensions);
+    }
+
+    /**
+     * Create a new plugin without extension support.
+     *
+     * @param resourceId   The spigot resource ID for the plugin.
+     * @param bStatsId     The bStats resource ID for the plugin.
+     * @param proxyPackage The package where proxy implementations are stored.
+     * @param color        The color of the plugin (used in messages, using standard formatting)
+     */
+    protected EcoPlugin(final int resourceId,
+                        final int bStatsId,
+                        @NotNull final String proxyPackage,
+                        @NotNull final String color) {
+        this(resourceId, bStatsId, proxyPackage, color, false);
+    }
+
+    /**
+     * Create a new plugin.
+     *
+     * @param resourceId           The spigot resource ID for the plugin.
+     * @param bStatsId             The bStats resource ID for the plugin.
+     * @param proxyPackage         The package where proxy implementations are stored.
+     * @param color                The color of the plugin (used in messages, using standard formatting)
+     * @param supportingExtensions If the plugin supports extensions.
+     */
+    protected EcoPlugin(final int resourceId,
+                        final int bStatsId,
+                        @NotNull final String proxyPackage,
+                        @NotNull final String color,
+                        final boolean supportingExtensions) {
+        /*
+        The handler must be initialized before any plugin's constructors
+        are called, as the constructors call Eco#getHandler().
+
+        To fix this, EcoSpigotPlugin an abstract class and the 'actual'
+        plugin class is EcoHandler - that way I can create the handler
+        before any plugins are loaded while still having a separation between
+        the plugin class and the handler class (for code clarity).
+
+        I don't really like the fact that the handler class *is* the
+        spigot plugin, but it is what it is.
+
+        There is probably a better way of doing it - maybe with
+        some sort of HandlerCreator interface in order to still have
+        a standalone handler class, but then there would be an interface
+        left in the API that doesn't really help anything.
+
+        The other alternative would be do use reflection to get a 'createHandler'
+        method that only exists in EcoSpigotPlugin - but that feels really dirty
+        and I'd rather only use reflection where necessary.
+        */
+
+        if (Eco.getHandler() == null && this instanceof Handler) {
+            /*
+            This code is only ever called by EcoSpigotPlugin (EcoHandler)
+            as it's the first plugin to load and it is a handler.
+
+            Any other plugins will never call this code as the handler
+            will have already been initialized.
+             */
+
+            Eco.setHandler((Handler) this);
+        }
+
+        assert Eco.getHandler() != null;
+
+        this.resourceId = resourceId;
+        this.bStatsId = bStatsId;
+        this.proxyPackage = proxyPackage;
+        this.color = color;
+        this.supportingExtensions = supportingExtensions;
+
+        this.scheduler = Eco.getHandler().createScheduler(this);
+        this.eventManager = Eco.getHandler().createEventManager(this);
+        this.namespacedKeyFactory = Eco.getHandler().createNamespacedKeyFactory(this);
+        this.metadataValueFactory = Eco.getHandler().createMetadataValueFactory(this);
+        this.runnableFactory = Eco.getHandler().createRunnableFactory(this);
+        this.extensionLoader = Eco.getHandler().createExtensionLoader(this);
+        this.configHandler = Eco.getHandler().createConfigHandler(this);
+        this.logger = Eco.getHandler().createLogger(this);
+        this.proxyFactory = this.proxyPackage.equalsIgnoreCase("") ? null : Eco.getHandler().createProxyFactory(this);
+
+        this.langYml = new LangYml(this);
+        this.configYml = new ConfigYml(this);
+
+        Eco.getHandler().addNewPlugin(this);
+    }
+
+    /**
+     * Default code to be executed on plugin enable.
+     */
+    @Override
+    public final void onEnable() {
+        super.onEnable();
+
+        this.getLogger().info("");
+        this.getLogger().info("Loading " + this.getColor() + this.getName());
+
+        if (this.getResourceId() != 0) {
+            new UpdateChecker(this).getVersion(version -> {
+                DefaultArtifactVersion currentVersion = new DefaultArtifactVersion(this.getDescription().getVersion());
+                DefaultArtifactVersion mostRecentVersion = new DefaultArtifactVersion(version);
+                if (!(currentVersion.compareTo(mostRecentVersion) > 0 || currentVersion.equals(mostRecentVersion))) {
+                    this.outdated = true;
+                    this.getScheduler().runTimer(() -> {
+                        this.getLogger().info("&c " + this.getName() + " is out of date! (Version " + this.getDescription().getVersion() + ")");
+                        this.getLogger().info("&cThe newest version is &f" + version);
+                        this.getLogger().info("&cDownload the new version!");
+                    }, 0, 864000);
+                }
+            });
+        }
+
+        DefaultArtifactVersion runningVersion = new DefaultArtifactVersion(Eco.getHandler().getEcoPlugin().getDescription().getVersion());
+        DefaultArtifactVersion requiredVersion = new DefaultArtifactVersion(this.getMinimumEcoVersion());
+        if (!(runningVersion.compareTo(requiredVersion) > 0 || runningVersion.equals(requiredVersion))) {
+            this.getLogger().severe("You are running an outdated version of eco!");
+            this.getLogger().severe("You must be on at least" + this.getMinimumEcoVersion());
+            this.getLogger().severe("Download the newest version here:");
+            this.getLogger().severe("https://polymart.org/download/773/recent/JSpprMspkuyecf5y1wQ2Jn8OoLQSQ_IW");
+            Bukkit.getPluginManager().disablePlugin(this);
+        }
+
+        if (this.getBStatsId() != 0) {
+            new Metrics(this, this.getBStatsId());
+        }
+
+        Set<String> enabledPlugins = Arrays.stream(Bukkit.getPluginManager().getPlugins()).map(Plugin::getName).collect(Collectors.toSet());
+
+        if (enabledPlugins.contains("PlaceholderAPI")) {
+            this.loadedIntegrations.add("PlaceholderAPI");
+            PlaceholderManager.addIntegration(Eco.getHandler().createPAPIIntegration(this));
+        }
+
+        this.loadIntegrationLoaders().forEach((integrationLoader -> {
+            if (enabledPlugins.contains(integrationLoader.getPluginName())) {
+                this.loadedIntegrations.add(integrationLoader.getPluginName());
+                integrationLoader.load();
+            }
+        }));
+
+        this.getLogger().info("Loaded integrations: " + String.join(", ", this.getLoadedIntegrations()));
+
+        Prerequisite.update();
+
+        this.loadPacketAdapters().forEach(abstractPacketAdapter -> {
+            if (!abstractPacketAdapter.isPostLoad()) {
+                abstractPacketAdapter.register();
+            }
+        });
+
+        this.loadListeners().forEach(listener -> this.getEventManager().registerListener(listener));
+
+        this.loadPluginCommands().forEach(PluginCommand::register);
+
+        this.getScheduler().runLater(this::afterLoad, 1);
+
+        if (this.isSupportingExtensions()) {
+            this.getExtensionLoader().loadExtensions();
+
+            if (this.getExtensionLoader().getLoadedExtensions().isEmpty()) {
+                this.getLogger().info("&cNo extensions found");
+            } else {
+                this.getLogger().info("Extensions Loaded:");
+                this.getExtensionLoader().getLoadedExtensions().forEach(extension -> this.getLogger().info("- " + extension.getName() + " v" + extension.getVersion()));
+            }
+        }
+
+        this.handleEnable();
+
+        this.getLogger().info("");
+    }
+
+    /**
+     * Default code to be executed on plugin disable.
+     */
+    @Override
+    public final void onDisable() {
+        super.onDisable();
+
+        this.getEventManager().unregisterAllListeners();
+        this.getScheduler().cancelAll();
+        this.getConfigHandler().saveAllConfigs();
+
+        this.handleDisable();
+
+        if (this.isSupportingExtensions()) {
+            this.getExtensionLoader().unloadExtensions();
+        }
+
+        this.getLogger().info("Cleaning up...");
+        Eco.getHandler().getCleaner().clean(this);
+    }
+
+    /**
+     * Default code to be executed on plugin load.
+     */
+    @Override
+    public final void onLoad() {
+        super.onLoad();
+
+        this.handleLoad();
+    }
+
+    /**
+     * Default code to be executed after the server is up.
+     */
+    public final void afterLoad() {
+        this.displayModule = createDisplayModule();
+
+        if (this.getDisplayModule() != null) {
+            Display.registerDisplayModule(this.getDisplayModule());
+        }
+
+        this.loadPacketAdapters().forEach(abstractPacketAdapter -> {
+            if (abstractPacketAdapter.isPostLoad()) {
+                abstractPacketAdapter.register();
+            }
+        });
+
+        if (!Prerequisite.HAS_PAPER.isMet()) {
+            this.getLogger().severe("");
+            this.getLogger().severe("----------------------------");
+            this.getLogger().severe("");
+            this.getLogger().severe("You don't seem to be running paper!");
+            this.getLogger().severe("Paper is strongly recommended for all servers,");
+            this.getLogger().severe("and some things may not function properly without it");
+            this.getLogger().severe("Download Paper from &fhttps://papermc.io");
+            this.getLogger().severe("");
+            this.getLogger().severe("----------------------------");
+            this.getLogger().severe("");
+        }
+
+        this.handleAfterLoad();
+
+        this.reload();
+
+        this.getLogger().info("Loaded " + this.color + this.getName());
+    }
+
+    /**
+     * Default code to be executed on plugin reload.
+     */
+    public final void reload() {
+        this.getConfigHandler().updateConfigs();
+
+        this.getConfigHandler().callUpdate();
+        this.getConfigHandler().callUpdate(); // Call twice to fix issues
+        this.getScheduler().cancelAll();
+
+        this.handleReload();
+    }
+
+    /**
+     * The plugin-specific code to be executed on enable.
+     * <p>
+     * Override when needed.
+     */
+    protected void handleEnable() {
+
+    }
+
+    /**
+     * The plugin-specific code to be executed on disable.
+     * <p>
+     * Override when needed.
+     */
+    protected void handleDisable() {
+
+    }
+
+    /**
+     * The plugin-specific code to be executed on load.
+     * <p>
+     * This is executed before enabling.
+     * <p>
+     * Override when needed.
+     */
+    protected void handleLoad() {
+
+    }
+
+    /**
+     * The plugin-specific code to be executed on reload.
+     * <p>
+     * Override when needed.
+     */
+    protected void handleReload() {
+
+    }
+
+    /**
+     * The plugin-specific code to be executed after the server is up.
+     * <p>
+     * Override when needed.
+     */
+    protected void handleAfterLoad() {
+
+    }
+
+    /**
+     * The plugin-specific integrations to be tested and loaded.
+     *
+     * @return A list of integrations.
+     */
+    protected List<IntegrationLoader> loadIntegrationLoaders() {
+        return new ArrayList<>();
+    }
+
+    /**
+     * The commands to be registered.
+     *
+     * @return A list of commands.
+     */
+    protected List<PluginCommand> loadPluginCommands() {
+        return new ArrayList<>();
+    }
+
+    /**
+     * ProtocolLib packet adapters to be registered.
+     * <p>
+     * If the plugin does not require ProtocolLib this can be left empty.
+     *
+     * @return A list of packet adapters.
+     */
+    protected List<AbstractPacketAdapter> loadPacketAdapters() {
+        return new ArrayList<>();
+    }
+
+    /**
+     * All listeners to be registered.
+     *
+     * @return A list of all listeners.
+     */
+    protected abstract List<Listener> loadListeners();
+
+    /**
+     * Create the display module for the plugin.
+     *
+     * @return The display module, or null.
+     */
+    @Nullable
+    protected DisplayModule createDisplayModule() {
+        Validate.isTrue(
+                this.getDisplayModule() == null,
+                "Display module exists!"
+        );
+
+        return null;
+    }
+
+    /**
+     * Get the minimum version of eco to use the plugin.
+     *
+     * @return The version.
+     */
+    public String getMinimumEcoVersion() {
+        return "6.0.0";
+    }
+
+    /**
+     * Get the plugin's logger.
+     *
+     * @return The logger.
+     */
+    @NotNull
+    @Override
+    public Logger getLogger() {
+        return logger;
+    }
+
+    /**
+     * Get a proxy.
+     *
+     * @param proxyClass The proxy class.
+     * @param <T>        The proxy type.
+     * @return The proxy.
+     */
+    public <T extends AbstractProxy> T getProxy(@NotNull final Class<T> proxyClass) {
+        Validate.notNull(proxyFactory, "Plugin does not support proxy!");
+
+        return proxyFactory.getProxy(proxyClass);
+    }
+
+    /**
+     * Get unwrapped config.
+     * Does not use eco config system, don't use.
+     *
+     * @return The bukkit config.
+     * @deprecated Use getConfigYml() instead.
+     */
+    @NotNull
+    @Override
+    @Deprecated
+    public final FileConfiguration getConfig() {
+        this.getLogger().warning("Call to default config method in eco plugin!");
+
+        return this.getConfigYml().getBukkitHandle();
+    }
+
+    /**
+     * Does not use eco config system, don't use.
+     *
+     * @deprecated Use eco config system.
+     */
+    @Override
+    @Deprecated
+    public final void saveConfig() {
+        this.getLogger().warning("Call to default config method in eco plugin!");
+
+        super.saveConfig();
+    }
+
+    /**
+     * Does not use eco config system, don't use.
+     *
+     * @deprecated Use eco config system.
+     */
+    @Override
+    @Deprecated
+    public final void saveDefaultConfig() {
+        this.getLogger().warning("Call to default config method in eco plugin!");
+
+        super.saveDefaultConfig();
+    }
+
+    /**
+     * Does not use eco config system, don't use.
+     *
+     * @deprecated Use eco config system.
+     */
+    @Override
+    @Deprecated
+    public final void reloadConfig() {
+        this.getLogger().warning("Call to default config method in eco plugin!");
+
+        super.reloadConfig();
+    }
+
+    /**
+     * Get an EcoPlugin by name.
+     *
+     * @param pluginName The name.
+     * @return The plugin.
+     */
+    public static EcoPlugin getPlugin(@NotNull final String pluginName) {
+        return Eco.getHandler().getPluginByName(pluginName);
+    }
+
+    /**
+     * Get all EcoPlugin names.
+     *
+     * @return The set of names.
+     */
+    public static Set<String> getPluginNames() {
+        return new HashSet<>(Eco.getHandler().getLoadedPlugins());
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/Handler.java

@@ -0,0 +1,161 @@
+package com.willfp.eco.core;
+
+import com.willfp.eco.core.config.updating.ConfigHandler;
+import com.willfp.eco.core.config.wrapper.ConfigFactory;
+import com.willfp.eco.core.drops.DropQueueFactory;
+import com.willfp.eco.core.events.EventManager;
+import com.willfp.eco.core.extensions.ExtensionLoader;
+import com.willfp.eco.core.factory.MetadataValueFactory;
+import com.willfp.eco.core.factory.NamespacedKeyFactory;
+import com.willfp.eco.core.factory.RunnableFactory;
+import com.willfp.eco.core.gui.GUIFactory;
+import com.willfp.eco.core.integrations.placeholder.PlaceholderIntegration;
+import com.willfp.eco.core.proxy.Cleaner;
+import com.willfp.eco.core.proxy.ProxyFactory;
+import com.willfp.eco.core.scheduling.Scheduler;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+import java.util.logging.Logger;
+
+/**
+ * @see Eco
+ */
+public interface Handler {
+    /**
+     * Create a scheduler.
+     *
+     * @param plugin The plugin.
+     * @return The scheduler.
+     */
+    Scheduler createScheduler(@NotNull EcoPlugin plugin);
+
+    /**
+     * Create an event manager.
+     *
+     * @param plugin The plugin.
+     * @return The event manager.
+     */
+    EventManager createEventManager(@NotNull EcoPlugin plugin);
+
+    /**
+     * Create a NamespacedKey factory.
+     *
+     * @param plugin The plugin.
+     * @return The factory.
+     */
+    NamespacedKeyFactory createNamespacedKeyFactory(@NotNull EcoPlugin plugin);
+
+    /**
+     * Create a MetadataValue factory.
+     *
+     * @param plugin The plugin.
+     * @return The factory.
+     */
+    MetadataValueFactory createMetadataValueFactory(@NotNull EcoPlugin plugin);
+
+    /**
+     * Create a Runnable factory.
+     *
+     * @param plugin The plugin.
+     * @return The factory.
+     */
+    RunnableFactory createRunnableFactory(@NotNull EcoPlugin plugin);
+
+    /**
+     * Create an ExtensionLoader.
+     *
+     * @param plugin The plugin.
+     * @return The factory.
+     */
+    ExtensionLoader createExtensionLoader(@NotNull EcoPlugin plugin);
+
+    /**
+     * Create a config handler.
+     *
+     * @param plugin The plugin.
+     * @return The handler.
+     */
+    ConfigHandler createConfigHandler(@NotNull EcoPlugin plugin);
+
+    /**
+     * Create a logger.
+     *
+     * @param plugin The plugin.
+     * @return The logger.
+     */
+    Logger createLogger(@NotNull EcoPlugin plugin);
+
+    /**
+     * Create a PAPI integration.
+     *
+     * @param plugin The plugin.
+     * @return The integration.
+     */
+    PlaceholderIntegration createPAPIIntegration(@NotNull EcoPlugin plugin);
+
+    /**
+     * Create a proxy factory.
+     *
+     * @param plugin The plugin.
+     * @return The factory.
+     */
+    ProxyFactory createProxyFactory(@NotNull EcoPlugin plugin);
+
+    /**
+     * Get eco Spigot plugin.
+     *
+     * @return The plugin.
+     */
+    EcoPlugin getEcoPlugin();
+
+    /**
+     * Get config factory.
+     *
+     * @return The factory.
+     */
+    ConfigFactory getConfigFactory();
+
+    /**
+     * Get drop queue factory.
+     *
+     * @return The factory.
+     */
+    DropQueueFactory getDropQueueFactory();
+
+    /**
+     * Get GUI factory.
+     *
+     * @return The factory.
+     */
+    GUIFactory getGUIFactory();
+
+    /**
+     * Get cleaner.
+     *
+     * @return The cleaner.
+     */
+    Cleaner getCleaner();
+
+    /**
+     * Add new plugin.
+     *
+     * @param plugin The plugin.
+     */
+    void addNewPlugin(@NotNull EcoPlugin plugin);
+
+    /**
+     * Get plugin by name.
+     *
+     * @param name The name.
+     * @return The plugin.
+     */
+    EcoPlugin getPluginByName(@NotNull String name);
+
+    /**
+     * Get all loaded eco plugins.
+     *
+     * @return A list of plugin names in lowercase.
+     */
+    List<String> getLoadedPlugins();
+}

eco-api/src/main/java/com/willfp/eco/core/PluginDependent.java

@@ -0,0 +1,27 @@
+package com.willfp.eco.core;
+
+import lombok.AccessLevel;
+import lombok.Getter;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Quick DI class to manage passing eco plugins.
+ *
+ * @param <T> The eco plugin type.
+ */
+public abstract class PluginDependent<T extends EcoPlugin> {
+    /**
+     * The {@link EcoPlugin} that is stored.
+     */
+    @Getter(AccessLevel.PROTECTED)
+    private final T plugin;
+
+    /**
+     * Pass an {@link EcoPlugin} in order to interface with it.
+     *
+     * @param plugin The plugin to manage.
+     */
+    protected PluginDependent(@NotNull final T plugin) {
+        this.plugin = plugin;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/Prerequisite.java

@@ -1,8 +1,8 @@
-package com.willfp.eco.util.optional;
+package com.willfp.eco.core;
 
+import com.willfp.eco.core.proxy.ProxyConstants;
 import com.willfp.eco.util.ClassUtils;
 import lombok.Getter;
-import org.bukkit.Bukkit;
 import org.jetbrains.annotations.NotNull;
 
 import java.util.ArrayList;
@@ -10,20 +10,18 @@ import java.util.Arrays;
 import java.util.List;
 import java.util.function.Supplier;
 
+/**
+ * A prerequisite is a requirement for something.
+ * <p>
+ * For example, you can require the server to have paper or be a specific version,
+ * or have some other dependency.
+ */
 public class Prerequisite {
     /**
      * All existing prerequisites are registered on creation.
      */
     private static final List<Prerequisite> VALUES = new ArrayList<>();
 
-    /**
-     * Requires the server to be running minecraft version 1.16 or higher.
-     */
-    public static final Prerequisite MINIMUM_1_16 = new Prerequisite(
-            () -> !Bukkit.getServer().getClass().getPackage().getName().split("\\.")[3].contains("15"),
-            "Requires minimum server version of 1.16"
-    );
-
     /**
      * Requires the server to be running an implementation of paper.
      */
@@ -32,6 +30,14 @@ public class Prerequisite {
             "Requires server to be running paper (or a fork)"
     );
 
+    /**
+     * Requires the server to be running 1.17.
+     */
+    public static final Prerequisite HAS_1_17 = new Prerequisite(
+            () -> ProxyConstants.NMS_VERSION.contains("17"),
+            "Requires server to be running 1.17+"
+    );
+
     /**
      * If the necessary prerequisite condition has been met.
      */

eco-api/src/main/java/com/willfp/eco/core/command/CommandBase.java

@@ -0,0 +1,51 @@
+package com.willfp.eco.core.command;
+
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Interface for all command implementations.
+ */
+public interface CommandBase {
+    /**
+     * Get command name.
+     *
+     * @return The name.
+     */
+    String getName();
+
+    /**
+     * Get command permission.
+     *
+     * @return The permission.
+     */
+    String getPermission();
+
+    /**
+     * If only players can execute the command.
+     *
+     * @return If true.
+     */
+    boolean isPlayersOnly();
+
+    /**
+     * Add a subcommand to the command.
+     *
+     * @param command The subcommand.
+     * @return The parent command.
+     */
+    CommandBase addSubcommand(@NotNull CommandBase command);
+
+    /**
+     * Get the handler.
+     *
+     * @return The handler.
+     */
+    CommandHandler getHandler();
+
+    /**
+     * Get the tab completer.
+     *
+     * @return The tab completer.
+     */
+    TabCompleteHandler getTabCompleter();
+}

eco-api/src/main/java/com/willfp/eco/core/command/CommandHandler.java

@@ -0,0 +1,25 @@
+package com.willfp.eco.core.command;
+
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+
+/**
+ * A command handler handles the actual code for a command.
+ * <p>
+ * The replacement for {@link org.bukkit.command.CommandExecutor#onCommand(CommandSender, Command, String, String[])}
+ * @see CommandBase
+ */
+@FunctionalInterface
+public interface CommandHandler {
+    /**
+     * The code to be called on execution.
+     *
+     * @param sender The sender.
+     * @param args   The arguments.
+     */
+    void onExecute(@NotNull CommandSender sender,
+                   @NotNull List<String> args);
+}

eco-api/src/main/java/com/willfp/eco/core/command/TabCompleteHandler.java

@@ -0,0 +1,26 @@
+package com.willfp.eco.core.command;
+
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+
+/**
+ * A Tab Complete handler handles the actual tab-completion code.
+ * <p>
+ * The replacement for {@link org.bukkit.command.TabCompleter#onTabComplete(CommandSender, Command, String, String[])}
+ * @see CommandBase
+ */
+@FunctionalInterface
+public interface TabCompleteHandler {
+    /**
+     * Handle Tab Completion.
+     *
+     * @param sender The sender.
+     * @param args   The arguments.
+     * @return The tab completion results.
+     */
+    List<String> tabComplete(@NotNull CommandSender sender,
+                             @NotNull List<String> args);
+}

eco-api/src/main/java/com/willfp/eco/core/command/impl/HandledCommand.java

@@ -0,0 +1,198 @@
+package com.willfp.eco.core.command.impl;
+
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.PluginDependent;
+import com.willfp.eco.core.command.CommandBase;
+import com.willfp.eco.core.command.CommandHandler;
+import com.willfp.eco.core.command.TabCompleteHandler;
+import lombok.AccessLevel;
+import lombok.Getter;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.bukkit.util.StringUtil;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+
+/**
+ * Abstract class for commands that can be handled.
+ * <p>
+ * Handled commands have a method to pass in raw input from bukkit commands
+ * in order to execute the command-specific code. It's essentially an internal
+ * layer, hence why it's a package-private class.
+ */
+abstract class HandledCommand extends PluginDependent<EcoPlugin> implements CommandBase {
+    /**
+     * The name of the command.
+     */
+    @Getter
+    private final String name;
+
+    /**
+     * The permission required to execute the command.
+     * <p>
+     * Written out as a string for flexibility with subclasses.
+     */
+    @Getter
+    private final String permission;
+
+    /**
+     * Should the command only be allowed to be executed by players?
+     * <p>
+     * In other worlds, only allowed to be executed by console.
+     */
+    @Getter
+    private final boolean playersOnly;
+
+    /**
+     * All subcommands for the command.
+     */
+    @Getter(AccessLevel.PROTECTED)
+    private final List<CommandBase> subcommands;
+
+    /**
+     * Create a new command.
+     * <p>
+     * The name cannot be the same as an existing command as this will conflict.
+     *
+     * @param plugin      Instance of a plugin.
+     * @param name        The name used in execution.
+     * @param permission  The permission required to execute the command.
+     * @param playersOnly If only players should be able to execute this command.
+     */
+    HandledCommand(@NotNull final EcoPlugin plugin,
+                   @NotNull final String name,
+                   @NotNull final String permission,
+                   final boolean playersOnly) {
+        super(plugin);
+        this.name = name;
+        this.permission = permission;
+        this.playersOnly = playersOnly;
+        this.subcommands = new ArrayList<>();
+    }
+
+    /**
+     * Add a subcommand to the command.
+     *
+     * @param subcommand The subcommand.
+     * @return The parent command.
+     */
+    @Override
+    public final CommandBase addSubcommand(@NotNull final CommandBase subcommand) {
+        subcommands.add(subcommand);
+
+        return this;
+    }
+
+    /**
+     * Handle the command.
+     *
+     * @param sender The sender.
+     * @param args   The arguments.
+     */
+    protected final void handle(@NotNull final CommandSender sender,
+                                @NotNull final String[] args) {
+        if (!canExecute(sender, this, this.getPlugin())) {
+            return;
+        }
+
+        if (args.length > 0) {
+            for (CommandBase subcommand : this.getSubcommands()) {
+                if (subcommand.getName().equalsIgnoreCase(args[0])) {
+                    if (!canExecute(sender, subcommand, this.getPlugin())) {
+                        return;
+                    }
+
+                    ((HandledCommand) subcommand).handle(sender, Arrays.copyOfRange(args, 1, args.length));
+
+                    return;
+                }
+            }
+        }
+
+        this.getHandler().onExecute(sender, Arrays.asList(args));
+    }
+
+    /**
+     * Handle the tab completion.
+     *
+     * @param sender The sender.
+     * @param args   The arguments.
+     * @return The tab completion results.
+     */
+    protected final List<String> handleTabCompletion(@NotNull final CommandSender sender,
+                                                     @NotNull final String[] args) {
+
+        if (!sender.hasPermission(this.getPermission())) {
+            return null;
+        }
+
+        if (args.length == 1) {
+            List<String> completions = new ArrayList<>();
+
+            StringUtil.copyPartialMatches(
+                    args[0],
+                    this.getSubcommands().stream().map(CommandBase::getName).collect(Collectors.toList()),
+                    completions
+            );
+
+            Collections.sort(completions);
+
+            if (!completions.isEmpty()) {
+                return completions;
+            }
+        }
+
+        if (args.length >= 2) {
+            HandledCommand command = null;
+
+            for (CommandBase subcommand : this.getSubcommands()) {
+                if (args[0].equalsIgnoreCase(subcommand.getName())) {
+                    command = (HandledCommand) subcommand;
+                }
+            }
+
+            if (command != null) {
+                return command.handleTabCompletion(sender, Arrays.copyOfRange(args, 1, args.length));
+            }
+        }
+
+        return this.getTabCompleter().tabComplete(sender, Arrays.asList(args));
+    }
+
+    @Override
+    public abstract CommandHandler getHandler();
+
+    @Override
+    public TabCompleteHandler getTabCompleter() {
+        return (sender, args) -> new ArrayList<>();
+    }
+
+    /**
+     * If a sender can execute the command.
+     *
+     * @param sender  The sender.
+     * @param command The command.
+     * @param plugin  The plugin.
+     * @return If the sender can execute.
+     */
+    public static boolean canExecute(@NotNull final CommandSender sender,
+                                     @NotNull final CommandBase command,
+                                     @NotNull final EcoPlugin plugin) {
+        if (command.isPlayersOnly() && !(sender instanceof Player)) {
+            sender.sendMessage(plugin.getLangYml().getMessage("not-player"));
+            return false;
+        }
+
+        if (!sender.hasPermission(command.getPermission()) && sender instanceof Player) {
+            sender.sendMessage(plugin.getLangYml().getNoPermission());
+            return false;
+        }
+
+        return true;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/command/impl/PluginCommand.java

@@ -0,0 +1,94 @@
+package com.willfp.eco.core.command.impl;
+
+import com.willfp.eco.core.EcoPlugin;
+import org.bukkit.Bukkit;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandExecutor;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.TabCompleter;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * PluginCommands are the class to be used instead of CommandExecutor.
+ * <p>
+ * The command will not be registered until register() is called.
+ * <p>
+ * The name cannot be the same as an existing command as this will conflict.
+ */
+public abstract class PluginCommand extends HandledCommand implements CommandExecutor, TabCompleter {
+    /**
+     * Create a new command.
+     *
+     * @param plugin      The plugin.
+     * @param name        The name used in execution.
+     * @param permission  The permission required to execute the command.
+     * @param playersOnly If only players should be able to execute this command.
+     */
+    protected PluginCommand(@NotNull final EcoPlugin plugin,
+                            @NotNull final String name,
+                            @NotNull final String permission,
+                            final boolean playersOnly) {
+        super(plugin, name, permission, playersOnly);
+    }
+
+    /**
+     * Registers the command with the server,
+     * <p>
+     * Requires the command name to exist, defined in plugin.yml.
+     */
+    public final void register() {
+        org.bukkit.command.PluginCommand command = Bukkit.getPluginCommand(this.getName());
+        assert command != null;
+        command.setExecutor(this);
+        command.setTabCompleter(this);
+    }
+
+    /**
+     * Internal implementation used to clean up boilerplate.
+     * Used for parity with {@link CommandExecutor#onCommand(CommandSender, Command, String, String[])}.
+     *
+     * @param sender  The executor of the command.
+     * @param command The bukkit command.
+     * @param label   The name of the executed command.
+     * @param args    The arguments of the command (anything after the physical command name)
+     * @return If the command was processed by the linked {@link EcoPlugin}
+     */
+    @Override
+    public final boolean onCommand(@NotNull final CommandSender sender,
+                                   @NotNull final Command command,
+                                   @NotNull final String label,
+                                   @NotNull final String[] args) {
+        if (!command.getName().equalsIgnoreCase(this.getName())) {
+            return false;
+        }
+
+        this.handle(sender, args);
+
+        return true;
+    }
+
+    /**
+     * Internal implementation used to clean up boilerplate.
+     * Used for parity with {@link TabCompleter#onTabComplete(CommandSender, Command, String, String[])}.
+     *
+     * @param sender  The executor of the command.
+     * @param command The bukkit command.
+     * @param label   The name of the executed command.
+     * @param args    The arguments of the command (anything after the physical command name).
+     * @return The list of tab-completions.
+     */
+    @Override
+    public @Nullable List<String> onTabComplete(@NotNull final CommandSender sender,
+                                                @NotNull final Command command,
+                                                @NotNull final String label,
+                                                @NotNull final String[] args) {
+        if (!command.getName().equalsIgnoreCase(this.getName())) {
+            return null;
+        }
+
+        return this.handleTabCompletion(sender, args);
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/command/impl/Subcommand.java

@@ -0,0 +1,38 @@
+package com.willfp.eco.core.command.impl;
+
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.command.CommandBase;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Subcommands can be added to PluginCommands or to other Subcommands.
+ */
+public abstract class Subcommand extends HandledCommand {
+    /**
+     * Create subcommand.
+     *
+     * @param plugin      The plugin.
+     * @param name        The subcommand name.
+     * @param permission  The subcommand permission.
+     * @param playersOnly If the subcommand only works on players.
+     */
+    protected Subcommand(@NotNull final EcoPlugin plugin,
+                         @NotNull final String name,
+                         @NotNull final String permission,
+                         final boolean playersOnly) {
+        super(plugin, name, permission, playersOnly);
+    }
+
+    /**
+     * Create subcommand.
+     *
+     * @param plugin The plugin.
+     * @param name   The name of the subcommand.
+     * @param parent The parent command.
+     */
+    protected Subcommand(@NotNull final EcoPlugin plugin,
+                         @NotNull final String name,
+                         @NotNull final CommandBase parent) {
+        super(plugin, name, parent.getPermission(), parent.isPlayersOnly());
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/base/ConfigYml.java

@@ -0,0 +1,19 @@
+package com.willfp.eco.core.config.base;
+
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.config.yaml.YamlBaseConfig;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Default plugin config.yml.
+ */
+public class ConfigYml extends YamlBaseConfig {
+    /**
+     * Config.yml.
+     *
+     * @param plugin The plugin.
+     */
+    public ConfigYml(@NotNull final EcoPlugin plugin) {
+        super("config", true, plugin);
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/base/LangYml.java

@@ -1,17 +1,19 @@
-package com.willfp.eco.util.config.configs;
+package com.willfp.eco.core.config.base;
 
-import com.willfp.eco.util.StringUtils;
-import com.willfp.eco.util.config.BaseConfig;
-import com.willfp.eco.util.plugin.AbstractEcoPlugin;
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.config.yaml.YamlBaseConfig;
 import org.jetbrains.annotations.NotNull;
 
-public class Lang extends BaseConfig {
+/**
+ * Default plugin lang.yml.
+ */
+public class LangYml extends YamlBaseConfig {
     /**
      * Lang.yml.
      *
      * @param plugin The plugin.
      */
-    public Lang(@NotNull final AbstractEcoPlugin plugin) {
+    public LangYml(@NotNull final EcoPlugin plugin) {
         super("lang", false, plugin);
     }
 
@@ -21,7 +23,7 @@ public class Lang extends BaseConfig {
      * @return The prefix.
      */
     public String getPrefix() {
-        return StringUtils.translate(this.getConfig().getString("messages.prefix"));
+        return this.getString("messages.prefix");
     }
 
     /**
@@ -30,7 +32,7 @@ public class Lang extends BaseConfig {
      * @return The message.
      */
     public String getNoPermission() {
-        return getPrefix() + StringUtils.translate(this.getConfig().getString("messages.no-permission"));
+        return getPrefix() + this.getString("messages.no-permission");
     }
 
     /**
@@ -40,6 +42,6 @@ public class Lang extends BaseConfig {
      * @return The message with a prefix appended.
      */
     public String getMessage(@NotNull final String message) {
-        return getPrefix() + StringUtils.translate(this.getConfig().getString("messages." + message));
+        return getPrefix() + this.getString("messages." + message);
     }
 }

eco-api/src/main/java/com/willfp/eco/core/config/interfaces/Config.java

@@ -0,0 +1,284 @@
+package com.willfp.eco.core.config.interfaces;
+
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * All canfigs implement this interface.
+ * <p>
+ * Contains all methods that must exist in yaml and json configurations.
+ */
+public interface Config extends Cloneable {
+    /**
+     * Clears cache.
+     */
+    void clearCache();
+
+    /**
+     * Convert the config into readable text.
+     *
+     * @return The plaintext.
+     */
+    String toPlaintext();
+
+    /**
+     * Get if the config contains a key.
+     *
+     * @param path The key to check.
+     * @return If contained.
+     */
+    boolean has(@NotNull String path);
+
+    /**
+     * Get config keys.
+     *
+     * @param deep If keys from subsections should be fetched too.
+     * @return A list of keys.
+     */
+    @NotNull
+    List<String> getKeys(boolean deep);
+
+    /**
+     * Get an object from config.
+     * Default implementations call {@link org.bukkit.configuration.file.YamlConfiguration#get(String)}.
+     *
+     * @param path The path.
+     * @return The object.
+     */
+    @Nullable
+    Object get(@NotNull String path);
+
+    /**
+     * Set an object in config.
+     * Default implementations call {@link org.bukkit.configuration.file.YamlConfiguration#set(String, Object)}
+     *
+     * @param path   The path.
+     * @param object The object.
+     */
+    void set(@NotNull String path,
+             @Nullable Object object);
+
+    /**
+     * Get subsection from config.
+     *
+     * @param path The key to check.
+     * @return The subsection. Throws NPE if not found.
+     */
+    @NotNull
+    Config getSubsection(@NotNull String path);
+
+    /**
+     * Get subsection from config.
+     *
+     * @param path The key to check.
+     * @return The subsection, or null if not found.
+     */
+    @Nullable
+    Config getSubsectionOrNull(@NotNull String path);
+
+    /**
+     * Get an integer from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or 0 if not found.
+     */
+    int getInt(@NotNull String path);
+
+    /**
+     * Get an integer from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    Integer getIntOrNull(@NotNull String path);
+
+    /**
+     * Get an integer from config with a specified default (not found) value.
+     *
+     * @param path The key to fetch the value from.
+     * @param def  The value to default to if not found.
+     * @return The found value, or the default.
+     */
+    int getInt(@NotNull String path,
+               int def);
+
+    /**
+     * Get a list of integers from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or a blank {@link java.util.ArrayList} if not found.
+     */
+    @NotNull
+    List<Integer> getInts(@NotNull String path);
+
+    /**
+     * Get a list of integers from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    List<Integer> getIntsOrNull(@NotNull String path);
+
+    /**
+     * Get a boolean from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or false if not found.
+     */
+    boolean getBool(@NotNull String path);
+
+    /**
+     * Get a boolean from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    Boolean getBoolOrNull(@NotNull String path);
+
+    /**
+     * Get a list of booleans from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or a blank {@link java.util.ArrayList} if not found.
+     */
+    @NotNull
+    List<Boolean> getBools(@NotNull String path);
+
+    /**
+     * Get a list of booleans from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    List<Boolean> getBoolsOrNull(@NotNull String path);
+
+    /**
+     * Get a string from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or an empty string if not found.
+     */
+    @NotNull
+    String getString(@NotNull String path);
+
+    /**
+     * Get a string from config.
+     *
+     * @param path   The key to fetch the value from.
+     * @param format If the string should be formatted.
+     * @return The found value, or an empty string if not found.
+     */
+    @NotNull
+    String getString(@NotNull String path,
+                     boolean format);
+
+    /**
+     * Get a string from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    String getStringOrNull(@NotNull String path);
+
+    /**
+     * Get a string from config.
+     *
+     * @param path   The key to fetch the value from.
+     * @param format If the string should be formatted.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    String getStringOrNull(@NotNull String path,
+                           boolean format);
+
+    /**
+     * Get a list of strings from config.
+     * <p>
+     * Formatted by default.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or a blank {@link java.util.ArrayList} if not found.
+     */
+    @NotNull
+    List<String> getStrings(@NotNull String path);
+
+    /**
+     * Get a list of strings from config.
+     *
+     * @param path   The key to fetch the value from.
+     * @param format If the strings should be formatted.
+     * @return The found value, or a blank {@link java.util.ArrayList} if not found.
+     */
+    @NotNull
+    List<String> getStrings(@NotNull String path,
+                            boolean format);
+
+    /**
+     * Get a list of strings from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    List<String> getStringsOrNull(@NotNull String path);
+
+    /**
+     * Get a list of strings from config.
+     *
+     * @param path   The key to fetch the value from.
+     * @param format If the strings should be formatted.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    List<String> getStringsOrNull(@NotNull String path,
+                                  boolean format);
+
+    /**
+     * Get a decimal from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or 0 if not found.
+     */
+    double getDouble(@NotNull String path);
+
+    /**
+     * Get a decimal from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    Double getDoubleOrNull(@NotNull String path);
+
+    /**
+     * Get a list of decimals from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or a blank {@link java.util.ArrayList} if not found.
+     */
+    @NotNull
+    List<Double> getDoubles(@NotNull String path);
+
+    /**
+     * Get a list of decimals from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    List<Double> getDoublesOrNull(@NotNull String path);
+
+    /**
+     * Clone the config.
+     *
+     * @return The clone.
+     */
+    Config clone();
+}

eco-api/src/main/java/com/willfp/eco/core/config/interfaces/JSONConfig.java

@@ -0,0 +1,34 @@
+package com.willfp.eco.core.config.interfaces;
+
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * JSON configs have extra methods compared to yaml configs.
+ * <p>
+ * If you need to use them, then use JSONConfig instead.
+ */
+public interface JSONConfig extends Config {
+    /**
+     * Get a list of subsections from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or a blank {@link java.util.ArrayList} if not found.
+     */
+    @NotNull
+    List<JSONConfig> getSubsections(@NotNull String path);
+
+    /**
+     * Get a list of subsections from config.
+     *
+     * @param path The key to fetch the value from.
+     * @return The found value, or null if not found.
+     */
+    @Nullable
+    List<JSONConfig> getSubsectionsOrNull(@NotNull String path);
+
+    @Override
+    JSONConfig clone();
+}

eco-api/src/main/java/com/willfp/eco/core/config/interfaces/LoadableConfig.java

@@ -0,0 +1,42 @@
+package com.willfp.eco.core.config.interfaces;
+
+import java.io.File;
+import java.io.IOException;
+
+/**
+ * Interface for configs that physically exist as files in plugins.
+ */
+public interface LoadableConfig {
+    /**
+     * Create the file.
+     */
+    void createFile();
+
+    /**
+     * Get resource path as relative to base directory.
+     *
+     * @return The resource path.
+     */
+    String getResourcePath();
+
+    /**
+     * Save the config.
+     *
+     * @throws IOException If error in saving.
+     */
+    void save() throws IOException;
+
+    /**
+     * Get the config file.
+     *
+     * @return The file.
+     */
+    File getConfigFile();
+
+    /**
+     * Get the config name (including extension)
+     *
+     * @return The name.
+     */
+    String getName();
+}

eco-api/src/main/java/com/willfp/eco/core/config/interfaces/WrappedYamlConfiguration.java

@@ -0,0 +1,17 @@
+package com.willfp.eco.core.config.interfaces;
+
+import org.bukkit.configuration.file.YamlConfiguration;
+
+/**
+ * Interface for configs that wrap an {@link YamlConfiguration}.
+ *
+ * @see com.willfp.eco.core.config.yaml.wrapper.YamlConfigWrapper
+ */
+public interface WrappedYamlConfiguration {
+    /**
+     * Get the ConfigurationSection handle.
+     *
+     * @return The handle.
+     */
+    YamlConfiguration getBukkitHandle();
+}

eco-api/src/main/java/com/willfp/eco/core/config/json/JSONStaticBaseConfig.java

@@ -0,0 +1,24 @@
+package com.willfp.eco.core.config.json;
+
+import com.willfp.eco.core.Eco;
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.config.json.wrapper.LoadableJSONConfigWrapper;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Non-updatable JSON config that exists within a plugin jar.
+ */
+public abstract class JSONStaticBaseConfig extends LoadableJSONConfigWrapper {
+    /**
+     * Config implementation for configs present in the plugin's base directory (eg config.json, lang.json).
+     * <p>
+     * Does not automatically update.
+     *
+     * @param configName The name of the config
+     * @param plugin     The plugin.
+     */
+    protected JSONStaticBaseConfig(@NotNull final String configName,
+                                   @NotNull final EcoPlugin plugin) {
+        super(Eco.getHandler().getConfigFactory().createLoadableJSONConfig(configName, plugin, "", plugin.getClass()));
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/json/JSONTransientConfig.java

@@ -0,0 +1,23 @@
+package com.willfp.eco.core.config.json;
+
+import com.willfp.eco.core.Eco;
+import com.willfp.eco.core.config.json.wrapper.JSONConfigWrapper;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.Map;
+
+/**
+ * Raw JSON config with a map of values at its core.
+ */
+public class JSONTransientConfig extends JSONConfigWrapper {
+    /**
+     * Config implementation for passing maps.
+     * <p>
+     * Does not automatically update.
+     *
+     * @param values The map of values.
+     */
+    public JSONTransientConfig(@NotNull final Map<String, Object> values) {
+        super(Eco.getHandler().getConfigFactory().createJSONConfig(values));
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/json/wrapper/JSONConfigWrapper.java

@@ -0,0 +1,38 @@
+package com.willfp.eco.core.config.json.wrapper;
+
+import com.willfp.eco.core.config.interfaces.JSONConfig;
+import com.willfp.eco.core.config.wrapper.ConfigWrapper;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Wrapper to handle the backend JSON config implementations.
+ */
+public abstract class JSONConfigWrapper extends ConfigWrapper<JSONConfig> implements JSONConfig {
+    /**
+     * Create a config wrapper.
+     *
+     * @param handle The handle.
+     */
+    protected JSONConfigWrapper(@NotNull final JSONConfig handle) {
+        super(handle);
+    }
+
+
+    @Override
+    public @NotNull List<JSONConfig> getSubsections(@NotNull final String path) {
+        return this.getHandle().getSubsections(path);
+    }
+
+    @Override
+    public @Nullable List<JSONConfig> getSubsectionsOrNull(@NotNull final String path) {
+        return this.getHandle().getSubsectionsOrNull(path);
+    }
+
+    @Override
+    public JSONConfig clone() {
+        return this.getHandle().clone();
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/json/wrapper/LoadableJSONConfigWrapper.java

@@ -0,0 +1,51 @@
+package com.willfp.eco.core.config.json.wrapper;
+
+import com.willfp.eco.core.config.interfaces.JSONConfig;
+import com.willfp.eco.core.config.interfaces.LoadableConfig;
+import org.apache.commons.lang.Validate;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.File;
+import java.io.IOException;
+
+/**
+ * Wrapper to handle the backend loadable JSON config implementations.
+ */
+public abstract class LoadableJSONConfigWrapper extends JSONConfigWrapper implements LoadableConfig {
+    /**
+     * Create a config wrapper.
+     *
+     * @param handle The handle.
+     */
+    protected LoadableJSONConfigWrapper(@NotNull final JSONConfig handle) {
+        super(handle);
+
+        Validate.isTrue(handle instanceof LoadableConfig, "Wrapped config must be loadable!");
+    }
+
+
+    @Override
+    public void createFile() {
+        ((LoadableConfig) this.getHandle()).createFile();
+    }
+
+    @Override
+    public String getResourcePath() {
+        return ((LoadableConfig) this.getHandle()).getResourcePath();
+    }
+
+    @Override
+    public void save() throws IOException {
+        ((LoadableConfig) this.getHandle()).save();
+    }
+
+    @Override
+    public File getConfigFile() {
+        return ((LoadableConfig) this.getHandle()).getConfigFile();
+    }
+
+    @Override
+    public String getName() {
+        return ((LoadableConfig) this.getHandle()).getName();
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/updating/ConfigHandler.java

@@ -0,0 +1,33 @@
+package com.willfp.eco.core.config.updating;
+
+import com.willfp.eco.core.config.interfaces.LoadableConfig;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Every {@link com.willfp.eco.core.EcoPlugin} has a config handler.
+ * <p>
+ * Handles updating and saving configs.
+ */
+public interface ConfigHandler {
+    /**
+     * Invoke all update methods.
+     */
+    void callUpdate();
+
+    /**
+     * Save all configs.
+     */
+    void saveAllConfigs();
+
+    /**
+     * Update all updatable configs.
+     */
+    void updateConfigs();
+
+    /**
+     * Add new config to be saved.
+     *
+     * @param config The config.
+     */
+    void addConfig(@NotNull LoadableConfig config);
+}

eco-api/src/main/java/com/willfp/eco/core/config/updating/ConfigUpdater.java

@@ -0,0 +1,39 @@
+package com.willfp.eco.core.config.updating;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Annotation to put on update methods.
+ * <p>
+ * All update methods must be public and static,
+ * and can accept an EcoPlugin as a parameter.
+ * <p>
+ * As such, there are only 2 valid update methods:
+ * <p>
+ * The first:
+ * <pre>{@code
+ * @ConfigUpdater
+ * public static void update() {
+ *     // Update code
+ * }
+ * }</pre>
+ * <p>
+ * The second:
+ * <pre>{@code
+ * public static void update(EcoPlugin plugin) {}
+ *     // Update code
+ * }</pre>
+ * <p>
+ * Config update methods in all classes in a plugin jar will be called
+ * on reload.
+ * <p>
+ * By having a plugin as a parameter, you shouldn't really need getInstance()
+ * calls in your code.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface ConfigUpdater {
+}

eco-api/src/main/java/com/willfp/eco/core/config/wrapper/ConfigFactory.java

@@ -0,0 +1,76 @@
+package com.willfp.eco.core.config.wrapper;
+
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.config.interfaces.Config;
+import com.willfp.eco.core.config.interfaces.JSONConfig;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.Map;
+
+/**
+ * Internal component to create backend config implementations.
+ */
+public interface ConfigFactory {
+    /**
+     * Updatable config.
+     *
+     * @param configName       The name of the config
+     * @param plugin           The plugin.
+     * @param subDirectoryPath The subdirectory path.
+     * @param source           The class that owns the resource.
+     * @param removeUnused     Whether keys not present in the default config should be removed on update.
+     * @param updateBlacklist  Substring of keys to not add/remove keys for.
+     * @return The config implementation.
+     */
+    Config createUpdatableYamlConfig(@NotNull String configName,
+                                     @NotNull EcoPlugin plugin,
+                                     @NotNull String subDirectoryPath,
+                                     @NotNull Class<?> source,
+                                     boolean removeUnused,
+                                     @NotNull String... updateBlacklist);
+
+    /**
+     * JSON loadable config.
+     *
+     * @param configName       The name of the config
+     * @param plugin           The plugin.
+     * @param subDirectoryPath The subdirectory path.
+     * @param source           The class that owns the resource.
+     * @return The config implementation.
+     */
+    JSONConfig createLoadableJSONConfig(@NotNull String configName,
+                                        @NotNull EcoPlugin plugin,
+                                        @NotNull String subDirectoryPath,
+                                        @NotNull Class<?> source);
+
+    /**
+     * Yaml loadable config.
+     *
+     * @param configName       The name of the config
+     * @param plugin           The plugin.
+     * @param subDirectoryPath The subdirectory path.
+     * @param source           The class that owns the resource.
+     * @return The config implementation.
+     */
+    Config createLoadableYamlConfig(@NotNull String configName,
+                                    @NotNull EcoPlugin plugin,
+                                    @NotNull String subDirectoryPath,
+                                    @NotNull Class<?> source);
+
+    /**
+     * Yaml config.
+     *
+     * @param config The handle.
+     * @return The config implementation.
+     */
+    Config createYamlConfig(@NotNull YamlConfiguration config);
+
+    /**
+     * JSON config.
+     *
+     * @param values The values.
+     * @return The config implementation.
+     */
+    JSONConfig createJSONConfig(@NotNull Map<String, Object> values);
+}

eco-api/src/main/java/com/willfp/eco/core/config/wrapper/ConfigWrapper.java

@@ -0,0 +1,196 @@
+package com.willfp.eco.core.config.wrapper;
+
+import com.willfp.eco.core.config.interfaces.Config;
+import lombok.Getter;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Configs from eco have an internal implementation,
+ * which is the handle.
+ * <p>
+ * This class handles them.
+ *
+ * @param <T> The type of the handle.
+ */
+public abstract class ConfigWrapper<T extends Config> implements Config {
+    /**
+     * Configs from eco have an internal implementation,
+     * which is the handle.
+     * <p>
+     * The handle should only ever be used if you want to
+     * do something <i>interesting</i> config-wise with some
+     * internals.
+     * <p>
+     * In general use, though, the handle isn't necessary.
+     */
+    @Getter
+    private final T handle;
+
+    /**
+     * Create a config wrapper.
+     *
+     * @param handle The config that is being wrapped.
+     */
+    protected ConfigWrapper(@NotNull final T handle) {
+        this.handle = handle;
+    }
+
+    @Override
+    public void clearCache() {
+        handle.clearCache();
+    }
+
+    @Override
+    public String toPlaintext() {
+        return handle.toPlaintext();
+    }
+
+    @Override
+    public boolean has(@NotNull final String path) {
+        return handle.has(path);
+    }
+
+    @Override
+    public @NotNull List<String> getKeys(final boolean deep) {
+        return handle.getKeys(deep);
+    }
+
+    @Override
+    public @Nullable Object get(@NotNull final String path) {
+        return handle.get(path);
+    }
+
+    @Override
+    public void set(@NotNull final String path,
+                    @Nullable final Object object) {
+        handle.set(path, object);
+    }
+
+    @Override
+    public @NotNull Config getSubsection(@NotNull final String path) {
+        return handle.getSubsection(path);
+    }
+
+    @Override
+    public @Nullable Config getSubsectionOrNull(@NotNull final String path) {
+        return handle.getSubsectionOrNull(path);
+    }
+
+    @Override
+    public int getInt(@NotNull final String path) {
+        return handle.getInt(path);
+    }
+
+    @Override
+    public @Nullable Integer getIntOrNull(@NotNull final String path) {
+        return handle.getIntOrNull(path);
+    }
+
+    @Override
+    public int getInt(@NotNull final String path,
+                      final int def) {
+        return handle.getInt(path, def);
+    }
+
+    @Override
+    public @NotNull List<Integer> getInts(@NotNull final String path) {
+        return handle.getInts(path);
+    }
+
+    @Override
+    public @Nullable List<Integer> getIntsOrNull(@NotNull final String path) {
+        return handle.getIntsOrNull(path);
+    }
+
+    @Override
+    public boolean getBool(@NotNull final String path) {
+        return handle.getBool(path);
+    }
+
+    @Override
+    public @Nullable Boolean getBoolOrNull(@NotNull final String path) {
+        return handle.getBoolOrNull(path);
+    }
+
+    @Override
+    public @NotNull List<Boolean> getBools(@NotNull final String path) {
+        return handle.getBools(path);
+    }
+
+    @Override
+    public @Nullable List<Boolean> getBoolsOrNull(@NotNull final String path) {
+        return handle.getBoolsOrNull(path);
+    }
+
+    @Override
+    public @NotNull String getString(@NotNull final String path) {
+        return handle.getString(path);
+    }
+
+    @Override
+    public @NotNull String getString(@NotNull final String path,
+                                     final boolean format) {
+        return handle.getString(path, format);
+    }
+
+    @Override
+    public @Nullable String getStringOrNull(@NotNull final String path) {
+        return handle.getStringOrNull(path);
+    }
+
+    @Override
+    public @Nullable String getStringOrNull(@NotNull final String path,
+                                            final boolean format) {
+        return handle.getStringOrNull(path, format);
+    }
+
+    @Override
+    public @NotNull List<String> getStrings(@NotNull final String path) {
+        return handle.getStrings(path);
+    }
+
+    @Override
+    public @NotNull List<String> getStrings(@NotNull final String path,
+                                            final boolean format) {
+        return handle.getStrings(path, format);
+    }
+
+    @Override
+    public @Nullable List<String> getStringsOrNull(@NotNull final String path) {
+        return handle.getStringsOrNull(path);
+    }
+
+    @Override
+    public @Nullable List<String> getStringsOrNull(@NotNull final String path,
+                                                   final boolean format) {
+        return handle.getStringsOrNull(path, format);
+    }
+
+    @Override
+    public double getDouble(@NotNull final String path) {
+        return handle.getDouble(path);
+    }
+
+    @Override
+    public @Nullable Double getDoubleOrNull(@NotNull final String path) {
+        return handle.getDoubleOrNull(path);
+    }
+
+    @Override
+    public @NotNull List<Double> getDoubles(@NotNull final String path) {
+        return handle.getDoubles(path);
+    }
+
+    @Override
+    public @Nullable List<Double> getDoublesOrNull(@NotNull final String path) {
+        return handle.getDoublesOrNull(path);
+    }
+
+    @Override
+    public Config clone() {
+        return handle.clone();
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/yaml/YamlBaseConfig.java

@@ -0,0 +1,53 @@
+package com.willfp.eco.core.config.yaml;
+
+import com.willfp.eco.core.Eco;
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.config.yaml.wrapper.LoadableYamlConfigWrapper;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Config implementation for configs present in the plugin's base directory (eg config.yml, lang.yml).
+ * <p>
+ * Automatically updates.
+ */
+public abstract class YamlBaseConfig extends LoadableYamlConfigWrapper {
+    /**
+     * @param configName      The name of the config
+     * @param removeUnused    Whether keys not present in the default config should be removed on update.
+     * @param plugin          The plugin.
+     * @param updateBlacklist Substring of keys to not add/remove keys for.
+     */
+    protected YamlBaseConfig(@NotNull final String configName,
+                             final boolean removeUnused,
+                             @NotNull final EcoPlugin plugin,
+                             @NotNull final String... updateBlacklist) {
+        super(
+                Eco.getHandler().getConfigFactory().createUpdatableYamlConfig(
+                        configName,
+                        plugin,
+                        "",
+                        plugin.getClass(),
+                        removeUnused, updateBlacklist
+                )
+        );
+    }
+
+    /**
+     * @param configName   The name of the config
+     * @param removeUnused Whether keys not present in the default config should be removed on update.
+     * @param plugin       The plugin.
+     */
+    protected YamlBaseConfig(@NotNull final String configName,
+                             final boolean removeUnused,
+                             @NotNull final EcoPlugin plugin) {
+        super(
+                Eco.getHandler().getConfigFactory().createUpdatableYamlConfig(
+                        configName,
+                        plugin,
+                        "",
+                        plugin.getClass(),
+                        removeUnused
+                )
+        );
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/yaml/YamlExtendableConfig.java

@@ -0,0 +1,43 @@
+package com.willfp.eco.core.config.yaml;
+
+import com.willfp.eco.core.Eco;
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.config.yaml.wrapper.LoadableYamlConfigWrapper;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Config implementation for configs present in one of two places:
+ * <ul>
+ *     <li>Plugin base directory (eg config.yml, lang.yml)</li>
+ *     <li>Other extension's configs</li>
+ * </ul>
+ * <p>
+ * Automatically updates.
+ */
+public abstract class YamlExtendableConfig extends LoadableYamlConfigWrapper {
+    /**
+     * @param configName       The name of the config
+     * @param removeUnused     Whether keys not present in the default config should be removed on update.
+     * @param plugin           The plugin.
+     * @param updateBlacklist  Substring of keys to not add/remove keys for.
+     * @param subDirectoryPath The subdirectory path.
+     * @param source           The class that owns the resource.
+     */
+    protected YamlExtendableConfig(@NotNull final String configName,
+                                   final boolean removeUnused,
+                                   @NotNull final EcoPlugin plugin,
+                                   @NotNull final Class<?> source,
+                                   @NotNull final String subDirectoryPath,
+                                   @NotNull final String... updateBlacklist) {
+        super(
+                Eco.getHandler().getConfigFactory().createUpdatableYamlConfig(
+                        configName,
+                        plugin,
+                        subDirectoryPath,
+                        source,
+                        removeUnused,
+                        updateBlacklist
+                )
+        );
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/yaml/YamlStaticBaseConfig.java

@@ -0,0 +1,24 @@
+package com.willfp.eco.core.config.yaml;
+
+import com.willfp.eco.core.Eco;
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.config.yaml.wrapper.LoadableYamlConfigWrapper;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Non-updatable yaml config that exists within a plugin jar.
+ */
+public abstract class YamlStaticBaseConfig extends LoadableYamlConfigWrapper {
+    /**
+     * Config implementation for configs present in the plugin's base directory (eg config.yml, lang.yml).
+     * <p>
+     * Does not automatically update.
+     *
+     * @param configName The name of the config
+     * @param plugin     The plugin.
+     */
+    protected YamlStaticBaseConfig(@NotNull final String configName,
+                                   @NotNull final EcoPlugin plugin) {
+        super(Eco.getHandler().getConfigFactory().createLoadableYamlConfig(configName, plugin, "", plugin.getClass()));
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/yaml/YamlTransientConfig.java

@@ -0,0 +1,29 @@
+package com.willfp.eco.core.config.yaml;
+
+import com.willfp.eco.core.Eco;
+import com.willfp.eco.core.config.yaml.wrapper.YamlConfigWrapper;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.StringReader;
+
+/**
+ * Config implementation for passing YamlConfigurations.
+ * <p>
+ * Does not automatically update.
+ */
+public class YamlTransientConfig extends YamlConfigWrapper {
+    /**
+     * @param config     The YamlConfiguration handle.
+     */
+    public YamlTransientConfig(@NotNull final YamlConfiguration config) {
+        super(Eco.getHandler().getConfigFactory().createYamlConfig(config));
+    }
+
+    /**
+     * @param contents     The contents of the config.
+     */
+    public YamlTransientConfig(@NotNull final String contents) {
+        super(Eco.getHandler().getConfigFactory().createYamlConfig(YamlConfiguration.loadConfiguration(new StringReader(contents))));
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/yaml/wrapper/LoadableYamlConfigWrapper.java

@@ -0,0 +1,51 @@
+package com.willfp.eco.core.config.yaml.wrapper;
+
+import com.willfp.eco.core.config.interfaces.Config;
+import com.willfp.eco.core.config.interfaces.LoadableConfig;
+import org.apache.commons.lang.Validate;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.File;
+import java.io.IOException;
+
+/**
+ * Wrapper to handle the backend loadable yaml config implementations.
+ */
+public abstract class LoadableYamlConfigWrapper extends YamlConfigWrapper implements LoadableConfig {
+    /**
+     * Create a config wrapper.
+     *
+     * @param handle The handle.
+     */
+    protected LoadableYamlConfigWrapper(@NotNull final Config handle) {
+        super(handle);
+
+        Validate.isTrue(handle instanceof LoadableConfig, "Wrapped config must be loadable!");
+    }
+
+
+    @Override
+    public void createFile() {
+        ((LoadableConfig) this.getHandle()).createFile();
+    }
+
+    @Override
+    public String getResourcePath() {
+        return ((LoadableConfig) this.getHandle()).getResourcePath();
+    }
+
+    @Override
+    public void save() throws IOException {
+        ((LoadableConfig) this.getHandle()).save();
+    }
+
+    @Override
+    public File getConfigFile() {
+        return ((LoadableConfig) this.getHandle()).getConfigFile();
+    }
+
+    @Override
+    public String getName() {
+        return ((LoadableConfig) this.getHandle()).getName();
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/config/yaml/wrapper/YamlConfigWrapper.java

@@ -0,0 +1,27 @@
+package com.willfp.eco.core.config.yaml.wrapper;
+
+import com.willfp.eco.core.config.interfaces.Config;
+import com.willfp.eco.core.config.interfaces.WrappedYamlConfiguration;
+import com.willfp.eco.core.config.wrapper.ConfigWrapper;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Wrapper to handle the backend yaml config implementations.
+ */
+public abstract class YamlConfigWrapper extends ConfigWrapper<Config> implements WrappedYamlConfiguration {
+    /**
+     * Create a config wrapper.
+     *
+     * @param handle The handle.
+     */
+    protected YamlConfigWrapper(@NotNull final Config handle) {
+        super(handle);
+    }
+
+
+    @Override
+    public YamlConfiguration getBukkitHandle() {
+        return ((WrappedYamlConfiguration) this.getHandle()).getBukkitHandle();
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/display/Display.java

@@ -0,0 +1,219 @@
+package com.willfp.eco.core.display;
+
+import lombok.experimental.UtilityClass;
+import org.apache.commons.lang.Validate;
+import org.bukkit.NamespacedKey;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.meta.ItemMeta;
+import org.bukkit.persistence.PersistentDataContainer;
+import org.bukkit.persistence.PersistentDataType;
+import org.jetbrains.annotations.ApiStatus;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Utility class to manage client-side item display.
+ */
+@UtilityClass
+public class Display {
+    /**
+     * The prefix for client-side lore lines.
+     */
+    public static final String PREFIX = "§z";
+
+    /**
+     * All registered display modules.
+     */
+    private static final Map<DisplayPriority, List<DisplayModule>> MODULES = new HashMap<>();
+
+    /**
+     * NamespacedKey for finalizing.
+     */
+    private static NamespacedKey finalizeKey = null;
+
+    /**
+     * Register display module.
+     *
+     * @param module The module.
+     */
+    public void registerDisplayModule(@NotNull final DisplayModule module) {
+        List<DisplayModule> modules = MODULES.get(module.getPriority());
+
+        modules.removeIf(module1 -> module1.getPluginName().equalsIgnoreCase(module.getPluginName()));
+
+        modules.add(module);
+
+        MODULES.put(module.getPriority(), modules);
+    }
+
+    /**
+     * Display on ItemStacks.
+     *
+     * @param itemStack The item.
+     * @return The ItemStack.
+     */
+    public ItemStack display(@NotNull final ItemStack itemStack) {
+        if (!itemStack.hasItemMeta()) {
+            return itemStack; // return early if there's no customization of the item
+        }
+
+        Map<String, Object[]> pluginVarArgs = new HashMap<>();
+
+        for (DisplayPriority priority : DisplayPriority.values()) {
+            List<DisplayModule> modules = MODULES.get(priority);
+            for (DisplayModule module : modules) {
+                pluginVarArgs.put(module.getPluginName(), module.generateVarArgs(itemStack));
+            }
+        }
+
+        revert(itemStack);
+
+        ItemMeta meta = itemStack.getItemMeta();
+
+        if (meta == null) {
+            return itemStack;
+        }
+
+        for (DisplayPriority priority : DisplayPriority.values()) {
+            List<DisplayModule> modules = MODULES.get(priority);
+            for (DisplayModule module : modules) {
+                Object[] varargs = pluginVarArgs.get(module.getPluginName());
+                module.display(itemStack, varargs);
+            }
+        }
+
+        return itemStack;
+    }
+
+    /**
+     * Display on ItemStacks and then finalize.
+     *
+     * @param itemStack The item.
+     * @return The ItemStack.
+     */
+    public ItemStack displayAndFinalize(@NotNull final ItemStack itemStack) {
+        return finalize(display(itemStack));
+    }
+
+    /**
+     * Revert on ItemStacks.
+     *
+     * @param itemStack The item.
+     * @return The ItemStack.
+     */
+    public ItemStack revert(@NotNull final ItemStack itemStack) {
+        if (Display.isFinalized(itemStack)) {
+            unfinalize(itemStack);
+        }
+
+        if (!itemStack.hasItemMeta()) {
+            return itemStack;
+        }
+
+        ItemMeta meta = itemStack.getItemMeta();
+
+        if (meta == null) {
+            return itemStack;
+        }
+
+        List<String> lore = meta.getLore();
+
+        if (lore != null && lore.removeIf(line -> line.startsWith(Display.PREFIX))) { // only apply lore modification if needed
+            meta.setLore(lore);
+            itemStack.setItemMeta(meta);
+        }
+
+        for (DisplayPriority priority : DisplayPriority.values()) {
+            List<DisplayModule> modules = MODULES.get(priority);
+            for (DisplayModule module : modules) {
+                module.revert(itemStack);
+            }
+        }
+
+        return itemStack;
+    }
+
+    /**
+     * Finalize an ItemStacks.
+     *
+     * @param itemStack The item.
+     * @return The ItemStack.
+     */
+    public ItemStack finalize(@NotNull final ItemStack itemStack) {
+        Validate.notNull(finalizeKey, "Key cannot be null!");
+
+        if (itemStack.getType().getMaxStackSize() > 1) {
+            return itemStack;
+        }
+
+        ItemMeta meta = itemStack.getItemMeta();
+        if (meta == null) {
+            return itemStack;
+        }
+
+        PersistentDataContainer container = meta.getPersistentDataContainer();
+        container.set(finalizeKey, PersistentDataType.INTEGER, 1);
+        itemStack.setItemMeta(meta);
+        return itemStack;
+    }
+
+    /**
+     * Unfinalize an ItemStacks.
+     *
+     * @param itemStack The item.
+     * @return The ItemStack.
+     */
+    public ItemStack unfinalize(@NotNull final ItemStack itemStack) {
+        Validate.notNull(finalizeKey, "Key cannot be null!");
+
+        ItemMeta meta = itemStack.getItemMeta();
+
+        if (meta == null) {
+            return itemStack;
+        }
+
+        PersistentDataContainer container = meta.getPersistentDataContainer();
+        container.remove(finalizeKey);
+        itemStack.setItemMeta(meta);
+        return itemStack;
+    }
+
+    /**
+     * If an item is finalized.
+     *
+     * @param itemStack The item.
+     * @return If finalized.
+     */
+    public boolean isFinalized(@NotNull final ItemStack itemStack) {
+        Validate.notNull(finalizeKey, "Key cannot be null!");
+
+        ItemMeta meta = itemStack.getItemMeta();
+
+        if (meta == null) {
+            return false;
+        }
+
+        PersistentDataContainer container = meta.getPersistentDataContainer();
+        return container.has(finalizeKey, PersistentDataType.INTEGER);
+    }
+
+    /**
+     * Set key to be used for finalization.
+     *
+     * @param finalizeKey The key.
+     */
+    @ApiStatus.Internal
+    public static void setFinalizeKey(@NotNull final NamespacedKey finalizeKey) {
+        Display.finalizeKey = finalizeKey;
+    }
+
+    static {
+        for (DisplayPriority priority : DisplayPriority.values()) {
+            MODULES.put(priority, new ArrayList<>());
+        }
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/display/DisplayModule.java

@@ -0,0 +1,69 @@
+package com.willfp.eco.core.display;
+
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.PluginDependent;
+import lombok.Getter;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Class for all plugin-specific client-side item display modules.
+ */
+public abstract class DisplayModule extends PluginDependent<EcoPlugin> {
+    /**
+     * The priority of the module.
+     */
+    @Getter
+    private final DisplayPriority priority;
+
+    /**
+     * Create a new display module.
+     *
+     * @param plugin   The plugin that the display is for.
+     * @param priority The priority of the module.
+     */
+    protected DisplayModule(@NotNull final EcoPlugin plugin,
+                            @NotNull final DisplayPriority priority) {
+        super(plugin);
+        this.priority = priority;
+    }
+
+    /**
+     * Display an item.
+     *
+     * @param itemStack The item.
+     * @param args      Optional args for display.
+     */
+    protected void display(@NotNull final ItemStack itemStack,
+                           @NotNull final Object... args) {
+        // Technically optional.
+    }
+
+    /**
+     * Revert an item.
+     *
+     * @param itemStack The item.
+     */
+    protected void revert(@NotNull final ItemStack itemStack) {
+        // Technically optional.
+    }
+
+    /**
+     * Create varargs to pass back to ItemStack after reverting, but before display.
+     *
+     * @param itemStack The itemStack.
+     * @return The plugin-specific varargs.
+     */
+    protected Object[] generateVarArgs(@NotNull final ItemStack itemStack) {
+        return new Object[0];
+    }
+
+    /**
+     * Get name of plugin.
+     *
+     * @return The plugin name.
+     */
+    public final String getPluginName() {
+        return super.getPlugin().getName();
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/display/DisplayPriority.java

@@ -0,0 +1,26 @@
+package com.willfp.eco.core.display;
+
+/**
+ * The priority (order) of display modules.
+ */
+public enum DisplayPriority {
+    /**
+     * Ran first.
+     */
+    LOWEST,
+
+    /**
+     * Ran second.
+     */
+    LOW,
+
+    /**
+     * Ran third.
+     */
+    HIGH,
+
+    /**
+     * Ran last.
+     */
+    HIGHEST
+}

eco-api/src/main/java/com/willfp/eco/core/drops/DropQueue.java

@@ -1,10 +1,6 @@
-package com.willfp.eco.util.drops;
+package com.willfp.eco.core.drops;
 
-import com.willfp.eco.util.drops.internal.AbstractDropQueue;
-import com.willfp.eco.util.drops.internal.DropManager;
-import com.willfp.eco.util.drops.internal.DropQueueType;
-import com.willfp.eco.util.drops.internal.FastCollatedDropQueue;
-import com.willfp.eco.util.drops.internal.InternalDropQueue;
+import com.willfp.eco.core.Eco;
 import org.bukkit.Location;
 import org.bukkit.entity.Player;
 import org.bukkit.inventory.ItemStack;
@@ -12,21 +8,26 @@ import org.jetbrains.annotations.NotNull;
 
 import java.util.Collection;
 
+/**
+ * A {@link DropQueue} is a set of drops linked to player.
+ * <p>
+ * All drops should be passed through a drop queue for telekinesis integration.
+ * <p>
+ * It functions essentially as a builder class, and runs very quickly.
+ *
+ * @see com.willfp.eco.util.TelekinesisUtils
+ */
 public class DropQueue {
     /**
-     * The internally used {@link AbstractDropQueue}.
+     * The internally used {@link DropQueue}.
      */
-    private final AbstractDropQueue handle;
+    private final InternalDropQueue handle;
 
     /**
-     * Create {@link DropQueue} linked to player.
-     * <p>
-     * All drops should be passed through a drop queue for telekinesis integration.
-     *
      * @param player The player.
      */
     public DropQueue(@NotNull final Player player) {
-        handle = DropManager.getType() == DropQueueType.COLLATED ? new FastCollatedDropQueue(player) : new InternalDropQueue(player);
+        handle = Eco.getHandler().getDropQueueFactory().create(player);
     }
 
     /**

eco-api/src/main/java/com/willfp/eco/core/drops/DropQueueFactory.java

@@ -0,0 +1,17 @@
+package com.willfp.eco.core.drops;
+
+import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Internal component to create backend DropQueue implementations.
+ */
+public interface DropQueueFactory {
+    /**
+     * Create a DropQueue.
+     *
+     * @param player The player.
+     * @return The Queue.
+     */
+    InternalDropQueue create(@NotNull Player player);
+}

eco-api/src/main/java/com/willfp/eco/core/drops/InternalDropQueue.java

@@ -1,4 +1,4 @@
-package com.willfp.eco.util.drops.internal;
+package com.willfp.eco.core.drops;
 
 import org.bukkit.Location;
 import org.bukkit.inventory.ItemStack;
@@ -6,14 +6,17 @@ import org.jetbrains.annotations.NotNull;
 
 import java.util.Collection;
 
-public interface AbstractDropQueue {
+/**
+ * Internal interface for backend DropQueue implementations.
+ */
+public interface InternalDropQueue {
     /**
      * Add item to queue.
      *
      * @param item The item to add.
      * @return The DropQueue.
      */
-    AbstractDropQueue addItem(@NotNull ItemStack item);
+    InternalDropQueue addItem(@NotNull ItemStack item);
 
     /**
      * Add multiple items to queue.
@@ -21,7 +24,7 @@ public interface AbstractDropQueue {
      * @param itemStacks The items to add.
      * @return The DropQueue.
      */
-    AbstractDropQueue addItems(@NotNull Collection<ItemStack> itemStacks);
+    InternalDropQueue addItems(@NotNull Collection<ItemStack> itemStacks);
 
     /**
      * Add xp to queue.
@@ -29,7 +32,7 @@ public interface AbstractDropQueue {
      * @param amount The amount to add.
      * @return The DropQueue.
      */
-    AbstractDropQueue addXP(int amount);
+    InternalDropQueue addXP(int amount);
 
     /**
      * Set location of the origin of the drops.
@@ -37,14 +40,14 @@ public interface AbstractDropQueue {
      * @param location The location.
      * @return The DropQueue.
      */
-    AbstractDropQueue setLocation(@NotNull Location location);
+    InternalDropQueue setLocation(@NotNull Location location);
 
     /**
      * Force the queue to act as if player is telekinetic.
      *
      * @return The DropQueue.
      */
-    AbstractDropQueue forceTelekinesis();
+    InternalDropQueue forceTelekinesis();
 
     /**
      * Push the queue.

eco-api/src/main/java/com/willfp/eco/core/events/ArmorEquipEvent.java

@@ -0,0 +1,49 @@
+package com.willfp.eco.core.events;
+
+import org.bukkit.entity.Player;
+import org.bukkit.event.HandlerList;
+import org.bukkit.event.player.PlayerEvent;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * The armor equip event <b>does not contain information about the event.</b>
+ * <p>
+ * It is purely a trigger called whenever a player changes armor, you have to run
+ * your own checks.
+ * <p>
+ * The event is called before the player's inventory actually updates,
+ * so you can check a tick later to see the new contents.
+ */
+public class ArmorEquipEvent extends PlayerEvent {
+    private static final HandlerList HANDLERS = new HandlerList();
+
+    /**
+     * Create a new ArmorEquipEvent.
+     *
+     * @param player The player.
+     */
+    public ArmorEquipEvent(@NotNull final Player player) {
+        super(player);
+    }
+
+    /**
+     * Gets a list of handlers handling this event.
+     *
+     * @return A list of handlers handling this event.
+     */
+
+    @Override
+    @NotNull
+    public HandlerList getHandlers() {
+        return HANDLERS;
+    }
+
+    /**
+     * Bukkit parity.
+     *
+     * @return The handler list.
+     */
+    public static HandlerList getHandlerList() {
+        return HANDLERS;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/events/EntityDeathByEntityEvent.java

@@ -1,4 +1,4 @@
-package com.willfp.eco.util.events.entitydeathbyentity;
+package com.willfp.eco.core.events;
 
 import lombok.Getter;
 import org.bukkit.entity.Entity;
@@ -12,7 +12,9 @@ import org.jetbrains.annotations.NotNull;
 import java.util.List;
 
 /**
- * Event triggered when entity is killed by entity.
+ * Event called when an entity is killed by another entity.
+ * <p>
+ * Not sure why spigot doesn't have this event normally.
  */
 public class EntityDeathByEntityEvent extends Event {
     /**

eco-api/src/main/java/com/willfp/eco/core/events/EventManager.java

@@ -1,7 +1,10 @@
-package com.willfp.eco.util.bukkit.events;
+package com.willfp.eco.core.events;
 
 import org.bukkit.event.Listener;
 
+/**
+ * Manages listeners for a plugin.
+ */
 public interface EventManager {
     /**
      * Register a listener with bukkit.

eco-api/src/main/java/com/willfp/eco/core/events/NaturalExpGainEvent.java

@@ -1,4 +1,4 @@
-package com.willfp.eco.util.events.naturalexpgainevent;
+package com.willfp.eco.core.events;
 
 import lombok.Getter;
 import org.bukkit.event.Event;
@@ -6,6 +6,10 @@ import org.bukkit.event.HandlerList;
 import org.bukkit.event.player.PlayerExpChangeEvent;
 import org.jetbrains.annotations.NotNull;
 
+/**
+ * Event similar to {@link PlayerExpChangeEvent}, except it
+ * isn't called if the exp is from a bottle.
+ */
 public class NaturalExpGainEvent extends Event {
     /**
      * Internal bukkit.

eco-api/src/main/java/com/willfp/eco/core/events/PlayerJumpEvent.java

@@ -0,0 +1,84 @@
+package com.willfp.eco.core.events;
+
+import org.bukkit.Location;
+import org.bukkit.event.HandlerList;
+import org.bukkit.event.player.PlayerMoveEvent;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Event called when a player jumps.
+ */
+public class PlayerJumpEvent extends PlayerMoveEvent {
+    /**
+     * Internal bukkit.
+     */
+    private static final HandlerList HANDLERS = new HandlerList();
+
+    /**
+     * The handled event.
+     */
+    private final PlayerMoveEvent handle;
+
+    /**
+     * Create a new PlayerJumpEvent.
+     *
+     * @param event The PlayerMoveEvent.
+     */
+    public PlayerJumpEvent(@NotNull final PlayerMoveEvent event) {
+        super(event.getPlayer(), event.getFrom(), event.getTo());
+
+        this.handle = event;
+    }
+
+    /**
+     * Internal bukkit.
+     *
+     * @return The handlers.
+     */
+    @Override
+    public @NotNull HandlerList getHandlers() {
+        return HANDLERS;
+    }
+
+    /**
+     * Internal bukkit.
+     *
+     * @return The handlers.
+     */
+    public static @NotNull HandlerList getHandlerList() {
+        return HANDLERS;
+    }
+
+    @Override
+    public boolean isCancelled() {
+        return handle.isCancelled();
+    }
+
+    @Override
+    public void setCancelled(final boolean cancel) {
+        handle.setCancelled(cancel);
+    }
+
+    @NotNull
+    @Override
+    public Location getFrom() {
+        return handle.getFrom();
+    }
+
+    @Override
+    public void setFrom(@NotNull final Location from) {
+        handle.setFrom(from);
+    }
+
+    @Nullable
+    @Override
+    public Location getTo() {
+        return handle.getTo();
+    }
+
+    @Override
+    public void setTo(@NotNull final Location to) {
+        handle.setTo(to);
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/extensions/Extension.java

@@ -1,25 +1,35 @@
-package com.willfp.eco.util.extensions;
+package com.willfp.eco.core.extensions;
 
-import com.willfp.eco.util.plugin.AbstractEcoPlugin;
+import com.willfp.eco.core.EcoPlugin;
 import lombok.AccessLevel;
 import lombok.Getter;
 import org.apache.commons.lang.Validate;
-import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 
+/**
+ * An extension is a separate jar file that hooks into the base plugin jar.
+ * <p>
+ * If you take PlaceholderAPI as an example, the PAPI expansions are identical to
+ * extensions.
+ * <p>
+ * Syntactically, extensions are very similar to plugins in their own right, except that
+ * they are loaded by another plugin.
+ *
+ * @see <a href="https://ecoenchants.polymart.org">EcoEnchants extension examples.</a>
+ */
 public abstract class Extension {
     /**
-     * The {@link AbstractEcoPlugin} that this extension is for.
+     * The {@link EcoPlugin} that this extension is for.
      */
     @Getter(AccessLevel.PROTECTED)
-    private final AbstractEcoPlugin plugin;
+    private final EcoPlugin plugin;
 
     /**
      * Create a new extension for a plugin.
      *
      * @param plugin The plugin.
      */
-    protected Extension(@NotNull final AbstractEcoPlugin plugin) {
+    protected Extension(@NotNull final EcoPlugin plugin) {
         this.plugin = plugin;
     }
 
@@ -71,7 +81,17 @@ public abstract class Extension {
      */
     public final String getName() {
         Validate.notNull(metadata, "Metadata cannot be null!");
-        return this.metadata.name;
+        return this.metadata.name();
+    }
+
+    /**
+     * Get the author of the extension.
+     *
+     * @return The author of the metadata attached to the extension.
+     */
+    public final String getAuthor() {
+        Validate.notNull(metadata, "Metadata cannot be null!");
+        return this.metadata.author();
     }
 
     /**
@@ -81,36 +101,6 @@ public abstract class Extension {
      */
     public final String getVersion() {
         Validate.notNull(metadata, "Metadata cannot be null!");
-        return this.metadata.version;
-    }
-
-    /**
-     * Wrapper for the string and version of the extension.
-     * Contains versions and name.
-     * Designed for internal use.
-     */
-    @ApiStatus.Internal
-    public static final class ExtensionMetadata {
-        /**
-         * The version of the extension.
-         */
-        private final @NotNull String version;
-
-        /**
-         * The extension's name.
-         */
-        private final @NotNull String name;
-
-        /**
-         * Create a new extension metadata.
-         *
-         * @param version The version for the extension to be.
-         * @param name    The name of the extension.
-         */
-        public ExtensionMetadata(@NotNull final String version,
-                                 @NotNull final String name) {
-            this.version = version;
-            this.name = name;
-        }
+        return this.metadata.version();
     }
 }

eco-api/src/main/java/com/willfp/eco/core/extensions/ExtensionLoader.java

@@ -1,15 +1,11 @@
-package com.willfp.eco.util.extensions.loader;
-
-import com.willfp.eco.util.extensions.Extension;
+package com.willfp.eco.core.extensions;
 
 import java.util.Set;
 
 /**
- * Interface for extension loader.
- * Some external plugins may modify extension loading for internal server purposes.
+ * Internal component to manage loading and unloading extensions.
  */
 public interface ExtensionLoader {
-
     /**
      * Load all extensions.
      */
@@ -20,11 +16,6 @@ public interface ExtensionLoader {
      */
     void unloadExtensions();
 
-    /**
-     * Reload all extensions.
-     */
-    void reloadExtensions();
-
     /**
      * Retrieve a set of all loaded extensions.
      *

eco-api/src/main/java/com/willfp/eco/core/extensions/ExtensionMetadata.java

@@ -0,0 +1,18 @@
+package com.willfp.eco.core.extensions;
+
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * The extension's metadata.
+ * <p>
+ * Stored as a record internally.
+ *
+ * @param version The extension version.
+ * @param name    The extension name.
+ * @param author  The extension's author.
+ */
+public record ExtensionMetadata(@NotNull String version,
+                                @NotNull String name,
+                                @NotNull String author) {
+
+}

eco-api/src/main/java/com/willfp/eco/core/extensions/MalformedExtensionException.java

@@ -1,18 +1,15 @@
-package com.willfp.eco.util.extensions;
+package com.willfp.eco.core.extensions;
 
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Called when the extension is made incorrectly.
+ * Potential causes include:
+ * Missing or invalid extension.yml.
+ * Invalid filetype.
  */
 public class MalformedExtensionException extends RuntimeException {
-
     /**
      * Create a new MalformedExtensionException.
-     * <p>
-     * Potential causes include:
-     * Missing or invalid extension.yml.
-     * Invalid filetype.
      *
      * @param errorMessage The error message to show.
      */

eco-api/src/main/java/com/willfp/eco/core/factory/MetadataValueFactory.java

@@ -0,0 +1,17 @@
+package com.willfp.eco.core.factory;
+
+import org.bukkit.metadata.FixedMetadataValue;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Factory to create metadata values for a specific plugin.
+ */
+public interface MetadataValueFactory {
+    /**
+     * Create a metadata value for a given plugin and object.
+     *
+     * @param value The object to store in metadata.
+     * @return The metadata value.
+     */
+    FixedMetadataValue create(@NotNull Object value);
+}

eco-api/src/main/java/com/willfp/eco/core/factory/NamespacedKeyFactory.java

@@ -0,0 +1,17 @@
+package com.willfp.eco.core.factory;
+
+import org.bukkit.NamespacedKey;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Factory to create {@link NamespacedKey}s for a plugin.
+ */
+public interface NamespacedKeyFactory {
+    /**
+     * Create an {@link NamespacedKey} associated with an {@link com.willfp.eco.core.EcoPlugin}.
+     *
+     * @param key The key in the {@link NamespacedKey}.
+     * @return The created {@link NamespacedKey}.
+     */
+    NamespacedKey create(@NotNull String key);
+}

eco-api/src/main/java/com/willfp/eco/core/factory/RunnableFactory.java

@@ -0,0 +1,20 @@
+package com.willfp.eco.core.factory;
+
+import com.willfp.eco.core.scheduling.RunnableTask;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.Consumer;
+
+/**
+ * Factory to create runnables. Much cleaner syntax than instantiating
+ * {@link org.bukkit.scheduler.BukkitRunnable}s.
+ */
+public interface RunnableFactory {
+    /**
+     * Create a {@link RunnableTask}.
+     *
+     * @param consumer Lambda of the code to run, where the parameter represents the instance of the runnable.
+     * @return The created {@link RunnableTask}.
+     */
+    RunnableTask create(@NotNull Consumer<RunnableTask> consumer);
+}

eco-api/src/main/java/com/willfp/eco/core/gui/GUIFactory.java

@@ -0,0 +1,31 @@
+package com.willfp.eco.core.gui;
+
+import com.willfp.eco.core.gui.menu.MenuBuilder;
+import com.willfp.eco.core.gui.slot.SlotBuilder;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.Function;
+
+/**
+ * Internal component used by {@link com.willfp.eco.core.gui.menu.Menu#builder(int)}
+ * and {@link com.willfp.eco.core.gui.slot.Slot#builder(ItemStack)}.
+ */
+public interface GUIFactory {
+    /**
+     * Create slot builder.
+     *
+     * @param provider The provider.
+     * @return The builder.
+     */
+    SlotBuilder createSlotBuilder(@NotNull Function<Player, ItemStack> provider);
+
+    /**
+     * Create menu builder.
+     *
+     * @param rows The amount of rows.
+     * @return The builder.
+     */
+    MenuBuilder createMenuBuilder(int rows);
+}

eco-api/src/main/java/com/willfp/eco/core/gui/menu/Menu.java

@@ -0,0 +1,56 @@
+package com.willfp.eco.core.gui.menu;
+
+import com.willfp.eco.core.Eco;
+import com.willfp.eco.core.gui.slot.Slot;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.Inventory;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * GUI version of {@link Inventory}.
+ * <p>
+ * A menu contains slots and is 1-indexed. (Top row has index 1, bottom row has index 6).
+ */
+public interface Menu {
+    /**
+     * Get the amount of rows.
+     *
+     * @return The amount of rows.
+     */
+    int getRows();
+
+    /**
+     * Get slot at given row and column.
+     *
+     * @param row    The row.
+     * @param column The column.
+     * @return The row.
+     */
+    Slot getSlot(int row,
+                 int column);
+
+    /**
+     * Get the menu title.
+     *
+     * @return The title.
+     */
+    String getTitle();
+
+    /**
+     * Open the inventory for the player.
+     *
+     * @param player The player.
+     * @return The inventory.
+     */
+    Inventory open(@NotNull Player player);
+
+    /**
+     * Create a builder with a given amount of rows.
+     *
+     * @param rows The rows.
+     * @return The builder.
+     */
+    static MenuBuilder builder(final int rows) {
+        return Eco.getHandler().getGUIFactory().createMenuBuilder(rows);
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/gui/menu/MenuBuilder.java

@@ -0,0 +1,56 @@
+package com.willfp.eco.core.gui.menu;
+
+import com.willfp.eco.core.gui.slot.FillerMask;
+import com.willfp.eco.core.gui.slot.Slot;
+import org.bukkit.event.inventory.InventoryCloseEvent;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.Consumer;
+
+/**
+ * Builder to create menus.
+ */
+public interface MenuBuilder {
+    /**
+     * Set the menu title.
+     *
+     * @param title The title.
+     * @return The builder.
+     */
+    MenuBuilder setTitle(@NotNull String title);
+
+    /**
+     * Set a slot.
+     *
+     * @param row    The row.
+     * @param column The column.
+     * @param slot   The slot.
+     * @return The builder.
+     */
+    MenuBuilder setSlot(int row,
+                        int column,
+                        @NotNull Slot slot);
+
+    /**
+     * Set the menu mask.
+     *
+     * @param mask The mask.
+     * @return The builder.
+     */
+    MenuBuilder setMask(@NotNull FillerMask mask);
+
+    /**
+     * Set the menu close handler.
+     *
+     * @param action The handler.
+     * @return The builder.
+     */
+    MenuBuilder onClose(@NotNull Consumer<InventoryCloseEvent> action);
+
+    /**
+     * Build the menu.
+     *
+     * @return The menu.
+     */
+    Menu build();
+}

eco-api/src/main/java/com/willfp/eco/core/gui/slot/FillerMask.java

@@ -0,0 +1,73 @@
+package com.willfp.eco.core.gui.slot;
+
+import com.willfp.eco.core.items.builder.ItemStackBuilder;
+import com.willfp.eco.util.ListUtils;
+import lombok.Getter;
+import org.bukkit.Material;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+
+/**
+ * Mask of filler slots.
+ * <p>
+ * A pattern consists of 1s and 0s, where a 1 is a filler slot,
+ * and a 0 isn't.
+ * <p>
+ * For example, creating a filler mask for a single-chest sized menu would look like this:
+ * <p>
+ * new FillerMask(
+ * material,
+ * "11111111"
+ * "10000001"
+ * "11111111"
+ * );
+ */
+public class FillerMask {
+    /**
+     * Mask.
+     */
+    @Getter
+    private final List<List<Slot>> mask;
+
+    /**
+     * Create a new filler mask.
+     *
+     * @param material The mask material.
+     * @param pattern  The pattern.
+     */
+    public FillerMask(@NotNull final Material material,
+                      @NotNull final String... pattern) {
+        if (material == Material.AIR) {
+            throw new IllegalArgumentException("Material cannot be air!");
+        }
+
+        mask = ListUtils.create2DList(6, 9);
+
+        ItemStack itemStack = new ItemStackBuilder(material)
+                .setDisplayName("&r")
+                .build();
+
+        int row = 0;
+
+        for (String patternRow : pattern) {
+            int column = 0;
+            if (patternRow.length() != 9) {
+                throw new IllegalArgumentException("Invalid amount of columns in pattern!");
+            }
+            for (char c : patternRow.toCharArray()) {
+                if (c == '0') {
+                    mask.get(row).set(column, null);
+                } else if (c == '1') {
+                    mask.get(row).set(column, new FillerSlot(itemStack));
+                } else {
+                    throw new IllegalArgumentException("Invalid character in pattern! (Must only be 0 and 1)");
+                }
+
+                column++;
+            }
+            row++;
+        }
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/gui/slot/FillerSlot.java

@@ -0,0 +1,33 @@
+package com.willfp.eco.core.gui.slot;
+
+import lombok.Getter;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * A filler slot is a slot that does nothing when clicked.
+ * <p>
+ * Useful for backgrounds.
+ */
+public class FillerSlot implements Slot {
+    /**
+     * The ItemStack.
+     */
+    @Getter
+    private final ItemStack itemStack;
+
+    /**
+     * Create new filler slot.
+     *
+     * @param itemStack The ItemStack.
+     */
+    public FillerSlot(@NotNull final ItemStack itemStack) {
+        this.itemStack = itemStack;
+    }
+
+    @Override
+    public ItemStack getItemStack(@NotNull final Player player) {
+        return itemStack;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/gui/slot/Slot.java

@@ -0,0 +1,41 @@
+package com.willfp.eco.core.gui.slot;
+
+import com.willfp.eco.core.Eco;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.Function;
+
+/**
+ * A slot is an item in a GUI that can handle clicks.
+ */
+public interface Slot {
+    /**
+     * Get the ItemStack that would be shown to a player.
+     *
+     * @param player The player.
+     * @return The ItemStack.
+     */
+    ItemStack getItemStack(@NotNull Player player);
+
+    /**
+     * Create a builder for an ItemStack.
+     *
+     * @param itemStack The ItemStack.
+     * @return The builder.
+     */
+    static SlotBuilder builder(@NotNull final ItemStack itemStack) {
+        return Eco.getHandler().getGUIFactory().createSlotBuilder(player -> itemStack);
+    }
+
+    /**
+     * Create a builder for a player-specific ItemStack.
+     *
+     * @param provider The provider.
+     * @return The builder.
+     */
+    static SlotBuilder builder(@NotNull final Function<Player, ItemStack> provider) {
+        return Eco.getHandler().getGUIFactory().createSlotBuilder(provider);
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/gui/slot/SlotBuilder.java

@@ -0,0 +1,58 @@
+package com.willfp.eco.core.gui.slot;
+
+import org.bukkit.event.inventory.InventoryClickEvent;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.BiConsumer;
+
+/**
+ * Builder to create slots.
+ */
+public interface SlotBuilder {
+    /**
+     * Set click handler.
+     *
+     * @param action The handler.
+     * @return The builder.
+     */
+    SlotBuilder onLeftClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action);
+
+    /**
+     * Set click handler.
+     *
+     * @param action The handler.
+     * @return The builder.
+     */
+    SlotBuilder onRightClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action);
+
+    /**
+     * Set click handler.
+     *
+     * @param action The handler.
+     * @return The builder.
+     */
+    SlotBuilder onShiftLeftClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action);
+
+    /**
+     * Set click handler.
+     *
+     * @param action The handler.
+     * @return The builder.
+     */
+    SlotBuilder onShiftRightClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action);
+
+    /**
+     * Set click handler.
+     *
+     * @param action The handler.
+     * @return The builder.
+     */
+    SlotBuilder onMiddleClick(@NotNull BiConsumer<InventoryClickEvent, Slot> action);
+
+    /**
+     * Build the slot.
+     *
+     * @return The slot.
+     */
+    Slot build();
+}

eco-api/src/main/java/com/willfp/eco/core/integrations/Integration.java

@@ -1,8 +1,12 @@
-package com.willfp.eco.util.integrations;
+package com.willfp.eco.core.integrations;
 
+/**
+ * Abstract class for integrations.
+ */
 public interface Integration {
     /**
      * Get the name of integration.
+     *
      * @return The name.
      */
     String getPluginName();

eco-api/src/main/java/com/willfp/eco/core/integrations/IntegrationLoader.java

@@ -1,8 +1,13 @@
-package com.willfp.eco.util.integrations;
+package com.willfp.eco.core.integrations;
 
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 
+/**
+ * An integration loader runs a runnable only if a specific plugin is present on the server.
+ * <p>
+ * Used by {@link com.willfp.eco.core.EcoPlugin} to load integrations.
+ */
 public class IntegrationLoader {
     /**
      * The lambda to be ran if the plugin is present.

eco-api/src/main/java/com/willfp/eco/core/integrations/anticheat/AnticheatManager.java

@@ -1,6 +1,6 @@
-package com.willfp.eco.util.integrations.anticheat;
+package com.willfp.eco.core.integrations.anticheat;
 
-import com.willfp.eco.util.plugin.AbstractEcoPlugin;
+import com.willfp.eco.core.EcoPlugin;
 import lombok.experimental.UtilityClass;
 import org.bukkit.entity.Player;
 import org.bukkit.event.Listener;
@@ -9,6 +9,9 @@ import org.jetbrains.annotations.NotNull;
 import java.util.HashSet;
 import java.util.Set;
 
+/**
+ * Class to handle anticheat integrations.
+ */
 @UtilityClass
 public class AnticheatManager {
     /**
@@ -22,7 +25,7 @@ public class AnticheatManager {
      * @param plugin    The plugin.
      * @param anticheat The anticheat to register.
      */
-    public void register(@NotNull final AbstractEcoPlugin plugin,
+    public void register(@NotNull final EcoPlugin plugin,
                          @NotNull final AnticheatWrapper anticheat) {
         if (anticheat instanceof Listener) {
             plugin.getEventManager().registerListener((Listener) anticheat);

eco-api/src/main/java/com/willfp/eco/core/integrations/anticheat/AnticheatWrapper.java

@@ -1,9 +1,12 @@
-package com.willfp.eco.util.integrations.anticheat;
+package com.willfp.eco.core.integrations.anticheat;
 
-import com.willfp.eco.util.integrations.Integration;
+import com.willfp.eco.core.integrations.Integration;
 import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
+/**
+ * Wrapper class for anticheat integrations.
+ */
 public interface AnticheatWrapper extends Integration {
     /**
      * Exempt a player from checks.

eco-api/src/main/java/com/willfp/eco/core/integrations/antigrief/AntigriefManager.java

@@ -1,4 +1,4 @@
-package com.willfp.eco.util.integrations.antigrief;
+package com.willfp.eco.core.integrations.antigrief;
 
 import lombok.experimental.UtilityClass;
 import org.bukkit.Location;
@@ -10,6 +10,9 @@ import org.jetbrains.annotations.NotNull;
 import java.util.HashSet;
 import java.util.Set;
 
+/**
+ * Class to handle antigrief integrations.
+ */
 @UtilityClass
 public class AntigriefManager {
     /**

eco-api/src/main/java/com/willfp/eco/core/integrations/antigrief/AntigriefWrapper.java

@@ -1,11 +1,14 @@
-package com.willfp.eco.util.integrations.antigrief;
+package com.willfp.eco.core.integrations.antigrief;
 
-import com.willfp.eco.util.integrations.Integration;
+import com.willfp.eco.core.integrations.Integration;
 import org.bukkit.Location;
 import org.bukkit.block.Block;
 import org.bukkit.entity.LivingEntity;
 import org.bukkit.entity.Player;
 
+/**
+ * Wrapper class for antigrief integrations.
+ */
 public interface AntigriefWrapper extends Integration {
     /**
      * Can player break block.

eco-api/src/main/java/com/willfp/eco/core/integrations/customitems/CustomItemsManager.java

@@ -0,0 +1,38 @@
+package com.willfp.eco.core.integrations.customitems;
+
+import lombok.experimental.UtilityClass;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Class to handle custom item integrations.
+ */
+@UtilityClass
+public class CustomItemsManager {
+    /**
+     * A set of all registered integrations.
+     */
+    private final Set<CustomItemsWrapper> registered = new HashSet<>();
+
+    /**
+     * Register a new integration.
+     *
+     * @param integration The integration to register.
+     */
+    public void register(@NotNull final CustomItemsWrapper integration) {
+        registered.add(integration);
+    }
+
+    /**
+     * Register all the custom items for a specific plugin into eco.
+     *
+     * @see com.willfp.eco.core.items.Items
+     */
+    public void registerAllItems() {
+        for (CustomItemsWrapper customItemsWrapper : registered) {
+            customItemsWrapper.registerAllItems();
+        }
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/integrations/customitems/CustomItemsWrapper.java

@@ -0,0 +1,13 @@
+package com.willfp.eco.core.integrations.customitems;
+
+/**
+ * Wrapper class for custom item integrations.
+ */
+public interface CustomItemsWrapper {
+    /**
+     * Register all the custom items for a specific plugin into eco.
+     *
+     * @see com.willfp.eco.core.items.Items
+     */
+    void registerAllItems();
+}

eco-api/src/main/java/com/willfp/eco/core/integrations/mcmmo/McmmoManager.java

@@ -0,0 +1,55 @@
+package com.willfp.eco.core.integrations.mcmmo;
+
+import lombok.experimental.UtilityClass;
+import org.bukkit.block.Block;
+import org.bukkit.event.Event;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Class to handle mcmmo integrations.
+ */
+@UtilityClass
+public class McmmoManager {
+    /**
+     * A set of all registered integrations.
+     */
+    private final Set<McmmoWrapper> regsistered = new HashSet<>();
+
+    /**
+     * Register a new integration.
+     *
+     * @param integration The integration to register.
+     */
+    public void register(@NotNull final McmmoWrapper integration) {
+        regsistered.add(integration);
+    }
+
+    /**
+     * Get bonus drop count from block.
+     *
+     * @param block The block.
+     * @return The bonus drop count.
+     */
+    public int getBonusDropCount(@NotNull final Block block) {
+        for (McmmoWrapper mcmmoWrapper : regsistered) {
+            return mcmmoWrapper.getBonusDropCount(block);
+        }
+        return 0;
+    }
+
+    /**
+     * Get if event is fake.
+     *
+     * @param event The event to check.
+     * @return If the event is fake.
+     */
+    public boolean isFake(@NotNull final Event event) {
+        for (McmmoWrapper mcmmoWrapper : regsistered) {
+            return mcmmoWrapper.isFake(event);
+        }
+        return false;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/integrations/mcmmo/McmmoWrapper.java

@@ -0,0 +1,26 @@
+package com.willfp.eco.core.integrations.mcmmo;
+
+import org.bukkit.block.Block;
+import org.bukkit.event.Event;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Wrapper class for mcmmo integrations.
+ */
+public interface McmmoWrapper {
+    /**
+     * Get bonus drop count of block.
+     *
+     * @param block The block.
+     * @return The drop multiplier.
+     */
+    int getBonusDropCount(@NotNull Block block);
+
+    /**
+     * Get if event is fake.
+     *
+     * @param event The event.
+     * @return If is fake.
+     */
+    boolean isFake(@NotNull Event event);
+}

eco-api/src/main/java/com/willfp/eco/core/integrations/placeholder/PlaceholderEntry.java

@@ -1,4 +1,4 @@
-package com.willfp.eco.util.integrations.placeholder;
+package com.willfp.eco.core.integrations.placeholder;
 
 import lombok.Getter;
 import org.apache.commons.lang.Validate;
@@ -8,6 +8,11 @@ import org.jetbrains.annotations.Nullable;
 
 import java.util.function.Function;
 
+/**
+ * A {@link PlaceholderEntry} is a placeholder in and of itself.
+ * <p>
+ * It should be fairly straightforward.
+ */
 public class PlaceholderEntry {
     /**
      * The name of the placeholder, used in lookups.

eco-api/src/main/java/com/willfp/eco/core/integrations/placeholder/PlaceholderIntegration.java

@@ -1,10 +1,13 @@
-package com.willfp.eco.util.integrations.placeholder;
+package com.willfp.eco.core.integrations.placeholder;
 
-import com.willfp.eco.util.integrations.Integration;
+import com.willfp.eco.core.integrations.Integration;
 import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+/**
+ * Wrapper class for placeholder integrations.
+ */
 public interface PlaceholderIntegration extends Integration {
     /**
      * Register the integration with the specified plugin.

eco-api/src/main/java/com/willfp/eco/core/integrations/placeholder/PlaceholderManager.java

@@ -1,4 +1,4 @@
-package com.willfp.eco.util.integrations.placeholder;
+package com.willfp.eco.core.integrations.placeholder;
 
 import lombok.experimental.UtilityClass;
 import org.bukkit.entity.Player;
@@ -10,6 +10,9 @@ import java.util.Optional;
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicReference;
 
+/**
+ * Class to handle placeholder integrations.
+ */
 @UtilityClass
 public class PlaceholderManager {
     /**
@@ -52,7 +55,7 @@ public class PlaceholderManager {
     public static String getResult(@Nullable final Player player,
                                    @NotNull final String identifier) {
         Optional<PlaceholderEntry> matching = REGISTERED_PLACEHOLDERS.stream().filter(expansion -> expansion.getIdentifier().equalsIgnoreCase(identifier)).findFirst();
-        if (!matching.isPresent()) {
+        if (matching.isEmpty()) {
             return null;
         }
         PlaceholderEntry entry = matching.get();

eco-api/src/main/java/com/willfp/eco/core/items/CustomItem.java

@@ -0,0 +1,68 @@
+package com.willfp.eco.core.items;
+
+import lombok.Getter;
+import org.bukkit.NamespacedKey;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.function.Predicate;
+
+/**
+ * A custom item has 3 components:
+ *
+ * <ul>
+ *     <li>The key to identify it</li>
+ *     <li>The test to check if any item is this custom item</li>
+ *     <li>The actual custom item {@link ItemStack}</li>
+ * </ul>
+ */
+public class CustomItem implements TestableItem {
+    /**
+     * The key.
+     */
+    @Getter
+    private final NamespacedKey key;
+
+    /**
+     * The test for ItemStacks to pass.
+     */
+    private final Predicate<ItemStack> test;
+
+    /**
+     * Example Item: what the user should see.
+     */
+    private final ItemStack item;
+
+    /**
+     * Create a new complex recipe part.
+     *
+     * @param key  The item key.
+     * @param test The test.
+     * @param item The example ItemStacks.
+     */
+    public CustomItem(@NotNull final NamespacedKey key,
+                      @NotNull final Predicate<ItemStack> test,
+                      @NotNull final ItemStack item) {
+        this.key = key;
+        this.test = test;
+        this.item = item;
+    }
+
+    @Override
+    public boolean matches(@Nullable final ItemStack itemStack) {
+        return test.test(itemStack);
+    }
+
+    @Override
+    public ItemStack getItem() {
+        return item;
+    }
+
+    /**
+     * Register the item.
+     */
+    public void register() {
+        Items.registerCustomItem(this.getKey(), this);
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/items/Items.java

@@ -0,0 +1,103 @@
+package com.willfp.eco.core.items;
+
+import com.willfp.eco.core.recipe.parts.EmptyTestableItem;
+import com.willfp.eco.core.recipe.parts.MaterialTestableItem;
+import com.willfp.eco.core.recipe.parts.TestableStack;
+import com.willfp.eco.util.NamespacedKeyUtils;
+import lombok.experimental.UtilityClass;
+import org.bukkit.Material;
+import org.bukkit.NamespacedKey;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * Class to manage all custom and vanilla items.
+ */
+@UtilityClass
+public final class Items {
+    /**
+     * All recipe parts.
+     */
+    private static final Map<NamespacedKey, CustomItem> REGISTRY = new HashMap<>();
+
+    /**
+     * Register a new recipe part.
+     *
+     * @param key  The key of the recipe part.
+     * @param part The recipe part.
+     */
+    public void registerCustomItem(@NotNull final NamespacedKey key,
+                                   @NotNull final CustomItem part) {
+        REGISTRY.put(key, part);
+    }
+
+    /**
+     * Lookup item from string.
+     * <p>
+     * Used for recipes.
+     *
+     * @param key The string to test.
+     * @return The found testable item, or an empty item if not found.
+     */
+    public TestableItem lookup(@NotNull final String key) {
+        String[] split = key.toLowerCase().split(":");
+
+        if (split.length == 1) {
+            Material material = Material.getMaterial(key.toUpperCase());
+            if (material == null || material == Material.AIR) {
+                return new EmptyTestableItem();
+            }
+            return new MaterialTestableItem(material);
+        }
+
+        if (split.length == 2) {
+            CustomItem part = REGISTRY.get(NamespacedKeyUtils.create(split[0], split[1]));
+
+            if (part == null) {
+                Material material = Material.getMaterial(split[0].toUpperCase());
+                if (material == null || material == Material.AIR) {
+                    return new EmptyTestableItem();
+                }
+                return new TestableStack(new MaterialTestableItem(material), Integer.parseInt(split[1]));
+            } else {
+                return part;
+            }
+        }
+
+        if (split.length == 3) {
+            CustomItem part = REGISTRY.get(NamespacedKeyUtils.create(split[0], split[1]));
+            return part == null ? new EmptyTestableItem() : new TestableStack(part, Integer.parseInt(split[2]));
+        }
+
+        return new EmptyTestableItem();
+    }
+
+    /**
+     * Get if itemStack is a custom item.
+     *
+     * @param itemStack The itemStack to check.
+     * @return If is recipe.
+     */
+    public boolean isCustomItem(@NotNull final ItemStack itemStack) {
+        for (CustomItem item : REGISTRY.values()) {
+            if (item.matches(itemStack)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * Get all registered custom items.
+     *
+     * @return A set of all items.
+     */
+    public Set<CustomItem> getCustomItems() {
+        return new HashSet<>(REGISTRY.values());
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/items/TestableItem.java

@@ -1,9 +1,12 @@
-package com.willfp.eco.util.recipe.parts;
+package com.willfp.eco.core.items;
 
 import org.bukkit.inventory.ItemStack;
 import org.jetbrains.annotations.Nullable;
 
-public interface RecipePart {
+/**
+ * An item with a test to see if any item is that item.
+ */
+public interface TestableItem {
     /**
      * If an ItemStack matches the recipe part.
      *
@@ -13,10 +16,9 @@ public interface RecipePart {
     boolean matches(@Nullable ItemStack itemStack);
 
     /**
-     * Get a displayed itemstack, for autocraft.
+     * Get an example item.
      *
-     * @return The item, displayed.
+     * @return The item.
      */
-    ItemStack getDisplayed();
+    ItemStack getItem();
 }
-

eco-api/src/main/java/com/willfp/eco/core/items/builder/AbstractItemStackBuilder.java

@@ -0,0 +1,199 @@
+package com.willfp.eco.core.items.builder;
+
+import com.willfp.eco.util.StringUtils;
+import lombok.AccessLevel;
+import lombok.Getter;
+import org.apache.commons.lang.Validate;
+import org.bukkit.Material;
+import org.bukkit.NamespacedKey;
+import org.bukkit.enchantments.Enchantment;
+import org.bukkit.inventory.ItemFlag;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.meta.ItemMeta;
+import org.bukkit.persistence.PersistentDataType;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.Supplier;
+
+/**
+ * Abstract item builder class to build items.
+ *
+ * @param <T> The meta type.
+ * @param <U> Itself.
+ */
+@SuppressWarnings("unchecked")
+public abstract class AbstractItemStackBuilder<T extends ItemMeta, U extends AbstractItemStackBuilder<T, U>> implements ItemBuilder {
+    /**
+     * The ItemMeta used while building.
+     */
+    @Getter(AccessLevel.PROTECTED)
+    private final T meta;
+
+    /**
+     * The ItemStack.
+     */
+    @Getter(AccessLevel.PROTECTED)
+    private final ItemStack base;
+
+    /**
+     * Create a new ItemStackBuilder.
+     *
+     * @param material The material.
+     */
+    protected AbstractItemStackBuilder(@NotNull final Material material) {
+        this(new ItemStack(material));
+    }
+
+    /**
+     * Create a new ItemStackBuilder to modify an existing item.
+     *
+     * @param base The ItemStack to start with.
+     */
+    protected AbstractItemStackBuilder(@NotNull final ItemStack base) {
+        this.base = base;
+        this.meta = (T) base.getItemMeta();
+        assert meta != null;
+    }
+
+    @Override
+    public U setAmount(final int amount) {
+        Validate.isTrue(amount >= 1 && amount <= base.getMaxStackSize());
+        base.setAmount(amount);
+        return (U) this;
+    }
+
+    @Override
+    public U setAmount(@NotNull final Supplier<Integer> amount) {
+        return setAmount(amount.get());
+    }
+
+    @Override
+    public U addEnchantment(@NotNull final Enchantment enchantment,
+                            final int level) {
+        meta.addEnchant(enchantment, level, true);
+        return (U) this;
+    }
+
+    @Override
+    public U addEnchantment(@NotNull final Supplier<Enchantment> enchantment,
+                            @NotNull final Supplier<Integer> level) {
+        return addEnchantment(enchantment.get(), level.get());
+    }
+
+    @Override
+    public U setDisplayName(@NotNull final String name) {
+        meta.setDisplayName(StringUtils.format(name));
+        return (U) this;
+    }
+
+    @Override
+    public U setDisplayName(@NotNull final Supplier<String> name) {
+        String result = name.get();
+
+        return result == null ? (U) this : setDisplayName(name.get());
+    }
+
+    @Override
+    public U addLoreLine(@NotNull final String line) {
+        List<String> lore = meta.hasLore() ? meta.getLore() : new ArrayList<>();
+        assert lore != null;
+        lore.add(StringUtils.format(line));
+        meta.setLore(lore);
+
+        return (U) this;
+    }
+
+    @Override
+    public U addLoreLine(@NotNull final Supplier<String> line) {
+        String result = line.get();
+
+        return result == null ? (U) this : addLoreLine(line.get());
+    }
+
+    @Override
+    public U addLoreLines(@NotNull final List<String> lines) {
+        List<String> lore = meta.hasLore() ? meta.getLore() : new ArrayList<>();
+        assert lore != null;
+        for (String line : lines) {
+            lore.add(StringUtils.format(line));
+        }
+        meta.setLore(lore);
+
+        return (U) this;
+    }
+
+    @Override
+    public U addLoreLines(@NotNull final Supplier<List<String>> lines) {
+        List<String> result = lines.get();
+
+        return result == null ? (U) this : addLoreLines(lines.get());
+    }
+
+    @Override
+    public U addItemFlag(@NotNull final ItemFlag... itemFlags) {
+        meta.addItemFlags(itemFlags);
+
+        return (U) this;
+    }
+
+    @Override
+    public U addItemFlag(@NotNull final Supplier<ItemFlag[]> itemFlags) {
+        ItemFlag[] result = itemFlags.get();
+
+        return result == null ? (U) this : addItemFlag(result);
+    }
+
+    @Override
+    public <A, B> U writeMetaKey(@NotNull final NamespacedKey key,
+                                 @NotNull final PersistentDataType<A, B> type,
+                                 @NotNull final B value) {
+        meta.getPersistentDataContainer().set(key, type, value);
+
+        return (U) this;
+    }
+
+    @Override
+    public <A, B> U writeMetaKey(@NotNull final Supplier<NamespacedKey> key,
+                                 @NotNull final Supplier<PersistentDataType<A, B>> type,
+                                 @NotNull final Supplier<B> value) {
+        return writeMetaKey(key.get(), type.get(), value.get());
+    }
+
+    @Override
+    public U setUnbreakable(final boolean unbreakable) {
+        meta.setUnbreakable(unbreakable);
+
+        return (U) this;
+    }
+
+    @Override
+    public U setUnbreakable(@NotNull final Supplier<Boolean> unbreakable) {
+        Boolean result = unbreakable.get();
+
+        return result == null ? (U) this : setUnbreakable(unbreakable);
+    }
+
+    @Override
+    public U setCustomModelData(@Nullable final Integer data) {
+        meta.setCustomModelData(data);
+
+        return (U) this;
+    }
+
+    @Override
+    public U setCustomModelData(@NotNull final Supplier<Integer> data) {
+        Integer result = data.get();
+
+        return result == null ? (U) this : setCustomModelData(result);
+    }
+
+    @Override
+    public ItemStack build() {
+        base.setItemMeta(meta);
+
+        return base;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/items/builder/EnchantedBookBuilder.java

@@ -0,0 +1,45 @@
+package com.willfp.eco.core.items.builder;
+
+import org.bukkit.Material;
+import org.bukkit.enchantments.Enchantment;
+import org.bukkit.inventory.meta.EnchantmentStorageMeta;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.Supplier;
+
+/**
+ * Class to build enchanted books.
+ */
+public class EnchantedBookBuilder extends AbstractItemStackBuilder<EnchantmentStorageMeta, EnchantedBookBuilder> {
+    /**
+     * Create a new EnchantedBookBuilder.
+     */
+    public EnchantedBookBuilder() {
+        super(Material.ENCHANTED_BOOK);
+    }
+
+    /**
+     * Add an enchantment to the item.
+     *
+     * @param enchantment The enchantment.
+     * @param level       The level.
+     * @return The builder.
+     */
+    public EnchantedBookBuilder addStoredEnchantment(@NotNull final Enchantment enchantment,
+                                                     final int level) {
+        this.getMeta().addStoredEnchant(enchantment, level, true);
+        return this;
+    }
+
+    /**
+     * Add an enchantment to the item.
+     *
+     * @param enchantment The enchantment.
+     * @param level       The level.
+     * @return The builder.
+     */
+    public EnchantedBookBuilder addStoredEnchantment(@NotNull final Supplier<Enchantment> enchantment,
+                                                     final Supplier<Integer> level) {
+        return this.addStoredEnchantment(enchantment.get(), level.get());
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/items/builder/ItemBuilder.java

@@ -0,0 +1,184 @@
+package com.willfp.eco.core.items.builder;
+
+import org.bukkit.NamespacedKey;
+import org.bukkit.enchantments.Enchantment;
+import org.bukkit.inventory.ItemFlag;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.persistence.PersistentDataType;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.function.Supplier;
+
+/**
+ * Interface for all item builders.
+ */
+public interface ItemBuilder {
+    /**
+     * Set the ItemStack amount.
+     *
+     * @param amount The amount.
+     * @return The builder.
+     */
+    ItemBuilder setAmount(int amount);
+
+    /**
+     * Set the ItemStack amount.
+     *
+     * @param amount The amount.
+     * @return The builder.
+     */
+    ItemBuilder setAmount(@NotNull Supplier<Integer> amount);
+
+    /**
+     * Add an enchantment to the item.
+     *
+     * @param enchantment The enchantment.
+     * @param level       The level.
+     * @return The builder.r
+     */
+    ItemBuilder addEnchantment(@NotNull Enchantment enchantment,
+                               int level);
+
+    /**
+     * Add an enchantment to the item.
+     *
+     * @param enchantment The enchantment.
+     * @param level       The level.
+     * @return The builder.
+     */
+    ItemBuilder addEnchantment(@NotNull Supplier<Enchantment> enchantment,
+                               @NotNull Supplier<Integer> level);
+
+    /**
+     * Set the item display name.
+     *
+     * @param name The name.
+     * @return The builder.
+     */
+    ItemBuilder setDisplayName(@NotNull String name);
+
+    /**
+     * Set the item display name.
+     *
+     * @param name The name.
+     * @return The builder.
+     */
+    ItemBuilder setDisplayName(@NotNull Supplier<String> name);
+
+    /**
+     * Add lore line.
+     *
+     * @param line The line.
+     * @return The builder.
+     */
+    ItemBuilder addLoreLine(@NotNull String line);
+
+    /**
+     * Add lore line.
+     *
+     * @param line The line.
+     * @return The builder.
+     */
+    ItemBuilder addLoreLine(@NotNull Supplier<String> line);
+
+    /**
+     * Add lore lines.
+     *
+     * @param lines The lines.
+     * @return The builder.
+     */
+    ItemBuilder addLoreLines(@NotNull List<String> lines);
+
+    /**
+     * Add lore lines.
+     *
+     * @param lines The lines.
+     * @return The builder.
+     */
+    ItemBuilder addLoreLines(@NotNull Supplier<List<String>> lines);
+
+    /**
+     * Add ItemFlags.
+     *
+     * @param itemFlags The flags.
+     * @return The builder.
+     */
+    ItemBuilder addItemFlag(@NotNull ItemFlag... itemFlags);
+
+    /**
+     * Add ItemFlags.
+     *
+     * @param itemFlags The flags.
+     * @return The builder.
+     */
+    ItemBuilder addItemFlag(@NotNull Supplier<ItemFlag[]> itemFlags);
+
+    /**
+     * Write meta key.
+     *
+     * @param key   The key.
+     * @param type  The type.
+     * @param value The value.
+     * @param <A>   The type.
+     * @param <B>   The type.
+     * @return The builder.
+     */
+    <A, B> ItemBuilder writeMetaKey(@NotNull NamespacedKey key,
+                                    @NotNull PersistentDataType<A, B> type,
+                                    @NotNull B value);
+
+    /**
+     * Write meta key.
+     *
+     * @param key   The key.
+     * @param type  The type.
+     * @param value The value.
+     * @param <A>   The type.
+     * @param <B>   The type.
+     * @return The builder.
+     */
+    <A, B> ItemBuilder writeMetaKey(@NotNull Supplier<NamespacedKey> key,
+                                    @NotNull Supplier<PersistentDataType<A, B>> type,
+                                    @NotNull Supplier<B> value);
+
+    /**
+     * Set unbreakable.
+     *
+     * @param unbreakable If the item should be unbreakable.
+     * @return The builder.
+     */
+    ItemBuilder setUnbreakable(boolean unbreakable);
+
+    /**
+     * Set unbreakable.
+     *
+     * @param unbreakable If the item should be unbreakable.
+     * @return The builder.
+     */
+    ItemBuilder setUnbreakable(@NotNull Supplier<Boolean> unbreakable);
+
+    /**
+     * Set custom model data.
+     *
+     * @param data The data.
+     * @return The builder.
+     */
+    ItemBuilder setCustomModelData(@Nullable Integer data);
+
+    /**
+     * Set custom model data.
+     *
+     * @param data The data.
+     * @return The builder.
+     */
+    ItemBuilder setCustomModelData(@NotNull Supplier<Integer> data);
+
+    /**
+     * Build the item.
+     *
+     * @return The item.
+     */
+    ItemStack build();
+}

eco-api/src/main/java/com/willfp/eco/core/items/builder/ItemStackBuilder.java

@@ -0,0 +1,29 @@
+package com.willfp.eco.core.items.builder;
+
+import org.bukkit.Material;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.meta.ItemMeta;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Builder for any item stack.
+ */
+public class ItemStackBuilder extends AbstractItemStackBuilder<ItemMeta, ItemStackBuilder> {
+    /**
+     * Create a new ItemStackBuilder.
+     *
+     * @param material The material.
+     */
+    public ItemStackBuilder(@NotNull final Material material) {
+        super(material);
+    }
+
+    /**
+     * Create a new ItemStackBuilder to modify an existing item.
+     *
+     * @param base The ItemStack to start with.
+     */
+    public ItemStackBuilder(@NotNull final ItemStack base) {
+        super(base);
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/items/builder/LeatherArmorBuilder.java

@@ -0,0 +1,55 @@
+package com.willfp.eco.core.items.builder;
+
+import org.bukkit.Color;
+import org.bukkit.Material;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.meta.LeatherArmorMeta;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.Supplier;
+
+/**
+ * Builder for leather armor.
+ */
+public class LeatherArmorBuilder extends AbstractItemStackBuilder<LeatherArmorMeta, LeatherArmorBuilder> {
+    /**
+     * Create a new ItemStackBuilder.
+     *
+     * @param material The material.
+     */
+    public LeatherArmorBuilder(@NotNull final Material material) {
+        super(material);
+    }
+
+    /**
+     * Create a new ItemStackBuilder to modify an existing item.
+     *
+     * @param base The ItemStack to start with.
+     */
+    public LeatherArmorBuilder(@NotNull final ItemStack base) {
+        super(base);
+    }
+
+    /**
+     * Set leather color.
+     *
+     * @param color The color.
+     * @return The builder.
+     */
+    public LeatherArmorBuilder setColor(@NotNull final java.awt.Color color) {
+        Color bukkitColor = Color.fromRGB(color.getRed(), color.getGreen(), color.getBlue());
+        this.getMeta().setColor(bukkitColor);
+
+        return this;
+    }
+
+    /**
+     * Set leather color.
+     *
+     * @param color The color.
+     * @return The builder.
+     */
+    public LeatherArmorBuilder setColor(@NotNull final Supplier<java.awt.Color> color) {
+        return this.setColor(color.get());
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/items/builder/SkullBuilder.java

@@ -0,0 +1,42 @@
+package com.willfp.eco.core.items.builder;
+
+import com.willfp.eco.util.SkullUtils;
+import org.bukkit.Material;
+import org.bukkit.inventory.meta.SkullMeta;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.Supplier;
+
+/**
+ * Builder for player heads.
+ */
+public class SkullBuilder extends AbstractItemStackBuilder<SkullMeta, SkullBuilder> {
+    /**
+     * Create a new EnchantedBookBuilder.
+     */
+    public SkullBuilder() {
+        super(Material.PLAYER_HEAD);
+    }
+
+    /**
+     * Set skull texture.
+     *
+     * @param texture The texture.
+     * @return The builder.
+     */
+    public SkullBuilder setSkullTexture(@NotNull final String texture) {
+        SkullUtils.setSkullTexture(this.getMeta(), texture);
+
+        return this;
+    }
+
+    /**
+     * Set skull texture.
+     *
+     * @param texture The texture.
+     * @return The builder.
+     */
+    public SkullBuilder setSkullTexture(@NotNull final Supplier<String> texture) {
+        return this.setSkullTexture(texture.get());
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/proxy/AbstractProxy.java

@@ -0,0 +1,14 @@
+package com.willfp.eco.core.proxy;
+
+/**
+ * All proxies must implement this interface.
+ * <p>
+ * A proxy is an NMS implementation of a proxy interface.
+ * <p>
+ * This allows for cross-version support.
+ * <p>
+ * See the core-spigot and core-nms modules of eco to see an example.
+ */
+public interface AbstractProxy {
+
+}

eco-api/src/main/java/com/willfp/eco/core/proxy/Cleaner.java

@@ -0,0 +1,18 @@
+package com.willfp.eco.core.proxy;
+
+import com.willfp.eco.core.EcoPlugin;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * A cleaner is an internal component to fix classloader errors.
+ * <p>
+ * Important to allow for PlugMan/ServerUtils support.
+ */
+public interface Cleaner {
+    /**
+     * Clean up classes left over from plugin.
+     *
+     * @param plugin The plugin.
+     */
+    void clean(@NotNull EcoPlugin plugin);
+}

eco-api/src/main/java/com/willfp/eco/core/proxy/ProxyConstants.java

@@ -1,8 +1,11 @@
-package com.willfp.eco.util.proxy;
+package com.willfp.eco.core.proxy;
 
 import lombok.experimental.UtilityClass;
 import org.bukkit.Bukkit;
 
+/**
+ * Proxy / NMS constants.
+ */
 @UtilityClass
 public class ProxyConstants {
     /**

eco-api/src/main/java/com/willfp/eco/core/proxy/ProxyFactory.java

@@ -0,0 +1,17 @@
+package com.willfp.eco.core.proxy;
+
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Factory to make proxies.
+ */
+public interface ProxyFactory {
+    /**
+     * Get the proxy implementation.
+     *
+     * @param proxyClass The proxy class.
+     * @param <T>        The proxy class.
+     * @return The proxy implementation.
+     */
+    <T extends AbstractProxy> @NotNull T getProxy(@NotNull Class<T> proxyClass);
+}

eco-api/src/main/java/com/willfp/eco/core/proxy/exceptions/ProxyError.java

@@ -0,0 +1,17 @@
+package com.willfp.eco.core.proxy.exceptions;
+
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Generic error with proxy loading.
+ */
+public class ProxyError extends RuntimeException {
+    /**
+     * Thrown if there is an error getting a proxy.
+     *
+     * @param message The message to send.
+     */
+    public ProxyError(@NotNull final String message) {
+        super(message);
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/proxy/exceptions/UnsupportedVersionException.java

@@ -1,8 +1,11 @@
-package com.willfp.eco.util.proxy;
+package com.willfp.eco.core.proxy.exceptions;
 
 import org.jetbrains.annotations.NotNull;
 
-public class UnsupportedVersionException extends RuntimeException {
+/**
+ * Error if the server is running an unsupported version.
+ */
+public class UnsupportedVersionException extends ProxyError {
     /**
      * Thrown if the server is running an unsupported NMS version.
      *

eco-api/src/main/java/com/willfp/eco/core/recipe/Recipes.java

@@ -0,0 +1,95 @@
+package com.willfp.eco.core.recipe;
+
+import com.google.common.collect.BiMap;
+import com.google.common.collect.HashBiMap;
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.items.Items;
+import com.willfp.eco.core.recipe.recipes.CraftingRecipe;
+import com.willfp.eco.core.recipe.recipes.ShapedCraftingRecipe;
+import lombok.experimental.UtilityClass;
+import org.bukkit.NamespacedKey;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Utility class to manage and register crafting recipes.
+ */
+@UtilityClass
+@SuppressWarnings("deprecation")
+public class Recipes {
+    /**
+     * Registry of all recipes.
+     */
+    private static final BiMap<NamespacedKey, CraftingRecipe> RECIPES = HashBiMap.create();
+
+
+    /**
+     * Register a recipe.
+     *
+     * @param recipe The recipe.
+     */
+    public void register(@NotNull final CraftingRecipe recipe) {
+        RECIPES.forcePut(recipe.getKey(), recipe);
+    }
+
+    /**
+     * Get recipe matching matrix.
+     *
+     * @param matrix The matrix to test.
+     * @return The match, or null if not found.
+     */
+    @Nullable
+    public CraftingRecipe getMatch(@NotNull final ItemStack[] matrix) {
+        return RECIPES.values().stream().filter(recipe -> recipe.test(matrix)).findFirst().orElse(null);
+    }
+
+    /**
+     * Get recipe by key.
+     *
+     * @param key The key.
+     * @return The recipe, or null if not found.
+     */
+    @Nullable
+    public CraftingRecipe getRecipe(@NotNull final NamespacedKey key) {
+        CraftingRecipe recipe = RECIPES.get(key);
+        if (recipe != null) {
+            return recipe;
+        }
+
+        if (key.getKey().contains("_displayed")) {
+            NamespacedKey otherKey = new NamespacedKey(key.getNamespace(), key.getKey().replace("_displayed", ""));
+
+            return RECIPES.get(otherKey);
+        }
+
+        return null;
+    }
+
+    /**
+     * Create and register recipe.
+     *
+     * @param plugin        The plugin.
+     * @param key           The key.
+     * @param output        The output.
+     * @param recipeStrings The recipe.
+     * @return The recipe.
+     */
+    public CraftingRecipe createAndRegisterRecipe(@NotNull final EcoPlugin plugin,
+                                                  @NotNull final String key,
+                                                  @NotNull final ItemStack output,
+                                                  @NotNull final List<String> recipeStrings) {
+        ShapedCraftingRecipe.Builder builder = ShapedCraftingRecipe.builder(plugin, key).setOutput(output);
+
+        for (int i = 0; i < 9; i++) {
+            builder.setRecipePart(i, Items.lookup(recipeStrings.get(i)));
+        }
+
+        ShapedCraftingRecipe recipe = builder.build();
+        recipe.register();
+
+        return recipe;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/recipe/parts/EmptyTestableItem.java

@@ -1,14 +1,18 @@
-package com.willfp.eco.util.recipe.parts;
+package com.willfp.eco.core.recipe.parts;
 
+import com.willfp.eco.core.items.TestableItem;
 import org.bukkit.Material;
 import org.bukkit.inventory.ItemStack;
 import org.jetbrains.annotations.Nullable;
 
-public class EmptyRecipePart implements RecipePart {
+/**
+ * Air or null items.
+ */
+public class EmptyTestableItem implements TestableItem {
     /**
      * Create a new empty recipe part.
      */
-    public EmptyRecipePart() {
+    public EmptyTestableItem() {
 
     }
 
@@ -24,7 +28,7 @@ public class EmptyRecipePart implements RecipePart {
     }
 
     @Override
-    public ItemStack getDisplayed() {
+    public ItemStack getItem() {
         return new ItemStack(Material.AIR);
     }
 }

eco-api/src/main/java/com/willfp/eco/core/recipe/parts/MaterialTestableItem.java

@@ -1,12 +1,16 @@
-package com.willfp.eco.util.recipe.parts;
+package com.willfp.eco.core.recipe.parts;
 
+import com.willfp.eco.core.items.TestableItem;
 import lombok.Getter;
 import org.bukkit.Material;
 import org.bukkit.inventory.ItemStack;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
-public class SimpleRecipePart implements RecipePart {
+/**
+ * Default vanilla items.
+ */
+public class MaterialTestableItem implements TestableItem {
     /**
      * The material.
      */
@@ -18,7 +22,7 @@ public class SimpleRecipePart implements RecipePart {
      *
      * @param material The material.
      */
-    public SimpleRecipePart(@NotNull final Material material) {
+    public MaterialTestableItem(@NotNull final Material material) {
         this.material = material;
     }
 
@@ -34,7 +38,7 @@ public class SimpleRecipePart implements RecipePart {
     }
 
     @Override
-    public ItemStack getDisplayed() {
+    public ItemStack getItem() {
         return new ItemStack(material);
     }
 }

eco-api/src/main/java/com/willfp/eco/core/recipe/parts/TestableStack.java

@@ -0,0 +1,73 @@
+package com.willfp.eco.core.recipe.parts;
+
+import com.willfp.eco.core.Eco;
+import com.willfp.eco.core.items.TestableItem;
+import lombok.Getter;
+import org.apache.commons.lang.Validate;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.meta.ItemMeta;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * Stacks of items.
+ */
+public class TestableStack implements TestableItem {
+    /**
+     * The item.
+     */
+    private final TestableItem handle;
+
+    /**
+     * The amount.
+     */
+    @Getter
+    private final int amount;
+
+    /**
+     * Create a new testable stack.
+     *
+     * @param item   The item.
+     * @param amount The amount.
+     */
+    public TestableStack(@NotNull final TestableItem item,
+                         final int amount) {
+        Validate.isTrue(!(item instanceof TestableStack));
+
+        this.handle = item;
+        this.amount = amount;
+    }
+
+    /**
+     * If the item matches the material.
+     *
+     * @param itemStack The item to test.
+     * @return If the item is of the specified material.
+     */
+    @Override
+    public boolean matches(@Nullable final ItemStack itemStack) {
+        return itemStack != null && handle.matches(itemStack) && itemStack.getAmount() >= amount;
+    }
+
+    @Override
+    public ItemStack getItem() {
+        ItemStack temp = handle.getItem().clone();
+        ItemMeta meta = temp.getItemMeta();
+        assert meta != null;
+
+        List<String> lore = meta.hasLore() ? meta.getLore() : new ArrayList<>();
+        assert lore != null;
+        lore.add("");
+        String add = Eco.getHandler().getEcoPlugin().getLangYml().getString("multiple-in-craft");
+        add = add.replace("%amount%", String.valueOf(amount));
+        lore.add(add);
+        meta.setLore(lore);
+        temp.setItemMeta(meta);
+        temp.setAmount(amount);
+
+        return temp;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/recipe/recipes/CraftingRecipe.java

@@ -0,0 +1,56 @@
+package com.willfp.eco.core.recipe.recipes;
+
+import com.willfp.eco.core.items.TestableItem;
+import org.bukkit.NamespacedKey;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+
+/**
+ * Any crafting recipe.
+ * <p>
+ * A crafting recipe consists of {@link TestableItem}s.
+ */
+public interface CraftingRecipe {
+    /**
+     * Test matrix against recipe.
+     *
+     * @param matrix The matrix to check.
+     * @return If the recipe matches.
+     */
+    boolean test(@NotNull ItemStack[] matrix);
+
+    /**
+     * Register the recipe.
+     */
+    void register();
+
+    /**
+     * The recipe parts.
+     *
+     * @return The parts.
+     */
+    List<TestableItem> getParts();
+
+    /**
+     * Get the recipe key.
+     *
+     * @return The key.
+     */
+    NamespacedKey getKey();
+
+    /**
+     * Get the displayed recipe key.
+     *
+     * @return The key.
+     */
+    NamespacedKey getDisplayedKey();
+
+    /**
+     * Get the recipe output.
+     *
+     * @return The output.
+     */
+    ItemStack getOutput();
+}

eco-api/src/main/java/com/willfp/eco/core/recipe/recipes/RecipePosition.java

@@ -0,0 +1,68 @@
+package com.willfp.eco.core.recipe.recipes;
+
+import lombok.Getter;
+
+/**
+ * Positions in a 3x3 crafting recipe.
+ */
+public enum RecipePosition {
+    /**
+     * Top left of matrix.
+     */
+    TOP_LEFT(0),
+
+    /**
+     * Top middle of matrix.
+     */
+    TOP_MIDDLE(1),
+
+    /**
+     * Top right of matrix.
+     */
+    TOP_RIGHT(2),
+
+    /**
+     * Middle left of matrix.
+     */
+    MIDDLE_LEFT(3),
+
+    /**
+     * Middle of matrix.
+     */
+    MIDDLE(4),
+
+    /**
+     * Middle right of matrix.
+     */
+    MIDDLE_RIGHT(5),
+
+    /**
+     * Bottom left of matrix.
+     */
+    BOTTOM_LEFT(6),
+
+    /**
+     * Bottom middle of matrix.
+     */
+    BOTTOM_MIDDLE(7),
+
+    /**
+     * Bottom right of matrix.
+     */
+    BOTTOM_RIGHT(8);
+
+    /**
+     * The index within a crafting table matrix.
+     */
+    @Getter
+    private final int index;
+
+    /**
+     * Recipe position with crafting table index.
+     *
+     * @param index The index.
+     */
+    RecipePosition(final int index) {
+        this.index = index;
+    }
+}

eco-api/src/main/java/com/willfp/eco/core/recipe/recipes/ShapedCraftingRecipe.java

@@ -0,0 +1,197 @@
+package com.willfp.eco.core.recipe.recipes;
+
+import com.willfp.eco.core.EcoPlugin;
+import com.willfp.eco.core.PluginDependent;
+import com.willfp.eco.core.items.TestableItem;
+import com.willfp.eco.core.recipe.Recipes;
+import com.willfp.eco.core.recipe.parts.EmptyTestableItem;
+import lombok.Getter;
+import org.bukkit.Bukkit;
+import org.bukkit.NamespacedKey;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.RecipeChoice;
+import org.bukkit.inventory.ShapedRecipe;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+
+/**
+ * Shaped 3x3 crafting recipe.
+ */
+public final class ShapedCraftingRecipe extends PluginDependent<EcoPlugin> implements CraftingRecipe {
+    /**
+     * Recipe parts.
+     */
+    @Getter
+    private final List<TestableItem> parts;
+
+    /**
+     * The key of the recipe.
+     */
+    @Getter
+    private final NamespacedKey key;
+
+    /**
+     * The key of the displayed recipe.
+     */
+    @Getter
+    private final NamespacedKey displayedKey;
+
+    /**
+     * The recipe's output.
+     */
+    @Getter
+    private final ItemStack output;
+
+    private ShapedCraftingRecipe(@NotNull final EcoPlugin plugin,
+                                 @NotNull final String key,
+                                 @NotNull final List<TestableItem> parts,
+                                 @NotNull final ItemStack output) {
+        super(plugin);
+
+        this.parts = parts;
+        this.key = plugin.getNamespacedKeyFactory().create(key);
+        this.displayedKey = plugin.getNamespacedKeyFactory().create(key + "_displayed");
+        this.output = output;
+    }
+
+    @Override
+    public boolean test(@NotNull final ItemStack[] matrix) {
+        boolean matches = true;
+        for (int i = 0; i < 9; i++) {
+            if (!parts.get(i).matches(matrix[i])) {
+                matches = false;
+            }
+        }
+
+        return matches;
+    }
+
+    @Override
+    public void register() {
+        Recipes.register(this);
+
+        Bukkit.getServer().removeRecipe(this.getKey());
+        Bukkit.getServer().removeRecipe(this.getDisplayedKey());
+
+        ShapedRecipe shapedRecipe = new ShapedRecipe(this.getKey(), this.getOutput());
+        shapedRecipe.shape("012", "345", "678");
+        for (int i = 0; i < 9; i++) {
+            char character = String.valueOf(i).toCharArray()[0];
+            shapedRecipe.setIngredient(character, parts.get(i).getItem().getType());
+        }
+
+        ShapedRecipe displayedRecipe = new ShapedRecipe(this.getDisplayedKey(), this.getOutput());
+        displayedRecipe.shape("012", "345", "678");
+        for (int i = 0; i < 9; i++) {
+            char character = String.valueOf(i).toCharArray()[0];
+            displayedRecipe.setIngredient(character, new RecipeChoice.ExactChoice(parts.get(i).getItem()));
+        }
+
+        Bukkit.getServer().addRecipe(shapedRecipe);
+        Bukkit.getServer().addRecipe(displayedRecipe);
+    }
+
+    /**
+     * Create a new recipe builder.
+     *
+     * @param plugin The plugin that owns the recipe.
+     * @param key    The recipe key.
+     * @return A new builder.
+     */
+    public static Builder builder(@NotNull final EcoPlugin plugin,
+                                  @NotNull final String key) {
+        return new Builder(plugin, key);
+    }
+
+    /**
+     * Builder for recipes.
+     */
+    public static final class Builder {
+        /**
+         * The recipe parts.
+         */
+        private final List<TestableItem> recipeParts = new ArrayList<>(Arrays.asList(null, null, null, null, null, null, null, null, null)); // Jank
+
+        /**
+         * The output of the recipe.
+         */
+        private ItemStack output = null;
+
+        /**
+         * The key of the recipe.
+         */
+        private final String key;
+
+        /**
+         * The plugin that created the recipe.
+         */
+        private final EcoPlugin plugin;
+
+        /**
+         * Create a new recipe builder.
+         *
+         * @param plugin The plugin that owns the recipe.
+         * @param key    The recipe key.
+         */
+        private Builder(@NotNull final EcoPlugin plugin,
+                        @NotNull final String key) {
+            this.key = key;
+            this.plugin = plugin;
+        }
+
+        /**
+         * Set a recipe part.
+         *
+         * @param position The position of the recipe within a crafting matrix.
+         * @param part     The part of the recipe.
+         * @return The builder.
+         */
+        public Builder setRecipePart(@NotNull final RecipePosition position,
+                                     @NotNull final TestableItem part) {
+            recipeParts.set(position.getIndex(), part);
+            return this;
+        }
+
+        /**
+         * Set a recipe part.
+         *
+         * @param position The position of the recipe within a crafting matrix.
+         * @param part     The part of the recipe.
+         * @return The builder.
+         */
+        public Builder setRecipePart(final int position,
+                                     @NotNull final TestableItem part) {
+            recipeParts.set(position, part);
+            return this;
+        }
+
+        /**
+         * Set the output of the recipe.
+         *
+         * @param output The output.
+         * @return The builder.
+         */
+        public Builder setOutput(@NotNull final ItemStack output) {
+            this.output = output;
+            return this;
+        }
+
+        /**
+         * Build the recipe.
+         *
+         * @return The built recipe.
+         */
+        public ShapedCraftingRecipe build() {
+            for (int i = 0; i < 9; i++) {
+                if (recipeParts.get(i) == null) {
+                    recipeParts.set(i, new EmptyTestableItem());
+                }
+            }
+
+            return new ShapedCraftingRecipe(plugin, key.toLowerCase(), recipeParts, output);
+        }
+    }
+}