Como enviar addons para seu servidor de Minecraft Bedrock

Instalar addon no Bedrock tem um passo a mais que no Java, e é justamente ele que faz a maioria das pessoas desistir: copiar o arquivo não basta. O mundo precisa ser avisado de que aquele pacote existe.

Este guia cobre o caminho inteiro.

Como o Bedrock organiza as coisas

O Bedrock separa um addon em duas metades, e cada uma tem a sua pasta:

Um addon pode ter só uma das metades ou as duas. Se vier com as duas, precisa das duas para funcionar direito.

E tem uma terceira pasta que importa:

• worlds/ — dentro dela fica a pasta do seu mundo, e é lá dentro que você diz quais pacotes ele usa.

Conectando por SFTP

É SFTP, não FTP. O painel usa SFTP na porta 2022, não o FTP comum da porta 21. Escolher "FTP" no FileZilla é o erro mais comum, e a mensagem de falha não explica o motivo.

Entre no painel em pelican.vitthost.com.br, abra o servidor e copie os dados de SFTP que ele mostra. O endereço depende do nó em que a sua máquina está e o usuário traz o identificador do servidor.

Passo 1: descompacte o addon

Addons de Bedrock vêm em .mcaddon, .mcpack ou .zip. O servidor não lê nenhum desses formatos compactados — quem faz isso é o jogo no celular ou no console.

No seu computador:

1. Troque a extensão para .zip (um .mcaddon é um zip com outro nome).
2. Descompacte.
3. Veja o que saiu. Se aparecerem duas pastas, uma é o behavior pack e a outra o resource pack. Para saber qual é qual, abra o manifest.json de cada uma e olhe o campo type dentro de modules: data é behavior, resources é resource.

Passo 2: envie as pastas

Conectado no SFTP:

• A pasta de comportamento vai inteira para behavior_packs/
• A pasta de aparência vai inteira para resource_packs/

Cada pacote fica na sua própria subpasta, com o manifest.json dentro dela. Não jogue o conteúdo solto na raiz de behavior_packs/.

Passo 3: avise o mundo (o passo que todo mundo pula)

Aqui é onde a instalação de verdade acontece. Entre em worlds/ e depois na pasta do seu mundo — o nome dela é o que está configurado no servidor.

Dentro dela, você precisa de dois arquivos:

• world_behavior_packs.json
• world_resource_packs.json

Se não existirem, crie. O conteúdo é uma lista, e cada item precisa do UUID e da versão do pacote — os dois estão no manifest.json de cada addon, no bloco header.

[
  {
    "pack_id": "cole-aqui-o-uuid-do-manifest",
    "version": [1, 0, 0]
  }
]

Repare que version é uma lista de três números, não texto. [1, 0, 0] funciona; "1.0.0" não.

Para mais de um pacote, acrescente outros blocos separados por vírgula dentro dos colchetes.

Copie o UUID do header, não o do modules. Os dois existem no mesmo arquivo e são diferentes. Pegar o errado faz o pacote simplesmente não carregar, sem erro nenhum.

Passo 4: reinicie

Reinicie pelo painel. Na volta, entre no mundo e confirme que o addon está valendo.

Quando não funciona

O pacote não aparece. Quase sempre é o JSON: UUID errado, versão como texto em vez de lista, ou uma vírgula sobrando no fim. Passe o arquivo num validador de JSON antes de culpar o addon.

Mundo carrega sem os blocos ou mobs novos. Você colocou só o resource pack. O que muda comportamento é o behavior pack.

Servidor não sobe. Abra o console no painel e leia as últimas linhas. Behavior pack com manifest.json quebrado derruba a inicialização.

Funciona no seu celular mas não no servidor. Importar o .mcaddon no aplicativo instala só para você. No servidor, o caminho é este daqui.

Vale lembrar

• O addon precisa ser compatível com a versão do servidor. Addon antigo em servidor novo costuma carregar pela metade.
• Alguns addons exigem experimentos ativados nas configurações do mundo.
• Faça backup da pasta do mundo antes. Behavior pack mexe em dados de mundo e nem sempre dá para voltar atrás. A responsabilidade pela cópia é sua, conforme a cláusula 14 dos Termos de Uso.

Para poucos arquivos, use o gerenciador do painel

O painel tem gerenciador de arquivos com upload e editor de texto pelo navegador. Para ajustar um world_behavior_packs.json, é mais rápido que abrir o FileZilla — e ainda evita erro de transferência em arquivo de texto.

Outros tutoriais desta série:

• Minecraft Java: como enviar plugins e mods
• MTA:SA: como enviar resources
• open.mp: como enviar gamemodes e plugins

Veja os planos de Minecraft ou abra um ticket se travar em algum passo.