Como instalar datapacks em um servidor de Minecraft

Datapacks vs plugins vs mods

Os três mudam o seu servidor, mas não são a mesma coisa, e confundi-los é o motivo comum para uma instalação falhar:

• Datapacks são integrados ao Minecraft vanilla. Eles mudam dados — receitas, tabelas de loot, funções, estruturas — e carregam a partir de uma pasta dentro do seu world. Sem software adicional, e os jogadores não precisam de nada do lado deles.
• Plugins são complementos do lado do servidor que precisam de Paper ou Spigot para funcionar (veja instalar plugins). Os datapacks funcionam em Vanilla puro; os plugins não.
• Mods precisam de um loader como Forge ou Fabric e que cada jogador instale os mesmos mods (veja servidores com mods).

Como os datapacks são vanilla e do lado do servidor, são a forma mais leve de personalizar um servidor survival ou SMP — e também funcionam sem problemas no Paper, então você pode combinar datapacks e plugins no mesmo servidor.

Passo 1: encontre um datapack para a sua versão

Os datapacks são distribuídos como arquivos .zip. As fontes principais são Modrinth e Planet Minecraft, além das próprias páginas dos criadores.

1. Combine com a sua versão de Minecraft. É a única coisa que confunde as pessoas. Um datapack criado para uma versão mais antiga pode se recusar a carregar em um servidor mais novo porque o seu pack.mcmeta declara um número de pack_format ligado à versão do jogo. Baixe a versão que indica a versão do seu servidor.
2. Baixe o zip — não o descompacte. O Minecraft carrega o datapack como um .zip. Descompactá-lo é um erro comum (uma pasta descompactada também pode funcionar, mas só se a estrutura interna estiver exatamente correta — o zip é mais seguro).

Passo 2: instale na pasta datapacks do world

Os datapacks vivem dentro de um world específico, na pasta datapacks desse world. A instalação é só isto:

1. Abra a pasta do seu world. O caminho de todo datapack é <world>/datapacks/. Se o seu world se chama world, isso é world/datapacks/.
2. Coloque o zip dentro. Ponha o .zip do datapack diretamente nessa pasta datapacks, sem subpastas.
3. Carregue-o. Se o servidor estiver rodando, digite /reload no console ou dentro do jogo; caso contrário, ele carrega na próxima inicialização. Um datapack totalmente novo que adiciona geração de mundo deve ser adicionado antes de o world ser criado pela primeira vez.
4. Verifique se carregou. Execute /datapack list: o seu pack deve aparecer na lista dos habilitados. Se um pack estiver presente mas desabilitado, habilite-o com /datapack enable "file/name.zip".

Onde fica a pasta: hospedado por você vs hospedado por terceiros

A pasta é a mesma; só muda como você chega até ela.

• Hospedado por você. O world fica no diretório do seu servidor (ou dentro de saves/ se você estiver convertendo um world de um jogador), então o caminho é <server>/world/datapacks/. Copie o zip com o seu gerenciador de arquivos.
• Hospedado por terceiros. Abra o gerenciador de arquivos do painel (ou conecte-se via SFTP), navegue até world/datapacks/ e envie o zip; depois execute /reload pelo console web. Em um servidor de Minecraft da HytHost isso é um arrastar e soltar e um clique, com backups em um clique ali mesmo se você quiser um snapshot antes.

Se o seu servidor roda vários worlds (uma divisão Nether/End, ou uma configuração multiverse), lembre-se de que os datapacks são por world: instale-os no world em que você realmente os quer.

Por que um datapack não carrega

Quase todo datapack que falha se resume a uma destas causas:

• Versão incompatível. O pack_format do pack não corresponde à sua versão de Minecraft — o console avisa que o pack é incompatível. Pegue a versão para a sua versão exata.
• Pasta errada. Ele precisa estar na pasta datapacks do world, não na raiz do servidor nem em uma pasta de resource pack.
• Você esqueceu de recarregar. Nada acontece até você executar /reload ou reiniciar. Depois disso, confirme com /datapack list.
• Na verdade é um resource pack. Os resource packs mudam a aparência do jogo e são uma configuração do cliente ou da lista de servidores, não um datapack: eles não vão nesta pasta.

Ainda travado? Leia o console na inicialização ou depois de /reload: os erros de datapack são exibidos ali com o nome do arquivo e o motivo.

Rodando vários datapacks bem

• Fique atento a conflitos. Dois datapacks que editam a mesma receita ou tabela de loot podem entrar em conflito. Adicione-os um de cada vez e teste, para saber qual causou o problema.
• A ordem pode importar. Quando os packs se sobrepõem, a ordem de carregamento decide qual prevalece; você pode defini-la com /datapack enable e suas opções first/last/before/after.
• Mantenha-os versionados com o seu servidor. Quando você atualizar o Minecraft, atualize também os seus datapacks, ou os incompatíveis param de carregar.
• Combine com Paper para o melhor dos dois. Datapacks para conteúdo compatível com vanilla, plugins para gerenciamento e proteção: eles convivem bem em um servidor Paper.