O que este conversor pode e não pode fazer
Os pacotes Minecraft Java e Bedrock usam metadados e caminhos de textura diferentes. Esta ferramenta lida com a conversão básica útil: metadados do pacote, ícones do pacote e pastas de textura comuns. Ela não pretende traduzir perfeitamente OptiFine CIT, modelos CEM, shaders, modelos de itens Java, render controllers Bedrock ou lógica de behavior packs.
Use o conversor quando um pacote for feito principalmente de texturas padrão de blocos e itens, ou quando você quiser um ponto de partida limpo para uma portabilidade manual. Java Edition e Bedrock Edition são motores separados com diferentes nomes de arquivo, sistemas de modelo, regras de material e metadados. Um arquivo convertido deve, portanto, ser tratado como um rascunho de trabalho que ainda precisa de um teste no jogo, não como prova de que cada recurso é compatível.
Java -> Bedrock
Cria manifest.json, gera UUIDs, mapeia assets/minecraft/textures/block e item para pastas de textura Bedrock, e exporta .mcpack.
Bedrock -> Java
Cria pack.mcmeta, mapeia textures/blocks e textures/items para pastas de textura Java, e exporta um .zip pronto para Java.
Atualização de Java
Copia o pacote Java e reescreve pack.mcmeta com o pack_format selecionado para versões mais recentes do Minecraft.
1. Mantenha o arquivo original
Faça um backup antes de começar. O conversor cria um novo download e não sobrescreve o arquivo de origem, mas o pacote original é a referência mais segura quando você precisa restaurar um modelo, textura ou entrada de metadados.
2. Escolha a direção correta
Use Java para Bedrock para um .zip Java que contém pack.mcmeta. Use Bedrock para Java para um .mcpack ou .zip que contém manifest.json. A Atualização de Versão Java apenas reescreve pack.mcmeta em um pacote Java existente.
3. Revise os detalhes do pacote detectado
Verifique o nome do pacote, a descrição e o pack_format Java antes de converter. Um valor pack_format apenas informa ao Java qual formato de pacote de recursos é direcionado. Ele não reescreve automaticamente modelos ou outros arquivos específicos da versão.
4. Baixe e teste em um mundo novo
Instale o arquivo convertido, ative-o sozinho e inspecione vários blocos e itens. Testar sem outros pacotes facilita a identificação de texturas ausentes, caminhos incorretos e conflitos de ordem de carregamento.
O que muda durante a conversão
A tabela abaixo separa o trabalho concluído automaticamente das partes que você deve revisar. Isso facilita a decisão de saber se o conversor se encaixa no seu pacote antes de processar um arquivo grande.
| Conversão | Tratado automaticamente | Revisar após o download |
|---|---|---|
| Java para Bedrock | Cria manifest.json e UUIDs, copia o ícone do pacote e remapeia os caminhos comuns de textura de blocos e itens. | Modelos Java, recursos OptiFine, shaders, fontes, sons, animações e requisitos de material ou render-controller Bedrock. |
| Bedrock para Java | Cria pack.mcmeta, copia o ícone do pacote e remapeia blocos e itens comuns para a árvore de texturas Java. | UI apenas para Bedrock, definições de entidade, attachables, render controllers, materiais e qualquer conteúdo de behavior pack. |
| Atualização de versão Java | Copia o arquivo e substitui pack.mcmeta pelo pack_format e descrição selecionados. | Caminhos de textura renomeados, esquemas de modelo alterados, ativos de jogo removidos e outras alterações entre as versões do Minecraft. |
Lista de verificação de testes
- Confirme que o Minecraft reconhece o arquivo e mostra o nome e o ícone do pacote esperados.
- Verifique blocos e itens de várias famílias de materiais em vez de testar apenas uma textura.
- Procure o padrão de textura ausente roxo e preto e leia o log do jogo para caminhos inválidos.
- Teste texturas animadas, pixels transparentes, sons personalizados, fontes, modelos e interfaces de usuário separadamente.
- Abra CONVERSION_NOTES.txt no download. Ele lista os arquivos que o conversor ignorou porque precisam de trabalho manual.
Problemas comuns de conversão
Minecraft não detecta o pacote: Abra o arquivo e certifique-se de que pack.mcmeta ou manifest.json esteja na raiz do arquivo, não dentro de uma pasta aninhada extra.
Algumas texturas estão faltando: Compare o ativo ausente com o pacote original e verifique seu caminho específico da edição. Modelos complexos podem referenciar texturas adicionais que não fazem parte do mapeamento básico de pastas.
O pacote carrega, mas parece errado: Desative outros pacotes de recursos, verifique a versão do Minecraft de destino e inspecione texturas transparentes ou animadas. Diferentes edições podem interpretar layouts UV e regras de renderização de forma diferente.
Privacidade e pacotes grandes
O arquivo selecionado permanece no seu navegador. O JSZip o lê e reconstrói localmente, então a ferramenta não envia suas texturas para o MC Toolbox. Pacotes muito grandes ainda podem usar uma memória substancial porque o navegador deve manter o arquivo de origem e o arquivo gerado ao mesmo tempo. Se uma conversão grande falhar, feche as abas não utilizadas e tente o pacote em um navegador de desktop.
FAQ do Conversor de Pacotes
Ele pode converter todos os pacotes perfeitamente?
Não. Ele lida com a conversão comum de texturas e metadados. OptiFine CIT, modelos CEM, shaders, modelos Java personalizados, render controllers Bedrock e lógica de comportamento geralmente precisam de edições manuais.
Meus arquivos são enviados?
Não. O conversor é executado localmente no seu navegador usando JSZip. Ele lê seu arquivo, constrói um novo arquivo e o baixa sem enviar o pacote para um servidor.
Quais formatos devo enviar?
Use .zip para pacotes Java e .mcpack ou .zip para pacotes Bedrock. A saída é .mcpack para Bedrock ou .zip para Java.
Mudar o pack_format atualiza texturas e modelos antigos?
Não. A Atualização de Versão Java altera apenas pack.mcmeta. O Minecraft renomeou arquivos e alterou formatos de modelo em diferentes lançamentos, então um pacote mais antigo ainda pode precisar de trabalho de migração manual.
Posso converter um behavior pack Bedrock em um data pack Java?
Não. Este conversor é para metadados e texturas comuns de pacotes de recursos. Behavior packs Bedrock e data packs Java usam sistemas diferentes e exigem conversão específica ou recriação manual.
Por que o pacote convertido tem menos arquivos?
Caminhos específicos da edição e não suportados são intencionalmente deixados de fora do arquivo gerado. Leia CONVERSION_NOTES.txt para ver quais arquivos foram ignorados e, em seguida, porte os recursos que você ainda precisa manualmente.