Interface BTCCoreAPI

public interface BTCCoreAPI

Main class of the SWM API. From here, you can load worlds and add them to the server's world list.
All methods are allowed to be called asynchronously unless specifically stated in the javadoc

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	BTCCoreAPI.Holder

Method Summary

Modifier and Type	Method	Description
SlimeWorld	cloneUnloadedWorld(String sourceWorldName, String targetWorldName, SlimeLoader loader, @Nullable SlimePropertyMap propertyMap)	BTCCore: Clones a SlimeWorld that is NOT currently loaded.
SlimeWorld	createEmptyWorld(String worldName, boolean readOnly, SlimePropertyMap propertyMap, @Nullable SlimeLoader loader)	Creates an empty world.
SlimeWorldInstance	getLoadedWorld(String worldName)	Gets a world which has already been loaded by ASWM.
List<SlimeWorldInstance>	getLoadedWorlds()	Gets a list of worlds which have been loaded by ASWM.
SlimeSerializationAdapter	getSerializer()	Returns the SlimeSerializationAdapter used to serialize and deserialize SlimeWorlds.
static BTCCoreAPI	instance()	Gets the instance of the BTCCore API.
SlimeWorldInstance	loadWorld(SlimeWorld world, boolean callWorldLoadEvent)	Generates a Minecraft World from a SlimeWorld and adds it to the server's world list.
void	migrateWorld(String worldName, SlimeLoader currentLoader, SlimeLoader newLoader)	Migrates a SlimeWorld to another datasource.
SlimeWorld	readVanillaWorld(File worldDir, String worldName, @Nullable SlimeLoader loader)	Reads a vanilla world and converts it to SRF.
SlimeWorld	readWorld(SlimeLoader loader, String worldName, boolean readOnly, SlimePropertyMap propertyMap)	Reads a world using a specified SlimeLoader.
void	saveWorld(SlimeWorld world)	Saves a SlimeWorld into the SlimeLoader obtained from SlimeWorld.getLoader() It is suggested to use this instead of World.save(), as this method will block the current thread until the world is saved
boolean	worldLoaded(SlimeWorld world)	Checks if a SlimeWorld is loaded on the server.

Method Details

readWorld

SlimeWorld readWorld(SlimeLoader loader,
 String worldName,
 boolean readOnly,
 SlimePropertyMap propertyMap)
              throws UnknownWorldException,
IOException,
CorruptedWorldException,
NewerFormatException

Reads a world using a specified SlimeLoader. This world won't be loaded into the server's world list.

Parameters:

loader - SlimeLoader used to retrieve the world.

worldName - Name of the world.

readOnly - Whether read-only mode is enabled.

propertyMap - A SlimePropertyMap object containing all the properties of the world.

Returns:

A SlimeWorld, which is the in-memory representation of the world.

Throws:

UnknownWorldException - if the world cannot be found.

IOException - if the world cannot be obtained from the specified data source.

CorruptedWorldException - if the world retrieved cannot be parsed into a SlimeWorld object.

NewerFormatException - if the world uses a newer version of the SRF.

getLoadedWorld

SlimeWorldInstance getLoadedWorld(String worldName)

Gets a world which has already been loaded by ASWM.

Parameters:

worldName - the name of the world to get

Returns:

the loaded world, or null if no loaded world matches the given name

getLoadedWorlds

List<SlimeWorldInstance> getLoadedWorlds()

Gets a list of worlds which have been loaded by ASWM. Note: The returned list is immutable, and encompasses a view of the loaded worlds at the time of the method call.

Returns:

a list of worlds

loadWorld

SlimeWorldInstance loadWorld(SlimeWorld world,
 boolean callWorldLoadEvent)
                      throws IllegalArgumentException

Generates a Minecraft World from a SlimeWorld and adds it to the server's world list.
This method must be called in sync with the Server Thread

Parameters:

world - SlimeWorldInstance world to be added to the server's world list

callWorldLoadEvent - Whether to call WorldLoadEvent

Returns:

Returns a slime world representing a live minecraft world

Throws:

IllegalArgumentException - if the world is already loaded

worldLoaded

boolean worldLoaded(SlimeWorld world)

Checks if a SlimeWorld is loaded on the server.

Parameters:

world - The SlimeWorld to check.

