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

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

![Cztery płomienie nad Kowadłem](https://wiki.ariku.pl/uploads/images/gallery/2026-10/kowadlo-cztery-iskry.png)

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 i rozróżnianie kanałów po kontekście** — 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. Przy wysyłce na Discorda Radar rozróżnia wiadomości po kontekście (`isTechNewsContext`): wydania z repozytoriów oraz wieści techniczne (narzędzia, upscalery, sterowniki, Linux/Proton, homelab) trafiają na **`#tech-news`**, ogłoszenia z konkretnych gier na **`#games-news`** (lub kanał danej gry), a ogólne wiadomości społecznościowe na **`#news`**.

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?