Plugin STORMHOMY wprowadza na serwer zaawansowany system zarządzania domkami inspirowany rozwiązaniami z Anarchia.GG. Jego główną funkcją jest możliwość ustawiania wielu punktów teleportacji (home) z pełną personalizacją, co pozwala graczom szybko przemieszczać się między ulubionymi lokalizacjami oraz zarządzać nimi w intuicyjny sposób.

GUI
Proces zarządzania domkami odbywa się poprzez przejrzysty system GUI, który składa się z czterech menu:

• MainMenu - główne GUI wyświetlający wszystkie dostępne sloty home. Gracz może kliknąć lewym przyciskiem myszy, aby ustawić nowy domek lub przeteleportować się do istniejącego, a prawym przyciskiem, aby otworzyć menu edycji.
• EditMenu - GUI zarządzania konkretnym domkiem, w którym gracz może zmienić ikonę, włączyć/wyłączyć wyświetlanie koordynatów oraz usunąć domek.
• DeleteConfirmMenu - GUI potwierdzenia usunięcia domku z przyciskami zatwierdzenia, anulowania i powrotu, zabezpieczające przed przypadkowym usunięciem.
• IconPickerMenu - wybór ikony z paginacją, wyszukiwarką oraz filtrowaniem materiałów, pozwalający na pełną personalizację wyglądu domku w GUI.

SYSTEM SLOTÓW
Plugin oferuje elastyczny system slotów home, gdzie każdy slot posiada:
Indywidualną permisję (np. stormhomy.home.1, stormhomy.home.2)

• Domyślną nazwę i ikonę konfigurowalną dla każdego slotu
• Pozycję w GUI dowolnie ustawialną przez administratora
• Możliwość rozbudowy można dodać dowolną liczbę slotów poprzez konfigurację

TELEPORTACJA
System teleportacji posiada mechaniki:

• Odliczanie z konfigurowalnymi dźwiękami i cząsteczkami
• Wyświetlanie milisekund w ostatniej sekundzie (losowo 950-999ms)
• Anulowanie przy ruchu z konfigurowalnymi progami odległości
• Anulowanie przy obrażeniach lub atakowaniu
• Cooldown z możliwością wyłączenia dla adminów
• Zachowanie kierunku patrzenia lub teleportacja z zapisanym kierunkiem

BAZA DANYCH
STORMHOMY oferuje dwa typy bazy danych:

• SQLite - prosty, plikowy system idealny dla małych serwerów
• MySQL - zaawansowana baza z poolingiem połączeń dla dużych serwerów

System zapisuje dane asynchronicznie z automatycznym zapisem co X minut oraz grupowaniem zapisów dla lepszej wydajności.

KOMENDY

• /home - otwiera GUI zarządzania domkami
• /home reload - przeładowuje konfigurację (wymaga permisji)
• /stormhomy list <gracz> - wyświetla listę home gracza
• /stormhomy teleport <gracz> <numer> - teleportuje do home gracza
• /stormhomy delete <gracz> <numer> - usuwa konkretny home gracza
• /stormhomy deleteall <gracz> - usuwa wszystkie home gracza
• /stormhomy allowedworlds <add|remove|list> [świat] - zarządza dozwolonymi światami
• /stormhomy blockedworlds <add|remove|list> [świat] - zarządza zablokowanymi światami
• /stormhomy blockedregions <add|remove|list> [region] - zarządza zablokowanymi regionami WorldGuard
• /stormhomy reload - przeładowuje konfigurację pluginu

PERMISJE

• stormhomy.home.admin - dostęp do wszystkich komend administracyjnych
• stormhomy.home.<numer> - dostęp do konkretnego slotu home (np. stormhomy.home.1)
• stormhomy.bypass.cooldown - pomija cooldown teleportacji
• stormhomy.reload - pozwala na przeładowanie konfiguracji

Plugin jest kompatybilny z wersjami Minecraft 1.19-26.1+ i został stworzony przez Ziffy_ na licencji CC BY-ND 4.0.