Returns:

true if the world is loaded, false otherwise.

saveWorld

void saveWorld(SlimeWorld world)
        throws IOException

Saves a SlimeWorld into the SlimeLoader obtained from SlimeWorld.getLoader()
It is suggested to use this instead of World.save(), as this method will block the current thread until the world is saved

Parameters:

world - The SlimeWorld to save.

Throws:

IOException - if the world could not be saved.

migrateWorld

void migrateWorld(String worldName,
 SlimeLoader currentLoader,
 SlimeLoader newLoader)
           throws IOException,
WorldAlreadyExistsException,
UnknownWorldException

Migrates a SlimeWorld to another datasource.

Parameters:

worldName - The name of the world to be migrated.

currentLoader - The SlimeLoader of the data source where the world is currently stored in.

newLoader - The SlimeLoader of the data source where the world will be moved to.

Throws:

IOException - if the world could not be migrated.

WorldAlreadyExistsException - if a world with the same name already exists inside the new data source.

UnknownWorldException - if the world has been removed from the old data source.

createEmptyWorld

SlimeWorld createEmptyWorld(String worldName,
 boolean readOnly,
 SlimePropertyMap propertyMap,
 @Nullable
 @Nullable SlimeLoader loader)

Creates an empty world.
This method does not load the world, nor save it to a datasource. Use loadWorld(SlimeWorld, boolean), and saveWorld(SlimeWorld) for that.

Parameters:

worldName - Name of the world.

readOnly - Whether read-only mode is enabled.

propertyMap - A SlimePropertyMap object containing all the properties of the world.

loader - The SlimeLoader used to store the world when it gets loaded, or null if the world is temporary.

Returns:

A SlimeWorld, which is the in-memory representation of the world.

readVanillaWorld

SlimeWorld readVanillaWorld(File worldDir,
 String worldName,
 @Nullable
 @Nullable SlimeLoader loader)
                     throws InvalidWorldException,
WorldLoadedException,
WorldTooBigException,
IOException,
WorldAlreadyExistsException

Reads a vanilla world and converts it to SRF.
This method does not load the world, nor save it to a datasource. Use loadWorld(SlimeWorld, boolean), and saveWorld(SlimeWorld) for that.

Parameters:

worldDir - The directory where the world is.

worldName - The name of the world.

loader - The SlimeLoader used to store the world when it gets loaded, or null if the world is temporary.

Returns:

SlimeWorld to import

Throws:

InvalidWorldException - if the provided directory does not contain a valid world.

WorldLoadedException - if the world is loaded on the server.

WorldTooBigException - if the world is too big to be imported into the SRF.

IOException - if the world could not be read or stored.

WorldAlreadyExistsException

getSerializer

@Experimental
SlimeSerializationAdapter getSerializer()

Returns the SlimeSerializationAdapter used to serialize and deserialize SlimeWorlds. Manual de-/serialization is considered experimental and may change in future versions.

Please use SlimeLoaders where possible

Returns:

A adapter for serializing and deserializing SlimeWorlds

cloneUnloadedWorld

SlimeWorld cloneUnloadedWorld(String sourceWorldName,
 String targetWorldName,
 SlimeLoader loader,
 @Nullable
 @Nullable SlimePropertyMap propertyMap)
                       throws UnknownWorldException,
WorldAlreadyExistsException,
IOException,
CorruptedWorldException,
NewerFormatException

BTCCore: Clones a SlimeWorld that is NOT currently loaded. This allows copying world data directly from the loader without needing to load it first. Useful for creating player islands from template worlds.

Parameters:

sourceWorldName - The name of the world to clone (must exist in the loader).

targetWorldName - The name of the new cloned world.

loader - The SlimeLoader where the source world is stored.

propertyMap - A SlimePropertyMap for the new world, or null to copy from source.

Returns:

A SlimeWorld representing the cloned world (not loaded).

Throws:

UnknownWorldException - if the source world cannot be found.

WorldAlreadyExistsException - if the target world already exists.

IOException - if the world cannot be read or saved.

CorruptedWorldException - if the source world data is corrupted.

NewerFormatException - if the world uses a newer version of the SRF.

instance

static BTCCoreAPI instance()

Gets the instance of the BTCCore API.

Returns:

the instance of the BTCCore API