[Plugin] MelonHunt 🎯 – Strzelaj, Rywalizuj, Awansuj!

[Serip]

MelonHunt to rozbudowany plugin, który przenosi graczy w dynamiczny świat mini-gier, gdzie liczy się celność, refleks i strategia. Twoim celem jest zestrzelenie wszystkich przypisanych tylko Tobie melonów za pomocą łuku – i to szybciej niż inni! Zbudowany z myślą o serwerach społecznościowych, eventowych, minigierkach, plugin oferuje bogaty system aren, rankingów, statystyk i personalizacji.

---

🔥 Najważniejsze Funkcje

🏹 Unikalna Rozgrywka

• Strzelanie do własnych melonów – każdy gracz ma indywidualny zestaw celów.

• Gra działa na wielu arenach jednocześnie, każda z niezależnym lobby, czasem i graczem.

• Czas rozgrywki widoczny na pasku expa – czy uda Ci się pobić rekord?

• Respawn po upadku, ukrywanie graczy zegarem, wskaźnik najbliższego melona – wszystko dla maksymalnej immersji.

• Zwycięża gracz, który pierwszy trafi wszystkie melony lub osiągnie najlepszy czas.

---

🏟️ System Aren

• Interaktywne tworzenie aren komendą /arena create "Nazwa Areny".

• Ustawienia lobby, respawnu, czasu, graczy, listy melonów.

• Specjalny patyk edytora do zaznaczania melonów (LPM – usuń, PPM – dodaj).

• Pełne wsparcie YAML – areny zapisują się automatycznie.

• Tryb testowy, aktywacja i dezaktywacja aren, klimatyczne nazwy - według uznania (np. "Smocza Jama").

---

⏱️ Zaawansowany System Odliczania

• Start gry po osiągnięciu minimalnej liczby graczy – domyślnie 15 sek.

• Jeśli dołączy kolejny gracz – licznik resetuje się.

• Maksymalna liczba graczy? Gra rusza szybciej – np. po 5 sekundach.

• Wszystko konfigurowalne w plikach.

---

📊 Statystyki i Rekordy

• Poziom, exp, monety, punkty i wiele więcej.

• Historia gier, liczba trafień, wygrane, czas gry.

• Rekordy czasowe dla każdej areny: najlepszy wynik + liczba prób.

• System działa z SQLite i MySQL – wybierasz w configu.

---

🏅 System Rang

• Rangi przyznawane na podstawie poziomu (exp).

• Konfigurowalne w ranks.yml – nazwa, kolor, próg.

• Wyświetlane na scoreboardzie + komenda podglądu.

• Gracz otrzymuje komunikat o awansie w trakcie gry.

---

📈 Scoreboard i HUD

• Aktualny postęp: ile melonów zostało.

• Pozostały czas, nazwa areny, liczba graczy, ranga.

• Informacje są dynamiczne i aktualizowane na żywo.

---

🎆 Efekty i Dodatki

• Efekty cząsteczek po trafieniu melona (w pełni konfigurowalne).

• Specjalne animacje i efekty przy pobiciu rekordu.

• Wyświetlenie czasu końcowego i odznaczenia za najlepsze wyniki.

• Historia wyników dostępna dla gracza.

---

🧰 Funkcyjne Itemy

• Patyk Edytorek – do zaznaczania melonów podczas edycji areny.

• Zegar – włącza/wyłącza widoczność graczy.

• Kompas – wskazuje najbliższego melona.

---

📜 Komendy

👤 Dla Graczy:

• /melonhunt join <nazwa> – dołącz do wybranej areny.

• /melonhunt leave – opuść rozgrywkę.

• /melonhunt menu – otwiera menu wyboru areny.

• /melonhunt stats – twoje statystyki.

• /melonhunt test <nazwa> – testowanie areny.

🔧 Dla Administratorów:

• /melonhunt setup <nazwa> – rozpocznij tworzenie areny.

• /melonhunt save – zapisz i aktywuj arenę.

• /melonhunt setspawn / setlobby – ustawienia punktów.

• /melonhunt enable / disable <nazwa> – zarządzanie arenami.

• /melonhunt reload – przeładuj plugin.

---

⚙️ Techniczne

• Pełne wsparcie SQLite/MySQL – dane zapisane bezpiecznie.

• YAML dla aren – łatwa edycja bez restartów.

• Optymalizacja pod wiele równoczesnych gier.

 

🔄 Zapis danych - Jak to działa krok po kroku?

1. Gracz wchodzi na serwer
   → StatsManager#loadStats(UUID) jest wywoływane.
   → Dane gracza są pobierane z bazy (asynchronicznie – nie laguje serwera!)
   → Obiekt PlayerStats ląduje do mapy Map<UUID, PlayerStats> w StatsManager.

2. Gracz gra – system operuje na danych w pamięci
   → Statystyki (exp, monety, poziom itd.) są modyfikowane w obiekcie PlayerStats – bez żadnych zapytań SQL.

3. Gracz wychodzi / plugin się wyłącza
   → StatsManager#saveStats(UUID) lub saveAllStats() zapisuje dane do bazy – tylko raz.

---

📌 Dlaczego to dobre rozwiązanie?

✅ Nie obciąża MySQL/SQLite – bo nie wykonujesz setek zapytań na minutę
✅ Szybki dostęp – dane są lokalnie w RAM, więc szybkie scoreboardy, rangi, poziomy
✅ Bezpieczeństwo danych – wszystko zapisuje się przy wyjściu lub na onDisable()

 

---

💡 Dlaczego MelonHunt?

To nie tylko minigierka. To pełnoprawny system rywalizacji:

• zintegrowany z rangami, statystykami i rekordami,

• pozwalający na interaktywne tworzenie i testowanie aren,

• gotowy do gry zarówno na dużych serwerach, jak i prywatnych sesjach.

 

 

 

Pytanie do Was - co tu jeszcze dodać? 

Edytowane 21 Kwietnia 2025 przez Serip

[Serip]

Dodatkowo pracuje nad strona, na razie taki szkielet 😄 
Nie wiem czy to forum jest aktywne, a chetnie bym przyjal jakies propozycje odnosnie tego projektu - co dodac, usunac, zmienic. 

[Serip]

Brak zainteresowania, szkielet i cały system zrobiony, ale nie wiem gdzie mogę rozpowszechnić wtyczkę tak, aby w ogóle ktoś z niej korzystał, zamykam temat 😞

[AlexsanderARG]

Otwieram ponownie na prośbę autora.