Plugin Minecraft BreweryX

🔌 Sobre o BreweryX

O BreweryX é um plugin de Minecraft que reformula a produção de bebidas em um sistema de várias etapas (fermentação, destilação, envelhecimento) para criar bebidas e poções personalizadas. As bebidas podem aplicar efeitos de embriaguez (movimento cambaleante, distorção no chat, ressaca) e o plugin inclui ferramentas para definir receitas, refinar a qualidade e gerenciar pontos de despertar para jogadores bêbados.

🎯 Propósito

O BreweryX oferece um sistema alternativo e mais completo de produção de bebidas para servidores que querem consumíveis com efeitos persistentes e etapas de ciclo de vida (fermentar → destilar → envelhecer). Ele resolve o problema da mecânica limitada de poções do vanilla ao dar aos donos do servidor receitas configuráveis, etapas de qualidade e jogabilidade social em torno da produção de bebidas.

⚙️ Recursos

• Ciclo de produção em várias etapas: fermentação, destilação e envelhecimento em barril.
• Bebidas alcoólicas que causam efeitos de embriaguez: movimento cambaleante, influência no chat, ressaca e comportamento ao acordar.
• Receitas configuráveis: defina ingredientes, etapas, propriedades e processos de criação personalizados.
• Mecânicas de refinamento de qualidade: as bebidas podem ser melhoradas ou gerar efeitos negativos quando a qualidade é baixa.
• Suporte para itens personalizados via CustomModelData e integrações com ItemsAdder e Oraxen.
• Suporte ao PlaceholderAPI para placeholders.
• Suporte total a RGB para versões modernas do Minecraft (1.16+ quando RGB é relevante).
• Suporte a addons e um pequeno ecossistema de addons (exemplos: addons de receitas, addons de holograma).

🧩 Para quem é

• Servidores Survival / SMP que querem consumíveis fabricáveis com elementos de roleplay.
• Servidores de roleplay ou focados em tavernas que buscam mecânicas de bebida mais profundas e interações sociais.
• Servidores que usam pacotes de itens personalizados (ItemsAdder/Oraxen) e querem que esses itens sirvam como ingredientes de produção.

🏗️ Casos de uso de exemplo

• Os administradores criam um conjunto de receitas secretas que os jogadores precisam descobrir por experimentação.
• Uma área de taverna onde os jogadores produzem, envelhecem e vendem bebidas artesanais com efeitos no jogo.
• Servidores que usam itens personalizados integram recursos do ItemsAdder/Oraxen como ingredientes para bebidas especiais.

⌨️ Comandos

(Observação: as descrições dos comandos e as associações específicas de permissões acima foram retiradas da documentação oficial do plugin; algumas distinções entre admin/mod são contextuais na documentação.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o .jar oficial do BreweryX (os lançamentos oficiais são publicados no recurso do projeto no Spigot e nas releases do GitHub).
• Coloque o .jar no diretório plugins/ do seu servidor.
• Inicie ou reinicie o servidor e veja o console para confirmar que o BreweryX carregou.

📦 Dependências

• PlaceholderAPI (integração suportada).
• ItemsAdder (integração suportada, opcional).
• Oraxen (integração suportada, opcional).

Inclua ou instale apenas as integrações de que você precisa; o BreweryX roda como um plugin Bukkit/Spigot padrão.

🧠 Notas técnicas

• Software de servidor confirmado como suportado: Spigot, Paper e Folia (as fontes do projeto informam suporte para Spigot/Paper/Folia).
• Versões do Minecraft confirmadas como suportadas (faixa fornecida pelo projeto): da 1.8.9 até a 1.21.8 (consulte os metadados oficiais do projeto para as versões testadas).
• O projeto é open source e licenciado sob GPL-3.0.
• O plugin cria arquivos de configuração e de idioma (os arquivos de idioma ficam em plugins/brewery/languages/ de acordo com a documentação).
• O projeto fornece uma API e tem um repositório separado da API do BreweryX mencionado pela equipe.

❓ FAQ (curto)

• P: Posso criar minhas próprias receitas?
  R: Sim — o BreweryX suporta receitas personalizadas configuráveis, incluindo ingredientes, etapas e propriedades.
• P: O BreweryX funciona com pacotes de itens personalizados?
  R: Sim — o projeto lista suporte para integrações com ItemsAdder e Oraxen.

🤝 Quando este plugin é útil

Se você quer adicionar um sistema de produção de bebidas persistente e configurável, com elementos de roleplay (embriaguez, envelhecimento, destilação) e suporte para itens personalizados, o BreweryX oferece as ferramentas de receitas e as integrações necessárias para rodar esse sistema em um servidor baseado em Spigot/Paper.