Serwis gier klasowych

Uruchamianie serwisu i panel nauczyciela

Przed pierwszą lekcją (raz)

cd ~/Dokumenty/moje_projekty/panstwa_miasta
npm install
sudo ufw allow 3000/tcp     # bez tego uczniowie się nie połączą

Port musi się zgadzać z tym, na którym stoi serwis. Domyślnie to 3000, ale jeśli zajmuje go inny program, wpisz własny do pliku .env w katalogu projektu i otwórz ten numer:

echo 'PORT=3003' >> .env
sudo ufw allow 3003/tcp

Szybkie sprawdzenie przed lekcją (opcjonalne)

npm test

Rozgrywa sztuczne mecze we wszystkich pięciu grach i sprawdza panel. Ma wypisać same „✓" i 0 niezaliczone. Testy piszą do katalogu tymczasowego — ranking uczniów jest bezpieczny.

Start gry (za każdym razem)

cd ~/Dokumenty/moje_projekty/panstwa_miasta
set -x ADMIN_PASSWORD twoje-wlasne-haslo
node server.js

Serwer wypisze adresy — podaj uczniom ten z numerem IP:

  Ty:        http://localhost:3000
  Uczniowie: http://192.168.100.117:3000      <-- ten na tablicę
  Panel nauczyciela: http://localhost:3000/admin.html
  Gry: Państwa-Miasta, Statki, Warcaby, Łamacz kodu, Jedynka

Nie zamykaj terminala podczas lekcji — zamknięcie kończy grę wszystkim. Zatrzymanie gry: Ctrl+C w tym terminalu.

Czasem przy starcie pojawi się wiersz [NICKI] Zwolniono … nicków — to normalne sprzątanie nicków nieużywanych dłużej niż miesiąc.

Panel nauczyciela — /admin.html

Panel ma zakładki: Na żywo (wspólna dla wszystkich gier) oraz po jednej zakładce na każdą grę.

Liczba przy nazwie zakładki mówi, ile rzeczy czeka na Twoją decyzję — przy Państwach-Miastach to słowa w kolejce. Zmiany zasad działają od następnego meczu i nie przerywają trwających.

Po 30 nieudanych próbach hasła z jednego komputera panel blokuje ten komputer na 5 minut. Ciebie to nie dotknie — liczone jest osobno dla każdego adresu.

Ranking i sezony

Ranking jest prowadzony osobno dla każdej gry, a gracze widzą wyniki bieżącego sezonu. Domyślnie sezon trwa tydzień i zaczyna się w poniedziałek — wtedy wszyscy startują od zera. Okres zmienisz w panelu, zakładka Na żywo → Sezon rankingu: tydzień, miesiąc albo bez resetu.

Po co to: przy jednym rankingu na zawsze uczeń, który dołączy w listopadzie, nie dogoni czołówki bez maratonu. Sezon co tydzień daje wszystkim świeży start, a na stronie głównej zostaje galeria zwycięzców — po jednym wierszu na sezon, żeby było o co grać na dłużej.

Gdy uczniowie wpisują byle co

Domyślnie gra przyjmuje każde słowo na właściwą literę — słownik służy tylko do oznaczania „nie na liście", żeby przeciwnik mógł je zakwestionować. Jeśli klasa zaczyna to wykorzystywać, włącz Tryb ścisły (zakładka Państwa-Miasta → Zasady gry). Wtedy słowo, którego nie ma w słowniku kategorii, daje 0 punktów, a uczeń widzi dlaczego.

Odrzucone słowa nadal trafiają do kolejki, więc jeśli gra nie znała poprawnego wyrazu, zatwierdzasz go jednym kliknięciem i od następnej partii liczy się normalnie.

Słownik ma obecnie około 6900 słów w 12 kategoriach. Najuboższe kategorie widzisz pod przełącznikiem trybu ścisłego — warto tam zajrzeć, zanim go włączysz.

Odświeżenie słownika

Przy podłączonym internecie, w katalogu projektu:

npm run slowniki

Pobiera aktualne listy państw, miast, imion, zawodów, sportów, kolorów i marek z Wikidanych (dane na licencji CC0, wolno ich używać). Potem uruchom serwer ponownie. Gra nigdy nie łączy się z internetem sama — to osobne narzędzie, więc w sali wszystko działa bez sieci jak dotąd.

Wystawienie gier w internecie

Pełna instrukcja jest w WDROZENIE.md. Tutaj to, co trzeba wiedzieć zawczasu.

Serwis ma dwa tryby. LAN to domyślny i niczego nie wymaga — uruchamianie w sali działa dokładnie jak dotąd. Produkcyjny włączasz świadomie przez TRYB=produkcja i wtedy serwis jest bardziej wymagający, bo w internecie pomyłka kosztuje więcej niż w sali.

Wzór pliku z ustawieniami: .env.przyklad.

Serwis wypisuje przy starcie wiersze UWAGA: z tym, co jest ustawione ryzykownie, i odmawia startu w trybie produkcyjnym przy domyślnym albo za krótkim haśle. Warto te wiersze przeczytać po pierwszym wdrożeniu.

Po wystawieniu w internecie sprawdź jedną rzecz ręcznie: wpisz kilkanaście razy złe hasło do panelu i zobacz, czy na kilka minut Cię zablokuje. Jeśli nie — ZA_PROXY nie zgadza się z faktyczną liczbą proxy.

Co serwis sam pilnuje

Nie musisz z tym nic robić, ale dobrze wiedzieć, że to jest:

• Limit połączeń z jednego adresu (domyślnie 60) — żeby jeden komputer nie otworzył ich tysiąca. Wartość jest wysoka celowo: za szkolnym NAT-em cała klasa wychodzi z jednego adresu.
• Limit zdarzeń na gracza (80 na 10 sekund) — przeciw zalewaniu serwera.
• Limit prób hasła do panelu i limit prób PIN-u do nicku.
• Odporność na dziwne dane — wiadomość, która nie wygląda jak trzeba, jest odrzucana zamiast wywracać serwer. Gdyby coś jednak poszło nie tak, serwer wypisuje [KRYTYCZNE] i gra dalej.
• Zapis plików po kawałku — przerwa w prądzie w trakcie zapisu nie niszczy rankingu.

Wyzerowanie rankingu i słowników

Przy zatrzymanym serwerze usuń katalog data/. Kasuje to ranking, historię meczów, kolejkę słów, ręcznie dodane słowa, zastrzeżone nicki i konfigurację. Słownik wbudowany zostaje. Chcesz skasować tylko ranking? Usuń data/playerStats.json — ale pamiętaj, że ranking liczy się z historii meczów, więc do pełnego wyzerowania trzeba też data/matchHistory.json.

Gdy coś pójdzie nie tak

Pozostałe dokumenty

• WDROZENIE.md — wystawienie serwisu w internecie krok po kroku
• MAPA_SERWISU.md — co gdzie leży w kodzie i jak dopisać czwartą grę
• KOPIA_CZATU.md — historia decyzji: co, kiedy i dlaczego zostało zmienione