Package com.enhancedechest.migration

Class PlayerVaultsXMigrationService

java.lang.Object

com.enhancedechest.migration.PlayerVaultsXMigrationService

public final class PlayerVaultsXMigrationService
extends Object

Migrates vaults from a PlayerVaultsX installation into EnhancedEchest's storage.

Each PlayerVaultsX vault is imported into the EnhancedEchest chest at the same index (vault #3 → chest #3), so a player's layout carries over. A vault is only written when no chest already holds data at that index — a chest with existing contents is left untouched and counted as skipped, which makes the migration safe to re-run and prevents it from ever overwriting live data.

All work here is synchronous; callers dispatch it onto the shared DB executor. The vault items are already decoded by PlayerVaultsXReader; this class only resizes/encodes/writes into storage. (PlayerVaultsX vault numbers and EnhancedEchest chest indices are both 1-based, so the mapping is direct.)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	PlayerVaultsXMigrationService.Result	Outcome of a migration run.

Constructor Summary

Constructors

Constructor	Description
PlayerVaultsXMigrationService()

Method Summary

Modifier and Type	Method	Description
PlayerVaultsXMigrationService.Result	migrateAll()	Migrates every player found in the PlayerVaultsX vault folder.
PlayerVaultsXMigrationService.Result	migratePlayer(UUID owner)	Migrates a single player by UUID.
boolean	sourceAvailable()	True if a PlayerVaultsX vault-data folder with at least one player file is present to migrate from.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

PlayerVaultsXMigrationService

public PlayerVaultsXMigrationService()

Method Details

sourceAvailable

public boolean sourceAvailable()

True if a PlayerVaultsX vault-data folder with at least one player file is present to migrate from.

migrateAll

public PlayerVaultsXMigrationService.Result migrateAll()
                                                throws Exception

Migrates every player found in the PlayerVaultsX vault folder.

Throws:

Exception

migratePlayer

public PlayerVaultsXMigrationService.Result migratePlayer(UUID owner)
                                                   throws Exception

Migrates a single player by UUID. Returns the same counters scoped to that player.

Throws:

Exception