Plugin Sm24-Votifier

Oficjalna dokumentacja pluginu pozwalającego na integrację Twojego serwera Minecraft z naszą platformą. Od automatycznych nagród za głosy, nagród za opinie, aż po wygodne zarządzanie serwerem wprost z gry.

1. Pobieranie i Instalacja

Integracja pozwala na automatyczne nagradzanie graczy i łatwe zarządzanie wizytówką Twojego serwera na liście z poziomu gry.

Proces instalacji:

  • Pobierz najnowszą wersję pluginu z linku powyżej.
  • Umieść pobrany plik .jar w folderze /plugins na swoim serwerze.
  • Zrestartuj lub uruchom ponownie serwer.
  • W folderze /plugins/Sm24-Votifier/ zostanie wygenerowany plik config.yml.
  • Wklej w nim swój unikalny token serwera.

2. Token Serwera

Token łączy Twój serwer z platformą. Jest on przypisywany automatycznie do autoryzowanych serwerów.

  • Wejdź w Edycję Serwera w swoim panelu użytkownika.
  • Kliknij przycisk Pobierz plugin. Pojawi się okno z Twoim tokenem.
  • Skopiuj token i wklej go do config.yml w pole server-token.

Bezpieczeństwo tokena

Token jest poufny! Nigdy go nie udostępniaj. W panelu edycji serwera, obok przycisku pobrania pluginu, znajduje się przycisk Regeneruj token. Użyj go, jeśli podejrzewasz, że Twój token mógł wyciec. Spowoduje to unieważnienie starego tokena.

3. Architektura Komend (/sm24)

W nowej wersji pluginu wszystkie komendy zostały zjednoczone pod jedną, główną komendą /sm24. Plugin posiada inteligentne autouzupełnianie (TabCompleter), które ułatwia korzystanie z komend i podpowiada składnię w zależności od posiadanych uprawnień. Starsze aliasy komend wciąż działają, aby zapewnić pełną kompatybilność.

Dla Graczy (Nagrody)

KomendaOpis
/sm24 glosuj
lub /sm24-glosuj
Wyświetla dedykowany link do głosowania na serwer.
/sm24 nagroda glosowanie
lub /sm24-nagroda
Sprawdza i odbiera nagrodę za oddany głos. Wymaga ewentualnego uprawnienia ustalonego w konfiguracji.
/sm24 nagroda opinia
lub /sm24-nagroda-opinia
[Nowość] Odbiera specjalną nagrodę za zostawienie opinii o serwerze na naszej liście.

Zarządzanie Serwerem (Dla Administracji)

Dzięki tym komendom możesz aktualizować swoją wizytówkę bezpośrednio z gry! Plugin na bieżąco pobiera z API dozwolone wartości, więc TabCompleter sam podpowie Ci dostępne wersje i tryby gry. Wymagane uprawnienie: sm24.admin.edit lub status OP.

KomendaOpis działania
/sm24 dodaj tryb <tryb>Dodaje nowy tryb do wizytówki serwera na stronie.
/sm24 usun tryb <tryb>Usuwa wybrany tryb.
/sm24 dodaj wersja <wersja>Dodaje wspieraną wersję gry.
/sm24 usun wersja <wersja>Usuwa wspieraną wersję gry.
/sm24 ustaw opis <opis>Zmienia krótki opis serwera.

Opcje Testowe i Konfiguracyjne (OP)

KomendaOpis działania
/sm24 reload
lub /sm24-reload
Przeładowuje plik konfiguracyjny z dysku.
/sm24 test nagroda glosowanieSztucznie przyznaje nagrodę za głos testując komendy z configu.
/sm24 test nagroda opiniaSztucznie przyznaje nagrodę za opinię testując komendy z configu.

4. Konfiguracja (config.yml)

