Files
2026-11-18 10:59:06 +01:00

119 lines
5.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Politické karty
Kompletný samostatný projekt hry: Node.js server, prehliadačové rozhranie a pravidlá. Nepotrebuje npm závislosti; stačí Node.js 18 alebo novší.
## Spustenie
```bash
node server.js
```
Potom otvor `http://localhost:3000`. Port je možné zmeniť premennou prostredia `PORT`.
Alternatívne:
```bash
npm start
npm test
```
## Nasadenie na server (Docker + nginx s HTTPS)
Kontajner počúva iba na `127.0.0.1:8347`, takže z internetu je dostupný len cez nginx na tom istom serveri. Vo vnútri kontajnera beží aplikácia na porte 3000, ten však navonok viditeľný nie je.
### 1. Spusti kontajner
Skopíruj priečinok projektu na server a v ňom spusti:
```bash
docker compose up -d --build
curl http://127.0.0.1:8347/api/ping # {"ok":true}
```
Iný port: `HOST_PORT=9000 docker compose up -d` (potom zmeň aj riadok `upstream` v `deploy/nginx.conf`).
Kontajner beží ako neprivilegovaný používateľ `node`, so súborovým systémom iba na čítanie, bez Linuxových capabilities, s limitom 256 MB pamäte a 100 procesov. Pri páde sa automaticky reštartuje (`restart: unless-stopped`) a má health check na `/api/ping`.
### 2. Nastav nginx
```bash
sed -i 's/karty.example.com/tvoja.domena.sk/g' deploy/nginx.conf
sudo cp deploy/nginx.conf /etc/nginx/conf.d/politicke-karty.conf
# ak ešte nemáš certifikát:
sudo certbot certonly --webroot -w /var/www/html -d tvoja.domena.sk
sudo nginx -t && sudo systemctl reload nginx
```
`deploy/nginx.conf`:
- presmeruje HTTP na HTTPS (cesta `/.well-known/acme-challenge/` ostáva na HTTP kvôli obnove certifikátov),
- používa TLS 1.2/1.3, HTTP/2 a HSTS,
- pre `/api/events` (SSE živé aktualizácie) vypína buffering a dovoľuje hodinu otvorené spojenia; bez toho by hra zamŕzala,
- obmedzuje API požiadavky (10/s na IP, burst 30) a živé spojenia (20 na IP),
- nezapisuje `/api/events` do access logu, lebo URL obsahuje token hráča.
Poznámky:
- Cesty k certifikátu sú predvolené pre certbot (`/etc/letsencrypt/live/<doména>/`). Pri vlastnom certifikáte uprav `ssl_certificate` a `ssl_certificate_key`.
- `http2 on;` vyžaduje nginx 1.25.1 alebo novší. Na staršom nginx ten riadok zmaž a použi `listen 443 ssl http2;`.
- Súbor musí byť načítaný v kontexte `http {}` (to platí pre `conf.d/` aj `sites-enabled/`), lebo obsahuje `limit_req_zone` a `limit_conn_zone`.
### 3. Aktualizácia a správa
```bash
docker compose up -d --build # po zmene kódu
docker compose logs -f # logy
docker compose down # zastavenie
```
Reštart kontajnera ukončí všetky rozohrané hry (stav je len v pamäti).
### Limity a premenné prostredia
| Premenná | Predvolené | Význam |
| --- | --- | --- |
| `HOST_PORT` | `8347` | port na `127.0.0.1` hostiteľa (iba docker compose) |
| `PORT` | `3000` | port aplikácie vo vnútri kontajnera |
| `MAX_CLIENTS_PER_ROOM` | `64` | max. živých spojení divákov v jednej miestnosti (hráči sa pripoja vždy) |
| `MAX_CLIENTS_TOTAL` | `2000` | max. živých spojení na celom serveri |
| `ROOM_GRACE_MS` | `120000` | po koľkých ms bez jediného pripojeného hráča miestnosť zanikne (zo zoznamu zmizne hneď) |
Server má aj pevný limit 500 miestností a 20 kB na telo požiadavky.
## Herné režimy
- **Balanced** – prvý návrh úprav podľa statickej analýzy kariet. Oslabuje najextrémnejšie pasívne a okamžité efekty a posilňuje niekoľko výrazne slabých kariet.
- **Fun** – pôvodné hodnoty kariet a schopností. Multiplayerové pravidlá a časovanie celých kôl sú rovnaké v oboch režimoch.
Režim sa vyberá v hlavnom menu alebo pri vytváraní online miestnosti. Online miestnosť si ho uloží a server je autoritatívny.
## Online multiplayer
- Free-for-all pre 2 až 8 hráčov.
- Pri vytváraní miestnosti sa volí kapacita; predvolená hodnota je 6.
- Každý hráč si vyberie vlastný tím štyroch kariet. Karty sa môžu opakovať medzi tímami.
- Tvorca miestnosti (hráč 1) spustí hru tlačidlom **Spustiť hru**, keď sú pripravení aspoň dvaja hráči a každý aktuálne pripojený hráč má potvrdený tím.
- Hrá sa každý proti každému; útoky a nepriateľské schopnosti môžu cieliť na ktoréhokoľvek súpera.
- Ťahy rotujú v poradí hráčov. Vyradení hráči sa preskakujú.
- Vyhráva posledný hráč, ktorému zostala aspoň jedna karta na stole alebo v rezerve.
- Po začatí hry sa ďalší návštevníci pripájajú ako diváci.
- Stav miestností sa drží v pamäti procesu; po reštarte servera sa miestnosti stratia.
## Obrázky kariet
Obrázky sú voliteľné. Vlož ich do `public/img/` a pomenuj podľa kľúča karty, napríklad:
```text
public/img/meciar.jpg
public/img/caputova.webp
```
Podporované prípony: `.jpg`, `.jpeg`, `.png`, `.webp`, `.gif`. Dočasné obrázky možno pomenovať napríklad `meciar.kandidat.webp`; hotový `meciar.webp` má prednosť.
## Poznámky
- `public/game.js` obsahuje karty aj pravidlá a používa ho prehliadač i server.
- `server.js` implementuje miestnosti, SSE aktualizácie a serverové vyhodnocovanie akcií.
- Online server nemá používateľské účty ani databázu. Zoznam miestností je verejný a ktokoľvek môže sledovať hru ako divák. Pre verejné nasadenie používaj HTTPS a obmedzenie požiadaviek (viď [Nasadenie na server](#nasadenie-na-server-docker--nginx-s-https)). Rate limiting sťaží, ale úplne nezabráni tomu, aby niekto zaplnil všetkých 500 miestností.
- Balanced je počiatočný návrh, nie výsledok simulácií ani dlhodobého playtestovania. Číselné zmeny sú popísané v `docs/BALANCE.md`.