Routing Komend – Network Shop Creepia

Routing to mechanizm decydujący, na który serwer (Worker) zostanie wysłana komenda po zakupie produktu. Każda komenda przypisana do produktu ma własną strategię routingu — produkty w jednym zamówieniu mogą trafiać do różnych serwerów jednocześnie.

Strategie routingu

DIRECT_TO_SERVER

Administrator wybiera konkretny serwer z listy Workers jako cel dostarczenia komendy. Komenda zawsze trafia na ten serwer, niezależnie od tego, gdzie aktualnie przebywa gracz.

Zakup → Creepia API → Redis → Master (Proxy) → Worker "skyblock" → komenda

Kiedy używać:

• Klucze skrzyń przypisane do konkretnego trybu gry
• Wirtualna waluta per-server (np. monety Skyblock)
• Itemy specyficzne dla danego serwera
• Dowolny produkt, który ma sens tylko na jednym, wybranym serwerze

Konfiguracja w edytorze produktu:

Komenda: [eco give {player} 1000            ]
Routing: [DIRECT_TO_SERVER ▾]  Serwer: [Skyblock ▾]

Administrator wybiera serwer z rozwijanej listy wszystkich Workers w sieci.

BROADCAST

Komenda jest wysyłana do każdego aktywnego Workera w sieci jednocześnie.

Zakup → Creepia API → Redis → Master → Worker "skyblock" → komenda
                                     → Worker "survival" → komenda
                                     → Worker "creative" → komenda

Kiedy używać:

• Rangi globalne (LuckPerms, PermissionsEx)
• Unbany / czas gry
• Ogłoszenia widoczne na wszystkich serwerach
• Fundusze premiowe dostępne wszędzie

Konfiguracja:

Komenda: [lp user {player} parent set vip   ]
Routing: [BROADCAST ▾]

PLAYER_SERVER

Komenda trafia na serwer, na którym aktualnie przebywa gracz w chwili zakupu.

Zakup → Creepia API → Redis → Master (sprawdza gdzie jest gracz) → odpowiedni Worker

Kiedy używać:

• Natychmiastowe nagrody do ekwipunku (give {player} ...)
• Efekty i boosters aktywowane na bieżącej lokalizacji gracza
• Produkty "wherever you are"

Gracz offline? Master zapisuje komendę do CentralPendingStore. Komenda zostanie dostarczona automatycznie gdy gracz dołączy do dowolnego serwera w sieci.

Unified Cart — wiele strategii w jednym zamówieniu

Gracz może dodać do koszyka produkty z różnymi strategiami routingu i opłacić je w jednej transakcji:

┌──────────────────────────────────────────────┐
│  🛒 Koszyk                                   │
│                                              │
│  [GLOBAL] Ranga VIP           49,99 PLN      │
│  [SKYBLOCK] 10x Klucz Skrzyni  9,99 PLN      │
│  [SURVIVAL] Zestaw Startowy    4,99 PLN      │
│                                              │
│  Suma: 64,97 PLN       [Zapłać]              │
└──────────────────────────────────────────────┘

Po płatności backend tworzy jedno zamówienie, a DeliveryService rozdziela komendy do odpowiednich kolejek Workers automatycznie.

Obsługa offline Workers

Jeśli docelowy Worker jest w momencie zakupu offline:

1. Master zapisuje komendę do CentralPendingStore (plik JSON na dysku Proxy, odporny na restarty).
2. Gdy Worker wróci online i gracz dołączy — Master automatycznie dostarczy zaległe komendy.
3. Komendy wygasają domyślnie po 30 dniach.

Deduplication

Każda komenda posiada unikalny deliveryId (UUID). Worker przechowuje wykonane ID w lokalnym cache (LRU, persist na dysk). Duplikaty — np. po restarcie Mastera — są automatycznie ignorowane.

Następny krok: Zarządzanie Workerami