ItemsAdder: itens e blocos customizados no seu servidor

O que é o ItemsAdder

ItemsAdder é um plugin premium pago feito por um desenvolvedor chamado LoneDev. O objetivo principal dele é permitir que admins de servidores de Minecraft adicionem conteúdo próprio (itens, blocos, móveis, mobs, animações e overlays de interface) sem que os jogadores precisem instalar mods.

Todo o mecanismo se apoia em dois pilares: um resource pack enviado automaticamente ao jogador quando ele entra no servidor, e arquivos de configuração em YAML onde o admin define todos os elementos customizados. Do lado do jogador, tudo funciona como o Minecraft vanilla: ele só precisa aceitar o resource pack.

O plugin está disponível no SpigotMC por cerca de 25 EUR. É um investimento que vale a pena considerar para servidores de RPG, servidores de sobrevivência com conteúdo único ou servidores com tema próprio, onde se destacar é fundamental.

O ItemsAdder está em desenvolvimento ativo desde 2019 e tem uma das maiores comunidades entre os plugins premium. No SpigotMC, o plugin acumulou milhares de avaliações positivas e é atualizado regularmente para as novas versões do Minecraft.

Como funciona o resource pack

O coração do ItemsAdder é o seu próprio resource pack, gerado automaticamente pelo plugin a partir dos seus arquivos de configuração. Quando o jogador entra no servidor, o Minecraft pergunta se ele quer baixar o resource pack. Depois que ele aceita, vê todos os itens, blocos e modelos customizados.

O ItemsAdder suporta três métodos de hospedagem do resource pack:

• Servidor HTTP embutido - o próprio plugin serve o arquivo em uma porta (8163 por padrão). A solução mais simples em uma VPS com IP próprio. Exige abrir a porta no firewall.
• Hospedagem própria via FTP/SFTP - você envia o pack gerado para o seu próprio servidor web ou CDN. Mais controle, mas mais configuração.
• Hospedagem externa - por exemplo GitHub Releases, Dropbox ou serviços dedicados de hospedagem de resource packs. Útil quando a sua hospedagem bloqueia portas extras.

O ponto-chave: o ItemsAdder usa CustomModelData, um número atribuído a um item vanilla existente (por exemplo PAPER com CustomModelData 1001 exibe o modelo de uma espada customizada). Essa limitação vem da arquitetura do Minecraft: até a versão 1.21.3 não existe API oficial para criar novos IDs de item. A partir da versão 1.21.4, o Minecraft passou a suportar o componente item_model, que o ItemsAdder já usa.

Depois de cada mudança na configuração, é preciso reconstruir o resource pack com o comando /iazip ou /iareload. O plugin comprime os arquivos e atualiza a URL automaticamente, e os jogadores recebem a nova versão na próxima vez que entrarem.

Criando itens

Você define cada item customizado em um arquivo YAML dentro da pasta plugins/ItemsAdder/contents/. A estrutura de diretórios fica totalmente por sua conta, então dá para agrupar os itens por pack ou por tema.

Um exemplo de definição de uma espada customizada:

info:
  namespace: moj_serwer
items:
  miecz_ognia:
    display_name: "Fire Sword"
    permission: moj_serwer.miecz_ognia
    resource:
      material: DIAMOND_SWORD
      generate: true
      textures:
        - item/miecz_ognia.png
    durability:
      max_custom_durability: 1024
    attribute_modifiers:
      mainhand:
        attackDamage: 8
    lore:
      - "&7Forged in the flames of the Nether."
    events:
      interact:
        right:
          set_on_fire:
            duration: 5

O campo namespace é um identificador único do seu pack de conteúdo, para que itens de packs diferentes não colidam. O campo resource.material aponta para o item vanilla que "finge" ser o seu modelo. As texturas vão na pasta contents/moj_serwer/textures/item/.

O ItemsAdder suporta:

• Modelos 3D em formato JSON (compatíveis com o Blockbench)
• Texturas animadas (mcmeta)
• Durabilidade e reparo customizados
• Efeitos de partículas ao usar
• Sons ligados a ações
• Eventos, por exemplo colocar fogo no jogador ao acertar ou curar ao consumir
• Integração com sistemas de habilidades (MMOItems, AureliumSkills)

Você pode baixar packs de itens prontos na wiki oficial e no Polymart, onde a comunidade compartilha conjuntos gratuitos e pagos.

Criando blocos

Criar blocos customizados é uma das partes tecnicamente mais difíceis de modar um servidor de Minecraft. O ItemsAdder resolve isso de um jeito esperto: usa estados de bloco musical ou estados de bloco de cogumelo como "recipientes" para os blocos customizados.

