Minecraft plugin BreweryX

🔌 About BreweryX

BreweryX is a Minecraft plugin that reworks brewing into a multi-step system (fermenting, distilling, aging) to produce custom drinks and potions. Drinks can apply drunkenness effects (staggering movement, chat distortion, hangovers) and the plugin includes tooling for defining recipes, refining quality, and managing wake-up points for drunk players.

🎯 Purpose

BreweryX provides an alternate, more involved brewing system for servers that want consumable beverages with persistent effects and lifecycle stages (ferment → distill → age). It solves the problem of vanilla's limited potion mechanics by giving server owners configurable recipes, quality stages, and social gameplay around brewing.

⚙️ Features

• Multi-step brewing lifecycle: fermenting, distilling, and barrel aging.
• Alcoholic drinks that cause drunkenness effects: staggered movement, chat influence, hangovers, and wake-up behavior.
• Configurable recipes: define ingredients, stages, properties and custom creation processes.
• Quality refinement mechanics: drinks can be improved or produce negative effects when low quality.
• Support for custom items via CustomModelData and integrations with ItemsAdder and Oraxen.
• PlaceholderAPI support for placeholders.
• Full RGB support for modern Minecraft versions (1.16+ where RGB is relevant).
• Addon support and a small ecosystem of addons (examples: recipe addons, hologram addons).

🧩 Who It Is For

• Survival / SMP servers that want craftable consumables with roleplay elements.
• Roleplay or tavern-focused servers seeking deeper drink mechanics and social interactions.
• Servers that use custom item packs (ItemsAdder/Oraxen) and want those items to act as brewing ingredients.

🏗️ Example Use Cases

• Operators create a set of secret recipes that players must discover through experimentation.
• A tavern area where players brew, age, and sell crafted beverages with in-game effects.
• Servers using custom items integrate ItemsAdder/Oraxen assets as ingredients for special drinks.

⌨️ Commands

(Note: command descriptions and the specific permission associations above are taken from the official plugin documentation; some admin/mod distinctions are contextual in the docs.)

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official BreweryX .jar (official releases are published on the project's Spigot resource and GitHub releases).
• Place the .jar into your server plugins/ directory.
• Start or restart the server and watch the console to confirm BreweryX loads.

📦 Dependencies

• PlaceholderAPI (integration supported).
• ItemsAdder (integration supported, optional).
• Oraxen (integration supported, optional).

Only include or install integrations you need; BreweryX runs as a standard Bukkit/Spigot plugin.

🧠 Technical Notes

• Confirmed supported server software: Spigot, Paper, and Folia (project sources state support for Spigot/Paper/Folia).
• Confirmed supported Minecraft versions (range provided by project): 1.8.9 through 1.21.8 (see official project metadata for tested versions).
• The project is open source and licensed under GPL-3.0.
• The plugin creates configuration and language files (language files are placed under plugins/brewery/languages/ according to the docs).
• The project provides an API surface and has a separate BreweryX API repository referenced by the team.

❓ FAQ (short)

• Q: Can I create my own recipes?
  A: Yes — BreweryX supports configurable custom recipes including ingredients, stages, and properties.
• Q: Does BreweryX work with custom item packs?
  A: Yes — the project lists support for ItemsAdder and Oraxen integrations.

🤝 When This Plugin Is Useful

If you want to add a persistent, configurable brewing system with roleplay elements (drunkenness, aging, distilling) and support for custom items, BreweryX provides the recipe tooling and integrations to run that system on a Spigot/Paper-based server.