Configuração e solução de problemas

O config.yml mantém as edições do administrador. Chaves ausentes usam os padrões atuais sem reescrever o arquivo, enquanto o config.reference.yml é regenerado a cada inicialização como referência completa. O Migrate recusa configurações criadas por uma versão mais nova do plugin.

Configurações importantes #

migration.confirmation-timeout-seconds: tempo permitido entre start e confirm.
migration.dry-run-validity-minutes: por quanto tempo o resultado de uma simulação continua válido.
migration.max-records: número máximo de registros aceitos em um plano.
performance.batch-size: registros gravados em um lote.
performance.pause-between-batches-ms: pausa entre os lotes; aumente-a em um servidor movimentado.
conflicts.defaults: resolução padrão para cada tipo de conflito.
world-mappings e currency-mappings: mapeamentos explícitos de origem para destino.
identity.create-missing-players: permite criar linhas de usuário do HuskHomes que estão faltando; desativado por padrão.
connections.advancedban e connections.litebans: conexões MariaDB/MySQL configuradas explicitamente.
compatibility.allow-unverified-versions: permite que versões de plugin mais novas e não verificadas cheguem à simulação mais rigorosa; desative para bloqueá-las.

O banco de dados de estado do próprio Migrate é SQLite. As opções alternativas de banco de dados de estado não estão verificadas para a 1.0.0 e exigem que o driver JDBC correspondente esteja instalado no servidor.

Políticas de conflito #

A simulação mostra cada conflito e a política que será aplicada. Os padrões seguros mantêm os registros de destino existentes e ignoram dados inválidos ou não suportados. Outras políticas adequadas à rota incluem OVERWRITE, RENAME, KEEP_NEWEST, KEEP_OLDEST, MANUAL e FAIL_MIGRATION.

text

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

Refaça a simulação depois de alterar uma política ou um mapeamento.

Backups e relatórios #

Antes da primeira gravação, o Migrate registra os dados normalizados, as imagens anteriores do destino, as cópias permitidas dos arquivos de origem e destino, a configuração ativa e os checksums SHA-256 em plugins/Migrate/backups/<id>/. Os backups nunca são excluídos automaticamente.

Cada migração grava relatórios JSON, de texto e HTML em plugins/Migrate/reports/; os registros ignorados também recebem um relatório CSV. /migrate backups <id> verifica os checksums armazenados.

Idiomas #

O Migrate inclui inglês, turco, alemão, espanhol, francês, português do Brasil, polonês, russo, chinês simplificado e japonês. Selecione um com /migrate language <locale> ou com language.default. Chaves de mensagem ausentes recorrem ao inglês.

Solução de problemas #

Mensagem ou situação	Ação
A simulação é antiga demais	Execute `/migrate dryrun <id>` de novo.
O plugin de destino precisa estar desativado	Remova ou desative o jar de destino, reinicie o servidor e comece de novo.
A versão não está verificada	Revise os avisos da simulação; desative `compatibility.allow-unverified-versions` se essas versões precisarem ser bloqueadas.
`connections.<plugin>` não está definido	Complete essa seção de conexão e execute `/migrate reload`.
Outra migração está gravando no destino	Aguarde o término ou consulte `/migrate history`.
A configuração não foi recarregada	Corrija o caminho inválido exato citado na mensagem; as configurações anteriores continuam ativas.
A migração foi interrompida	Execute `/migrate inspect <id>` e escolha `resume` ou `rollback`.

Para suporte, inclua /migrate diagnostics, /migrate compatibility, /migrate adapters, o relatório de texto da migração e as linhas relevantes do log do servidor. Remova senhas e endereços de servidor de tudo o que você compartilhar.