MagmaCore/com.magmaguy.magmacore.util/WorldBlueprint

WorldBlueprint

Inspects one exported dimension, copies it without modifying the source, and replaces it with the server's own conversion of it.

Types

CopyListener

public interface CopyListener

Follows a copy into a new world folder.

Functions

adoptConversion

public void adoptConversion(Path convertedWorld, boolean modernServer, int serverDataVersion)

Replaces the blueprint with the world folder the server saved while converting it, keeping no per-world identity.

copyForConversion

public void copyForConversion(Path worldFolder)

Copies the blueprint into the world folder the server loads and saves to convert it.

copyTo

public void copyTo(Path destination, World.Environment environment, boolean modernServer)

public void copyTo(Path destination, World.Environment environment, boolean modernServer, WorldBlueprint.CopyListener listener)

hasInterruptedConversion

public static boolean hasInterruptedConversion(Path root)

Whether a conversion left its staged replacement or the blueprint it replaced beside this one.

inspect

public static WorldBlueprint inspect(Path root, World.Environment environment)

needsConversion

public boolean needsConversion(boolean modernServer, int serverDataVersion)

Whether this server rebuilds the blueprint's storage for every copy it loads: Paper 26.1+ imports any world with its own level data into its dimension storage, and every server upgrades level data an older version saved.

recoverInterruptedConversion

public static void recoverInterruptedConversion(Path root)

Restores a blueprint whose conversion stopped between moving it aside and moving its replacement in.

requireCompatibleServer

public void requireCompatibleServer(boolean modernServer)

usesModernDestination

public boolean usesModernDestination(boolean modernServer)

Worlds with their own level data retain Paper's native migration; terrain-only inputs use the live layout.