Loaders

Unlike the old SWM API, the new API does not manage the loaders for you. You have to create and manage them yourself. This allows you to have more control over the loaders and how they work. You can either create your own loader by implementing the SlimeLoader interface or use the reference ones provided by us. This page will focus on the latter option.

Obtaining the reference loaders

You need to shade the loaders into your plugin. You can do this by adding the following Maven or Gradle dependencies:

Maven

<dependencies>
  <dependency>
    <groupId>com.infernalsuite.aswm</groupId>
    <artifactId>loaders</artifactId>
    <version>3.0.0-SNAPSHOT</version>
  </dependency>
</dependencies>

Gradle

dependencies {
    implementation 'com.infernalsuite.aswm:loaders:3.0.0-SNAPSHOT'
}

Don't forget that the reference loaders are not included with the server; you have to shade them into your plugin.

Using the reference loaders

I personally recommend instantiating the loader in your plugin's onEnable method and storing it in a field. This way, you can access the loader from anywhere in your plugin. For example:

public class MyPlugin extends JavaPlugin {
    private SlimeLoader loader;
    private final AdvancedSlimePaperAPI asp = AdvancedSlimePaperAPI.instance();

    @Override
    public void onEnable() {
        loader = new FileLoader("slime_worlds");
    }
    
    public void doSomething() {
        SlimeWorld world = asp.readWorld(loader, "world", false, new SlimePropertyMap());
        
        // Do stuff with the world
    }
}