No Minecraft, um bloco musical tem 800 estados únicos. O ItemsAdder reserva esses estados para os seus blocos: o jogador vê o modelo do resource pack, e o motor do servidor vê um bloco musical em um estado específico. Com isso, os blocos se comportam como blocos de verdade: podem ser coletados, colocados e minerados na velocidade certa.

Um exemplo de definição de bloco:

items:
  rubin_ore:
    display_name: "Ruby Ore"
    resource:
      material: PAPER
      generate: false
      model_path: block/rubin_ore
    specific_properties:
      block:
        placed_model:
          type: REAL_NOTE
          break_particles_material: DIAMOND_ORE
        hardness: 5
        blast_resistance: 6
        drop_exp:
          min: 2
          max: 5

O tipo REAL_NOTE significa usar um estado de bloco musical: o bloco é "real", tem colisão, dá para ficar em cima dele e dá para minerá-lo. As alternativas são REAL_TRANSPARENT (suporta transparência) e REAL_WIRE (baseado no fio de armadilha, para elementos finos).

Os blocos também suportam drops customizados. Você pode configurar o seu minério para dropar só em um nível de mineração específico ou com um item específico, o que combina bem com sistemas de RPG.

Mobs customizados

O ItemsAdder permite criar mobs customizados com modelos 3D e animações próprios. Os mobs são definidos de forma parecida com os itens, em arquivos YAML que referenciam um modelo do Blockbench.

Os modelos de mobs para o ItemsAdder são feitos no Blockbench com o plugin do ItemsAdder. O plugin suporta um conjunto completo de animações: andar, correr, atacar, morrer, comer e animações customizadas definidas pelo criador.

O maior poder aparece com a integração com o MythicMobs. Você pode atribuir um modelo do ItemsAdder a um mob do MythicMobs e ganha uma fera com visual único e lógica de IA avançada, fases de combate, ataques especiais e recompensas. Essa combinação é usada em dezenas de servidores de RPG.

Um exemplo de configuração de mob customizado no ItemsAdder:

info:
  namespace: moj_serwer
entity_models:
  smok_ognia:
    display_name: "Fire Dragon"
    model: entity/smok_ognia
    animations:
      walk:
        speed_multiplier: 1.0
      attack:
        duration: 1.2

Depois, no MythicMobs, você referencia esse modelo com a opção Options.ItemsAdder: moj_serwer:smok_ognia. O jogador vê um belo modelo 3D, e o MythicMobs cuida de toda a lógica de comportamento.

Móveis e decorações

Um dos recursos mais elogiados do ItemsAdder é o sistema de móveis. Móveis são estruturas decorativas de vários blocos (cadeiras, mesas, camas, luminárias, baús) que você pode colocar no mundo do jogo.

Tecnicamente, os móveis são construídos com suportes de armadura invisíveis com modelos do resource pack anexados. Isso permite dimensões próprias, ocupar mais de um bloco e ser colocado em ângulos diferentes.

O ItemsAdder já vem com alguns conjuntos de móveis prontos, mas o valor real está em poder criar os seus. Você exporta um modelo do Blockbench, configura as hitboxes e pronto. Os móveis suportam:

• Sentar (os jogadores podem sentar em uma cadeira ou banco)
• Colisão com jogadores (bloqueia o movimento)
• Interações (abrir armários, ativar mecanismos)
• Colocação em paredes e tetos (por exemplo quadros e luminárias)
• Rotação em 8 ou 16 direções

Os plugins FurnitureLib e FurnitureEngine são alternativas para o sistema de móveis, mas o ItemsAdder integra tudo em um só ecossistema, o que elimina problemas de compatibilidade entre plugins.

Emotes

O ItemsAdder suporta emotes animados de jogadores: animações completas do personagem que os outros jogadores veem em tempo real. O jogador pode acenar, dançar, rir ou fazer qualquer animação que o admin tenha definido.

Os emotes funcionam sobrescrevendo o modelo do jogador no resource pack e tocando a animação no lado do cliente. Para que o emote fique visível para os outros, o ItemsAdder usa truques de protocolo com metadados de entidade.

Exemplos de uso dos emotes:

• Cumprimentos de VIP no spawn (uma animação especial para doadores)
• Animações de classes de personagem em jogos de RPG (um mago lançando feitiços)
• Danças e gestos em áreas sociais
• Animações de morte no lugar da queda padrão do personagem

Os emotes podem ser ligados a ranks pelo LuckPerms, por exemplo só jogadores com o rank VIP têm acesso a animações raras. É uma parte popular da oferta de monetização nos servidores.

