Radar premier i darmowych gier (/radar i /radar.ics)

Źródło: repo afterlife/docs/narzedzia/radar-rp.md — edytuj w repo, nie tutaj.

Krrrg... Czas wokół cudzych gwiazd płynie nierówno, a wydarzenia w odległych światach pojawiają się i gasną, zanim nieuważny Adept zdąży podnieść wzrok. Aby żadne ważne otwarcie wrót, darmowa gra ani wydarzenie społeczności nie umknęło waszej uwadze, pod adresem https://ariku.pl/radar uruchomiono Radar. Zapisujemy zasady jego działania.

◈ Czym jest Radar i co odsiewa

Radar to publiczny terminal wczesnego ostrzegania dostępny na stronie https://ariku.pl/radar. Kolektor nie gromadzi w nim przypadkowego szumu — każdy wpis przechodzi ocenę i tylko wydarzenia z wysokim wynikiem trafiają na tablicę, podczas gdy reszta odpada.

Strona jest w pełni renderowana po stronie serwera, co oznacza, że działa nawet bez włączonej obsługi skryptów w przeglądarce, a filtry na żywo pozwalają zawęzić widok według dwóch wymiarów:

1. Filtr konkretnej gry (każda gra) — pozwala wyświetlić wpisy przypisane wyłącznie do wybranego tytułu.
2. Filtr kategorii (Typ) — dzieli sygnały na osiem rozpoznawanych grup w kodzie (RadarPublic.tsx):

Klucz kategorii w kodzie	Znaczenie wpisu na Radarze
free_game	Darmowe gry do odebrania na stałe (m.in. z Epic Games Store oraz Steam)
deal	Gorące promocje i wysokie obniżki cenowe na wybrane tytuły
game_event	Wydarzenia wewnątrz gier, nowe sezony, duże aktualizacje i premiery
maintenance	Zaplanowane przerwy techniczne i konserwacje serwerów
code	Aktywne kody promocyjne na waluty i przedmioty w grach (łatwe do skopiowania jednym kliknięciem)
news	Ważne ogłoszenia i wiadomości ze świata gier
music	Premiery ścieżek dźwiękowych, koncerty i wydania muzyczne
convention	Konwenty, targi i spotkania społeczności

✦ Trzy koszyki osi czasu

Każde wydarzenie na Radarze posiada dokładne znaczniki czasu w strefie Europe/Warsaw i zostaje przyporządkowane do jednej z trzech sekcji terminalowych:

• $ cat radar/now (// teraz) — wydarzenia, promocje i darmowe gry trwające w tej właśnie chwili, które wymagają reakcji, zanim wygasną.
• $ cat radar/week (// ten tydzień) — premiery, przerwy techniczne i wydarzenia rozpoczynające się w ciągu najbliższych siedmiu dni.
• $ cat radar/later (// nadchodzi) — potwierdzone daty w dalszej przyszłości, na które warto przygotować miejsce w pamięci.

◈ Subskrypcja kalendarza iCal (/radar.ics)

Nie musicie odwiedzać strony codziennie, aby zachować czujność. W prawym górnym rogu widoku /radar znajduje się przycisk odsyłający do pliku https://ariku.pl/radar.ics. Jest to żywy strumień kalendarza w standardzie iCalendar:

1. Google Calendar (przeglądarka) — wybierz w menu bocznym „Inne kalendarze” → „Z adresu URL” i wklej adres https://ariku.pl/radar.ics.
2. Apple Calendar (macOS / iOS) — wybierz „Plik” → „Nowa subskrypcja kalendarza” (lub „Konta” → „Subskrybowane kalendarze” w telefonie) i podaj ten sam adres.
3. Mozilla Thunderbird / aplikacje desktopowe — utwórz nowy kalendarz sieciowy w formacie iCalendar (ICS) wskazujący na https://ariku.pl/radar.ics.

Od tej chwili terminy darmowych gier, wydarzeń i konwentów będą odświeżać się w waszym kalendarzu automatycznie, bez potrzeby ręcznego importowania plików. Równolegle najważniejsze sygnały z Radaru są rozsyłane na dedykowane kanały powiadomień na naszym Discordzie.

◈ Śledzenie repozytoriów GitHub i Forgejo (panel dla Majstra i Adminów)

Krrrg... Poza grami i konwentami Radar śledzi również nowe wydania (releases) oraz aktywność wybranych repozytoriów oprogramowania i narzędzi dla graczy (np. narzędzi upscalingu na kartach AMD Radeon: lonewolf0622/HelixSR, zgauthier2000/fsr4-shader-performance-overrides, countervolts/d4r, optiscaler/OptiScaler, countervolts/x4r, a także projektów z naszej lokalnej instancji Forgejo na https://git.ariku.pl).

Gdy na stronę https://ariku.pl/radar wejdzie zalogowany przez Discorda Majster (isOwner) lub opiekun posiadający rolę Admina / operatora gier na naszym serwerze Discord, na dole widoku otwiera się dodatkowa sekcja terminalowa $ cat radar/repos // śledzone repozytoria:

1. Dodawanie repozytorium (POST /api/radar/repos) — wystarczy wkleić skrót owner/repo (domyślnie GitHub), pełny link https://github.com/owner/repo albo adres z naszej instancji https://git.ariku.pl/owner/repo (lub codeberg.org), opcjonalnie nadać własną etykietę i zaznaczyć opcję „+ commity (gdy brak wydań)” dla świeżych projektów, które nie publikują jeszcze oficjalnych paczek Releases.
2. Wstrzymywanie i usuwanie (POST / DELETE /api/radar/repos) — każde repozytorium na liście można jednym kliknięciem tymczasowo wstrzymać (wstrzymaj / wznów) lub całkowicie usunąć ze śledzenia.
3. Automatyczny obieg — cykliczny zegar Radaru pobiera listę aktywnych repozytoriów (GET /api/internal/radar) i sprawdza kanały Atom wydań (GitHub) oraz API Releases (Forgejo). Każde nowe wydanie pojawia się na tablicy /radar w kategorii news z żółtym oznaczeniem repozytorium obok tytułu oraz trafia na kanał powiadomień Discorda.

Odnotowujemy, że Radar klasyfikuje wydarzenia w 8 odrębnych kategoriach (free_game, deal, game_event, maintenance, code, news, music, convention) podzielonych na 3 przedziały czasowe (now, week, later), a opiekunowie Warsztatu mogą samodzielnie dopisywać nowe repozytoria do obserwacji. Czy dopisaliście już strumień /radar.ics do swoich ksiąg czasu, czy pozwolicie, aby darmowe światy i nowe wydania przeminęły niezauważone?