Plugin Minecraft PhoenixCrates

🔌 O Phoenix Crates

Phoenix Crates to plugin do Minecrafta do obsługi systemów skrzynek/nagród na serwerze. Udostępnia typy skrzynek, klucze (fizyczne i wirtualne), animowane sekwencje otwierania oraz edytor w grze do tworzenia i zarządzania skrzynkami i nagrodami bez edycji surowych plików. Projekt jest publikowany przez Phoenix Plugins i jest dostępny jako darmowa edycja oraz płatna wersja premium z dodatkowymi funkcjami.

🎯 Cel

Zapewnienie administratorom serwera konfigurowalnego systemu nagród/skrzyniek, który może prezentować animowane otwieranie, zarządzać kluczami i kluczami w stylu waluty wirtualnej oraz pozwalać ekipie tworzyć lub edytować skrzynki i nagrody w grze. Jest przeznaczony dla serwerów, które chcą mechanik w stylu wydarzeń lub sklepu/nagród (na przykład: rozdania nagród, skrzynki sklepowe lub nagrody eventowe).

⚙️ Funkcje

• Wiele trybów silnika skrzynek (vanilla block, vanilla model, integracja z Model Engine).
• Animowane sekwencje otwierania i animacje bezczynności z konfigurowalnymi fazami i kombinacjami.
• Fizyczne klucze i zarządzanie kluczami wirtualnymi (menu kluczy wirtualnych, komendy płacenia/przesyłania, daj/odbierz/ustaw).
• Edytor w grze do tworzenia/edycji skrzynek, kluczy, nagród i animacji.
• Typy nagród, w tym nagrody losowe i wybierane (gracz wybiera), rerolle oraz nagrody gwarantowane.
• Dodatki i elementy premium (dodatkowe animacje, obsługa MySQL, API oraz instalacja dodatków w planie premium).
• Podstawowa obsługa podglądu na Bedrock/Geyser dla niektórych animacji i modeli.
• Narzędzia po stronie serwera do podglądu i zarządzania nagrodami (globalne/indywidualne limity wygranych, reset cooldownów).

🧩 Dla kogo jest ten plugin

• Serwery Survival/SMP i ekonomiczne, które oferują skrzynki lub systemy nagród.
• Serwery, które chcą animowanych/wizualnych otwarć skrzynek i obsługi modeli (Model Engine).
• Administratorzy, którzy wolą edytor w grze do konfiguracji skrzynek zamiast ręcznej edycji plików.

🏗️ Przykładowe zastosowania

• Daj graczom wirtualne klucze, które mogą wydać w GUI, aby otworzyć skrzynki kosmetyczne lub przedmiotowe.
• Twórz skrzynki o świątecznej tematyce z własnymi animacjami otwierania i ograniczonymi nagrodami.
• Użyj edytora w grze do migracji lub przebudowy konfiguracji skrzynek bez ręcznej edycji YAML.

⌨️ Komendy

(Powyższe komendy pochodzą z oficjalnej dokumentacji Phoenix Crates i referencji komend.)

🔐 Uprawnienia

(Listowane są tylko węzły uprawnień wyraźnie udokumentowane przez projekt.)

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR wtyczki Phoenix Crates lub uzyskaj go z oficjalnego kanału dystrybucji.
• Umieść plik JAR w katalogu plugins/ serwera na obsługiwanym serwerze (zobacz Notatki techniczne).
• Uruchom lub zrestartuj serwer i sprawdź konsolę, aby potwierdzić, że wtyczka została załadowana.
• Użyj edytora w grze lub udostępnionych komend do tworzenia skrzynek i kluczy; wtyczka udostępnia też komendy przeładowania i edytora.

📦 Zależności

• Domyślnie nie ma wymaganych zależności zewnętrznych. Wtyczka integruje się z opcjonalnymi systemami, takimi jak Model Engine dla niestandardowych modeli, i udostępnia placeholdery wspomniane w changelogach.

🧠 Notatki techniczne

• Obsługiwane oprogramowanie serwera (według autora): Spigot i forki Spigota, Paper i forki Paper oraz Folia.
• Obsługiwane wersje Minecrafta: zgodnie z dokumentacją Phoenix Crates (w podanej linii wersji) obsługuje Minecraft 1.20.4+ (obsługa starszych wersji została usunięta w wskazanym dużym wydaniu).
• Opcjonalne integracje: Model Engine (niestandardowe animowane modele), uwagi o zgodności GeyserMC dla podglądu Bedrock oraz placeholdery PlaceholderAPI wspomniane w aktualizacjach.
• Projekt jest oferowany w wersji darmowej i premium; premium dodaje funkcje takie jak obsługa MySQL, publiczny dostęp do API, nieograniczone skrzynki, dodatkowe animacje i dodatki.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz konfigurowalnego, opartego na animacjach systemu skrzynek z edytorem w grze i opcjonalną obsługą modeli/Bedrock, Phoenix Crates zapewnia zarówno wizualne elementy dla graczy, jak i narzędzia administracyjne do zarządzania nagrodami i kluczami z poziomu serwera.