SŁOWOGRÓD 1.3 — GRA GOTOWA DO SAMODZIELNEGO WGRANIA ================================================== Polska gra słowna dla konsoleigry.pl: komputer, lokalna gra 2–4 osób, prywatne pokoje online 2–4 osób, wyzwanie dnia oraz 24 poziomy Szlaku słów. Czytelna instrukcja w przeglądarce: INSTRUKCJA.html. CO NOWEGO W 1.3 Pięć nowych ilustracji SVG: cztery osobne sceny wyboru trybu i notes pierwszego ruchu. Długie pseudonimy, podgląd słowa i przyciski dopasowują się do węższego ekranu. Czytelniejsze podpisy kart trybów. Powiększona plansza podąża za kursorem klawiatury; historię można przewijać klawiszami. Naprawiono mylenie wyników szybkich zapytań w słowniku oraz odblokowanie przycisków przez nieaktualną odpowiedź innego trybu gry. Po utracie odpowiedzi przy tworzeniu pokoju lub dołączaniu „Ponów połączenie” odzyskuje ten sam stół i miejsce, także po odświeżeniu karty. Nieprawidłowa odpowiedź i awaria zapisu nie kasują klucza odzyskiwania. Zachowano 24 poziomy, wszystkie tryby, medale i grafiki poprzedniej wersji. 1. NAJSZYBSZE URUCHOMIENIE ------------------------- Oddzielny plik Graj_Slowogrod.html jest wersją do uruchomienia przez dwukrotne kliknięcie. Ma pełny polski słownik i obsługuje komputer, grę na jednym urządzeniu, wyzwanie dnia oraz cały Szlak słów. Tryb online wymaga serwera i w tym pliku jest wyłączony. Pierwszy odczyt dużego słownika może potrwać. Plik index.html w tej paczce uruchamiaj przez serwer HTTP/HTTPS, ponieważ pobiera sąsiednie skrypty i części słownika. Do gry online potrzebny jest PHP 8.1 lub nowszy oraz możliwość zapisu poza publicznym katalogiem WWW. Nie potrzeba MySQL, MariaDB, Node.js, Composera, kluczy API ani płatnej usługi. 2. WGRANIE NA KONSOLEIGRY.PL -------------------------- 1) W katalogu publicznym domeny utwórz gry/slowogrod/. 2) Wgraj ZAWARTOŚĆ folderu slowogrod do tego katalogu. Zachowaj podkatalogi dictionary/, server/ i assets/ oraz wszystkie pliki gry. Uważaj, aby nie powstała ścieżka /gry/slowogrod/slowogrod/. 3) Otwórz https://konsoleigry.pl/gry/slowogrod/ i uruchom partię z komputerem. 4) Sprawdź https://konsoleigry.pl/gry/slowogrod/api.php?health=1. Prawidłowa odpowiedź zawiera "ok":true i "online":true. Następnie utwórz pokój i dołącz z drugiej przeglądarki lub telefonu, żeby sprawdzić rzeczywistą konfigurację swojego hostingu. Minimalne pliki działającej gry: index.html, style.css, app.js, engine.js, ai.js, ai-worker.js, campaign.js, visuals.js, assets/slowogrod-town.png, icon.svg, api.php, server/engine.php, dictionary/manifest.json, dictionary/ai.txt, dictionary/full/*.txt. Zachowaj także informacje o licencjach i źródłach. Pozostałe pliki słownika zawierają metadane, wersje skompresowane i narzędzie odtwarzania. Folder tests/ zawiera narzędzia dla programisty, a wordpress/ opcjonalne osadzenie — nie są konieczne do uruchomienia gry. Nie przekazuj haseł hostingu ani danych administratora WordPress w kodzie. Gra nie potrzebuje tych danych. Wszystkie ruchy online są przesyłane do api.php na Twojej domenie; wyniki i poprawność ruchów oblicza serwer. Nie wysyłaj ani nie publikuj prywatnego katalogu danych pokojów. 3. POKOJE I UPRAWNIENIA HOSTINGU ------------------------------ Domyślnie API samo tworzy odseparowany katalog w lokalizacji tymczasowej PHP, poza katalogiem publicznym gry. PHP musi mieć prawo zapisu. Nie trzeba tworzyć katalogu data/ wewnątrz gry ani nadawać praw 777. Opcjonalnie administrator hostingu może ustawić zmienną środowiskową SLOWOGROD_DATA_DIR na pełną ścieżkę prywatnego katalogu poza document root, np. /prywatny/katalog/konta/slowogrod-data. To przykład, nie gotowa ścieżka do wklejenia. Właściwą ścieżkę ustal na swoim hostingu. Katalog musi być dostępny do zapisu dla PHP. Takie ustawienie pozwala uniezależnić zapis pokojów od czyszczenia katalogu tymczasowego przez hosting. Pokoje w trakcie gry wygasają po 48 godzinach od ostatniej zmiany stanu, a ukończone po 24 godzinach od zakończenia. Samo otwarcie strony/odpytywanie serwera nie przedłuża ważności. To gra turowa: uczestnicy nie muszą wykonywać ruchów jednocześnie. Hosting może wcześniej usunąć pliki tymczasowe, dlatego pokoje nie stanowią trwałego archiwum partii. Nazwa gracza i stan partii są zapisywane na Twoim serwerze. Prywatny identyfikator uczestnika pozostaje w jego przeglądarce; do zaproszenia znajomego służy kod pokoju. Kod nie odtwarza utraconej sesji już rozpoczętej gry. Wyczyszczenie danych przeglądarki może uniemożliwić powrót na swoje miejsce. Nie ma kont, publicznego lobby, czatu ani rankingu internetowego. Jeżeli odpowiedź przy tworzeniu lub dołączaniu zaginie, wybierz „Ponów połączenie” w menu. Gra zachowuje rozpoczętą próbę w tej samej karcie przeglądarki i ponawia ją z pierwotnym pseudonimem. Nie tworzy drugiego pokoju ani drugiego miejsca. Działa to również po odświeżeniu i po starcie meczu przez gospodarza, w ciągu 48 godzin od rozpoczęcia połączenia, jeśli sam pokój nadal istnieje. Zamknięcie karty lub wyczyszczenie jej danych może usunąć klucz. Gra nie rozpocznie nowego połączenia, jeżeli przeglądarka nie pozwala wcześniej zachować klucza do jego odzyskania. Na serwerze prywatny zapis odzyskiwania wygasa po 48 godzinach. Informacja o zużytej próbie pozostaje jeszcze przez pięć dni, po czym może zostać usunięta przez okresowe sprzątanie. Nie zawiera jawnego klucza. 4. OSADZENIE W WORDPRESS ----------------------- Najprościej dodaj blok „Własny HTML” i wklej:
Jeżeli edytor usuwa iframe, użyj opcjonalnej wtyczki: - zainstaluj wordpress/slowogrod-embed.zip przez Wtyczki → Dodaj wtyczkę → Wyślij wtyczkę na serwer, a następnie ją aktywuj; albo skopiuj katalog wordpress/slowogrod-embed do wp-content/plugins/ i aktywuj go w panelu; - dodaj blok „Shortcode” z treścią [slowogrod]. Wtyczka domyślnie używa home_url('/gry/slowogrod/'). Opcjonalne ustawienia: [slowogrod height="1100"] [slowogrod src="/gry/slowogrod/" height="1020"] Własny adres musi używać tego samego protokołu, hosta i portu co witryna. Niedozwolony adres jest zastępowany adresem domyślnym. Wtyczka nie pobiera ani nie instaluje samej gry, nie zmienia motywu i nie dodaje automatycznie kafla do istniejącego katalogu na /zagraj/. Dla tego kafla użyj mechanizmu obecnego katalogu oraz metadanych pomocniczych z catalog-entry.json. 5. JAK GRAĆ ----------- Komputer: wybierz jeden z trzech poziomów. Komputer wyszukuje legalne ruchy z własnych liter; podzbiór jego słownika ma 120 000 słów. Przy jednym urządzeniu: 2–4 osoby przekazują sobie urządzenie między ruchami. Ekran przekazania zasłania stojak; jest to prywatność podczas zwykłej gry, a nie ochrona przed osobą przeglądającą dane przeglądarki. Online: gospodarz tworzy pokój, podaje kod znajomym i rozpoczyna partię po dołączeniu co najmniej drugiej osoby. Każdy gra na swoim urządzeniu. Wyzwanie dnia: ten sam start danego dnia; spróbuj uzyskać dobry wynik w 10 ruchach. Porównuj wyniki samodzielnie — nie ma rankingu online. Szlak słów: 24 krótkie zagadki w sześciu dzielnicach: 1–4 Ogród słów; 5–8 Zaułek krzyżówek; 9–12 Dziedziniec premii; 13–16 Warsztat blanków; 17–20 Aleja siódemek; 21–24 Wieża mistrzów. Każdy poziom ma stałą planszę, stojak, cel i trzy progi gwiazdek. Ułóż jedno legalne słowo lub krzyżówkę i spełnij wszystkie cele. Wynik pochodzi z punktów tego ruchu; pozostałe litery nie obniżają wyniku zagadki. Wszystkie poziomy są od razu dostępne i można je powtarzać bez limitu. Przycisk „Rozwiązanie” układa sprawdzony ruch, który trzeba zatwierdzić; użycie tej pomocy ogranicza wynik próby do 1 gwiazdki. Samodzielne powtórzenie pozwala zdobyć 3 gwiazdki. Najlepszy wynik i gwiazdki są zachowywane osobno dla poziomów — gorsza próba nie kasuje rekordu. Wybierz płytkę, a potem pole, lub przeciągnij płytkę na planszę. Możesz też kliknąć pole i pisać. Strzałki ustawiają kierunek wpisywania, Backspace cofa, Enter zatwierdza. „Zbierz litery” cofa niezatwierdzone płytki. „Pomieszaj” zmienia kolejność liter na stojaku. Blank otwiera wybór reprezentowanej litery i zachowuje wartość 0 punktów. Zasady: - Plansza ma 15×15 pól. W zestawie jest 100 płytek, w tym 2 blanki; stojak mieści 7 liter. Pierwsze słowo ma co najmniej 2 litery i przechodzi przez środek. Następne słowa łączą się z istniejącym układem. - Wszystkie nowe płytki w ruchu leżą w jednej linii. Nie mogą zostawiać pustych przerw; istniejące litery mogą wypełniać przerwy między nimi. Każde powstałe słowo, także poprzeczne, musi należeć do słownika. - Pola 2×/3× litera zwiększają wartość nowej płytki. Pola 2×/3× słowo mnożą sumę całego słowa. Kilka premii słownych mnoży się wzajemnie. Premię pola wykorzystuje się tylko w ruchu, w którym położono płytkę. - Wykorzystanie wszystkich 7 płytek w jednym ruchu daje dodatkowe 50 pkt. Blank ma 0 pkt także na premii literowej, ale uruchamia premię słowną. - Wymiana zajmuje kolejkę i wymaga co najmniej 7 płytek w woreczku. Pas oddaje kolejkę. Gra może odrzucić niepoprawny ruch bez jego wykonania. - Partia kończy się po opróżnieniu woreczka i stojaka jednego gracza, po dwóch kolejnych pasach wszystkich graczy albo po 6 kolejnych ruchach bez punktów. Ostatnia reguła zapobiega nieskończonym wymianom. Wybrany limit rund również kończy partię. - Na końcu odejmowane są wartości pozostałych liter. Gracz, który opróżnił stojak przy pustym woreczku, dostaje dodatkowo wartość liter przeciwników. 6. ZAPIS, AKTUALIZACJE I ROZWIĄZYWANIE PROBLEMÓW --------------------------------------------- Zapis lokalnych partii i statystyk zależy od danych przeglądarki. Usunięcie ich, inna przeglądarka albo inny adres gry może oznaczać osobny zapis. Tryb prywatny przeglądarki może nie zachować postępu po zamknięciu okna. Wersja 1.3 czyta poprawne zapisy wersji 1.0, 1.1 i 1.2. Uszkodzoną partię odrzuca z komunikatem, a niepoprawne pola statystyk przywraca do bezpiecznych wartości. Zakończona partia jest również zachowywana. Przycisk „Zobacz wynik” w menu odtwarza końcową planszę i punkty bez ponownego przyznawania odznak lub gier. Przy aktualizacji zrób kopię plików gry oraz prywatnego katalogu pokojów, jeśli skonfigurowałeś własną lokalizację. Aktualizuj komplet zgodnych skryptów i słownika; nie mieszaj wersji engine.js, app.js i server/engine.php. Zaplanowane aktualizacje najlepiej wykonywać po zakończeniu aktywnych partii, a potem odświeżyć cache strony/CDN i ponownie otworzyć grę. Nigdy nie dołączaj danych pokojów do publicznego ZIP-a. Problemy: - Pusty interfejs lub brak liter: sprawdź, czy wgrano wszystkie pliki i czy ich wielkości liter/ścieżki są zachowane. - Gra online niedostępna: sprawdź api.php?health=1, aktywną wersję PHP, cały katalog dictionary/full oraz możliwość zapisu poza web root. - Serwer pokazuje kod PHP jako tekst: włącz obsługę PHP dla tej lokalizacji przed udostępnieniem trybu online. - Błąd słownika: prześlij ponownie wskazany plik i pasujący manifest.json z kompletnej paczki. Gra sprawdza rozmiar i liczbę słów; na HTTPS także SHA-256, a serwer zawsze sprawdza SHA-256 pobieranej części. Następnie wybierz „Sprawdź ponownie”. Szkic i kolejka nie przepadają. Komputer ma własny przycisk ponowienia ruchu. Kontrola api.php?health=1 sprawdza dostępność i rozmiary wszystkich 256 części przed rozpoczęciem meczu. - Połączenie z pokojem nie zostało potwierdzone: kliknij „Ponów połączenie”. Użyj tej samej karty; po odświeżeniu przycisk pozostaje w menu. Jeśli gra zgłasza blokadę zapisu danych, zezwól stronie na ich zapis. - W iframe jest ciasno: użyj pełnego ekranu, osobnego okna lub większej wartości height. Na telefonie można powiększyć planszę. Ta paczka nie zawiera deklaracji testu obciążenia Twojego serwera. Faktyczną konfigurację dhosting i osadzenie sprawdź po wgraniu plików. 7. ŹRÓDŁA I LICENCJE ------------------- Słownik SJP.PL z 1.11.2026: https://sjp.pl/sl/growy/ Po odrzuceniu liter q/v/x: 3 245 253 słowa. To lista SJP, nie oficjalny OSPS. Lista częstości KWJP100: https://github.com/ipipan/kwjp100-varia Oba źródła: CC BY 4.0. Zachowaj LICENSE-dictionary.txt i oznaczenia w grze. Reguły gry źródłowej: https://www.pfs.org.pl/reguly.php Słowogród jest niezależną grą z własnym interfejsem, kodem i dodatkami. Nie jest oficjalnym produktem Scrabble. Kod i oryginalna grafika CSS/SVG oraz ilustracja miasta: MIT, szczegóły w LICENSE.txt. Informacja o projekcie: NOTICE.txt.