EasyQuests ⚔️

EasyQuests to nowoczesny, lekki i niezwykle wydajny silnik zadań z linearnym drzewkiem progresu, stworzony z myślą o serwerach Survival, RPG oraz Skyblock. Oferuje bezproblemową współpracę z nowoczesnymi interfejsami oraz pełną synchronizację danych.

---

⭐ Główne Funkcje (Features)

• 🗺️ Płynna Paginacja (Wielostronicowe GUI): Jeśli Twoja ścieżka ma więcej niż 28 zadań, wtyczka automatycznie podzieli ją na dynamiczne strony z płynną nawigacją za pomocą piórek.
• 💾 Zapis w Bazach Danych (SQL): Wybierz najwygodniejszy zapis: płaskie pliki YAML, lokalną bazę SQLite chroniącą przed utratą danych, lub zewnętrzną bazę MySQL do synchronizacji w sieciach BungeeCord/Velocity.
• ⏱️ Wygasający HUD (Fading Cooldown): Paski BossBar i ActionBar pojawiają się tylko wtedy, gdy gracz aktywnie wykonuje zadanie, i automatycznie wygaszają się po 5 sekundach bezczynności, dbając o czystość ekranu.
• 🛡️ Zaawansowany System Anty-Exploit: Automatycznie oznacza bloki postawione przez graczy (rudy, drewno) metadanymi, zapobiegając oszustwom polegającym na stoiskowym stawianiu i niszczeniu tych samych surowców.
• 🧪 Wsparcie Alchemii i Rzemiosła: Precyzyjne zliczanie masowego wytwarzania przedmiotów (w tym Shift-Click) oraz warzenia mikstur (z pełną kompatybilnością od 1.16 do najnowszych wydań 1.20.5+ i nowszych).
• 📝 Automatyczny Translator Nagród: Wtyczka samodzielnie interpretuje komendy konsolowe (takie jak /give oraz /xp add) i wyświetla je w opisie jako estetyczne napisy w GUI (np. » 5x Chleb, » 50 XP).

---

🔗 Integracja z PlaceholderAPI & CustomNameplates

Plugin udostępnia zoptymalizowane zmienne PlaceholderAPI, idealne do integracji z pluginem CustomNameplates, tablistami (TAB) czy scoreboardami:

Zmienna (Placeholder)	Opis	Przykład
%easyquests_has_active%	Zwraca true lub false (służy jako warunek wyświetlania HUD)	true
%easyquests_active_quest%	Nazwa obecnie wykonywanego zadania	Węglowy Początek
%easyquests_progress%	Aktualny postęp gracza w zadaniu	4
%easyquests_target%	Wymagana ilość do ukończenia zadania	16
%easyquests_percent%	Procentowe ukończenie misji	25
%easyquests_progress_bar%	RPG-owy, kolorowy pasek postępu z kwadracikami	■■■■■■■■■■

---

🛠️ Komendy i Uprawnienia

• /quests (Aliasy: /zadania, /easyquests, /questy) — Otwiera główne menu kategorii zadań.
  Uprawnienie: easyquests.use (Domyślnie: true)
• /quests reload — Natychmiast przeładowuje plik config.yml oraz wszystkie kategorie w folderze categories/.
  Uprawnienie: easyquests.admin (Domyślnie: OP)

---

💻 Wymagania i Kompatybilność

• Wersja Javy: Java 17 lub nowsza
• Silnik Serwera: Paper / Spigot 1.16 - 1.20.x, 1.21, 1.22+
• Zależności: PlaceholderAPI (Soft-dependency, zalecane)