🎮 ETP GAMES (Teleturniej Overlay & Admin System)

Kompletny potężny ekosystem do profesjonalnej obsługi interaktywnych teleturniejów na żywo. Aplikacja udostępnia prowadzącemu wielofunkcyjne kontrolery przeglądarkowe (zarządzane przez technologię Socket.IO i silnik Node.js), wyprowadzając jednocześnie zsynchronizowane, płynne plansze overlay dla OBS Studio. System został zaprojektowany w stylu ETP Brutalist (surowy, neonowy akcent #00ffcc).

---

🛠 Instalacja i Uruchomieni

1. Wymagania: Upewnij się, że posiadasz zainstalowane środowisko Node.js.
2. Otwórz terminal w katalogu głównym projektu.
3. Przed pierwszym uruchomieniem wpisz:

   npm install

4. Odpalenie Systemu:

   node server.js

   Możesz również po prostu uruchomić dwuklikiem plik start.bat.

Serwer uaktywni się na lokalnym porcie 3000. Nie musisz zajmować się żadnymi portami sieciowymi u routera, wszystko hula po wirtualnych socketach lokalnie!

---

🎲 3 Główne Tryby Rozgrywki

Aplikacja rozkłada się na 3 kluczowe panele zarządzania dostępne z poziomu nawigacji u góry. Do każdego panelu przypisana jest odpowiednia warstwa graficzna (Overlay) w przeglądarce OBS.

1. Panel Głównego Hosta (Standard Quiz)

Wchodzisz przez: http://localhost:3000/admin.html

• Dodawanie i zarządzenie listą Graczy.
• Przyznawanie "Żyć" i zdobytych Punktów (obsługa ułamków dziesiątnych w locie).
• Czytanie pytań, uruchamianie Ruletki (Przycisk "Wylosuj Osobę") i puszczanie muzyki (Przycisk "Fanfary").
• Skalowanie widoku list.

2. Panel GRID (Zasady Jeopardy)

Wchodzisz przez: http://localhost:3000/grid-admin.html

• Bitwa dwóch drużyn Czerwona vs Niebieska na Siatce wyboru Kategorii z kafelkami.
• Sterowanie nagłówkami, odkrywanie Odpowiedzi pod wybranym boxem na tablicy i rozliczanie nagród (Przydziel Punkty Drużynie X).
• Dynamicznie generowana tabela ze wpiętymi odpowiedziami.

3. Panel FAMILIADY

Wchodzisz przez: http://localhost:3000/familiada-admin.html

• Legendarna gra polegająca na zgadywaniu listy ukrytych wariantów pod jedno hasło!
• Skrzynka Hosta pozwala w locie przyznawać "❌ BŁĘDY", pompować Pulę Punktów z mniejszych odpowiedz oraz przelewać całkowity zysk do salda Lewej albo Prawej dryżyny uderzeniem jednego przycisku!

---

📺 Integracja z Obs Studio (Overlays)

Aby wyprowadzić obraz z serwera bezpośrednio dla widza, w swoim programie strimerskim (np. OBS Studio), utwórz wybrane ujęcie i dodaj nowe źródło typu "Źródło Przeglądarki" (Browser Source):

Nakładki Właściwe Do Trybów

Pamiętaj o włączeniu opcji "Czyste tło / Clear Background"!

• http://localhost:3000/overlay.html?player=ID – Skrypt nakładki pojedynczego gracza nad kamerkę, uwzględniająca życia, nick, team i logikę bloku! Pamiętaj podmienić ID na ten obecny w Panelu z wygenerowanego konta zawodnika. Parametr &bg=off w adresie URL wyłącza szare tło.
• http://localhost:3000/grid-overlay.html oraz grid-overlay-right.html – Puszczenie Siatki Jeopardy na ekran główny.
• http://localhost:3000/familiada-overlay.html – Wywołana tablica zasłoniętych list dla hitowej potyczki i wyświetlania 3 Krzyżyków po kiksach.
• http://localhost:3000/question.html – Dynamiczne wyrzucanie czytanego przez Hosta pytania testowego ABCD na ułamek kranu podczas trwania debaty graczy.

Nakładki Pasyswne (Audio / Animacje)

• http://localhost:3000/audio.html – ZABEZPIECZ BEZPIECZNE AUDIO: Dodaj tylko RAZ. Ukryj obraz tego źródła (oczko) lecz zaznacz "Steruj dźwiękiem przez OBS", dzięki czemu twoje kliknięcia w puszczanie muzyczek typu Win.mp3 czy Death wypuścisz na live płynnie, oddzielnie ściszając je i bez echa na desktopie!!
• http://localhost:3000/title-overlay.html – Przezroczysty zintegrowany napis teleturnieju.

---

📁 Wzorce Pytań – Jak zbudować własną bazę?

Dla bezpieczeństwa, domyślna pula dodanych wpisów nie jest przesyłana na to repozytorium GitHub i jest izolowana lokalnie w twoich zrzutach. Masz za to swobodny wgląd w matryce do układania struktury .json. Twórz własne kolekcje naśladując plik: WZOR_PYTAN_...json z odpowiednich podzespołów.

1. Standardowe (Karty ABCD): Ładuj pliki json ze standardowego szablonu do folderu /Pytania
2. Tablica Kafli (Jeopardy): Ładuj jsony do katalogu /Pytania_Grid
3. Pule Pytań Ukrytych: Zapełniaj strefę w katalogu /Pytania_Familiada

Wrzucaj pliki wizualne (Jeżeli jakieś pytania ich wymagają od prefixa "img:") w gniazdo /public/img_cache/. Jeśli Twoja baza zawiedzie z odnalezieniem zdjęcia z json, algorytm zapamięta je wyrzucając brak do logów missing_images.txt w głównym folderze!

---

(System jest w pełni przygotowany do hostowania turniejów i zaimplementował wszelkie wymagane techniki ochrony danych na dyskach twardych "wspomaganych" w chmurach w razie awarii serwera lokalnego). 🚀