Complemento

Um complemento (em inglês, add-on) é um formato de pacote e um tipo de conteúdo para download que fornece recursos para criar personalizações adicionais no jogo na Edição Bedrock. Ele contém um conjunto de interfaces de programação usadas para construir e personalizar certos objetos e elementos do jogo, como entidades, blocos, itens, biomas, estruturas, interface de usuário e muito mais. É oficialmente suportado pela Mojang Studios, que fornece a documentação oficial em inglês para desenvolvedores.

Os complementos consistem em três APIs principais: um pacote de recursos para gerenciar ativos e recursos, um pacote de comportamento or behavior packs em inglês para definir comportamentos orientados a dados e a API de script para escrever um conjunto de instruções procedurais para executar comportamentos e interações personalizadas. Muitas de suas funções e utilitários podem ser usados para mods.

Os complementos são hospedados oficialmente no Marketplace, onde os jogadores podem baixá-los ou comprá-los em seus dispositivos. Eles devem ser enviados por membros do Programa de Parceiros do Minecraft e aprovados pela Equipe de Conteúdo do Minecraft.

Além do Marketplace, há sites da comunidade dedicados a hospedar complementos criados pela comunidade, como MCPEDL, Curse Forge e ModBay, sendo o primeiro mais popular dos três, enquanto o terceiro tem menos anúncios e, portanto, pode oferecer uma experiência melhor para dispositivos mais lentos.

Pacote de comportamento ou behavior pack é uma estrutura orientada a dados usada para definir comportamentos, características e lógica de várias coisas no mundo do jogo. Ele serve como camada fundamental para muitos aspectos do jogo, ditando os comportamentos da entidade,^[1] tabela de itens,^[2] regras de geração,^[3] comportamentos de itens,^[4] receitas de itens,^[5] características de biomas,^[6] e muito mais. Essas definições são escritas em arquivos JSON, que são organizados em várias pastas por seus recursos. Este sistema permite que os usuários substituam e modifiquem certos recursos do jogo base ou adicionem recursos exclusivos com seu próprio pacote de comportamento. Os pacotes de comportamento são frequentemente usados em conjunto com pacotes de recursos, o que permite que eles usem recursos personalizados, como modelos, animações, texturas, sons e muito mais.

O pacote de comportamento fornece um sistema baseado em componentes que compõe a maioria das entidades no jogo, descrevendo suas propriedades e comportamentos exclusivos — como a vida, caixa de colisão, movimento, comportamento da criatura e física — por meio de vários componentes.^[7] Esses componentes são codificados no jogo, mas são comumente compartilhados entre entidades e podem ser usados extensivamente para criar ou modificar entidades existentes em um pacote de comportamento. Um recurso semelhante na Edição Java seriam os atributos de entidade, mas são muito limitados em termos de recursos em comparação aos componentes. O sistema baseado em componentes também é usado para definir itens personalizados, blocos e biomas.^[8][9][6]

A maioria das entidades, biomas, tabelas de saque e várias coisas do jogo base são definidas pelo pacote de comportamento vanilla, que é construído dentro do próprio jogo. A Mojang lança os arquivos de amostra do complemento na Bedrock em cada nova atualização da Edição Bedrock, que fornecem os pacotes de recursos e comportamento vanilla mais recentes do jogo.

Molang é uma linguagem simples baseada em expressões, projetada para cálculos rápidos e baseados em dados de valores em tempo de execução, e com uma conexão direta com valores e sistemas do jogo. Ele é usado na Edição Bedrock em seu sistema de complementos com o propósito de permitir que sistemas de baixo nível, como animação, ofereçam suporte a comportamento flexível baseado em dados para criadores internos e externos, ao mesmo tempo em que permanecem com alto desempenho.^[10]

O script é um recurso adicional usado para escrever um conjunto de instruções procedurais para o jogo executar comportamentos e interações personalizados. Em comparação com componentes e definições predefinidos fornecidos pelo jogo, os usuários podem controlar comportamentos de entidades, blocos e itens; características do mundo; ou um loop do jogo por completo.^[11]

Arquivos de script são usados no ambiente de script, eles são escritos na linguagem de programação JavaScript e carregados pelo jogo no diretório scripts dentro de um complemento. Os usuários podem usar a ferramenta TypeScript que fornece melhores relatórios de erros e sistema de tipos estáticos.^[11][12] A API de script fornece vários módulos para os usuários interagirem com o jogo, cada módulo deve ser adicionado como uma dependência no manifest.json, alguns notáveis são:^[13]

• @minecraft/common – fornece recursos comuns, como classes de erro ou interfaces.
• @minecraft/server – fornece interações entre o mecanismo de script e o mundo do jogo, como blocos, entidades, itens, jogadores e outros.
• @minecraft/server-ui – fornece comunicação entre jogadores e o servidor por meio de formulários personalizáveis.
• @minecraft/server-net – fornece acesso à Internet por meio de solicitações da web, como GET, POST e outros.
• @minecraft/server-gametest – fornece a estrutura GameTest para testar comportamentos e interações dentro do mundo do jogo. Consulte GameTest § Edição Bedrock para mais informações.
• E outros módulos de leitura adicional.

