Tutoriais / Criando um pacote de dados

Este arquivo foi escrito em JSON! Este tutorial não entra em detalhes sobre o formato agora, mas esteja ciente de como as coisas estão dispostas. Tenha muito cuidado para não esquecer aspas, dois-pontos e colchetes ou curvas. Certifique-se de não escrever vírgulas finais. A falta de um deles pode fazer com que seu pacote de dados não funcione corretamente! Para verificar seus arquivos, você pode usar um validador JSON, como o encontrado no JSONLint.

name="-pack-format-">"pack_format"

O valor de name="-pack-format-">"pack_format" diz ao Minecraft para qual versão o pacote de dados foi projetado e é diferente para certas versões. A lista a seguir a quais versões cada valor está associado:

• 4 para as versões 1.13 - 1.14.4
• 5 para as versões 1.15 - 1.16.1
• 6 para as versões 1.16.2 - 1.16.5
• 7 para versões 1.17+

Nota: Conforme mais atualizações são lançadas, os valores podem ser alterados ou adicionados.

name="-descri--o-">"Descrição"

O texto após a "descrição" pode ser qualquer string ou um texto JSON bruto. Ele aparecerá quando você passar o mouse sobre o pacote de dados na saída da lista / datapack e na interface do usuário do pacote de dados ao criar um mundo. Em pack.mcmeta, é possível usar o símbolo § (consulte os códigos de formatação do Minecraft) na descrição de pack.mcmeta e no nome do pacote de dados.

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

Depois de criar seu pack.mcmeta, tente testá-lo no jogo! Abra o mundo ou, se você já estiver no mundo, digite / reload e, em seguida, digite / datapack list. Deve listar duas entradas. Um deve ser [vanilla] (embutido), o segundo deve ser nomeado como [arquivo / (nome do seu pacote de dados) (mundo)], onde fica o nome da pasta do seu pacote de dados (nome do seu pacote de dados). Quando você passa o mouse sobre a entrada do seu pacote de dados, você deve ver a descrição do seu pacote de dados como você escreveu na descrição do seu pack.mcmeta.

Quando sua mochila aparecer, você estará pronto para seguir em frente.

Se você não encontrar seu pacote na lista, verifique se o arquivo pack.mcmeta está correto e salvo. Procure por chaves ausentes {}, vírgulas, dois pontos:, aspas "" ou colchetes. Lembre-se de que para cada chave aberta, citação ou colchete, você deve ter um colchete de fechamento, citação ou colchete. Se você ainda não consegue ver seu pacote, certifique-se de que está na pasta certa.

Nomeando

Crie uma pasta chamada data em sua pasta de pacote de dados, onde você colocou o arquivo pack.mcmeta. Nesta pasta de dados você deve criar uma ou mais pastas que irão atuar como seus namespaces.

As entradas em pacotes de dados têm localizações de recursos na forma de namespace: path. O arquivo correspondente estaria localizado em data / namespace / (data_type) / path. (Sufixo). Observe que os caracteres / no caminho serão traduzidos em separadores de diretório.

Alguns exemplos:

• uma etiqueta de item de ID dummy: foo_proof / bar estaria localizada em data / dummy / tags / item / foo_proof / bar.json
• uma função de ID foo: handler / bar_call estaria localizada em data / foo / functions / handler / bar_call.mcfunction

Personagens legais

Namespaces, caminhos e outros nomes de pastas e arquivos no pacote de dados devem conter apenas os seguintes símbolos:

• Números 0123456789
• abcdefghijklmnopqrstuvwxyz Letras minúsculas
• _ Sublinhado
• - Hífen / menos
• / Barra para frente / Separador de diretório (não pode ser usado no namespace)
• . Período

A convenção de nomenclatura preferida é lower_case_with_underscores, chamada de lower snake case.

Namespace

A maioria dos objetos no jogo usa locais de recursos com namespace para evitar possíveis conflitos de conteúdo ou substituições não intencionais.

Por exemplo, se dois pacotes de dados adicionarem dois novos mecanismos de minigame ao Minecraft e ambos tiverem uma função chamada start. Sem os namespaces, essas duas funções entrariam em conflito e os minijogos seriam interrompidos. Mas se eles tiverem namespaces diferentes de minigame_one e minigame_two, as funções se tornarão minigame_one: start e minigame_two: start, que não entram em conflito.

Na maioria das vezes, quando o Minecraft requer um ID, como para / função, você deve fornecer o namespace além do caminho. Se você não especificar o namespace, ele retornará ao minecraft.

