Visão geral

Aguardando aprovação v1.0.0

Plataformas: Spigot, Paper, Purpur, CraftBukkit, Folia
Minecraft: Minecraft 1.20.6 ou mais recente; testado em 1.20.6, 1.21.11 e 26.2
Java: 21
Obrigatório: Nenhum
Opcional: EssentialsX, HuskHomes, PlayerPoints, AdvancedBan, LiteBans

O Migrate move homes, warps, saldos e punições entre plugins de Minecraft compatíveis, mantendo cada execução revisável e reversível. Ele prepara um plano, faz uma simulação somente leitura, cria um backup verificado, grava em lotes e relê o resultado antes de informar o sucesso.

Requisitos #

Spigot, Paper, Purpur ou Folia, Minecraft 1.20.6 ou mais recente.
Java 21 ou mais recente.
Nenhum plugin é necessário apenas para carregar o Migrate. Os plugins de origem e de destino dependem da rota de migração escolhida.

Domínios de dados #

Domínio	Nome da rota	Dados movidos
Homes	`homes`	Dono, nome, mundo, coordenadas, yaw e pitch
Warps	`warps`	Nome, mundo, coordenadas, yaw e pitch
Economia	`economy`	Saldo do jogador e moeda
Punições	`punishments`	Banimentos, silenciamentos, advertências, expulsões e notas, incluindo datas, autor e motivo

O Migrate também lê as listas de banimento vanilla do servidor e oferece suporte a um formato de troca JSON Lines documentado para transferências que não usam um adaptador direto.

Instalação #

Coloque Migrate.jar em plugins/ e inicie o servidor.
O Migrate cria plugins/Migrate/ com sua configuração, idiomas, pasta de importação, backups, relatórios e banco de dados de estado.
Execute /migrate compatibility e /migrate scan antes de preparar uma rota.

Todos os comandos são administrativos e, por padrão, restritos aos operadores do servidor. O Migrate não tem verificador de atualizações, métricas nem serviços de rede alheios à sua função. Ele só se conecta aos servidores de banco de dados que você configura explicitamente para uma rota.

Fluxo de migração 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 os dados compatíveis instalados e sugere rotas.
prepare lê a origem e cria um plano sem gravar.
dryrun valida o plano, lista os conflitos e informa se a execução é segura, segura com avisos ou bloqueada.
start mostra o escopo exato de gravação e de reversão. Ainda assim, não altera nada.
confirm, digitado dentro do prazo de confirmação configurado, cria o backup e inicia a migração.
O Migrate relê os registros gravados e informa a verificação como aprovada, aprovada com avisos ou reprovada.

Uma simulação precisa ser recente para que uma migração possa começar. O plugin de destino deve estar desativado enquanto o Migrate grava, porque os plugins compatíveis mantêm seus dados em cache. Mantenha seu próprio backup completo do servidor, além do backup específico da rota feito pelo Migrate.

Recuperação e reversão #

O Migrate registra o progresso em migrate.db. Depois de uma interrupção, ele aguarda um administrador; nunca retoma uma gravação automaticamente. Inspecione a migração e escolha resume ou rollback. O resume compara um lote interrompido com o destino antes de gravar de novo, para que os registros não sejam duplicados.

text

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

A reversão altera apenas os registros gravados por aquela migração. Um registro de destino editado depois é deixado intocado e informado.

Privacidade #

As senhas dos bancos de dados permanecem em config.yml e ficam fora dos relatórios e dos diagnósticos. Os relatórios de migração contêm informações da rota, do plano, dos conflitos, do resultado, da verificação e do backup; revise qualquer arquivo antes de compartilhá-lo publicamente.