Configuración y solución de problemas

config.yml conserva las ediciones del administrador. Las claves que faltan usan los valores predeterminados actuales sin reescribir el archivo, mientras que config.reference.yml se regenera en cada inicio como referencia completa. Migrate rechaza la configuración creada por una versión más reciente del plugin.

Ajustes importantes #

migration.confirmation-timeout-seconds: tiempo permitido entre start y confirm.
migration.dry-run-validity-minutes: cuánto tiempo sigue siendo válido el resultado de una simulación.
migration.max-records: número máximo de registros que acepta un plan.
performance.batch-size: registros escritos en un lote.
performance.pause-between-batches-ms: pausa entre lotes; auméntala en un servidor con mucha carga.
conflicts.defaults: resolución predeterminada para cada tipo de conflicto.
world-mappings y currency-mappings: asignaciones explícitas de origen a destino.
identity.create-missing-players: permite crear filas de usuario de HuskHomes que faltan; desactivado por defecto.
connections.advancedban y connections.litebans: conexiones MariaDB/MySQL configuradas explícitamente.
compatibility.allow-unverified-versions: permite que versiones de plugin más recientes y no verificadas lleguen a la simulación más estricta; desactívalo para bloquearlas.

La base de datos de estado de Migrate es SQLite. Las opciones alternativas de base de datos de estado no están verificadas para la 1.0.0 y requieren que el controlador JDBC correspondiente esté instalado en el servidor.

Políticas de conflicto #

La simulación muestra cada conflicto y la política que se aplicará. Los valores predeterminados seguros conservan los registros de destino existentes y omiten los datos no válidos o no compatibles. Otras políticas adecuadas según la ruta son OVERWRITE, RENAME, KEEP_NEWEST, KEEP_OLDEST, MANUAL y FAIL_MIGRATION.

text

/migrate conflicts MIG-20261008-0001
/migrate resolve MIG-20261008-0001 INVALID_WORLD SKIP
/migrate dryrun MIG-20261008-0001

Vuelve a hacer la simulación después de cambiar una política o una asignación.

Copias de seguridad e informes #

Antes de la primera escritura, Migrate registra los datos normalizados, las imágenes previas del destino, las copias permitidas de archivos de origen y destino, la configuración activa y las sumas de comprobación SHA-256 en plugins/Migrate/backups/<id>/. Las copias de seguridad nunca se eliminan automáticamente.

Cada migración escribe informes JSON, de texto y HTML en plugins/Migrate/reports/; los registros omitidos reciben además un informe CSV. /migrate backups <id> verifica las sumas de comprobación almacenadas.

Idiomas #

Migrate incluye inglés, turco, alemán, español, francés, portugués de Brasil, polaco, ruso, chino simplificado y japonés. Selecciona uno con /migrate language <locale> o con language.default. Las claves de mensaje que faltan recurren al inglés.

Solución de problemas #

Mensaje o situación	Acción
La simulación es demasiado antigua	Vuelve a ejecutar `/migrate dryrun <id>`.
El plugin de destino debe estar desactivado	Quita o desactiva el jar de destino, reinicia el servidor y empieza de nuevo.
La versión no está verificada	Revisa los avisos de la simulación; desactiva `compatibility.allow-unverified-versions` si hay que bloquear esas versiones.
`connections.<plugin>` no está definido	Completa esa sección de conexión y ejecuta `/migrate reload`.
Otra migración está escribiendo en el destino	Espera a que termine o revisa `/migrate history`.
La configuración no se recargó	Corrige la ruta no válida exacta que indica el mensaje; los ajustes anteriores siguen activos.
La migración se interrumpió	Ejecuta `/migrate inspect <id>` y elige `resume` o `rollback`.

Para soporte, incluye /migrate diagnostics, /migrate compatibility, /migrate adapters, el informe de texto de la migración y las líneas relevantes del registro del servidor. Elimina las contraseñas y las direcciones del servidor de todo lo que compartas.