Minecraft plugin BreweryX

🔌 O BreweryX

BreweryX je Minecraft plugin, který předělává brewing na vícekrokový systém (kvašení, destilace, zrání), aby vytvořil vlastní nápoje a lektvary. Nápoje mohou vyvolávat efekty opilosti (nejistý pohyb, zkreslení chatu, kocovina) a plugin obsahuje i nástroje pro definování receptů, vylepšování kvality a správu wake-up points pro opilé hráče.

🎯 Účel

BreweryX poskytuje alternativní, propracovanější systém brewingu pro servery, které chtějí konzumovatelné nápoje s trvalými efekty a fázemi životního cyklu (ferment → distill → age). Řeší problém omezené vanilkové mechaniky lektvarů tím, že majitelům serverů dává konfigurovatelné recepty, fáze kvality a sociální gameplay kolem brewingu.

⚙️ Funkce

• Vícekrokový brewing lifecycle: kvašení, destilace a zrání v sudu.
• Alkoholické nápoje, které způsobují efekty opilosti: nejistý pohyb, ovlivnění chatu, kocovinu a chování po probuzení.
• Konfigurovatelné recepty: definujte ingredience, fáze, vlastnosti a vlastní postupy výroby.
• Mechaniky zlepšování kvality: nápoje lze vylepšit, nebo při nízké kvalitě vyvolat negativní efekty.
• Podpora vlastních itemů přes CustomModelData a integrace s ItemsAdder a Oraxen.
• Podpora PlaceholderAPI pro placeholdery.
• Plná podpora RGB pro moderní verze Minecraftu (1.16+ tam, kde je RGB relevantní).
• Podpora addonů a malého ekosystému addonů (např. addonů na recepty, addonů na hologramy).

🧩 Pro koho je

• Survival / SMP servery, které chtějí craftitelné spotřební předměty s roleplay prvky.
• Roleplay nebo taverně zaměřené servery, které hledají hlubší mechaniky nápojů a sociální interakce.
• Servery používající vlastní balíčky itemů (ItemsAdder/Oraxen) a chtějí, aby tyto itemy sloužily jako ingredience pro brewing.

🏗️ Příklady použití

• Operátoři vytvoří sadu tajných receptů, které hráči musí objevit experimentováním.
• Taverní oblast, kde hráči vaří, nechávají zrát a prodávají vyrobené nápoje s herními efekty.
• Servery s vlastními itemy integrují assety ItemsAdder/Oraxen jako ingredience pro speciální nápoje.

⌨️ Příkazy

(Pozn.: popisy příkazů a konkrétní přiřazení oprávnění výše jsou převzaté z oficiální dokumentace pluginu; některé rozdíly mezi admin/mod jsou v dokumentaci kontextové.)

🔐 Oprávnění

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální BreweryX .jar (oficiální releasy jsou zveřejňovány na Spigot resource projektu a na GitHub releases).
• Umístěte .jar do složky plugins/ na vašem serveru.
• Spusťte nebo restartujte server a sledujte konzoli, abyste potvrdili, že se BreweryX načetl.

📦 Závislosti

• PlaceholderAPI (integrace podporována).
• ItemsAdder (integrace podporována, volitelné).
• Oraxen (integrace podporována, volitelné).

Instalujte jen integrace, které potřebujete; BreweryX běží jako standardní Bukkit/Spigot plugin.

🧠 Technické poznámky

• Potvrzený podporovaný server software: Spigot, Paper a Folia (zdroje projektu uvádějí podporu Spigot/Paper/Folia).
• Potvrzené podporované verze Minecraftu (rozsah uvedený projektem): 1.8.9 až 1.21.8 (viz oficiální metadata projektu pro testované verze).
• Projekt je open source a licencovaný pod GPL-3.0.
• Plugin vytváří konfigurační a jazykové soubory (jazykové soubory jsou podle dokumentace umístěny v plugins/brewery/languages/).
• Projekt poskytuje API a tým odkazuje na samostatné BreweryX API repository.

❓ FAQ (stručně)

• Q: Mohu si vytvořit vlastní recepty?
  A: Ano — BreweryX podporuje konfigurovatelné vlastní recepty včetně ingrediencí, fází a vlastností.
• Q: Funguje BreweryX s vlastními balíčky itemů?
  A: Ano — projekt uvádí podporu integrací ItemsAdder a Oraxen.

🤝 Kdy je tento plugin užitečný

Pokud chcete přidat trvalý, konfigurovatelný brewing systém s roleplay prvky (opilost, zrání, destilace) a podporou vlastních itemů, BreweryX vám poskytne nástroje pro recepty a integrace, díky kterým tento systém spustíte na serveru založeném na Spigot/Paper.