Plugin LikeCraft

📄 Plik konfiguracyjny

Cała konfiguracja pluginu znajduje się w pliku plugins/LikeCraft/config.yml. Po zmianach użyj /likecraft reload.

# =====================================================
# LikeCraft — konfiguracja pluginu
# Plugin pobiera Top-Serwery v1.4.2
# =====================================================

# Token API z Top-Serwery (zakładka "Moje serwery")
api:
  token: "WSTAW_SWOJ_TOKEN_TUTAJ"
  server-id: 1234              # ID serwera z Top-Serwery
  base-url: "https://top-serwery.pl/api/v1"
  poll-interval: 60            # Co ile sekund sprawdzać nowe głosy
  port: 8765                   # Port dla webhooków (opcjonalnie)

# Blokada wielokrotnego głosowania
cooldown:
  enabled: true
  seconds: 86400               # 24h (1 głos / 24h)
  check-mode: "nick"           # "nick" / "ip" / "both"

# Captcha (wymusza weryfikację na stronie)
require-captcha: true
verify-player-exists: true     # sprawdzaj czy nick istnieje w grze

# Nagrody — możesz zdefiniować dowolną liczbę zestawów
rewards:
  # Domyślny zestaw nagród (dla wszystkich)
  default:
    enabled: true
    chance: 100                # % szans (100 = zawsze)
    commands:
      - "give %player% diamond 5"
      - "eco give %player% 500"
      - "give %player% golden_apple 3"
      - "broadcast &a&l✦ &7%player% &fzagłosował! &7(/glosuj)"

  # VIP — dodatkowa nagroda dla osób z rangą
  vip:
    enabled: true
    permission: "likecraft.vip"
    commands:
      - "give %player% diamond 10"
      - "eco give %player% 1500"
      - "give %player% nether_star 1"

  # Premium — jeszcze więcej dla rangi Premium
  premium:
    enabled: true
    permission: "likecraft.premium"
    commands:
      - "give %player% netherite_ingot 2"
      - "eco give %player% 5000"

  # Losowe nagrody (jedna z poniższych)
  random:
    enabled: true
    chance: 25                 # 25% szans na bonus
    type: "random"             # zamiast wszystkich — losuje jedną
    commands:
      - "give %player% elytra 1"
      - "give %player% diamond_block 5"
      - "give %player% experience_bottle 64"

# Co X-ty głos = mega bonus
milestone:
  enabled: true
  every-votes: 10              # co 10. głos gracza
  commands:
    - "give %player% diamond_block 1"
    - "eco give %player% 5000"
    - "broadcast &6&l✦ &7%player% &foddał już %votes% głosów! &6Mega bonus!"

# Co dzieje się gdy gracz głosuje offline
offline-rewards:
  enabled: true                # zapamiętuje głos do odebrania
  notify-on-join: true         # informuj o czekających nagrodach
  claim-command: "odbierz"     # /odbierz

# Komunikaty
messages:
  prefix: "&7[&aLikeCraft&7] "
  vote-success: "&a✓ Dziękujemy za głos! Odebrałeś nagrodę."
  vote-pending: "&eMasz &f%count% &eczekających nagród. Użyj &6/odbierz"
  cooldown-active: "&cMożesz głosować ponownie za &f%time%&c."
  not-online: "&c%player% nie jest online — nagroda zapisana."
  reload-success: "&aPlugin przeładowany."

# Akcje przy udanym głosie (dodatkowe efekty)
effects:
  sound:
    enabled: true
    name: "ENTITY_PLAYER_LEVELUP"
    volume: 1.0
    pitch: 1.0
  particles:
    enabled: true
    type: "TOTEM"
    count: 50
  firework: true
  title:
    enabled: true
    title: "&a&l✦ DZIĘKUJEMY!"
    subtitle: "&7Twoja nagroda czeka w ekwipunku"

# Hook do innych pluginów
hooks:
  vault: true                  # eco/permisje
  placeholderapi: true         # %likecraft_votes% itp.
  discord-webhook: ""          # URL webhooka Discord (opcjonalnie)

⌨️ Komendy

• /odbierz — odbierz czekające nagrody za głosy
• /glosy — pokaż liczbę swoich głosów i kiedy następny
• /top — top 10 graczy z największą liczbą głosów
• /glosuj — link do strony głosowania na Top-Serwery
• /likecraft reload — przeładuj konfigurację (admin)
• /likecraft give <gracz> — ręcznie wydaj nagrodę (admin)
• /likecraft stats — statystyki pluginu (admin)

🔑 Uprawnienia

• likecraft.vote — możliwość głosowania (default: true)
• likecraft.vip — odbiera nagrody VIP
• likecraft.premium — odbiera nagrody Premium
• likecraft.admin — pełne uprawnienia administracyjne

📝 Placeholdery

W komendach nagród i komunikatach możesz używać:

• %player% — nick gracza
• %votes% — łączna liczba głosów gracza
• %vote_streak% — passa głosów (dni z rzędu)
• %time% — czas do następnego głosu (np. "23h 12m")
• %server% — nazwa serwera

PlaceholderAPI

Jeśli masz PAPI, możesz używać tych placeholderów w innych pluginach:

• %likecraft_votes%
• %likecraft_streak%
• %likecraft_rank% — miejsce w rankingu top głosujących
• %likecraft_next_vote%

🔌 REST API

Plugin udostępnia lokalny endpoint HTTP do integracji z własnymi systemami:

GET  /api/v1/votes/:player    # liczba głosów gracza
GET  /api/v1/top              # top 10 głosujących
POST /api/v1/vote             # ręcznie zarejestruj głos
     body: { player: "Steve", source: "manual" }
POST /api/v1/reward/:player   # wydaj nagrodę bez głosowania

Endpoint wymaga nagłówka Authorization: Bearer YOUR_TOKEN.

❓ FAQ

Czy plugin jest darmowy?

Tak — w pełni bezpłatny, open-source. Bez ograniczeń liczby graczy ani serwerów.

Czy wymaga premium account?

Nie. Plugin sprawdza tylko, czy gracz o danym nicku istnieje na serwerze (lub istniał — można konfigurować).

Co jeśli mam network (BungeeCord / Velocity)?

Wrzuć plugin na każdy backend serwer. Plugin używa wspólnej bazy SQLite/MySQL — głosy synchronizują się między serwerami.

Czy działa na 1.8?

Tak! Plugin jest kompatybilny z wersjami 1.8.x — 1.21.4.

Jak zgłosić błąd?

Otwórz zgłoszenie na GitHubie albo napisz na e-mail support@top-serwery.pl.