A API de script também fornece interfaces para definir componentes personalizados, com base na API de script v2.0.0;^[14] com a próxima API, eles também podem ser usados para definir comandos personalizados.^[15]

O Marketplace é uma plataforma dentro do jogo onde os criadores podem vender seus complementos para a base de jogadores. Todo o conteúdo do Marketplace deve ser enviado pelos membros do Programa de Parceiros do Minecraft e aprovado pela Equipe de Conteúdo do Minecraft. O conteúdo comprado no Marketplace é sincronizado com a conta Microsoft do jogador e, se ele não estiver conectado, ele é salvo localmente no dispositivo dele.

Os complementos geralmente são adicionados ao Marketplace toda terça-feira (originalmente quarta-feira)^{[carece de fontes]}, embora ocasionalmente apareçam em outros dias. Complementos gratuitos são lançados como parte de eventos especiais, para ocasiões como promover o lançamento de Um Filme Minecraft para a celebração dos 15 anos do Minecraft e a movimentada promoção do McDonald's X Um Filme Minecraft.

Além do Marketplace, há sites da comunidade dedicados a hospedar complementos feitos pela comunidade, embora tais complementos só possam ser carregados em PCs e celulares, enquanto os consoles só podem acessá-los por meio do Realms.

O complemento foi sugerido em uma postagem de Searge em 12 de agosto de 2016, afirmando "Haverá novidades sobre a API na Minecon".^[16] No dia seguinte, foi confirmado por Grum como uma API de modificação para Edição Bedrock (anteriormente chamado de Edição Pocket ou MCPE),^[17] e na MINECON 2016, o plano e o roteiro para o desenvolvimento de complementos foram delineados.

Dicas extras de carregamento que aparecem quando complementos são aplicados em um mundo foram adicionadas desde a Edição Bedrock Preview 1.20.70.21. Na Edição Bedrock Preview 1.21.0.23, mais oito deles foram introduzidos, substituindo o da 1.20.70.21.

Anteriormente, complementos autônomos do Marketplace não estavam disponíveis e precisavam ser empacotados com um mundo para serem vendidos no Marketplace. No entanto, a partir de fevereiro de 2024, complementos individuais agora podem ser vendidos separadamente no Marketplace.^[18]

Mensagens extras de dicas de carregamento apareceriam se o jogador estivesse carregando um mundo com complementos aplicados. A caixa de mensagem de carregamento é intitulada como "Mundo Modificado", e as mensagens de dicas de carregamento alertam principalmente o jogador sobre os complementos ou pacotes de recursos aplicados. Aqui está a lista de dicas de carregamento dos complementos aplicados:

Tutoriais do canal oficial Minecraft Creator Channel(em inglês)

• 
  Arte promocional lançada junto com o trailer cinematográfico Mude seu jogo, do seu jeito!.
• 
  Renderização de um complemento "Cake Golem".^[20]
• 
  Arte de um complemento de motocicleta.^[21]
• Animação do comerciante do Lush Bath Bomb Add-On.^[22]
• 
  Imagem promocional para compatibilidade das conquistas com complementos.

• Mods
• Comandos
• Pacote de dados
• Pacote de recursos

• Addons JSON Documentation (em inglês)
• Animation JSON Documentation (em inglês)
• Biome Documentation (em inglês)
• Block JSON Documentation (em inglês)
• Entity JSON Documentation (em inglês)
• Features JSON Documentation (em inglês)
• Item JSON Documentation (em inglês)
• Molang Documentation (em inglês)
• Recipe JSON Documentation (em inglês)
• Particle JSON Documentation (em inglês)
• Schema Documentation (em inglês)
• Script API Documentation (em inglês)

• Getting Started with Add-On Development (em inglês)
• Introduction to Resource Packs (em inglês)
• Introduction to Behavior Packs (em inglês)
• Getting Started with the Minecraft Entity Wizard(em inglês)
• Getting Started with the Minecraft Item Wizard(em inglês)
• Getting Started with the Minecraft Block Wizard(em inglês)
• Installing Add-Ons (em inglês)

• Commonly Used Tools(em inglês)
• Minecraft Creator Tools(em inglês)
• Bedrock Editor(em inglês)
• Snowstorm(em inglês)
• Chunker(em inglês)

• Bedrock Wiki(em inglês)

Exemplos de pacotes de recursos e complementos:

• Arquivos de amostra para add-ons da Edição Bedrock

Pacotes de exemplos da API de script:

• Amostras da API de scripts @minecraft/server-gametest
• Amostras da API de scripts @minecraft/server

