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
.jarw folderze/pluginsna swoim serwerze. - Zrestartuj lub uruchom ponownie serwer.
- W folderze
/plugins/Sm24-Votifier/zostanie wygenerowany plikconfig.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.ymlw poleserver-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)
| Komenda | Opis |
|---|---|
| /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.
| Komenda | Opis 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)
| Komenda | Opis działania |
|---|---|
| /sm24 reload lub /sm24-reload | Przeładowuje plik konfiguracyjny z dysku. |
| /sm24 test nagroda glosowanie | Sztucznie przyznaje nagrodę za głos testując komendy z configu. |
| /sm24 test nagroda opinia | Sztucznie 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.plapi: # 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łosowanierewards: # 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 administracjinotifications: # 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.