# =================================================================
# Konfiguracja pluginu Sm24VoterJava
# =================================================================
# Poradnik konfiguracji: https://serweryminecraft24.pl/konfiguracja-pluginu
# Ustawienia dotyczące komunikacji z API serweryminecraft24.pl
api:
# Twój unikalny token serwera ze strony. Kluczowy do działania pluginu. Możesz go pozyskać po wejściu w panel edycji serwera na stronie serweryminecraft24.pl,
#w oknie informacyjnym, które pojawia się po kliknięciu przycisku "Pobierz plugin"
server-token: 'tutaj_wpisz_token'
# Ustawienia nagród za głosowanie
rewards:
# Cooldown w sekundach, jak często gracz może użyć komendy /sm24-nagroda. Minimum 60 sekund
cooldown-seconds: 60
permission:
# Czy wymagane jest uprawnienie, aby odebrać nagrodę?
# true - tak, gracz musi mieć uprawnienie zdefiniowane poniżej
# false - każdy może odebrać nagrodę
required: false
# Uprawnienie, które będzie sprawdzane, jeśli 'required' jest ustawione na 'true'
node: 'sm24.reward.claim'
# Lista komend wykonywanych przez konsolę po pomyślnym odebraniu nagrody.
# Użyj {player} jako placeholder na nick gracza.
commands:
- 'give {player} diamond 1'
- 'eco give {player} 100'
- 'msg {player} &aDziękujemy za oddanie głosu na nasz serwer!'
# Ustawienia powiadomień dla administracji
notifications:
# Czy wysyłać powiadomienia o zniżkach na promowanie po wejściu na serwer?
discounts: true
# Czy wysyłać powiadomienia o dostępnych aktualizacjach pluginu?
updates: true
# =================================================================
# Konfigurowalne wiadomości wysyłane przez plugin
# =================================================================
messages:
# Prefix dodawany na początku większości wiadomości.
prefix: "&8[&6SM24&8] &r"
# Wiadomości ogólne
no-permission: "{prefix}&cNie posiadasz wymaganych uprawnień."
player-only-command: "{prefix}&cTej komendy może użyć tylko gracz."
internal-error: "{prefix}&cWystąpił wewnętrzny błąd. Skontaktuj się z administratorem."
# Wiadomości dla komendy /sm24-nagroda
reward:
on-cooldown: "{prefix}&cMożesz odebrać nagrodę ponownie za &e{seconds} &csekund."
verifying-vote: "{prefix}&aWeryfikujemy Twój głos, proszę czekać..."
api-error: "{prefix}&c{message}" # {message} zostanie zastąpione wiadomością z API
# Wiadomości dla komendy /sm24-glosuj
vote:
fetching-link: "{prefix}&aPobieranie linku do głosowania..."
link-info: "{prefix}&aTwój link do głosowania:" # Link zostanie dołączony w nowej linii
link-success: "{prefix}&aZagłosuj na serwer tutaj -> " # Klikalny link zostanie dołączony po tej wiadomości
# Wiadomości dla komendy /sm24-test
test:
not-op: "{prefix}&cTa komenda jest dostępna tylko dla operatorów serwera."
info: "{prefix}&aUruchomiono testowe przyznawanie nagrody..."
# Wiadomość o błędnym tokenie
invalid-token:
line1: "{prefix}&cBrak poprawnego tokena serwera w konfiguracji!"
line2: "{prefix}&cSzczegóły konfiguracji znajdziesz pod adresem:"
# Link pozostaje w kodzie, ale tekst można edytować
# Wiadomośc reloadu pluginu
reload-success: "{prefix}&aKonfiguracja pluginu została pomyślnie przeładowana!"
# Wiadomości dla komendy edycji /sm24
admin:
invalid-token: "{prefix}&cBłąd autoryzacji. Prawdopodobnie wygenerowano nowy token na stronie. Zaktualizuj config.yml i przeładuj plugin."
rate-limit: "{prefix}&cPrzekroczono limit prób edycji (max 10 na minutę). Spróbuj za chwilę."
update-success: "{prefix}&aDane serwera zaktualizowane pomyślnie!"
api-error: "{prefix}&cWystąpił błąd podczas komunikacji z serwerem."
# =================================================================
# Konfiguracja Systemu Opinii (Review System)
# =================================================================
review-system:
enabled: false
# Lista komend wykonywanych przez konsolę po pomyślnym odebraniu nagrody za opinię.
# Użyj {player} jako placeholder na nick gracza.
rewards:
- 'give {player} diamond_block 5'
- 'eco give {player} 5000'
- 'broadcast &bGracz &f{player} &bzostawil opinie na liscie i odebral nagrode!'
messages:
success: "{prefix}&aTwoja opinia zostala zweryfikowana. Nagroda zostala przyznana!"
not-found: "{prefix}&cOceny nie znaleziono, podano zly nick na stronie lub nagroda zostala juz odebrana."
api-error: "{prefix}&cWystapil blad polaczenia z API. Sprobuj ponownie pozniej."
cooldown: "{prefix}&cMusisz odczekac chwile przed ponownym sprawdzeniem!"
# =================================================================
# Sekcja Pamięci Podręcznej (Cache) - NIE EDYTUJ RĘCZNIE
# =================================================================
# Pamięć podręczna dla linku do głosowania. Nie zmieniaj tych wartości ręcznie.
vote-cache:
# Link do głosowania, automatycznie uzupełniany przez plugin.
link: ''
# Token, który został użyty do wygenerowania powyższego linku.
token: ''

5. Rozwiązywanie Problemów

Plugin nie działa, w konsoli pojawiają się błędy?

Upewnij się, że poprawnie wkleiłeś swój unikalny token serwera do pola server-token w pliku config.yml. Jeżeli zmieniłeś token na stronie (zregenerowałeś go), stary token przestaje działać - musisz podać nowy. Usuń jeszcze token z sekcji cache na samym dole configu. Po zmianach w pliku użyj komendy /sm24 reload.