5.4 KiB
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
node server.js
Potom otvor http://localhost:3000. Port je možné zmeniť premennou prostredia PORT.
Alternatívne:
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:
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
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/eventsdo 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 upravssl_certificateassl_certificate_key. http2 on;vyžaduje nginx 1.25.1 alebo novší. Na staršom nginx ten riadok zmaž a použilisten 443 ssl http2;.- Súbor musí byť načítaný v kontexte
http {}(to platí preconf.d/ajsites-enabled/), lebo obsahujelimit_req_zonealimit_conn_zone.
3. Aktualizácia a správa
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 |
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:
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.jsobsahuje karty aj pravidlá a používa ho prehliadač i server.server.jsimplementuje 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). 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.