GUI e HUD

O ItemsAdder inclui um sistema avançado para criar overlays na interface do jogador (HUD). Você pode mostrar barras, ícones, contadores e informações próprias direto na tela do jogador, sem plugins extras.

O HUD no ItemsAdder funciona sobrescrevendo a bossbar ou a actionbar com uma Bitmap Font customizada do resource pack. O efeito: o jogador vê na tela um overlay em pixel art que parece parte da interface do jogo.

Usos típicos de HUD:

• Barra de mana/energia - um recurso de magias exibido ao lado da barra de vida
• Contador de moeda - um saldo ou pontos de experiência no canto da tela
• Indicador de temperatura/fome/poluição - para servidores de sobrevivência com mecânicas de survival
• Miniatura de bússola - direção e coordenadas no topo da tela
• Notificações de conquista - banners animados quando algo é desbloqueado

Para montar um HUD, você pode usar o editor integrado ao plugin ou ferramentas externas como o HMCCosmetics. O ItemsAdder também oferece uma API para desenvolvedores, para que outros plugins registrem os próprios elementos de HUD.

Preço e licença

O ItemsAdder é um plugin premium pago, disponível só na plataforma SpigotMC. O preço atual é de cerca de 25 EUR por licença. Confira o preço atual na página do SpigotMC, pois ele pode mudar.

A sua compra dá direito a:

• Uma licença para um servidor (um IP ou uma rede de proxy)
• Acesso a todas as atualizações por tempo ilimitado
• Acesso ao canal oficial de suporte no Discord
• Acesso à wiki oficial com a documentação

Pontos importantes sobre a licença:

• Cada servidor precisa de uma licença separada, porque uma licença não cobre uma farm de servidores
• Redes BungeeCord/Velocity podem valer como uma licença só, mas vale confirmar com o autor
• Você baixa o plugin pelo painel do SpigotMC depois da compra, pois o arquivo .jar não é público
• Não existe versão de "teste". Antes de comprar, só dá para testar em um ambiente local, com algumas limitações

O preço pode parecer alto ao lado de alternativas gratuitas como o Oraxen CE (Community Edition), mas o ItemsAdder oferece muito mais recursos, documentação melhor e suporte ativo. Para servidores com orçamento, é um investimento sólido que se paga rápido com uma experiência melhor para os jogadores.

Comparação com o Oraxen

O principal concorrente do ItemsAdder é o Oraxen. Durante anos a escolha era "alternativa gratuita vs premium pago", mas a situação ficou mais complicada: o Oraxen lançou um plano premium pago (Oraxen Pro), enquanto o ItemsAdder manteve um preço fixo.

Quando escolher o ItemsAdder: você tem orçamento, precisa de emotes e de um HUD extenso, quer integração nativa com o MythicMobs e se importa com suporte profissional e uma grande comunidade de recursos.

Quando escolher o Oraxen CE: você não tem orçamento nenhum para plugins, só precisa de itens e blocos customizados e valoriza código aberto e a possibilidade de modificar o código.

Compatibilidade

O ItemsAdder é compatível com:

• Versões do Minecraft: 1.14 - 1.21.x (atualizado continuamente)
• Software de servidor: Paper (recomendado), Spigot, Purpur, Pufferfish
• Redes: BungeeCord, Velocity (o plugin é instalado em cada backend separadamente)
• MythicMobs - integração nativa de modelos e mobs
• MMOItems - stats customizados ligados a itens do IA
• AureliumSkills / AuraSkills - um sistema de habilidades com itens do IA
• LuckPerms - permissões para itens, emotes e ranks
• EssentialsX - kits e lojas com itens do IA
• PlaceholderAPI - placeholders customizados para HUDs e chats
• WorldGuard - proteção de regiões que considera os blocos do IA

Limitações conhecidas:

• Não funciona no Bedrock Edition (só Java)
• Exige que o jogador aceite o resource pack, e jogadores com o resource pack desligado veem só itens vanilla
• Resource packs grandes podem deixar a entrada no servidor mais lenta (tempo de download)
• Os limites de estados do bloco musical/bloco de cogumelo restringem o número de blocos únicos (cerca de 800 de bloco musical + 54 de cogumelo)
• Não é compatível com outros plugins que usam os mesmos estados de bloco musical sem uma integração dedicada

Você encontra mais sobre plugins de servidor no catálogo de plugins. Se está montando um servidor de RPG, confira também o MythicMobs: combinar os dois plugins abre ótimas possibilidades para criar bosses e aventuras únicos.