Open Source Java 17+ MC 1.20+

🏆 TopServerRewards

Plugin do automatycznego nagradzania graczy za głosowanie na serwer na TopServer.pl — polskiej liście serwerów Minecraft.

Pobierz .jar Kod źródłowy Strona główna

✨ Funkcje

Nagrody za głosy przez komendę /ts odbierz

Itemy, komendy i pieniądze (Vault) jako nagrody

Broadcast po odebraniu nagrody

Pełna customizacja wiadomości i placeholderów

Cooldown — ochrona przed spamem

Reload konfiguracji na żywo (/ts reload)

Tab-completion komend

Asynchroniczna komunikacja z API

📋 Wymagania

Minecraft 1.20+ (Spigot / Paper / Forki)
Java 17+
Serwer dodany na TopServer.pl
Opcjonalnie: Vault (dla nagród pieniężnych)

⚙️ Instalacja

1

Pobierz plugin
Kliknij przycisk "Pobierz .jar" powyżej lub pobierz TopServerRewards.jar z GitHuba.
2

Wrzuć do plugins/
Skopiuj plik .jar do folderu plugins/ na swoim serwerze.
3

Zrestartuj serwer
Użyj /stop i uruchom serwer ponownie. Po starcie plugin wygeneruje plik konfiguracji.
4

Ustaw adres IP serwera
Otwórz plik plugins/TopServerRewards/config.yml i zmień wartość server-ip na dokładnie taki adres, jaki wpisałeś przy dodawaniu serwera na TopServer.pl (np. mc.twojserwer.pl).
5

Przeładuj konfigurację
Wpisz /ts reload na serwerze — gotowe!

Jeśli widzisz TopServerRewards na zielono po wpisaniu /plugins — plugin załadował się poprawnie.

🔧 Komendy

Komenda	Opis	Uprawnienie
`/ts`	Wyświetla pomoc	—
`/ts odbierz`	Odbiera nagrodę za głos	`topserver.claim` domyślnie: wszyscy
`/ts reload`	Przeładowuje konfigurację	`topserver.admin` domyślnie: OP

Aliasy: /topserver /tsreward

🎁 Konfiguracja nagród

Plik config.yml pozwala ustawić trzy niezależne typy nagród — możesz włączyć jeden, kilka lub wszystkie naraz.

yaml — config.yml

rewards:
  enabled: true
  broadcast: true

  items:
    enabled: true
    list:
      - "DIAMOND:5"
      - "EMERALD:3"
      - "GOLDEN_APPLE:1"

  commands:
    enabled: false
    list:
      - "give {player} diamond_sword 1"
      - "eco give {player} 500"

  money:
    enabled: false
    amount: 100.0

💬 Customizacja wiadomości

Wszystkie wiadomości są konfigurowalne w config.yml. Obsługiwane placeholdery:

Placeholder	Opis
`{player}`	Nick gracza
`{command}`	Pełna komenda (np. `/ts odbierz`)
`{server}`	Nazwa serwera z API
`{seconds}`	Sekundy cooldownu
`{error}`	Treść błędu
`{amount}`	Kwota pieniędzy (wymaga Vault)
`{api_message}`	Gotowa wiadomość z API

Aby wyłączyć konkretną wiadomość, ustaw jej wartość na "" lub false w config.yml.

🔌 API

Plugin korzysta z oficjalnego API TopServer.pl. Komunikacja odbywa się asynchronicznie — serwer nie jest blokowany podczas sprawdzania głosów.

📄 Licencja

Projekt open-source. Kod źródłowy dostępny na GitHubie.

Pobierz plugin (.jar) Kod źródłowy