O que é o Oraxen

O Oraxen é um plugin para criar itens, blocos, móveis e equipamentos customizados em servidores de Minecraft. Ele não precisa de mods no cliente: em vez disso, gera um pacote de recursos e o envia automaticamente aos jogadores quando eles entram.

O plugin se baseia no CustomModelData (desde o Minecraft 1.14) e nos componentes de item (1.20.5+) para fazer itens vanilla já existentes parecerem itens totalmente novos. No lado do servidor, cada item customizado continua sendo um item do Minecraft (por exemplo, uma espada de madeira com CustomModelData 1001), mas o cliente o exibe com textura e modelo 3D próprios.

O Oraxen está no GitHub. Você pode baixá-lo no SpigotMC ou no Modrinth.

Como ele funciona por dentro

O Oraxen combina três mecanismos do Minecraft:

CustomModelData / componentes de item - permite atribuir um modelo 3D customizado a um item existente. O cliente mostra o modelo do pacote de recursos no lugar do padrão
Pacote de recursos - o Oraxen gera automaticamente um pacote de recursos com as texturas e os modelos. O servidor o hospeda e força o download quando um jogador entra
Estados do bloco musical / bloco de cogumelo - os blocos customizados usam estados não utilizados do bloco musical ou do bloco de cogumelo para exibir texturas únicas

Por causa dessa abordagem, os jogadores não precisam instalar nenhum mod. Basta aceitar o pacote de recursos do servidor. O plugin é totalmente compatível com o cliente vanilla do Minecraft.

Criando itens

Os itens customizados são definidos em arquivos YAML em plugins/Oraxen/items/:

# ruby_sword.yml
ruby_sword:
  displayname: "&cEspada de rubi"
  material: DIAMOND_SWORD
  Pack:
    generate_model: true
    parent_model: item/handheld
    textures:
      - ruby_sword.png
  Mechanics:
    durability:
      value: 2000
  AttributeModifiers:
    attack_damage:
      amount: 12
      slot: MAINHAND
    attack_speed:
      amount: 1.6
      slot: MAINHAND

Você coloca a textura ruby_sword.png em plugins/Oraxen/pack/textures/, e o Oraxen automaticamente:

Cria um modelo JSON a partir da textura que você forneceu
Atribui um CustomModelData único
Gera um pacote de recursos com o modelo
Registra o item no sistema

Para entregar itens aos jogadores, use /oraxen give [player] ruby_sword. Você também pode adicioná-los a kits, lojas e loot tables pela API do Oraxen ou por placeholders.

Blocos e móveis customizados

O Oraxen suporta quatro tipos de blocos e móveis customizados:

NoteBlock - blocos de tamanho completo com texturas próprias (usa os estados do bloco musical). Podem ter dureza, um drop e uma ferramenta necessária para quebrá-los
StringBlock - blocos transparentes (por exemplo flores, grama, decorações) que usam o fio de armadilha
Furniture - móveis 3D baseados em entidades de display (1.19.4+) ou em suportes de armaduras. Cadeiras, mesas, lâmpadas, TVs: qualquer modelo
MushroomBlock - um sistema de blocos mais antigo, compatível com versões anteriores

Um exemplo de definição de móvel:

lamp:
  displayname: "&eLâmpada"
  material: PAPER
  Pack:
    generate_model: true
    textures:
      - lamp.png
  Mechanics:
    furniture:
      type: DISPLAY_ENTITY
      hitbox:
        width: 1
        height: 2
      light: 14
      placeable_on:
        - FLOOR

Os jogadores colocam os móveis com o botão direito do mouse segurando o item. Os móveis podem emitir luz, ter hitboxes para interação e ter animações.

Pacote de recursos

O Oraxen gera e distribui o pacote de recursos automaticamente. A configuração fica em settings.yml:

Pack:
  generation:
    auto-generated: true          # gerar automaticamente
    compression: BEST_COMPRESSION # compressão do pacote
  upload:
    type: polymath               # hospedagem do pacote
  dispatch:
    send_pack: true              # enviar aos jogadores
    mandatory: true              # forçar o download

Opções de hospedagem do pacote de recursos:

Polymath - hospedagem gratuita do Oraxen (o padrão)
Self-host - seu próprio servidor HTTP
Amazon S3 / DigitalOcean Spaces - hospedagem na nuvem

Depois de qualquer mudança em texturas ou itens, execute /oraxen reload all. O plugin reconstrói o pacote e envia a versão atualizada aos jogadores.

Dicas e integrações

Modelos 3D - o Oraxen suporta modelos JSON customizados do Blockbench. Exporte o modelo como Java Block/Item e coloque-o em pack/models/
Receitas de craft - defina receitas customizadas direto na config do item
Integração com MythicMobs - use itens customizados do Oraxen como drops de chefes
Integração com lojas - ShopGUI+ e outros plugins de loja suportam itens do Oraxen
Compatibilidade - o Oraxen funciona com o ProtocolLib em versões antigas e nativamente com o Paper 1.20.5+

Alternativas: Nova (um framework para conteúdo customizado), ItemsAdder (pago, com funcionalidades parecidas), CraftEngine (uma edição Community gratuita sob a licença GPL-3.0, com suporte ao 26.x e ao Folia). O Oraxen se destaca pelo desenvolvimento ativo.