Konfiguracja Pluginu Sm24-Votifier

Kompletny poradnik, jak zainstalować i skonfigurować nasz plugin do głosowania.

Pobieranie i Instalacja

Nasz oficjalny plugin do głosowania pozwala na integrację Twojego serwera Minecraft z listą SerweryMinecraft24.pl, umożliwiając automatyczne nagradzanie graczy za oddane głosy.

Instrukcja instalacji:

  1. Pobierz najnowszą wersję pluginu z linku powyżej.
  2. Umieść pobrany plik Sm24-Votifier-x.x.x.jar w folderze /plugins na swoim serwerze.
  3. Zrestartuj lub uruchom ponownie serwer.
  4. Po pierwszym uruchomieniu w folderze /plugins/Sm24-Votifier/ zostanie wygenerowany plik config.yml.
  5. Otwórz wygenerowany plik i wklej swój unikalny token serwera (poniżej instrukcja, jak go zdobyć).

Konfiguracja pliku config.yml

Jak zdobyć Token Serwera?

Token jest kluczem, który łączy Twój serwer z naszą stroną. Aby go pozyskać, postępuj zgodnie z poniższymi krokami:

  1. Zaloguj się na swoje konto na stronie serweryminecraft24.pl.
  2. Przejdź do panelu zarządzania swoim serwerem i wejdź w opcje edycji.
  3. Upewnij się, że Twój serwer jest zweryfikowany i poprawnie przypisany do Twojego konta.
  4. W panelu edycji znajdź i kliknij przycisk o nazwie "Pobierz plugin".
  5. W okienku, które się pojawi, znajdziesz swój unikalny token. Skopiuj go i wklej do pliku config.yml w miejsce 'tutaj_wpisz_token'.

Pełna zawartość domyślnego pliku konfiguracyjnego:

# =================================================================
# Konfiguracja pluginu Sm24-Votifier
# =================================================================
# 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!'
# To pole zostanie uzupełnione automatycznie przez plugin po pierwszym użyciu /sm24-glosuj.
# Nie zmieniaj go ręcznie.
cached-vote-link: ''
# =================================================================
# Konfigurowalne wiadomości wysyłane przez plugin
# =================================================================
messages:
prefix: "&8[&6SM24&8] &r"
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."
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}"
vote:
fetching-link: "{prefix}&aPobieranie linku do głosowania..."
link-info: "{prefix}&aTwój link do głosowania:"
link-success: "{prefix}&aZagłosuj na serwer tutaj -> "
test:
not-op: "{prefix}&cTa komenda jest dostępna tylko dla operatorów serwera."
info: "{prefix}&aUruchomiono testowe przyznawanie nagrody..."
invalid-token:
line1: "{prefix}&cBrak poprawnego tokena serwera w konfiguracji!"
line2: "{prefix}&cSzczegóły konfiguracji znajdziesz pod adresem:"
reload-success: "{prefix}&aKonfiguracja pluginu została pomyślnie przeładowana!"

Komendy i Uprawnienia

Plugin dodaje kilka komend administracyjnych i dla graczy. Poniżej znajduje się ich lista wraz z wymaganymi uprawnieniami.

KomendaOpisUprawnienie
/sm24-glosujWyświetla graczowi jego unikalny link do głosowania.Brak
/sm24-nagrodaPozwala graczowi odebrać nagrodę za oddany głos.sm24.reward.claim (jeśli włączone w configu)
/sm24-testTestuje przyznawanie nagród (bez weryfikacji głosu).Wymagane uprawnienia operatora (OP).
/sm24-reloadPrzeładowuje konfigurację pluginu z pliku config.yml.sm24.command.reload

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. Pamiętaj, aby po każdej zmianie w konfiguracji użyć komendy /sm24-reload.