Introdução aos Pacotes de Recursos

Antes de criar seu primeiro complemento para Minecraft: Bedrock Edition, você precisará criar um pacote para armazenar seu conteúdo personalizado. Existem dois tipos de pacotes que um criador pode fazer: pacotes de recursos e pacotes de comportamento. A pacote de recursos é uma estrutura de pastas que conterá todos os seus modelos personalizados, sons, texturas e outros conteúdos personalizados. Este tutorial mudará a cor da sujeira para um verde brilhante.

alt="Introdução aos Pacotes de Recursos" src="/images/posts/059bb17c55d44da740c709d91a720175-0.jpg">

Neste tutorial, você aprenderá o seguinte:

Como um pacote de recursos é criado.

Como um arquivo de manifesto é criado.

Como as texturas personalizadas são carregadas no Minecraft.

O conceito de Empilhamento de Pacotes ao trabalhar com conteúdo Add-On.

name="exemplo-de-pacote-de-recursos">Exemplo de pacote de recursos

Há um pacote de recursos de exemplo disponível no Github de exemplos do Minecraft. pode ser usado para entender a estrutura dos pacotes de recursos e verificar seu trabalho após o tutorial.

name="requisitos">Requisitos

Recomendamos concluir o seguinte antes de iniciar este tutorial:

Introdução ao desenvolvimento de complementos

name="construindo-o-pacote-de-recursos">Construindo o pacote de recursos

Para que o Minecraft encontre e use seus arquivos de recursos, você deve configurar as pastas e arquivos em uma estrutura específica. Este tutorial irá guiá-lo através da criação desta pasta e estrutura de arquivo.

alt="Introdução aos Pacotes de Recursos" src="/images/posts/059bb17c55d44da740c709d91a720175-1.jpg">

name="crie-uma-pasta">Crie uma pasta

Nesta seção, você começará criando uma pasta chamada Meu_RESOURCE_Pack. Bem, você não precisa chamá-lo assim. Na verdade, você pode nomear esta pasta como quiser, mas as outras pastas devem ser nomeadas exatamente como este tutorial diz para que o Minecraft saiba onde procurar.

Abra o seu com.mojang pasta.

Clique duas vezes no development_resource_packs pasta para abri-lo.

Adicione uma nova pasta e nomeie-a Meu_RESOURCE_Pack.

Clique duas vezes no *Meu_RESOURCE_Pack pasta para abri-lo.
alt="Introdução aos Pacotes de Recursos" src="/images/posts/059bb17c55d44da740c709d91a720175-2.jpg">

name="criar-um-arquivo-de-manifesto">Criar um arquivo de manifesto

Para carregar um pacote de recursos no Minecraft, um arquivo de manifesto precisará ser criado. O arquivo de manifesto é um arquivo JSON que contém as seguintes informações:

Descrição: descrição no jogo do que o pacote de recursos faz.

Nome: Nome no jogo do pacote de recursos.

name="uuid">UUID: Identificador universalmente exclusivo.

Versão: Versão do pacote de recursos.

Versão Mínima do Motor: Versão necessária do Minecraft em que este pacote funcionará.

Anote os

Para saber mais sobre como um arquivo manifest.json funciona, consulte a documentação do manifest.json Referência de complementos.

O Minecraft analisará as informações do arquivo de manifesto e as exibirá na seção Add-On do jogo. Dentro do arquivo, as informações serão divididas em duas seções separadas: cabeçalho e módulos. A seção de cabeçalho conterá as informações gerais do pacote e a seção de módulos conterá as informações dos pacotes dedicados.

Clique com o botão direito do mouse na janela do Explorer, selecione Novo> Documento de Texto.

Diga manifest.json.
1. Você precisará alterar a extensão do arquivo de .txt para .json. Se a janela do Explorer não mostrar as extensões de arquivo, você pode habilitar Extensões de nome de arquivo sob a Veja aba.
  alt="Introdução aos Pacotes de Recursos" src="/images/posts/059bb17c55d44da740c709d91a720175-3.jpg">
  Clique duas vezes no arquivo manifest.json para abri-lo em um editor de texto.

Copie e cole o seguinte código em seu arquivo.

{ "format_version": 2, "header": { "description": "Meu complemento do pacote de recursos sujos!", "name": "Meu pacote de recursos", "uuid":"", "versão": [1 , 0, 0], "min_engine_version": [1, 16, 0] }, "modules": [ { "description": "Meu primeiro complemento!", "type": "resources", "uuid": "", "versão": [1, 0, 0] } ] }

name="uuid">UUID

Universally Unique Identifier, ou name="uuid">UUID para abreviar, é um número único usado para identificar diferentes softwares. Para Minecraft, o name="uuid">UUID é usado para definir um pacote específico e para evitar que qualquer software duplicado cause problemas. Para o cabeçalho e os módulos, serão necessários dois números name="uuid">UUID diferentes inseridos em cada um dos campos "uuid" entre as aspas. Você pode obter name="uuid">UUIDs de um gerador de name="uuid">UUID online, como https://www.uuidgenerator.net/.

alt="Introdução aos Pacotes de Recursos" src="/images/posts/059bb17c55d44da740c709d91a720175-4.jpg">

Copie e cole um name="uuid">UUID na seção de cabeçalho. O name="uuid">UUID precisará ser colado no campo "uuid":"" entre aspas ("") para ser lido corretamente.

Atualize a página da Web para gerar um novo name="uuid">UUID para uso na seção Módulos.

