Descripción general

Pendiente de aprobación v1.0.0

Plataformas: Spigot, Paper, Purpur, CraftBukkit, Folia
Minecraft: Minecraft 1.20.6 o posterior; probado en 1.20.6, 1.21.11 y 26.2
Java: 21
Obligatorio: Ninguno
Opcional: EssentialsX, HuskHomes, PlayerPoints, AdvancedBan, LiteBans

Migrate traslada hogares, warps, saldos y sanciones entre plugins de Minecraft compatibles, y mantiene cada ejecución revisable y reversible. Prepara un plan, realiza una simulación de solo lectura, crea una copia de seguridad verificada, escribe por lotes y vuelve a leer el resultado antes de informar del éxito.

Requisitos #

Spigot, Paper, Purpur o Folia, Minecraft 1.20.6 o superior.
Java 21 o superior.
No hace falta ningún plugin solo para cargar Migrate. Los plugins de origen y destino dependen de la ruta de migración que elijas.

Dominios de datos #

Dominio	Nombre de la ruta	Datos que se trasladan
Hogares	`homes`	Propietario, nombre, mundo, coordenadas, yaw y pitch
Warps	`warps`	Nombre, mundo, coordenadas, yaw y pitch
Economía	`economy`	Saldo del jugador y moneda
Sanciones	`punishments`	Bans, silenciamientos, advertencias, expulsiones y notas, con fechas, emisor y motivo

Migrate también lee las listas de baneos vanilla del servidor y admite un formato de intercambio JSON Lines documentado para las transferencias que no usan un adaptador directo.

Instalación #

Copia Migrate.jar en plugins/ e inicia el servidor.
Migrate crea plugins/Migrate/ con su configuración, los idiomas, la carpeta de importación, las copias de seguridad, los informes y la base de datos de estado.
Ejecuta /migrate compatibility y /migrate scan antes de preparar una ruta.

Todos los comandos son administrativos y por defecto están reservados a los operadores del servidor. Migrate no tiene comprobador de actualizaciones, métricas ni servicios de red ajenos a su función. Solo se conecta a los servidores de bases de datos que configuras explícitamente para una ruta.

Flujo de migración seguro #

text

/migrate scan
/migrate prepare essentialsx huskhomes homes
/migrate dryrun MIG-20261008-0001
/migrate start MIG-20261008-0001
/migrate confirm MIG-20261008-0001
/migrate status MIG-20261008-0001

scan detecta los datos compatibles instalados y sugiere rutas.
prepare lee el origen y crea un plan sin escribir.
dryrun valida el plan, lista los conflictos e indica si la ejecución es segura, segura con avisos o está bloqueada.
start muestra el alcance exacto de escritura y de reversión. Aun así no cambia nada.
confirm, introducido dentro del plazo de confirmación configurado, crea la copia de seguridad e inicia la migración.
Migrate vuelve a leer los registros escritos e informa de la verificación como superada, superada con avisos o fallida.

Una simulación debe ser reciente para que pueda iniciarse una migración. El plugin de destino debe estar desactivado mientras Migrate escribe, porque los plugins compatibles almacenan sus datos en caché. Mantén tu propia copia de seguridad completa del servidor además de la copia específica de la ruta de Migrate.

Recuperación y reversión #

Migrate registra el progreso en migrate.db. Tras una interrupción espera a un administrador; nunca reanuda una escritura automáticamente. Inspecciona la migración y elige resume o rollback. Resume comprueba un lote cortado contra el destino antes de volver a escribir, para que no se dupliquen registros.

text

/migrate inspect MIG-20261008-0001
/migrate rollback MIG-20261008-0001
/migrate rollback MIG-20261008-0001 confirm

La reversión solo cambia los registros escritos por esa migración. Un registro de destino editado después se deja intacto y se informa.

Privacidad #

Las contraseñas de las bases de datos permanecen en config.yml y se excluyen de los informes y diagnósticos. Los informes de migración contienen información de la ruta, el plan, los conflictos, el resultado, la verificación y las copias de seguridad; revisa cualquier archivo antes de compartirlo públicamente.