Certifique-se de sempre usar seu próprio namespace para qualquer coisa nova que você adicionar, e apenas use outros namespaces se você estiver substituindo explicitamente alguma outra coisa ou, no caso de tags, acrescentando a outra coisa.

Por exemplo, o Minecraft usa o namespace minecraft, o que significa que esse namespace só deve ser usado quando o pacote de dados precisa sobrescrever os dados existentes do Minecraft ou adicionar suas entradas às tags vanilla.

Funções

Funções são um conjunto de comandos que podem ser executados em ordem.

Para adicionar funções, primeiro crie uma pasta chamada functions dentro da pasta do namespace. Em seguida, crie um arquivo chamado (function_name) .mcfunction nesta pasta ou em qualquer uma de suas subpastas. Este será o seu arquivo de função. Sua função será nomeada no jogo como (namespace) :( name) ou (namespace) :( subfolder1) / (subfolder2) /.../ (name) quando o arquivo de função estiver localizado em uma subpasta.

Mesas de saque

As tabelas de loot dirão ao Minecraft o que deve ser descartado quando um mob morre ou o que deve ser gerado dentro de contêineres, como baús, quando abertos pela primeira vez, eles também podem ser chamados pelo comando / loot.

Para adicionar tabelas de saque, primeiro crie uma pasta chamada loot_tables dentro da pasta do namespace. Em seguida, crie um arquivo chamado (loot_table_name) .json nesta pasta ou em qualquer uma de suas subpastas. Este será o seu arquivo de tabela de loot. Sua tabela de loot será nomeada no jogo como (namespace) :( name) ou (namespace) :( subfolder1) / (subfolder2) /.../ (name) se o arquivo estiver localizado em uma subpasta. Todas as tabelas de loot vanilla estão no namespace minecraft.

Aqui está um exemplo de mesa de pilhagem de uma vaca, ela pode ser usada como referência:

Para saber o que cada tag significa, consulte as tabelas de loot. Há também uma lista de tabelas de loot de baunilha nessa página.

Estruturas

As estruturas podem ser usadas com blocos de estrutura e blocos de quebra-cabeça e / ou podem sobrescrever a aparência de certas estruturas básicas no Minecraft. Ele é salvo no formato NBT. Você pode criar um arquivo NBT usando um bloco de estrutura ou exportando uma compilação usando um programa de terceiros como o MCEdit.

Para adicionar estruturas a um pacote de dados, primeiro crie uma pasta chamada estruturas dentro da pasta do namespace. Em seguida, coloque seu arquivo de estrutura nesta pasta ou em qualquer uma de suas subpastas. Sua estrutura será nomeada no jogo como (namespace) :( nome) ou (namespace) :( subpasta1) / (subpasta2) /.../ (nome) se o arquivo estiver localizado em uma subpasta.

Geração mundial

Geração de mundo personalizado permite que os pacotes de dados mudem a forma como o mundo é gerado. Isso é particularmente útil em conjunto com mundos personalizados.

Para alterar a geração do mundo, primeiro crie uma pasta chamada worldgen dentro da pasta do namespace. Em seguida, coloque o arquivo noise_settings nesta pasta ou em qualquer uma de suas subpastas. Suas alterações serão nomeadas no jogo como (namespace) :( nome) ou (namespace) :( subpasta1) / (subpasta2) /.../ (nome) se o arquivo estiver localizado em uma subpasta.

Avanços

Os avanços podem ser concluídos pelos jogadores e dar várias recompensas.

Para adicionar avanços, primeiro crie uma pasta chamada avanços dentro da pasta do namespace. Em seguida, crie um arquivo chamado (advancement_name) .json (Você não pode colocar espaços no nome do arquivo. Use letras minúsculas no nome do arquivo). nesta pasta ou em qualquer uma de suas subpastas. Este será o seu arquivo de avanço. Seu avanço será nomeado no jogo como (namespace) :( name) ou (namespace) :( subfolder1) / (subfolder2) /.../ (name) se o arquivo estiver localizado em uma subpasta.

Receitas

As receitas são usadas para permitir que os jogadores criem itens.

Para adicionar receitas, primeiro crie uma pasta chamada receitas dentro da pasta do namespace. Em seguida, crie um arquivo chamado (recipe_name) .json nesta pasta ou em qualquer uma de suas subpastas. Este será o seu arquivo de receita. Sua receita será nomeada no jogo como (namespace) :( name) ou (namespace) :( subfolder1) / (subfolder2) /.../ (name) se o arquivo estiver localizado em uma subpasta.

Artesanato moldado

O primeiro tipo comum de elaboração é a confecção de formas.

