Zarządzanie Workerami – Network Shop Creepia

Worker to każdy serwer gry (Paper/Spigot) podłączony do sieci Creepia. Workerami zarządzasz w panelu Creepia w zakładce Integracja → Workers — bez potrzeby edytowania plików konfiguracyjnych.

Auto-Discovery — serwery wykrywają się same

Zamiast ręcznie wpisywać listę serwerów, Creepia czyta konfigurację Twojego Proxy bezpośrednio i buduje listę Workers automatycznie.

Velocity (velocity.toml):

[servers]
  skyblock = "127.0.0.1:25566"
  survival = "127.0.0.1:25567"
  creative = "127.0.0.1:25568"

BungeeCord (config.yml):

servers:
  skyblock:
    address: 127.0.0.1:25566
  survival:
    address: 127.0.0.1:25567

Po wykonaniu /creepia auth <token> na Proxy, lista serwerów z powyższych plików trafia automatycznie do Creepia. Administratorzy nie konfigurują niczego ręcznie po stronie pluginu.

Statusy Workers

Każdy Worker ma jeden z dwóch statusów:

Status jest odświeżany co 60 sekund przez NetworkHeartbeatService na Masterze. W panelu Creepia widoczny jako zielony lub szary węzeł na Topology Map.

Topology Map

Sekcja Network Dashboard w panelu administratora zawiera wizualizację grafu sieci:

         🌐 Proxy (Master)
        /         |        \
   ⛏️ Skyblock  🌲 Survival  🎨 Creative
   🟢 1.2k     🟢 847       🟡 12

Węzły kolorowane według statusu:

• Zielony — serwer online z aktywnymi graczami
• Żółty — serwer online, brak graczy
• Szary — serwer offline

Liczba graczy na każdym węźle pochodzi z ostatniego heartbeatu i odświeżana jest co 60 sekund.

Konfiguracja Workers

Po auto-discovery możesz edytować każdy Worker w panelu Creepia:

Pola konfiguracyjne

Jak edytować

1. Przejdź do Panel admina → Integracja → Workers
2. Kliknij ikonę ołówka przy wybranym serwerze
3. Zaktualizuj pola i zapisz

Zmiany są natychmiastowe — nie wymagają restartu pluginu.

Network Portal — widok gracza

Gracz odwiedzający Twój sklep sieciowy zobaczy Network Portal — landing page z kafelkami serwerów:

┌───────────────────────────────────────────────────────┐
│  🌐 Sieć XYZ — Sklep Premium                          │
│                                                       │
│  ┌─────────────────────────────────────────────────┐  │
│  │  GLOBALNY SKLEP SIECI                           │  │
│  │  Rangi • Unbany • Pakiety VIP                   │  │
│  └─────────────────────────────────────────────────┘  │
│                                                       │
│  Wybierz serwer:                                      │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐            │
│  │ Skyblock │  │ Survival │  │ Creative │            │
│  │ 🟢 1.2k  │  │ 🟢  847  │  │ 🟡  12   │            │
│  └──────────┘  └──────────┘  └──────────┘            │
└───────────────────────────────────────────────────────┘

Liczba graczy jest pobierana z API w czasie rzeczywistym (polling co 60s).

Sub-sklep serwera

Kliknięcie w kafelek Skyblock otwiera sub-sklep (sklep.twojasiec.pl/server/skyblock) z produktami dostępnymi dla tego serwera:

• Produkty z routingiem DIRECT_TO_SERVER=skyblock
• Produkty z routingiem BROADCAST i PLAYER_SERVER (dostępne wszędzie)

Heartbeat Sieci

Co 60 sekund Master wysyła do Redis zagregowany heartbeat dla całej sieci:

{
  "workers": [
    { "id": "skyblock", "status": "ONLINE", "players": 1243 },
    { "id": "survival", "status": "ONLINE", "players": 847 },
    { "id": "creative", "status": "OFFLINE", "players": 0 }
  ],
  "totalPlayers": 2090,
  "timestamp": 1718000000
}

Backend odczytuje te dane do:

• Wyświetlania statusów na Topology Map
• Liczby graczy w Network Portal
• Statystyk w Network Dashboard (wykres aktywności per serwer)

Troubleshooting

Worker pojawia się jako OFFLINE mimo że serwer działa

1. Sprawdź czy CreepiaBridge.jar jest zainstalowany na tym serwerze gry.
2. Sprawdź logi serwera gry — Worker powinien zalogować [CreepiaBridge] Worker Mode — handshake received.
3. Sprawdź czy serwer gry jest w konfiguracji Proxy (velocity.toml / config.yml).
4. Wykonaj /creepia status na Proxy — pokaże listę Workers z ich statusem handshake.

Komendy nie docierają do Workera

1. Sprawdź czy Worker jest ONLINE w panelu.
2. Sprawdź Plugin Message Channel — Worker musi być podłączony do Proxy przed dostarczeniem.
3. Komendy dla offline Workers są w kolejce CentralPendingStore — zostaną dostarczone gdy serwer wróci.

Po restarcie Proxy — Workers nie widzą Mastera

Wykonaj ponownie /creepia auth <token> na Proxy lub /creepia reload. Master wyśle nowy Handshake do Workers.