v t e Complementos
Promocional	Batata Venenosa Suprimentos de Festa de 15 Anos Tetris Bomba de Banho Luxuosa Bob Esponja Calça Quadrada Animais de estimação fantasmas Majestoso Add-On de acampamento Armações Fantasmas Móveis assustadores LUZES MOB Comida de monstro Frango de lava Paisagens sonoras + Sonic Um Filme Minecraft Complemento de Mochila a Jato Biomas+
Amostras	Amostra de Nova Entidade Minecon 2018 Ferramentas Criativas Tomates Pacote de amostra do Minecraft Live 2022 Cake Golem Motorcycle
Edição China	Pet Complementos da Edição China
Outro	Molang

v t e Jogabilidade
Mecânicas gerais	Alcance de interação Atributo Caixa de colisão Circuito de redstone Condutividade Comandos Complementos Corte de neve Distância Efeito Potência Explosão Inundação Inventário Inventário do criativo Barra rápida salva Matérias-primas Multijogador Servidor Lista de servidores Realms Tela dividida Oxidação Proteção de geração Raridade Regras de jogo Regra do sudeste Renovabilidade Renováveis Não renováveis Rotação Saque gerado
Sobrevivência	Agricultura Arqueologia Capitão invasor Comércio Cura Dificuldade Domar Durabilidade Empunhadura dupla Encantamento Evento sombrio Presságio de desafio Invasão Experiência Fabricação Grade 2×2 Livro de receitas Fermentação Ferraria Fome Fundição Geração Geração de criaturas Invasão zumbi Local de trabalho Materiais de armadura Patrulha Pesca Progressos Conquistas Quebra Mineração instantânea Reparo de itens Reprodução Troca Vida
Combate	Bloquear Dano Recarga de ataque Golpe crítico Drops Lutas internas de monstros Repulsão Repulsão de velocidade
Ambiente	Biomas Ciclo de dia e noite Clima Dimensões Estrutura Geração de mundo Iluminação Sementes Mais
Movimento	Agachar Caminhar Correr Deitar Montar Nadar Planar Rastejar Saltar Sentar Voar
Interface de usuário	Alternador de modo de jogo Barra de ação Barra de chefe Chat Mensagens de morte Dica de ferramenta Fonte Idioma Interface de usuário Barra de Localização Narrador Placar Balões Dicas de tutoriais
Visuais	Cor Cores dos blocos Cores dos itens Cores dos efeitos Cores diversas Efeitos de tela Emotes Mensagens de erro Pacotes de recursos Skins Personagem Pacote de skins Visão em terceira pessoa
Desatualizado	Bloquear com espada Materiais Supressão de atualização

v t e Edição Bedrock
Edições	Mesclado Edição Pocket Windows 10 Edition Portado para consoles Xbox One Nintendo Switch PlayStation 4 PS VR Descontinuado Apple TV Edition Gear VR Edition Fire TV Edition
Desenvolvimento	Histórico de Versões Alpha Versão completa Versões de desenvolvimento Minecraft Preview Recursos removidos Recursos não utilizados Texturas não utilizadas Características exclusivas Lista de problemas de paridade Características mencionadas Super Duper Graphics Pack Versões planejadas
Técnico	Erros conhecidos Valores de dados Componentes de entidade Desempenho de hardware Formato de nível Add-on Entidade de bloco Bedrock Editor com.mojang Comandos Funções Coordenadas Componentes de item JSON Molang Protocolo Protocolo da Edição Pocket Legado Protocolo da Edição Pocket Versão do protocolo RenderDragon Captura de tela Semente Servidores dedicados sound_definitions.json Tipo de som de bloco Tick Área de marcação Minecraft Launcher Partida rápida UUID Nivelamento manifest.json
Multijogador	Servidores Servidores de eventos Servidores em destaque Minecraft Realms Plus Tela dividida Minecraft Realms Realms Plus Realms Stories
Características exclusivas	Como jogar Criador de personagem Emotes Servidores em destaque Servidores de eventos Dicas de carregamento Marketplace Minecoins Tokens Partner Program Add-ons Pacotes de conteúdo Marketplace Pass Pacotes Mash-up Pacote de skins Pacote de texturas Ore UI Modelos de sementes Visuais Vibrantes Estruturas geradas Terras Distantes Terra listrada Blocos e itens Rocha invisível Efeito de estado Veneno fatal Não usado Bloco de atualização reserved6 Câmera Núcleo do reator do Nether Obsidiana brilhante Cortador de pedras Aldeão velho Aldeão zumbi velho Oceano congelado legado
Removido	Reator do Nether Descrições de criação Antigo Realidade virtual

v t e Modificações
Mods Armaduras e ferramentas Tetra Aventura e RPG Dungeons and Taverns Criaturas From The Fog JurassiCraft The Herobrine Mod Desempenho OptiFine Sodium Dimensões Aether Geração de mundo Tectonic Terralith Magia Botania Minecraft Wiki Hey Wiki Tecnologia Applied Energistics 2 Create
Modloaders Modloaders Fabric Forge NeoForge LiteLoader Quilt
Oficiais (Mojang) Oficiais MinecraftEdu Projeto Malmö
Servidor Servidor Bukkit (CraftBukkit) BungeeCord PaperMC Spigot