Discord
Wiki - Pluginy

Plan - analityka i statystyki graczy

Plan (Player Analytics) to darmowy plugin, który zbiera szczegółowe statystyki o aktywności graczy i wydajności serwera. Wyświetla je w czytelnym panelu webowym z wykresami, tabelami i mapami. Niezbędne narzędzie dla administratorów, którzy chcą podejmować decyzje oparte na danych.

Czas czytania: ~5 min Platforma: Paper / Spigot / BungeeCord / Velocity / Fabric / Sponge

Co to jest Plan

Plan (Player Analytics) to darmowy, open-source plugin analityczny dla serwerów Minecraft. Zbiera dane o aktywności graczy, wydajności serwera i użyciu zasobów, a następnie prezentuje je w eleganckim panelu webowym dostępnym z przeglądarki. Plugin jest rozwijany od 2017 roku przez AuroraLS3 i wspiera praktycznie każdą platformę serwerową.

Dlaczego analityka jest ważna? Bez danych administrator podejmuje decyzje na wyczucie. Plan pokazuje, kiedy gracze najczęściej grają, jak długo zostają, ile nowych graczy przychodzi i ilu wraca. Te informacje pozwalają planować eventy, dostosowywać zasoby serwera i identyfikować problemy zanim gracze zaczną odchodzić.

Plan jest dostępny na SpigotMC, Modrinth i GitHub.

Panel webowy

Plan uruchamia wbudowany serwer HTTP na konfigurowalnym porcie (domyślnie 8804). Panel webowy zawiera kilka głównych widoków:

  • Dashboard serwera - przegląd aktywności: gracze online, nowi gracze, TPS, użycie pamięci, dysku, CPU
  • Wykresy aktywności - interaktywne grafy pokazujące liczbę graczy w czasie, z podziałem na godziny, dni, tygodnie
  • Lista graczy - tabela wszystkich graczy z czasem gry, ostatnią wizytą, aktywnością i geolokalizacją
  • Profil gracza - szczegółowe statystyki pojedynczego gracza: sesje, śmierci, zabójstwa, używane komendy
  • Wydajność - wykresy TPS, czasu odpowiedzi serwera, zużycia pamięci i czasu GC (garbage collector)
  • Mapa graczy - geolokalizacja graczy na mapie świata (na podstawie IP)

Panel jest responsywny i działa dobrze na urządzeniach mobilnych. Można go zabezpieczyć hasłem lub certyfikatem SSL przez reverse proxy (nginx/Apache).

Zbierane statystyki

Plan zbiera i analizuje następujące dane:

  • Retencja graczy - ilu graczy wraca po pierwszej wizycie (po 1 dniu, 7 dniach, 30 dniach)
  • Czas gry - łączny i średni czas gry na gracza, rozłożony na sesje
  • Aktywność godzinowa - w których godzinach serwer jest najaktywniejszy
  • TPS i lag - monitorowanie wydajności serwera z historią i alertami
  • Geolokalizacja - skąd łączą się gracze (kraj, kontynent)
  • Komendy - najczęściej używane komendy na serwerze
  • Śmierci i zabójstwa - statystyki PvP i PvE
  • Ekonomia - dane z pluginów ekonomii (Vault)

Dane są przechowywane w SQLite (domyślnie) lub MySQL. Dla sieci serwerów MySQL jest wymagany, aby agregować statystyki ze wszystkich serwerów w jednym panelu.

Komendy

Komenda Co robi Uprawnienie
/plan Wyświetla link do panelu webowego plan.inspect
/plan inspect Gracz Link do profilu gracza plan.inspect
/plan server Link do dashboardu serwera plan.server
/plan network Link do dashboardu sieci (BungeeCord) plan.network
/plan register Rejestracja konta w panelu webowym plan.register
/plan reload Przeładowanie konfiguracji plan.reload

Konfiguracja

Główny plik to plugins/Plan/config.yml. Najważniejsze ustawienia:

# Serwer webowy
Webserver:
  Port: 8804
  Alternative_IP: "twojadomena.pl"  # adres publiczny panelu
  Security:
    SSL_certificate: ""              # ścieżka do certyfikatu SSL

# Baza danych
Database:
  Type: MySQL  # SQLite lub MySQL
  MySQL:
    Host: "localhost"
    Port: 3306
    Database: "plan"
    User: "plan"

# Eksport danych
Export:
  HTML_export: false  # eksport statycznego HTML (dla hostów blokujących porty)

Jeśli hosting blokuje dodatkowe porty, Plan oferuje tryb eksportu HTML - statyczne pliki generowane cyklicznie, które możesz umieścić na dowolnym serwerze WWW.

Integracje z pluginami

Plan automatycznie wykrywa i integruje się z popularnymi pluginami, wzbogacając panel o dodatkowe dane:

  • EssentialsX - dane ekonomii, salda graczy, transakcje
  • LuckPerms - rangi i grupy uprawnień graczy
  • mcMMO - poziomy umiejętności, topki
  • Jobs Reborn - statystyki zawodów graczy
  • Vault - ekonomia i uprawnienia
  • LiteBans / AdvancedBan - historia kar
  • DiscordSRV - integracja z Discordem

Plan to must-have dla każdego poważnego serwera. Darmowy, lekki i dostarczający danych, których nie da się uzyskać w żaden inny sposób. Świetnie uzupełnia się z Spark (profilowanie wydajności).