Pobieranie i instalacja

Oficjalny plugin CraftList.pl-Glosowanie pozwala w prosty sposób zintegrować Twój serwer Minecraft z listą CraftList.pl. Dzięki temu gracze mogą być automatycznie nagradzani za oddane głosy, a Ty zyskujesz większą widoczność swojego serwera.

Pobierz plugin z SpigotMC

Instrukcja instalacji

Aby rozpocząć korzystanie z pluginu, wykonaj poniższe kroki:

• Pobierz najnowszą wersję pluginu z linku powyżej.
• Skopiuj plik CraftList.pl-Glosowanie.jar do folderu /plugins na Twoim serwerze.
• Zrestartuj lub uruchom ponownie serwer, aby plugin się załadował.
• Po pierwszym uruchomieniu w folderze /plugins/CraftList.pl-Glosowanie/ zostanie automatycznie wygenerowany plik config.yml.
• Otwórz plik config.yml i wklej swój unikalny token API serwera (instrukcja poniżej).

Konfiguracja – plik config.yml

Jak zdobyć token API serwera?
Token to unikalny klucz, który łączy Twój serwer z platformą CraftList.pl. Bez niego plugin nie będzie działał poprawnie.

• Zaloguj się na swoje konto na stronie CraftList.pl.
• Wejdź do panelu swojego serwera (link dostępny z głównej strony po zalogowaniu).
• Sprawdź, czy Twój serwer został poprawnie zweryfikowany i przypisany do konta.
• W panelu znajdź pomarańczowy przycisk "API-KEY serwera" i kliknij go.
• W wyświetlonym okienku znajdziesz swój unikalny klucz. Skopiuj go i wklej do pliku config.yml w miejsce TWÓJ_API_KEY.
• Ważne! Nigdy nie udostępniaj swojego API-KEY innym osobom ani publicznie.

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

# =================================================================
#        Konfiguracja pluginu CraftList.pl-Glosowanie
# =================================================================
# Szczegółowy poradnik konfiguracji dostępny na:
# https://CraftList.pl/plugin

# Dostępne komendy dla graczy i operatorów:
#
# /cl-glosuj
#   Aliasy: /glosuj-cl, /cl-vote, /vote-cl
#
# /cl-odbierz
#   Aliasy: /odbierz-cl, /cl-nagroda, /nagroda-cl
#
# /cl-test
#   [!!] Komenda dostępna wyłącznie dla operatorów!
#
# /cl-reload
#   [!!] Komenda dostępna wyłącznie dla operatorów!
#   [!] Alternatywnie wymaga uprawnienia "cl.command.reload"

api:
  # Twój unikalny token serwera ze strony CraftList.pl
  # Nie działa bez poprawnego klucza.
  # Aby skopiować API-KEY znajdz go po lewej stronie w panelu serwera:
  # przycisk "Pobierz plugin".
  api-key: TWÓJ_API_KEY

# =================================================================
#        Ustawienia nagród za głosowanie
# =================================================================
rewards:
  # Czas oczekiwania w sekundach między kolejnym odebraniem nagrody.
  # Minimalny czas to 60 sekund.
  cooldown-seconds: 60
  
  permission:
    # Określa, czy gracz musi posiadać uprawnienie, aby odebrać nagrodę.
    # true  - wymagane
    # false - każdy gracz może odebrać nagrodę
    required: false
    # Uprawnienie sprawdzane, jeśli 'required' jest ustawione na true
    node: cl.reward.odbierz
  
  # Komendy wykonywane przez konsolę po odebraniu nagrody.
  # Użyj {player} lub {gracz} jako placeholdera dla nicku gracza.
  commands:
  - give {player} diamond 1
  - eco give {gracz} 100
  - say {player} Dziękujemy za oddanie głosu na nasz serwer!

# =================================================================
#        Wiadomości wysyłane przez plugin
# =================================================================
messages:
  # Prefix dodawany na początku większości wiadomości
  prefix: '&f&lCraft&9&lList&f.pl &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 /cl-odbierz
  reward:
    on-cooldown: '{prefix}&cMożesz ponownie użyć tej komendy za &9{seconds} &csekund.'
    reward-claimed: '{prefix}&aOdebrałeś już swoją nagrodę, spróbuj jutro.'
  
  # Wiadomości dla komendy /cl-glosuj
  vote:
    link-info: '{prefix}&aTwój link do głosowania:'
    no-vote: '{prefix}&cNie znaleziono głosu do odebrania.'
    time-no: '{prefix}&cGłos jest już nieaktualny.'
  
  # Wiadomości dla komendy /cl-test
  test:
    not-op: '{prefix}&cTa komenda jest dostępna tylko dla operatorów serwera.'
    info: '{prefix}&aUruchomiono testowe przyznawanie nagrody...'
  
  # Wiadomość dla reloadu konfiguracji
  reload-success: '{prefix}&aKonfiguracja pluginu została pomyślnie przeładowana!'

Komendy i Uprawnienia

Plugin dostarcza zestaw komend dla graczy oraz administratorów. Poniżej znajduje się pełna lista wraz z krótkim opisem i wymaganymi uprawnieniami:

---

Rozwiązywanie problemów

• Plugin nie działa lub pojawiają się błędy w konsoli?
  Upewnij się, że w pliku config.yml poprawnie wpisałeś swój unikalny api-key. Błędny lub pusty Api-Key uniemożliwia komunikację z API.
• Zmieniłem konfigurację, ale nic się nie zmieniło.
  Po każdej edycji pliku config.yml użyj komendy /cl-reload, aby przeładować ustawienia bez restartowania serwera.
• Gracze nie mogą odebrać nagrody.
  Sprawdź, czy w config.yml masz aktywowaną opcję wymagania uprawnienia cl.reward.claim. Jeśli tak, upewnij się, że gracze mają przypisane odpowiednie permisje.