Este é um exemplo aproximado de receita de modelagem de artesanato, conforme especificado pelo tipo crafting_shaped. padrão é uma lista usada para especificar a forma da receita de artesanato. Ele contém no máximo 3 cordas, cada corda representando uma linha na grade de crafting. Essas sequências contêm, no máximo, 3 caracteres únicos um ao lado do outro, cada caractere representando um ponto na grade de criação. Você não precisa de todas as 3 strings, nem precisa de 3 caracteres em cada string. Mas cada string deve conter a mesma quantidade de caracteres. Você pode usar espaços para indicar pontos vazios.

key é um composto usado para especificar qual item deve ser usado para qual caractere no padrão. Isso pode ser especificado usando o item seguido por um ID do item ou marca seguida por uma marca do pacote de dados do item.

O composto do resultado fala por si mesmo, ele especificou qual deveria ser o item resultante. a contagem é usada para especificar quantos itens do item devem ser fornecidos.

Esta é a receita original para um pistão (pode ser usada como referência):

Fabricação sem forma

Existe outro tipo comum de receita, uma receita sem forma.

Conforme especificado pelo tipo crafting_shapeless, esta é uma receita sem um padrão. Os ingredientes podem ser colocados na grade de artesanato em qualquer formato ou forma. No exemplo, há uma lista dentro do composto dos ingredientes. Isso significa que qualquer um dos itens desta lista pode ser usado.

Esta é a receita original para Fire Charge (pode ser usada como referência):

Também é possível criar novas receitas de fundição.

Este é um exemplo aproximado de uma receita de fundição. "ingrediente" é usado para especificar o item que você vai fundir. "result" irá especificar o resultado. Em "experiência", você pode escolher a quantidade de XP ganha para a fundição, e em "tempo de cozimento" a quantidade de tempo que o item levará para fundir, que neste caso é de 10 segundos (200 ticks = 10 segundos )

Esta é a receita de fundição padrão para um minério de diamante:

Identificações

As tags são usadas para agrupar blocos, itens, entidades ou funções. Além disso, a tag de função minecraft: tick é usada para executar funções a cada tick e a tag de função minecraft: load é usada para executar funções toda vez que o mundo é (re) carregado.

Para adicionar tags, primeiro crie uma pasta chamada tags dentro da pasta do namespace. Dentro desta pasta, crie pastas chamadas blocos, itens e funções. Em seguida, crie um arquivo chamado (tag_name) .json em uma dessas pastas ou em qualquer uma de suas subpastas. Este será o seu arquivo de tag. Sua tag será nomeada no jogo como (namespace) :( name) ou (namespace) :( subfolder1) / (subfolder2) /.../ (name) se o arquivo estiver localizado em uma subpasta.

Predicados

Predicados são arquivos JSON técnicos que representam as condições para tabelas de loot, / execute if predicate comando ou argumento do seletor de destino do predicado.

Para adicionar predicados, primeiro crie uma pasta chamada predicados dentro da pasta do namespace. Em seguida, crie um arquivo chamado (predicate_name) .json (Você não pode colocar espaços no nome do arquivo. Use letras minúsculas no nome do arquivo). nesta pasta ou em qualquer uma de suas subpastas. Este será o seu arquivo de predicado. Seu predicado será nomeado no jogo como (namespace) :( name) ou (namespace) :( subfolder1) / (subfolder2) /.../ (name) se o arquivo estiver localizado em uma subpasta.

dimensões

Dimensões são arquivos JSON usados ​​para especificar todas as dimensões que um mundo contém.

Para adicionar dimensões, primeiro crie uma pasta chamada dimensão dentro da pasta do namespace. Em seguida, crie um arquivo chamado (dimension_name) .json (Você não pode colocar espaços no nome do arquivo. Use letras minúsculas no nome do arquivo). nesta pasta. Este será o seu arquivo de dimensão.

As dimensões personalizadas podem ser acessadas no jogo usando / execute em (namespace) :( dimension_name)

Utilidades

Muitos utilitários foram criados para facilitar a programação em funções mc. Esta é uma lista de referência para utilitários como transpiladores ou plug-ins de realce de sintaxe. Tenha cuidado ao baixar o software para o seu PC, pois os criadores são responsáveis ​​pelo conteúdo fornecido.

Outra opção é usar uma interface visual para criar a estrutura ou o conteúdo do seu projeto.

Se você usar um IDE, convém destacar a sintaxe da sintaxe mcfunction. Dependendo do seu IDE ou do seu editor de texto, etapas extras podem ser necessárias para instalá-lo em seu ambiente.

• Pacotes de dados
• Pacotes de recursos
• Tutoriais / Instalando um pacote de dados