PL:

🛠️ Opis projektu

Quazift-TotemCoach to lekki, innowacyjny plugin wprowadzający na serwer system treningu refleksu i szybkiego klikania totemów (Totem Popping). Gracze mogą ćwiczyć swoje umiejętności w specjalnie zaprojektowanym GUI, gdzie muszą błyskawicznie reagować na losowo pojawiające się przedmioty, zanim minie określony czas.

Dzięki temu narzędziu dodasz na swój serwer nową warstwę rywalizacji i świetną mini-grę, idealną do zabicia czasu lub treningu przed walkami PvP. Plugin idealnie sprawdzi się do:

• Treningu czasu reakcji i precyzji graczy w bezpiecznym, wirtualnym środowisku (GUI).
• Budowania rywalizacji na serwerze dzięki zautomatyzowanemu rankingowi Top 10.
• Wzbogacenia trybów typu BoxPvP, CrystalPvP, Anarchy czy Survival o unikalną mechanikę.

💡 Dlaczego warto wybrać ten projekt?

• Asynchroniczny Ranking Top 10: Plugin ładuje skiny głów najlepszych graczy w tle (asynchronicznie), co całkowicie eliminuje problem lagów (spadków TPS) podczas otwierania menu rankingu.
• Zaawansowana Mechanika Treningu: Wbudowany system "timeout" (wymuszający szybką reakcję) oraz wykrywanie błędnych kliknięć.
• Pełna personalizacja: Kompleksowa obsługa wiadomości (TITLE, ACTIONBAR, CHAT) oraz oddzielny system dźwięków (songs.yml) z możliwością zmiany głośności i tonacji (pitch).
• Elastyczne GUI: Każde menu (main.yml, top.yml, training.yml) pozwala na swobodną zmianę ułożenia przedmiotów (slotów), materiałów oraz akcji po kliknięciu.
• Wsparcie PlaceholderAPI: Możliwość łatwego wyświetlania rekordu gracza lub całej topki na scoreboardach, hologramach czy czacie.

---

⚠️ Ważne informacje przed pobraniem

🎖️ Komendy

• /trener » Otwiera główne menu treningu totemów.
• /qtrener reload » Komenda administracyjna do przeładowania plików konfiguracyjnych w locie.

🍀 Permisje

• quazift.totemcoach.admin » Pozwala na użycie komendy administracyjnej i przeładowanie konfiguracji pluginu (domyślnie: OP).

🏷️ Placeholdery

(Wymagają zainstalowanego pluginu PlaceholderAPI na serwerze)

• %totemcoach_record% » Zwraca najwyższy wynik (rekord) gracza.
• %totemcoach_top_name_<1-10>% » Zwraca nick gracza na danym miejscu w rankingu (np. %totemcoach_top_name_1%).
• %totemcoach_top_score_<1-10>% » Zwraca wynik gracza na danym miejscu w rankingu (np. %totemcoach_top_score_1%).

📘 Wymagane pluginy

• Brak do podstawowego działania.
• Opcjonalnie: PlaceholderAPI (do obsługi zmiennych w innych pluginach).

---

EN:

🛠️ Project Description

Quazift-TotemCoach is a lightweight, innovative plugin that introduces a reflex and totem-clicking training system (Totem Popping) to your server. Players can practice their skills in a specially designed GUI, where they must react instantly to randomly appearing items before the time runs out.

With this tool, you can add a new layer of competition and a great mini-game to your server, perfect for killing time or warming up before PvP fights. The plugin is perfect for:

• Training players' reaction time and precision in a safe, virtual environment (GUI).
• Building server-wide competition through an automated Top 10 leaderboard.
• Enhancing BoxPvP, CrystalPvP, Anarchy, or Survival servers with a unique mechanic.

💡 Why should you download this project?

• Asynchronous Top 10 Leaderboard: The plugin loads top players' head skins in the background (asynchronously), completely eliminating server lag (TPS drops) when opening the ranking menu.
• Advanced Training Mechanics: Built-in timeout system (forcing quick reactions) and miss-click detection.
• Full Customization: Comprehensive message support (TITLE, ACTIONBAR, CHAT) and a dedicated sound system (songs.yml) with adjustable volume and pitch.
• Flexible GUIs: Every menu (main.yml, top.yml, training.yml) allows you to freely modify item placement (slots), materials, and on-click actions.
• PlaceholderAPI Support: Easily display a player's record or the entire leaderboard on scoreboards, holograms, or chat.

---

⚠️ Critical Information before downloading

🎖️ Commands

• /trener » Opens the main totem training menu.
• /qtrener reload » Administrative command for reloading configuration files on the fly.

🍀 Permissions

• quazift.totemcoach.admin » Allows the use of the admin command and plugin configuration reload (default: OP).

🏷️ Placeholders

(Requires PlaceholderAPI plugin installed on the server)

• %totemcoach_record% » Returns the player's highest score (record).
• %totemcoach_top_name_<1-10>% » Returns the nickname of the player at a given ranking position (e.g., %totemcoach_top_name_1%).
• %totemcoach_top_score_<1-10>% » Returns the score of the player at a given ranking position (e.g., %totemcoach_top_score_1%).

📘 Required plugins

• None for core functionality.
• Optional: PlaceholderAPI (if you want to fetch stats and leaderboards for use in other plugins).