Copie e cole o novo name="uuid">UUID na seção de módulos no campo "uuid" entre as aspas.

Salve o arquivo manifest.json.

name="mudando-o-bloco-de-sujeira">Mudando o bloco de sujeira

Com o arquivo de manifesto concluído, agora você pode começar a adicionar conteúdo personalizado ao Minecraft. Vamos começar aplicando uma nova textura ao bloco de terra de baunilha. A primeira parte do processo envolve a criação de uma estrutura de pastas para conter a textura.

No Explorador de Arquivos, no Meu_RESOURCE_Pack pasta, crie uma pasta e nomeie-a texturas.

Clique duas vezes no texturas pasta para abri-lo.

Dentro da pasta textures, crie uma pasta e nomeie-a blocos.

Clique duas vezes no blocos pasta para abri-lo.

name="criando-a-textura">Criando a textura

Agora que a estrutura da pasta foi criada, você pode colocar suas texturas personalizadas lá. Este pequeno quadrado verde é um exemplo do tipo de arquivo criado pelas etapas a seguir.

Você pode baixá-lo e salvá-lo em seu blocos pasta ou siga estas etapas para criar sua textura:

Abra um editor de imagens como o MS Paint.

Vou ao Envie o Menu e selecione Propriedades.

Colocou o Largura e Altura para Pixels 16 cada.

Clique OK.

Agora você pode criar um padrão ou qualquer arte no editor. Para fazer o quadrado verde, uma cor de preenchimento simples foi adicionada.

Anote os

O MS Paint é usado neste exemplo para acesso rápido e fácil, mas você precisará usar um editor gráfico diferente para recursos gráficos mais avançados, como efeitos de transparência ou suporte a arquivos .tga.

Quando terminar de editar sua textura, vá para o Envie o Menu e selecione Salvar como.

Escolha o imagem PNG opção.

Na série Salvar como caixa de diálogo, navegue até o blocos pasta que você criou.

Salve o arquivo como sujeira.png.

name="testando-o-pacote">Testando o pacote

Agora que o pacote possui um arquivo de manifesto e um arquivo de textura, você pode iniciar o Minecraft e testar seu novo complemento de recurso.

importante

Empilhamento de Pacotes é como o conteúdo é carregado em cima do conteúdo vanilla, fazendo com que cada objeto que tenha o mesmo nome em ambos os pacotes seja substituído pelo último pacote aplicado. Em nosso exemplo, a textura de sujeira original é substituída por nossa textura personalizada.

Se outro pacote que usa o arquivo dirt.png for carregado depois de My_RESOURCE_Pack, o Minecraft usará esse e você não verá essa alteração.

Sua textura personalizada será usada em cada bloco dirt.png do mundo, mas não será usada em blocos de terra com grama porque esses blocos têm um nome diferente.

Inicie o Minecraft e selecione Jogar.

Selecionar Crie um novo mundo.

Debaixo Configurações, role para baixo até o Serviços extra seção.

Clique em Pacotes de recursos para ver todos os pacotes disponíveis.

Clique na MEUS PACOTES drop-down para abri-lo.

Selecionar Meu pacote de RECURSOS e clique Ativação para adicionar o pacote de recursos ao mundo.

Clique Create para criar o seu mundo.
alt="Introdução aos Pacotes de Recursos" src="/images/posts/059bb17c55d44da740c709d91a720175-5.jpg">

Problemas com o pacote de recursos? A solução de problemas é uma parte normal de qualquer processo de desenvolvimento. Aqui estão alguns lugares para começar a solucionar problemas de um pacote de recursos ausente.

Você pode usar o pacote de recursos de amostra no site do Github de amostras do Minecraft para verificar a estrutura do seu pacote de recursos.

Seu pacote de recursos não aparece no Minecraft

Se o seu pacote de recursos não aparecer na seção Add-Ons de um mundo, isso aponta para um arquivo manifest.json malformado. Vamos investigá-lo.

Existem dois name="uuid">UUIDs diferentes no cabeçalho manifest.json e na seção de módulos? Veja o name="uuid">UUID seção para mais informações.

Você ativou extensões e caminhos de arquivo? Se a janela do Explorer não mostrar as extensões de arquivo, você pode habilitar Extensões de nome de arquivo sob a Veja aba.

Verifique novamente as chaves e colchetes JSON. As ferramentas de linting JSON podem ajudar.

O pacote de recursos aparece, o conteúdo não funciona

Verifique se a pasta de texturas está no lugar certo e digitada corretamente. Em seguida, verifique a pasta de blocos também.

Baixe o pacote de recursos Vanilla e tente adicionar seu bloco à pasta existente de texturas/blocos.

Certifique-se de que o novo arquivo de textura tenha o mesmo nome da textura vanilla que você está substituindo.

Mova seu pacote acima dos outros para garantir que sua textura dirt.png seja carregada antes de outros pacotes de recursos, graças ao empilhamento de pacotes.

Qual é o próximo?

Com uma textura personalizada agora fazendo parte do seu mundo Minecraft, é hora de ver como os pacotes de comportamento alteram os comportamentos de entidades existentes. Na próxima seção, você adicionará comportamento agressivo a uma entidade vaca normalmente pacífica.

pacote de comportamento

Para ver exemplos de recursos inalterados e arquivos de comportamento, confira o pacote de recursos do Minecraft Vanilla e o pacote de comportamento Vanilla.