Complemento do Bedrock não funciona? Como resolver problemas de atualização e versão

Quase todo problema com complementos no Bedrock se resume a poucas causas: versões que não batem, um pacote que não está ativado, dois pacotes carregando a mesma coisa, ou um erro de script que o Minecraft esconde a não ser que você peça para ver. Este guia vai sintoma por sintoma.

Primeiro: qual versão eu tenho?

O Minecraft Bedrock mudou o jeito de numerar as versões em 2026. As atualizações agora levam o ano: 26.50, 26.52, e assim por diante. Dentro dos arquivos do jogo, a mesma atualização continua sendo 1.26.52. É a mesma coisa.

A tela inicial mostra sua versão no canto inferior direito.
Toda página de mod da LLS mostra Requer (a versão mais antiga em que ele roda) e Testado no (a versão mais nova em que ele foi jogado de verdade).
Um complemento que diz Requer 1.21.60 roda na 1.21.60 e em tudo o que vem depois, inclusive as atualizações 26.x.

Celulares e consoles às vezes recebem uma atualização alguns dias depois do PC. Se um complemento precisa de uma versão que o seu dispositivo ainda não recebeu, ele não importa ou não funciona até ela chegar.

“Falha na importação”

O arquivo estragou ou foi renomeado no caminho. Às vezes um navegador ou um celular salva um .mcaddon como .zip, ou um download interrompido deixa meio arquivo. Baixe de novo, garanta que o nome termina em .mcaddon e abra esse.

Ele precisa de um Minecraft mais novo. Todo pacote diz qual versão do jogo precisa. Se a sua é mais antiga, a importação falha ou o pacote mostra um aviso nas configurações do mundo. Atualize o jogo.

Você abriu de dentro de um app de zip. No Android e no iOS, abra o arquivo pelo app Arquivos (ou Compartilhar → Minecraft no iOS), não de dentro de um app que descompactou ele.

“Pacote duplicado” ou “já está instalado”

Exatamente essa versão já está na biblioteca do Minecraft. Não tem nada de errado: vá na tela de edição do mundo e ative.

Se você está tentando atualizar e mesmo assim aparece isso, o arquivo novo tem o mesmo número de versão do antigo. Exclua o antigo em Configurações → Armazenamento (pacotes de comportamento e de texturas) e importe de novo.

As criaturas estão invisíveis, ou os blocos aparecem roxo com preto

O jogo tem o pacote de comportamento (o que as coisas fazem) mas não consegue desenhar elas.

O pacote de texturas não está ativado. Edite o mundo, abra Pacotes de texturas e garanta que o pacote do complemento está entre os ativos.
O pacote de texturas é de uma versão mais antiga que o de comportamento. Depois de uma atualização, confira se os dois mostram a mesma versão, e exclua o antigo em Configurações → Armazenamento.
Um erro de renderização no pacote. O Bedrock joga fora a aparência inteira de uma criatura por causa de uma linha errada, e só avisa no registro de conteúdo (abaixo). Se as duas primeiras estão certas, é um bug do complemento: relate com o registro.

O complemento não faz nada depois de uma atualização do Minecraft

Os itens novos existem mas nada acontece quando você usa, ou as criaturas ficam paradas: é a parte de scripts que não está rodando.

Complementos com scripts beta quebram nas atualizações, é assim mesmo. As APIs beta mudam a cada versão. Um complemento que manda você ligar o experimento APIs beta pode parar de funcionar no dia em que o Minecraft atualiza, e só o autor consegue consertar. Os complementos da LLS usam a API estável, que continua funcionando entre atualizações, e não precisam de experimentos.
Experimentos ligados que o complemento não precisa podem mudar como o jogo se comporta. Teste o complemento num mundo de teste novo com todos os experimentos desligados.
Confira o registro de conteúdo. Um erro de script aparece lá com o arquivo e a linha onde aconteceu.

Como ler o registro de conteúdo

O Minecraft guarda os erros dos complementos num registro, mas esconde ele a não ser que você ative:

Configurações → Criador.
Ative a GUI do registro de conteúdo (os erros aparecem na tela quando acontecem) e o arquivo do registro de conteúdo (eles também são salvos num arquivo).
Carregue o mundo de novo e faça o que está quebrado.

No Windows, os arquivos do registro ficam em %APPDATA%\Minecraft Bedrock\logs (cole isso na barra de endereço do Explorador de Arquivos). Procure linhas com [error]. Algumas úteis:

No registro	Quer dizer
`[Molang][error]` … `Unexpected number of parameters`	Uma expressão de animação errada. O Bedrock joga fora a aparência inteira daquela criatura: ela fica invisível.
`unknown variable`	Uma linha de animação leu um valor antes de ele ser definido. As criaturas ficam rosas ou invisíveis, e o jogo pode ficar lento.
`TypeError: ... is not a function`	Um script escrito para uma API de scripts mais antiga, rodando numa mais nova.
`requires a newer version`	Atualize o Minecraft.

Você não precisa entender o erro para usar ele: copiar as primeiras linhas com [error] num relato de bug normalmente diz ao autor exatamente o que está errado.

Dois complementos brigando

O mesmo conteúdo carregado duas vezes. Alguns downloads são pacotes de outros mods. Ter os dois arquivos instalados não faz mal, porque o Minecraft só carrega os pacotes ativos num mundo. Ativar os dois no mesmo mundo carrega os mesmos blocos, criaturas e scripts duas vezes. Para os mods da LLS:

Pacote	Já inclui	Não ative também
Farm Sim Pack	Missing Blocks, Night Lite	Missing Blocks, Night Lite
Magic Pack	Magic Companions	Magic Companions

Toda página de mod lista os próprios conflitos em Não use junto com. O que não está listado lá funciona junto com qualquer outro mod da LLS.

Dois complementos diferentes mudando a mesma coisa do jogo normal. Se dois complementos mudam, por exemplo, o jogador ou o cavalo normais, só um deles ganha. Nas listas de Pacotes de comportamento e Pacotes de texturas de um mundo, o pacote mais acima na lista de ativos tem prioridade. Mova um para cima ou para baixo para escolher qual; se os dois precisam da mudança, eles não conseguem rodar juntos.

Um mundo não carrega, ou fecha depois de adicionar um complemento

Faça primeiro uma cópia do mundo (tela de edição → Copiar Mundo) e teste com a cópia.
Na cópia, desative os complementos um por um até carregar. Isso mostra qual é.
Relate ao autor daquele complemento com a sua versão do Minecraft, o dispositivo e o registro de conteúdo.

Quem joga no console

Xbox, PlayStation e Switch não instalam arquivos de complemento. Se um complemento não está no Marketplace, o único jeito de jogar com ele no console é entrar num Realm ou num mundo de alguém no PC ou no celular que tenha ele ativado.

Ainda travado?

Pergunte no Discord. Diga qual dispositivo, qual versão do Minecraft e qual complemento, e cole as linhas com [error] do registro de conteúdo. Se você ainda não instalou o complemento, comece por como instalar complementos de Minecraft Bedrock.