Guia

Como instalar um datapack

Atualizado em 18 de outubro de 2026

Os datapacks não precisam de mods nem de software de servidor: funcionam no vanilla, no singleplayer e em qualquer servidor. Um datapack pertence a um mundo: você o coloca na pasta datapacks desse mundo e recarrega. A única coisa a observar é se o pack foi feito para a sua versão do Minecraft.

Um exemplo para começar.

Gere isto com o Codexe

Passo a passo

1.Confira a versão
A página do pack diz quais versões do Minecraft ele suporta. Os formatos de datapack mudam entre as versões, então um pack para a 1.20 pode não funcionar na 1.21.
2.Encontre a pasta datapacks do mundo
Singleplayer: .minecraft/saves/<World>/datapacks/. Servidor: world/datapacks/ (a pasta indicada por level-name no server.properties).
3.Copie o pack
Coloque o .zip lá do jeito que está, ou a pasta descompactada. De qualquer forma, o pack.mcmeta precisa estar no nível mais alto do zip ou da pasta.
4.Recarregar
Use /reload no jogo (precisa de operador ou cheats) ou reinicie o servidor.
5.Confira se está ativado
O /datapack list mostra os packs ativados e disponíveis. Se o seu estiver disponível mas não ativado, use /datapack enable "file/<name>".

Adicionando um datapack ao criar um mundo

No singleplayer, Criar novo mundo, depois Mais e Pacotes de dados: arraste o .zip para a janela e mova para o lado dos ativados. Esse é o jeito certo para packs que mudam a geração de mundo (biomas, terreno, estruturas), porque essas mudanças só valem para os chunks gerados depois de o pack ser ativado.

Em um servidor, coloque um pack de geração de mundo em world/datapacks/ antes da primeira inicialização; senão o terreno antigo fica como estava e só os chunks novos mudam.

Problemas comuns

O pack não aparece no /datapack list: ele está na pasta errada, ou o zip tem um nível de pasta a mais, então o pack.mcmeta não está no topo.
Aviso "Feito para uma versão mais antiga/mais nova": o pack_format não corresponde ao seu jogo. O pack pode carregar, mas receitas ou funções escritas para outra versão podem falhar.
Carregou mas nada acontece: uma função ou receita tem um erro. O log do servidor (ou o log do jogo no singleplayer) indica o arquivo que falhou.
Você baixou um resource pack: texturas e sons vão em resourcepacks/, não em datapacks/. Alguns conteúdos vêm nos dois formatos.

Em um painel de hospedagem

Em um painel de hospedagem, abra o gerenciador de arquivos, vá até a pasta do mundo, envie o zip para datapacks/ e reinicie. Algumas hospedagens têm um instalador de datapacks que faz o mesmo. A pasta do mundo é a que está no server.properties, não a raiz do servidor.

Datapacks feitos com o Codexe

Um datapack feito no Codexe é carregado em um servidor real de Minecraft antes de ficar Pronto, e o log do servidor é lido em busca de erros em receitas, funções, advancements ou JSON. Você o baixa como um zip com pack.mcmeta e data/ no topo, pronto para world/datapacks/, e pode jogá-lo antes em um servidor de teste privado.

Perguntas

Preciso instalar alguma coisa no cliente?

Não. Os datapacks rodam no servidor (ou no servidor integrado do singleplayer). Os jogadores só precisam de um resource pack se o datapack vier com um para as texturas.

Um datapack vale para todos os mundos?

Não, só para o mundo em cuja pasta ele está. Copie-o para cada mundo que deve usá-lo.

Posso remover um datapack?

Use /datapack disable "file/<name>" e apague-o da pasta. O que ele já criou (itens, scoreboards, terreno gerado) pode continuar no mundo.

Crie um datapack para o seu mundo

Este prompt abre pronto para enviar:

“Um datapack para Minecraft 1.21.4, namespace "camp": uma receita sem formato para um Bedroll (3 lãs brancas e 2 linhas) que dá uma cama branca com nome, uma receita que transforma 4 carnes podres em 1 couro e uma função de load que mostra uma scoreboard de "mortes" na barra lateral.”