Minecraft plugin PhoenixCrates

🔌 O Phoenix Crates

Phoenix Crates je Minecraft plugin pro provoz crate/reward systémů na serveru. Poskytuje typy crate, klíče (fyzické i virtuální), animované otevírání a vestavěný editor ve hře pro vytváření a správu crate a odměn bez úprav syrových souborů. Projekt vydává Phoenix Plugins a je dostupný jako bezplatná edice plus placená prémiová verze s dalšími funkcemi.

🎯 Účel

Poskytnout správcům serveru konfigurovatelný systém odměn/crate, který umí zobrazovat animované otevírání, spravovat klíče a virtuální klíče ve stylu měny a umožnit staffu vytvářet nebo upravovat crate a odměny přímo ve hře. Je určen pro servery, které chtějí mechaniky ve stylu eventů nebo shop/reward (například: odměnové giveaway, store crate nebo eventové ceny).

⚙️ Funkce

• Více režimů crate enginu (vanilla block, vanilla model, integrace Model Engine).
• Animované sekvence otevírání a idle animace s konfigurovatelnými fázemi a kombinacemi.
• Fyzické klíče a správa virtuálních klíčů (nabídky virtuálních klíčů, platby/převody, příkazy give/take/set).
• Vestavěný editor ve hře pro vytváření/úpravu crate, klíčů, odměn a animací.
• Typy odměn včetně náhodných a výběrových (hráč si volí) odměn, rerollů a zaručených odměn.
• Add-ony a prémiové bonusy (další animace, podpora MySQL, API a instalace add-onu v prémiovém plánu).
• Základní podpora zobrazení na Bedrock/Geyser pro některé animace a modely.
• Nástroje pro náhled a správu odměn na straně serveru (globální/hráčské limity výher, reset cooldownů).

🧩 Pro koho je

• Survival/SMP a ekonomické servery, které zobrazují crate nebo reward systémy.
• Servery, které chtějí animované/vizuální otevírání crate a podporu modelů (Model Engine).
• Správce, kteří dávají přednost vestavěnému editoru pro nastavení crate před ruční úpravou souborů.

🏗️ Příklady použití

• Dát hráčům virtuální klíče, které mohou utratit v GUI za otevření kosmetických nebo item crate.
• Vytvořit crate s prázdninovou tematikou na míru s vlastními animacemi otevírání a omezenými odměnami.
• Použít vestavěný editor k migraci nebo znovuvytvoření nastavení crate bez ruční úpravy YAML.

⌨️ Příkazy

(Výše uvedené příkazy pocházejí z oficiální dokumentace Phoenix Crates a referenční příručky příkazů.)

🔐 Oprávnění

(Uvedeny jsou pouze uzly oprávnění, které projekt výslovně dokumentuje.)

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální JAR pluginu Phoenix Crates nebo jej získejte z oficiálního distribučního kanálu.
• Umístěte JAR do adresáře plugins/ vašeho serveru pro podporovaný server (viz Technické poznámky).
• Spusťte nebo restartujte server a zkontrolujte konzoli, zda se plugin načetl.
• K vytváření crate a klíčů použijte vestavěný editor nebo poskytnuté příkazy; plugin také nabízí příkazy reload a editor.

📦 Závislosti

• Ve výchozím nastavení nejsou uvedeny žádné povinné závislosti třetích stran. Plugin se integruje s volitelnými systémy, jako je Model Engine pro vlastní modely, a poskytuje placeholders zmíněné v changelogu.

🧠 Technické poznámky

• Podporovaný serverový software (dle autora): Spigot a odvozeniny Spigotu, Paper a odvozeniny Paperu a Folia.
• Podporované verze Minecraftu: podle dokumentace Phoenix Crates (ke zmíněné verzi) podporuje Minecraft 1.20.4+ (podpora starších verzí byla ukončena od zmíněného major releasu).
• Volitelné integrace: Model Engine (vlastní animované modely), poznámky ke kompatibilitě GeyserMC pro zobrazení Bedrock a placeholders PlaceholderAPI zmíněné v aktualizacích.
• Projekt je nabízen v bezplatné i premium úrovni; premium přidává funkce jako podpora MySQL, veřejný přístup k API, neomezené crate, další animace a add-ony.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete konfigurovatelný crate systém řízený animacemi s vestavěným editorem a volitelnou podporou modelů/Bedrock, Phoenix Crates nabízí jak vizuální prvky pro hráče, tak administrátorské nástroje pro správu odměn a klíčů přímo ze serveru.