Adaptadores e compatibilidade
Execute /migrate adapters e /migrate compatibility no servidor antes de cada migração. A tabela abaixo descreve o Migrate 1.0.0; uma versão de plugin fora da faixa esperada de um adaptador é informada como não verificada ou não suportada, em vez de ser aceita em silêncio.
Capacidades #
R = leitura, W = gravação, RB = reversão dos registros gravados pelo Migrate.
| Origem ou destino | Homes | Warps | Economia | Punições | Armazenamento |
|---|---|---|---|---|---|
| EssentialsX | R W RB | R W RB | R W RB | — | Dados de usuário em YAML, warps e mapa de usuários |
| HuskHomes | R W RB | R W RB | — | — | Somente SQLite |
| PlayerPoints | — | — | R W RB | — | Somente SQLite |
| AdvancedBan | — | — | — | R W RB | MariaDB ou MySQL |
| LiteBans | — | — | — | R | MariaDB ou MySQL; somente leitura |
| Listas de banimento vanilla | — | — | — | R | banned-players.json e banned-ips.json; somente leitura |
| Arquivos de troca | R W RB | R W RB | R W RB | R W RB | Arquivos JSON Lines versionados |
Qualquer adaptador de leitura pode alimentar um adaptador de gravação do mesmo domínio. A leitura pode ocorrer enquanto o plugin de origem está em execução. A gravação exige que o plugin de destino esteja desativado e que o servidor seja reiniciado, para que o estado em cache do plugin não sobrescreva os dados migrados.
Versões verificadas #
As rotas a seguir foram exercitadas com dados reais gerados pelos plugins ou pelo servidor durante a verificação da 1.0.0:
- EssentialsX 2.21.0: homes e warps lidos e gravados; saldos lidos.
- HuskHomes 4.9.10 e 4.11: homes e warps via SQLite.
- PlayerPoints 3.3.5: saldos via SQLite.
- AdvancedBan 2.3.0: punições via MariaDB 11.8.9.
- LiteBans 2.18.7: punições lidas do MariaDB como teste de compatibilidade de caixa-preta.
- Listas de banimento vanilla de jogadores e de IPs do Paper 1.21.11.
- Arquivos de troca para homes, warps, economia e punições.
O LiteBans continua marcado como não verificado no plugin porque é de código fechado e o layout do banco de dados dele não é um contrato público de compatibilidade. Revise a simulação com cuidado.
Armazenamentos e sentidos não suportados #
- Bancos de dados de punições H2 e HSQLDB.
- Armazenamento remoto em MySQL, MariaDB ou PostgreSQL para o HuskHomes.
- Armazenamento em MySQL para o PlayerPoints.
- Gravação no LiteBans.
- Criação de arquivos de usuário do EssentialsX para jogadores que ainda não têm um.
Os adaptadores recusam armazenamento não suportado em vez de tentar uma conversão no melhor esforço.
Notas de plataforma #
O Migrate é compilado contra a API do Spigot 1.20.6 e já foi executado em Spigot, Paper, Purpur, CraftBukkit e Folia. No Folia, as rotas que exigem a API ativa de outro plugin ou acesso aos mundos ficam desativadas; as rotas de arquivos e de bancos de dados continuam disponíveis. Confie sempre no comando de compatibilidade ao vivo do servidor que você vai migrar.