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:
- Filtr konkretnej gry (
każda gra) — pozwala wyświetlić wpisy przypisane wyłącznie do wybranego tytułu. - 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:
- Google Calendar (przeglądarka) — wybierz w menu bocznym „Inne kalendarze” → „Z adresu URL” i wklej adres
https://ariku.pl/radar.ics. - Apple Calendar (macOS / iOS) — wybierz „Plik” → „Nowa subskrypcja kalendarza” (lub „Konta” → „Subskrybowane kalendarze” w telefonie) i podaj ten sam adres.
- 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:
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.
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.
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?