Fully implement Discord bot (#33)

* Fully implement Discord bot

* Fix plugin-yml plugin errors & switch to night-config

# Changes:
- Migrate from com.google.gson:gson and com.tomlj:tomlj over to com.electronwill.night-config:core, toml, and json
- Add the appropriate bukkit tags required by the minecrell/plugin-yml gradle plugin to Veritas and Tyr.

* Replace TOML wrapper with generic support

# Changes:
- Removed specific TOML wrapper in favor of GenericConfiguration.
- Added ConfigType enum to define configuration formats, parsers, and writers for TOML and JSON.
- Created FileUtils class containing useful file and directory creation methods
- Added @ApiStatus.Internal to both the BukkitDelegate class and Completions annotation to specify that they should not be used externally.

Patchwork/build.gradle

@@ -8,6 +8,9 @@ repositories {
 dependencies {
     library 'io.projectreactor:reactor-core:3.5.4'
     library 'io.github.classgraph:classgraph:4.8.162'
+    library 'com.electronwill.night-config:core:3.6.7'
+    library 'com.electronwill.night-config:toml:3.6.7'
+    library 'com.electronwill.night-config:json:3.6.7'
     api 'org.slf4j:slf4j-api:1.7.36'
 
     testImplementation platform('org.junit:junit-bom:5.9.1')
@@ -19,7 +22,7 @@ bukkit {
     description = "Freedom Network Suite Core Module (API & Library)"
 }
 
-var weight = 1
+def weight = 1
 
 test {
     useJUnitPlatform()

Patchwork/src/main/java/fns/patchwork/api/Interpolator.java

@@ -1,44 +0,0 @@
-/*
- * This file is part of FreedomNetworkSuite - https://github.com/SimplexDevelopment/FreedomNetworkSuite
- * Copyright (C) 2023 Simplex Development and contributors
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-package fns.patchwork.api;
-
-/**
- * Interpolates a range of values and returns the results in a {@link Double} array.
- * <br>
- * This is a functional interface, to allow for lambda expressions, but also for anonymous custom interpolation
- * implementations.
- */
-@FunctionalInterface
-public interface Interpolator
-{
-    /**
-     * Interpolates a range of values and returns the results in a {@link Double} array.
-     *
-     * @param from The starting value.
-     * @param to   The ending value.
-     * @param max  The number of values to interpolate.
-     * @return The interpolated values.
-     */
-    double[] interpolate(final double from, final double to, final int max);
-}

Patchwork/src/main/java/fns/patchwork/base/Registration.java

@@ -23,12 +23,12 @@
 
 package fns.patchwork.base;
 
-import fns.patchwork.data.ConfigRegistry;
-import fns.patchwork.data.EventRegistry;
-import fns.patchwork.data.GroupRegistry;
-import fns.patchwork.data.ModuleRegistry;
-import fns.patchwork.data.ServiceTaskRegistry;
-import fns.patchwork.data.UserRegistry;
+import fns.patchwork.registry.ConfigRegistry;
+import fns.patchwork.registry.EventRegistry;
+import fns.patchwork.registry.GroupRegistry;
+import fns.patchwork.registry.ModuleRegistry;
+import fns.patchwork.registry.ServiceTaskRegistry;
+import fns.patchwork.registry.UserRegistry;
 
 /**
  * This class is a holder for each registry in the data package.

Patchwork/src/main/java/fns/patchwork/command/BukkitDelegate.java

@@ -43,6 +43,7 @@ import org.bukkit.command.PluginIdentifiableCommand;
 import org.bukkit.entity.Player;
 import org.bukkit.plugin.Plugin;
 import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -60,6 +61,8 @@ import org.jetbrains.annotations.NotNull;
  * <br>
  * This class is not meant to be used outside Patchwork.
  */
+@ApiStatus.Internal
+@ApiStatus.NonExtendable
 public final class BukkitDelegate extends Command implements PluginIdentifiableCommand
 {
     private final JavaPlugin plugin;
@@ -274,3 +277,4 @@ public final class BukkitDelegate extends Command implements PluginIdentifiableC
         return this.plugin;
     }
 }
+

Patchwork/src/main/java/fns/patchwork/command/annotation/Completions.java

@@ -27,6 +27,7 @@ import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import org.jetbrains.annotations.ApiStatus;
 
 /**
  * A marker interface which represents a holder for multiple {@link Completion} annotations.
@@ -36,6 +37,7 @@ import java.lang.annotation.Target;
  */
 @Target(ElementType.TYPE)
 @Retention(RetentionPolicy.RUNTIME)
+@ApiStatus.Internal
 public @interface Completions
 {
     /**

Patchwork/src/main/java/fns/patchwork/config/ConfigType.java

@@ -0,0 +1,88 @@
+/*
+ * This file is part of FreedomNetworkSuite - https://github.com/SimplexDevelopment/FreedomNetworkSuite
+ * Copyright (C) 2023 Simplex Development and contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package fns.patchwork.config;
+
+import com.electronwill.nightconfig.core.Config;
+import com.electronwill.nightconfig.core.ConfigFormat;
+import com.electronwill.nightconfig.core.io.ConfigParser;
+import com.electronwill.nightconfig.core.io.ConfigWriter;
+import com.electronwill.nightconfig.json.FancyJsonWriter;
+import com.electronwill.nightconfig.json.JsonFormat;
+import com.electronwill.nightconfig.json.JsonParser;
+import com.electronwill.nightconfig.json.MinimalJsonWriter;
+import com.electronwill.nightconfig.toml.TomlFormat;
+import com.electronwill.nightconfig.toml.TomlParser;
+import com.electronwill.nightconfig.toml.TomlWriter;
+
+public enum ConfigType
+{
+    TOML(TomlFormat.instance(),
+         ".toml",
+         new TomlWriter(),
+         new TomlParser()),
+    JSON(JsonFormat.minimalInstance(),
+         ".json",
+         new MinimalJsonWriter(),
+         new JsonParser()),
+    JSON_FANCY(JsonFormat.fancyInstance(),
+               ".json",
+               new FancyJsonWriter(),
+               new JsonParser());
+
+    private final ConfigFormat<?> format;
+    private final String fileExtension;
+    private final ConfigWriter writer;
+    private final ConfigParser<?> parser;
+
+    ConfigType(final ConfigFormat<?> format,
+               final String fileExtension,
+               final ConfigWriter writer,
+               final ConfigParser<?> parser)
+    {
+        this.format = format;
+        this.fileExtension = fileExtension;
+        this.writer = writer;
+        this.parser = parser;
+    }
+
+    public ConfigFormat<?> getFormat()
+    {
+        return this.format;
+    }
+
+    public String getExtension()
+    {
+        return this.fileExtension;
+    }
+
+    public ConfigWriter getWriter()
+    {
+        return this.writer;
+    }
+
+    public ConfigParser<?> getParser()
+    {
+        return this.parser;
+    }
+}

Patchwork/src/main/java/fns/patchwork/config/Configuration.java

@@ -23,9 +23,8 @@
 
 package fns.patchwork.config;
 
-import fns.patchwork.api.Context;
+import fns.patchwork.provider.Context;
 import fns.patchwork.provider.ContextProvider;
-import org.jetbrains.annotations.Nullable;
 import org.jetbrains.annotations.Unmodifiable;
 
 import java.io.File;

Patchwork/src/main/java/fns/patchwork/config/GenericConfiguration.java

@@ -0,0 +1,224 @@
+/*
+ * This file is part of FreedomNetworkSuite - https://github.com/SimplexDevelopment/FreedomNetworkSuite
+ * Copyright (C) 2023 Simplex Development and contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package fns.patchwork.config;
+
+import com.electronwill.nightconfig.core.Config;
+import com.electronwill.nightconfig.core.ConfigFormat;
+import com.electronwill.nightconfig.core.UnmodifiableConfig;
+import fns.patchwork.utils.FileUtils;
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.io.FileReader;
+import java.io.FileWriter;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Optional;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.ApiStatus;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.Unmodifiable;
+
+public final class GenericConfiguration implements Configuration
+{
+    private final File configFile;
+    private final String fileName;
+    private final Config config;
+    private final ConfigType configType;
+
+    public GenericConfiguration(@NotNull final ConfigType configType,
+                                   @Nullable final JavaPlugin plugin,
+                                   @NotNull final File dataFolder,
+                                   @NotNull final String fileName,
+                                   final boolean isConcurrent) throws IOException
+    {
+        if (!fileName.endsWith(configType.getExtension()))
+            throw new IllegalArgumentException("File name must end with " + configType.getExtension() + "!");
+
+        // Ternary just to piss off Allink :)
+        final Optional<File> file = (plugin != null) ?
+            FileUtils.getOrCreateFileWithResource(dataFolder, fileName, plugin) :
+            FileUtils.getOrCreateFile(dataFolder, fileName);
+
+        if (file.isEmpty())
+            throw new FileNotFoundException();
+
+        this.configFile = file.get();
+        this.fileName = fileName;
+        this.configType = configType;
+
+        final ConfigFormat<?> format = configType.getFormat();
+
+        // Another ternary just to piss off Allink :)
+        this.config = isConcurrent ? format.createConcurrentConfig() : format.createConfig();
+
+        this.load();
+    }
+
+    public GenericConfiguration(final ConfigType type, final File dataFolder, final String fileName)
+        throws IOException
+    {
+        this(type, null, dataFolder, fileName, false);
+    }
+
+    public GenericConfiguration(final ConfigType type, final JavaPlugin plugin, final String fileName)
+        throws IOException
+    {
+        this(type, plugin, plugin.getDataFolder(), fileName, false);
+    }
+
+    public GenericConfiguration(final ConfigType type, final File dataFolder, final String fileName,
+                                   final boolean isConcurrent)
+        throws IOException
+    {
+        this(type, null, dataFolder, fileName, isConcurrent);
+    }
+
+    @Override
+    public void save() throws IOException
+    {
+        final File backup = new File(this.configFile.getParentFile(), this.fileName + ".bak");
+
+        if (backup.exists())
+            Files.delete(backup.toPath());
+
+        Files.copy(this.configFile.toPath(), backup.toPath());
+
+        try (final FileWriter writer = new FileWriter(this.configFile))
+        {
+            this.configType.getWriter().write(this.getConfig(), writer);
+        }
+    }
+
+    @Override
+    public void load() throws IOException {
+        try (final FileReader reader = new FileReader(this.configFile)) {
+            this.config.clear();
+
+            final UnmodifiableConfig parsed = this.configType.getParser().parse(reader).unmodifiable();
+            this.config.putAll(parsed);
+        }
+    }
+
+    @Override
+    public String getFileName()
+    {
+        return fileName;
+    }
+
+    @Override
+    public File getConfigurationFile()
+    {
+        return configFile;
+    }
+
+    @Override
+    public String getString(final String path)
+    {
+        if (!(this.getConfig().get(path) instanceof String))
+            throw new IllegalArgumentException(String.format("Value at path %s is not a string!", path));
+
+        return this.getConfig().get(path);
+    }
+
+    @Override
+    public boolean getBoolean(String path)
+    {
+        if (!(this.getConfig().get(path) instanceof Boolean))
+            throw new IllegalArgumentException(String.format("Value at path %s is not a boolean!", path));
+
+        return this.getConfig().get(path);
+    }
+
+    @Override
+    @ApiStatus.Internal
+    public @Unmodifiable <T> List<T> getList(String path, Class<T> clazz)
+    {
+        // TODO: Figure out how to parse lists with Night Config.
+
+        return new ArrayList<>();
+    }
+
+    @Override
+    @ApiStatus.Internal
+    public @Unmodifiable List<String> getStringList(String path)
+    {
+        // TODO: Figure out how to parse lists with Night Config.
+
+        return new ArrayList<>();
+    }
+
+    @Override
+    public int getInt(String path)
+    {
+        return this.getConfig().getInt(path);
+    }
+
+    @Override
+    public long getLong(String path)
+    {
+        return this.getConfig().getLong(path);
+    }
+
+    @Override
+    public double getDouble(String path)
+    {
+        if (!(this.getConfig().get(path) instanceof Double))
+            throw new IllegalArgumentException(String.format("Value at path %s is not a double!", path));
+
+        return this.getConfig().get(path);
+    }
+
+    @Override
+    public <T> Optional<T> get(String path, Class<T> clazz)
+    {
+        // I love ternary statements, sorry Allink :)
+        return clazz.isInstance(this.getConfig().get(path)) ?
+            Optional.of(clazz.cast(this.getConfig().get(path))) :
+            Optional.empty();
+    }
+
+    @Override
+    public <T> T getOrDefault(String path, Class<T> clazz, T fallback)
+    {
+        return this.get(path, clazz).orElse(fallback);
+    }
+
+    @Override
+    public <T> void set(final String path, final T value) {
+        this.config.set(path, value);
+    }
+
+    private UnmodifiableConfig getConfig()
+    {
+        return config.unmodifiable();
+    }
+
+    public ConfigType getConfigType()
+    {
+        return configType;
+    }
+}

Patchwork/src/main/java/fns/patchwork/event/EventBus.java

@@ -23,7 +23,7 @@
 
 package fns.patchwork.event;
 
-import fns.patchwork.api.Context;
+import fns.patchwork.provider.Context;
 import fns.patchwork.base.Patchwork;
 import fns.patchwork.service.Service;
 import java.util.HashSet;

Patchwork/src/main/java/fns/patchwork/particle/Trail.java

@@ -23,7 +23,6 @@
 
 package fns.patchwork.particle;
 
-import fns.patchwork.api.Interpolator;
 import fns.patchwork.utils.InterpolationUtils;
 import java.util.Set;
 import java.util.UUID;
@@ -101,7 +100,7 @@ public interface Trail
      * @see #getColor()
      * @see Particle
      * @see InterpolationUtils
-     * @see Interpolator
+     * @see InterpolationUtils.Interpolator
      */
     @Nullable
     Set<Color> getColors();

Patchwork/src/main/java/fns/patchwork/provider/Context.java

@@ -21,9 +21,8 @@
  * SOFTWARE.
  */
 
-package fns.patchwork.api;
+package fns.patchwork.provider;
 
-import fns.patchwork.provider.ContextProvider;
 import java.util.function.Function;
 import net.kyori.adventure.text.Component;
 import org.bukkit.Location;

Patchwork/src/main/java/fns/patchwork/registry/ConfigRegistry.java

@@ -21,7 +21,7 @@
  * SOFTWARE.
  */
 
-package fns.patchwork.data;
+package fns.patchwork.registry;
 
 import fns.patchwork.config.Configuration;
 import java.util.HashMap;

Patchwork/src/main/java/fns/patchwork/registry/EventRegistry.java

@@ -21,7 +21,7 @@
  * SOFTWARE.
  */
 
-package fns.patchwork.data;
+package fns.patchwork.registry;
 
 import fns.patchwork.event.FEvent;
 import fns.patchwork.provider.EventProvider;

Patchwork/src/main/java/fns/patchwork/registry/GroupRegistry.java

@@ -21,7 +21,7 @@
  * SOFTWARE.
  */
 
-package fns.patchwork.data;
+package fns.patchwork.registry;
 
 import fns.patchwork.permissible.Group;
 import java.util.ArrayList;

Patchwork/src/main/java/fns/patchwork/registry/ModuleRegistry.java

@@ -21,7 +21,7 @@
  * SOFTWARE.
  */
 
-package fns.patchwork.data;
+package fns.patchwork.registry;
 
 import fns.patchwork.provider.ModuleProvider;
 import java.util.ArrayList;

Patchwork/src/main/java/fns/patchwork/registry/ServiceTaskRegistry.java

@@ -21,7 +21,7 @@
  * SOFTWARE.
  */
 
-package fns.patchwork.data;
+package fns.patchwork.registry;
 
 import fns.patchwork.service.Service;
 import fns.patchwork.service.ServiceSubscription;

Patchwork/src/main/java/fns/patchwork/registry/UserRegistry.java

@@ -21,7 +21,7 @@
  * SOFTWARE.
  */
 
-package fns.patchwork.data;
+package fns.patchwork.registry;
 
 import fns.patchwork.user.User;
 import fns.patchwork.user.UserData;

Patchwork/src/main/java/fns/patchwork/serializer/Serializable.java

@@ -21,7 +21,7 @@
  * SOFTWARE.
  */
 
-package fns.patchwork.api;
+package fns.patchwork.serializer;
 
 /**
  * This interface represents a Serializable object. Objects which require custom serialization and cannot simply

Patchwork/src/main/java/fns/patchwork/utils/FileUtils.java

@@ -0,0 +1,129 @@
+/*
+ * This file is part of FreedomNetworkSuite - https://github.com/SimplexDevelopment/FreedomNetworkSuite
+ * Copyright (C) 2023 Simplex Development and contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package fns.patchwork.utils;
+
+import fns.patchwork.utils.logging.FNS4J;
+import java.io.File;
+import java.io.IOException;
+import java.nio.file.Path;
+import java.util.Optional;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NonNls;
+import org.jetbrains.annotations.NotNull;
+
+public final class FileUtils
+{
+    @NonNls
+    private static final String CREATED_DIRECTORY = "Created directory ";
+
+    private FileUtils()
+    {
+        throw new AssertionError();
+    }
+
+    public static String getExtension(@NotNull final File file)
+    {
+        return file.getName()
+                   .substring(file.getName()
+                                  .lastIndexOf('.'));
+    }
+
+    public static Optional<File> getOrCreateDirectory(final File parentDirectory, final String directoryName)
+    {
+        if (parentDirectory.mkdirs())
+            FNS4J.PATCHWORK.info(CREATED_DIRECTORY + parentDirectory.getAbsolutePath());
+
+        final File directory = new File(parentDirectory, directoryName);
+        if (directory.mkdirs())
+            FNS4J.PATCHWORK.info(CREATED_DIRECTORY + directory.getAbsolutePath());
+
+        if (directory.exists())
+            return Optional.of(directory);
+
+        return Optional.empty();
+    }
+
+    public static Optional<File> getOrCreateDirectory(final Path directoryPath)
+    {
+        Optional<File> directory = Optional.empty();
+
+        if (directoryPath.toFile().mkdirs())
+            directory = Optional.of(directoryPath.toFile());
+
+        if (directory.isPresent())
+            FNS4J.PATCHWORK.info(CREATED_DIRECTORY + directoryPath.toAbsolutePath());
+
+        return directory;
+    }
+
+    public static Optional<File> getOrCreateFile(final File parentDirectory, final String fileName)
+    {
+        if (parentDirectory.mkdirs())
+            FNS4J.PATCHWORK.info(CREATED_DIRECTORY + parentDirectory.getAbsolutePath());
+
+        final File file = new File(parentDirectory, fileName);
+        try
+        {
+            if (file.createNewFile())
+                FNS4J.PATCHWORK.info("Created file " + file.getAbsolutePath());
+
+            return Optional.of(file);
+        }
+        catch (final IOException ex)
+        {
+            FNS4J.PATCHWORK.error("Failed to create file " + fileName + ": " + ex.getMessage());
+            return Optional.empty();
+        }
+    }
+
+    public static Optional<File> getOrCreateFileWithResource(final File parentDirectory,
+                                                final String fileName,
+                                                final JavaPlugin plugin)
+    {
+        if (parentDirectory.mkdirs())
+            FNS4J.PATCHWORK.info(CREATED_DIRECTORY + parentDirectory.getAbsolutePath());
+
+        final File file = new File(parentDirectory, fileName);
+        try
+        {
+            if (file.createNewFile())
+            {
+                FNS4J.PATCHWORK.info("Created file " + file.getAbsolutePath());
+                FNS4J.PATCHWORK.info(
+                    "Copying default file from resources/" + fileName + " to " + file.getAbsolutePath());
+
+                plugin.saveResource(fileName, true);
+                FNS4J.PATCHWORK.info(
+                    "Successfully copied default file from resources/" + fileName + " to " + file.getAbsolutePath());
+            }
+
+            return Optional.of(file);
+        }
+        catch (final IOException ex)
+        {
+            FNS4J.PATCHWORK.error("Failed to create file " + fileName + ": " + ex.getMessage());
+            return Optional.empty();
+        }
+    }
+}

Patchwork/src/main/java/fns/patchwork/utils/InterpolationUtils.java

@@ -23,7 +23,6 @@
 
 package fns.patchwork.utils;
 
-import fns.patchwork.api.Interpolator;
 import java.util.LinkedHashSet;
 import java.util.Set;
 import net.kyori.adventure.text.format.NamedTextColor;
@@ -155,4 +154,24 @@ public final class InterpolationUtils
     {
         return componentRGBGradient(length, from, to, InterpolationUtils::linear);
     }
+
+    /**
+     * Interpolates a range of values and returns the results in a {@link Double} array.
+     * <br>
+     * This is a functional interface, to allow for lambda expressions, but also for anonymous custom interpolation
+     * implementations.
+     */
+    @FunctionalInterface
+    public static interface Interpolator
+    {
+        /**
+         * Interpolates a range of values and returns the results in a {@link Double} array.
+         *
+         * @param from The starting value.
+         * @param to   The ending value.
+         * @param max  The number of values to interpolate.
+         * @return The interpolated values.
+         */
+        double[] interpolate(final double from, final double to, final int max);
+    }
 }