Guia

Como criar um datapack de Minecraft

Atualizado em 7 de outubro de 2026

Um datapack muda o jogo sem mods nem plugins: receitas, loot, conquistas e funções que rodam a cada tick. Funciona em servidores vanilla e em mundos de um jogador. É uma pasta (ou um .zip) de arquivos JSON e arquivos .mcfunction com uma estrutura rígida.

Um exemplo para começar.

Gere isto com o Codexe

Passo a passo

  1. 1.Crie o pack.mcmeta

    O arquivo na raiz, com uma descrição e o número pack_format da sua versão do Minecraft. Um número errado faz o jogo avisar ou recusar o pacote.

  2. 2.Adicione a pasta data

    data/<namespace>/ com pastas como function, recipe, loot_table e advancement. Os nomes das pastas mudaram na 1.21 (singular em vez de plural).

  3. 3.Escreva as funções

    Os arquivos .mcfunction guardam comandos, um por linha. Ligue-os a minecraft:load e minecraft:tick por meio de tags de função.

  4. 4.Instale

    Coloque a pasta ou o .zip em <world>/datapacks/ e execute /reload, ou adicione ao criar o mundo.

  5. 5.Teste

    Confira o /datapack list e depois teste no jogo todas as receitas e funções. Os erros aparecem no log do servidor.

Com o Codexe

Descreva as receitas, o loot ou as mecânicas e a versão. O Codexe escreve os arquivos com a estrutura e o pack_format corretos, carrega o pacote em um servidor real de Minecraft para pegar erros antes de marcá-lo como Pronto, e deixa você entrar nesse servidor para jogar.

Perguntas

Datapack ou plugin?

Um datapack não precisa de software de servidor e funciona em um jogador, mas só consegue fazer o que os comandos e o JSON permitem. Um plugin pode fazer tudo o que a API do servidor permitir, mas precisa de Spigot ou Paper.

Por que o meu datapack não carrega?

Em geral é um pack_format errado, o nome de uma pasta de outra versão ou um erro de JSON. O log do servidor mostra o arquivo.

Crie um datapack

Este prompt abre pronto para enviar:

“Um datapack para Minecraft 1.21.4: uma receita com forma para um "Sea Totem" (Coração do Mar no meio, ouro em volta) que dá um Totem da Imortalidade com nome personalizado, e uma função de carregamento que adiciona um placar de mortes na barra lateral.”

Gere isto com o Codexe
Como criar um datapack de Minecraft (passo a passo) | Codexe