InventorySync PRO — Instalação

Instalação
Requisitos desta versão
Servidores de jogo: o backend fornecido é compilado para a API Spigot do Minecraft 26.2 e exige Java 25+. Inclui agendamento Spigot/Paper/Folia e pode funcionar em versões compatíveis do Purpur. Usa uma distribuição destinada à sua versão real; esta Wiki não confirma compatibilidade com todas as versões do Minecraft.
Proxy opcional: BungeeCord ou Velocity compatível com sua configuração. Os módulos proxy usam bytecode Java 17, mas é necessário cumprir a exigência de Java da versão do proxy utilizada. O módulo de jogo continua exigindo Java 25+. Os drivers SQLite e MySQL estão incluídos no Universal JAR.

Instalar em um servidor de jogo

1. Para o servidor e, ao atualizar, faz backup dos dados dos jogadores e da pasta do plugin.
   
2. Coloque InventorySyncPRO-1.7.0-Universal.jar em plugins/. Mantém apenas um JAR do InventorySyncPRO; JARs de módulos Maven não são a distribuição final.
   
3. Inicia uma vez para gerar plugins/InventorySyncPRO/config.yml e messages.yml. O padrão usa SQLite, perfis GLOBAL, sincronização baú do Ender/XP ativa e ponte proxy desativada.
   
4. Para, escolhe o modo de perfis e os mapeamentos e inicia novamente. Mudanças de armazenamento, sincronização e ponte do backend exigem reinício completo.
   
5. Concede as permissões necessárias à equipe. Teste reconexão, mundos com perfis diferentes, uma consulta offline e backup antes de liberar aos jogadores.
   

Instalar em uma rede

1. Instale o Universal JAR em cada backend participante. Para os backends enquanto prepara as definições partilhadas. Cria um banco MySQL e uma conta com permissão para as tabelas do plugin.
   
2. Define storage.type: MYSQL e o mesmo banco acessível em todos os backends. Atribui um storage.server-id exclusivo a cada um. Mantém a configuração completa de sincronização/grupos e a política administrativa iguais.
   
3. Escolhe GLOBAL, PER_WORLD ou PER_GROUP. Mantém sync.restore-on-join e sync.kick-on-failure como true; MySQL exige ambos. Vê o exemplo Survival-1/Survival-2/Lobby em Configuração.
   
4. Para usar a ponte opcional, instale o mesmo JAR no BungeeCord ou Velocity. Inicia uma vez para gerar proxy.properties. Ativa a ponte nos backends e proxy e usa o mesmo segredo aleatório em todos.
   
5. Com a ponte ativa, os IDs devem coincidir exatamente com os nomes registados no proxy, incluindo maiúsculas e minúsculas. Aceitam letras, números, pontos, sublinhados e hífens, até 32 caracteres; ALL é reservado. Usa esses nomes na lista opcional de permitidos.
   
6. Reinicia backends e proxy. Confirma a inicialização, executa /isync status em cada backend e /isyncproxy status se usar a ponte. Com uma conta de teste, verifica transferência, grupo separado, restauração de XP/baú do Ender e uma edição remota permitida.
   

SQLite é local a um backend; não compartilhe seu ficheiro entre servidores. Configura corretamente encaminhamento de UUID e restrições de acesso aos backends. O proxy não precisa de credenciais do banco e não substitui MySQL.