Plugin Minecraft ExcellentCrates

🔌 O ExcellentCrates

ExcellentCrates to wtyczka Minecraft dla serwerów Spigot/Paper, która implementuje rozbudowany system crates (lootbox). Skupia się na konfigurowalnych typach crate, zarządzaniu kluczami (wirtualnymi i fizycznymi) oraz elastycznych definicjach nagród, którymi administratorzy serwera mogą zarządzać głównie za pomocą edytora GUI w grze.

🎯 Cel

Wtyczka rozwiązuje problem tworzenia, konfigurowania i prezentowania nagród opartych na crate na serwerze bez konieczności ręcznej edycji plików. Jest przeznaczona dla właścicieli serwerów i administratorów, którzy chcą używać crates z nagrodami (na wydarzenia, nagrody dzienne, funkcje monetyzowane lub postęp gracza), zachowując konfigurację i podglądy dostępne w grze.

⚙️ Funkcje

• Edytor GUI w grze do tworzenia i zarządzania crate, kluczami i nagrodami.
• Obsługa kluczy fizycznych i wirtualnych (klucze wirtualne zapobiegają handlowi/udostępnianiu).
• Wbudowane hologramy i efekty cząsteczek dla bloków crate (w przypadku niektórych funkcji hologramów mogą być wymagane opcjonalne wtyczki).
• Crate Blocks: łączenie crate z fizycznymi blokami/strefami dla interakcji z crate w świecie.
• Niestandardowe GUI podglądu i niestandardowe GUI otwierania dla każdej crate.
• Typy nagród: nagrody przedmiotowe i nagrody z komend.
• Obsługa bundle: wiele stosów przedmiotów na nagrodę (udokumentowany limit do 27 przedmiotów na nagrodę przedmiotową) oraz nieograniczona liczba komend na nagrodę z komendy.
• Rzadkości i wagi do równoważenia szans nagród.
• Kamienie milowe i funkcja masowego otwierania.
• Czas odnowienia otwierania i koszt otwarcia na gracza (integracja z ekonomią jest implikowana przez funkcję kosztu otwarcia).
• Wymagania dotyczące uprawnień i kluczy dla crate i nagród.
• Limity nagród (globalne i dla gracza) oraz ogłaszanie/rejestrowanie nagród.
• Obsługa PlaceholderAPI wskazana przez oficjalne źródła.

🧩 Dla kogo

• Publiczne i prywatne serwery Spigot/Paper używające crate do wydarzeń, monetyzacji lub zaangażowania graczy.
• Administratorzy serwerów, którzy wolą edytor w grze zamiast ręcznej edycji YAML.

🏗️ Przykładowe zastosowania

• Skonfiguruj crate z rzadkościami i ważonymi nagrodami, umieść blok crate na spawnie i daj graczom wirtualne klucze do jej otwierania.
• Twórz podglądy crate i hologramy, aby gracze mogli sprawdzić nagrody przed wydaniem kluczy.
• Użyj masowego otwierania i kamieni milowych, aby organizować wydarzenia ograniczone czasowo lub nagradzać aktywnych graczy.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR wtyczki i umieść go w katalogu plugins/ swojego serwera na potwierdzonej, obsługiwanej wersji serwera (Spigot lub Paper).
• Uruchom ponownie serwer i sprawdź konsolę, aby potwierdzić, że wtyczka została załadowana.
• Jeśli wtyczka wymaga zależności od silnika pomocniczego, zainstaluj wymagany plugin zależności (nightcore) przed ExcellentCrates lub razem z nim.

📦 Zależności

• Wymagane: nightcore (silnik wtyczki), zgodnie z oficjalnymi źródłami.
• Opcjonalne: ProtocolLib lub PacketEvents do zaawansowanej funkcjonalności hologramów; PlaceholderAPI jest obsługiwane dla placeholderów w tekstach.

🧠 Uwagi techniczne

• Potwierdzone obsługiwane oprogramowanie serwera: Spigot i Paper.
• Potwierdzone minimalne wymaganie wersji serwera: 1.21.8 lub nowsza (zgodnie z projektem).
• Potwierdzone wymaganie Java: Java 21 lub nowsza.
• Obsługa Folia i Forge jest wyraźnie niewspierana.
• Repozytorium projektu wskazuje licencję GPL-3.0.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli potrzebujesz konfigurowalnego w grze systemu crate z wirtualnymi/fizycznymi kluczami, hologramami i elastycznymi definicjami nagród (przedmioty, komendy, rzadkości i limity) dla serwera Spigot/Paper, ExcellentCrates oferuje te funkcje oraz workflow edytora, który pozwala zarządzać większością konfiguracji bez ręcznej edycji plików.