SŁOWOGRÓD / KONSOLEIGRY.PL

Dokumentacja techniczna Słowogrodu

Instrukcja uruchomienia, dodania gry do WordPressa i rozegrania pierwszej partii. Samodzielna paczka z polskim słownikiem i pokojami dla znajomych.

Wersja 1.3 · komputer, telefon i tablet

Szukasz zasad i punktacji? Przejdź do instrukcji gracza Słowogrodu.

Nowości w wersji 1.3

Cztery tryby gry mają własne ilustrowane sceny, a historia zaczyna się od nowej grafiki notesu. Poprawiono zawijanie długich pseudonimów, słów i przycisków oraz kontrast opisów trybów. Przy pisaniu na powiększonej planszy aktywne pole pozostaje widoczne; historię ruchów można przewijać klawiaturą.

Jeśli utracisz odpowiedź przy tworzeniu pokoju albo dołączaniu, wybierz „Ponów połączenie”. Gra odzyska ten sam pokój i Twoje miejsce, również po odświeżeniu tej samej karty. Poprawiono też kolejność odpowiedzi słownika i blokadę ruchu podczas zmiany trybu. Wszystkie 24 poziomy, odznaki i dotychczasowe tryby pozostają dostępne.

Wybierz sposób uruchomienia

02 / DODAJ NA STRONĘ

Wgraj folder gry na hosting

Paczka z index.html i api.php obsługuje również prywatne pokoje online. Wymaga serwera PHP 8.1 lub nowszego.

Bez bazy danych, Node.js, klucza API, abonamentu lub instalatora. Zwykły index.html otwieraj przez serwer, nie jako plik lokalny.

Wgraj na konsoleigry.pl w czterech krokach

  1. Utwórz folder /gry/slowogrod/.Chodzi o katalog w publicznym folderze domeny. Zachowaj dokładnie małe litery w nazwie.
  2. Prześlij do niego zawartość folderu slowogrod.Zachowaj całą strukturę, w tym dictionary/ wraz z manifest.json, server/ i assets/. Sprawdź, czy nie powstał przypadkiem dodatkowy poziom /slowogrod/slowogrod/.
  3. Otwórz grę i uruchom partię.Docelowy adres: https://konsoleigry.pl/gry/slowogrod/. Wybierz grę z komputerem, ułóż słowo i zatwierdź ruch.
  4. Sprawdź działanie pokojów.Otwórz api.php?health=1. Poprawna odpowiedź zawiera "ok":true i "online":true. Utwórz pokój i dołącz do niego z drugiej przeglądarki albo telefonu.
Do uruchomienia nie podajesz żadnych haseł. Gra nie potrzebuje danych administratora WordPress ani haseł hostingu. Pokoje zapisuje lokalnie na Twoim serwerze, a ruchy wysyła do API pod adresem gry.
Gdzie są przechowywane pokoje?

Domyślnie PHP tworzy własny katalog w lokalizacji tymczasowej serwera, poza katalogiem publicznym. Musi mieć prawo zapisu. Nie twórz publicznego folderu data/ i nie ustawiaj uprawnień 777.

Administrator może opcjonalnie ustawić zmienną środowiskową SLOWOGROD_DATA_DIR na pełną ścieżkę prywatnego katalogu poza katalogiem WWW. To przydatne, gdy hosting regularnie czyści pliki tymczasowe. Właściwa ścieżka zależy od konta hostingowego; nie jest adresem URL.

Dodaj grę do WordPressa

WARIANT A / BEZ WTYCZKI

Blok „Własny HTML”

Po wgraniu gry dodaj do strony blok HTML i wklej:

<iframe
  src="/gry/slowogrod/"
  title="Słowogród — polska gra słowna"
  style="width:100%;height:1020px;border:0;border-radius:18px;"
  loading="lazy"
  allow="fullscreen"
  allowfullscreen
  referrerpolicy="same-origin">
</iframe>
<p><a href="/gry/slowogrod/"
  target="_blank" rel="noopener">
  Graj w osobnym oknie
</a></p>
WARIANT B / KRÓTKI KOD

Opcjonalna wtyczka do osadzenia

W panelu WordPress wybierz Wtyczki → Dodaj wtyczkę → Wyślij wtyczkę na serwer. Wskaż wordpress/slowogrod-embed.zip, zainstaluj i aktywuj.

Następnie wstaw blok „Shortcode”:

[slowogrod]

Możesz ustawić wysokość lub inną ścieżkę gry na tej samej stronie:

[slowogrod src="/gry/slowogrod/" height="1100"]

Wtyczka wymaga najpierw wgrania samej gry. Akceptuje własny adres z takim samym protokołem, hostem i portem co witryna; nieprawidłowy adres zastępuje domyślnym.

Osadzenie a kafelek w katalogu /zagraj/. Iframe i shortcode wyświetlają grę. Kafelek w Twoim istniejącym katalogu trzeba dodać jego dotychczasowym mechanizmem. Plik catalog-entry.json zawiera tytuł, opis, tryby, kategorię i adres do wykorzystania przy dodawaniu wpisu; nie jest automatycznym importerem.

Cztery sposoby na dobrą partię

TrybJak działaDla kogo
Z komputeremTrzy poziomy trudności, wyszukiwanie legalnych ruchów i możliwość podpowiedzi.Jedna osoba, dowolna pora.
Razem na kanapie2–4 osoby na jednym urządzeniu. Pomiędzy kolejkami stojak zasłania ekran przekazania.Rodzina lub znajomi przy jednym stole.
Pokój online2–4 urządzenia, prywatny kod, gospodarz rozpoczynający partię. Serwer sprawdza ruchy i oblicza wyniki.Znajomi grający z różnych miejsc.
Szlak słów24 poziomy w sześciu dzielnicach, 72 gwiazdki, cele punktowe i taktyczne. Każda zagadka kończy się po jednym legalnym ruchu.Nauka, trening i polowanie na trzy gwiazdki.
Wyzwanie dniaTen sam start danego dnia i 10 ruchów na dobry wynik. Bez publicznego rankingu.Krótka codzienna rozgrywka.

Gra ma także podgląd punktów przed ruchem, historię partii, statystyki lokalne, sprawdzanie słów, mieszanie stojaka, powiększenie planszy i pełny ekran. Komputer wykorzystuje podzbiór 120 000 słów; słowa gracza są sprawdzane w pełnym słowniku.

Szlak słów — 24 poziomy

Odwiedź kolejno Ogród słów, Zaułek krzyżówek, Dziedziniec premii, Warsztat blanków, Aleję siódemek i Wieżę mistrzów. Każda dzielnica ma cztery zagadki. Z panelu celu odczytasz wymagane punkty, liczbę słów albo obowiązek użycia blanka i wszystkich siedmiu płytek.

Wybierz dowolny poziom, ułóż ruch i zatwierdź go. Tutaj liczą się punkty ruchu; litery pozostałe na stojaku nie obniżają wyniku. Wyższe progi punktowe dają do trzech gwiazdek. Najlepszy wynik i gwiazdki pozostają zapisane po słabszej próbie.

Możesz zawsze spróbować ponownie. Wszystkie poziomy są dostępne od początku. Przycisk „Rozwiązanie” pokazuje sprawdzone ułożenie do zatwierdzenia. Ta próba daje najwyżej jedną gwiazdkę; kolejną możesz rozegrać samodzielnie. „Od nowa” przywraca tę samą planszę i stojak.

Zasady, które szybko zapamiętasz

15×15pól planszy
100płytek, w tym 2 blanki
7liter na stojaku
+50za wyłożenie całej siódemki
Kiedy kończy się partia? Przy pustym woreczku i pustym stojaku jednego gracza; po dwóch kolejnych pasach wszystkich uczestników; po sześciu kolejnych ruchach bez punktów; albo po wybranym limicie rund. Reguła sześciu ruchów bez punktów jest przyjętą regułą Słowogrodu. Na końcu odejmuje się wartości pozostałych liter; gracz, który opróżnił stojak przy pustym woreczku, dostaje dodatkowo wartości liter przeciwników.

Sterowanie

CzynnośćSposób
Połóż literęKliknij lub dotknij płytki, potem pola. Możesz też przeciągnąć płytkę.
Wpisuj słowo klawiaturąKliknij pole i pisz dostępne litery. Strzałki ustawiają kierunek.
Zatwierdź / cofnij literęEnter / Backspace.
Cofnij przygotowany ruch„Zbierz litery” — wracają tylko niezatwierdzone płytki.
Zmień kolejność stojaka„Pomieszaj”. Nie zmienia zestawu liter.
Więcej miejscaPowiększenie planszy, pełny ekran albo otwarcie gry w osobnym oknie.

Zapis i prywatne pokoje

Na jednym urządzeniu

Partie lokalne, ostatni wynik, postęp poziomów i statystyki są związane z danymi tej przeglądarki. Inny adres strony lub przeglądarka może mieć oddzielny zapis. Czyszczenie danych usuwa zapis; tryb prywatny może nie zachować go po zamknięciu okna.

Ekran przekazania w grze lokalnej zasłania litery przed kolejną osobą. Nie służy do ochrony danych przed osobą analizującą pamięć przeglądarki.

Przez internet

Pokoje działają turowo. Można wrócić później: aktywny pokój wygasa po 48 godzinach od ostatniej zmiany stanu, a zakończony po 24 godzinach od zakończenia. Samo odświeżanie nie przedłuża terminu.

Do zaproszenia użyj kodu. Powrót do swojego miejsca wymaga zachowania sesji w przeglądarce; kod nie odzyskuje utraconej sesji rozpoczętej gry. Nie ma kont, czatu ani rankingu internetowego.

Serwer przechowuje nazwy uczestników i stan partii. Domyślne pliki tymczasowe mogą zostać wcześniej usunięte przez hosting. Jeżeli potrzebujesz stabilniejszego przechowywania w ramach czasu ważności, skonfiguruj prywatny katalog danych opisany wyżej.

Odzyskiwanie przerwanego połączenia. Jeśli odpowiedź zaginęła przy tworzeniu lub dołączaniu, przycisk „Ponów połączenie” w menu przywróci ten sam pokój i miejsce. Działa także po odświeżeniu tej samej karty, do 48 godzin od rozpoczęcia połączenia i w czasie ważności pokoju. Przeglądarka musi pozwalać na zapis danych. Zamknięcie karty lub usunięcie danych może usunąć klucz odzyskiwania.

Aktualizacje

Zrób kopię plików gry oraz własnego prywatnego katalogu pokojów. Aktualizuj zgodny komplet skryptów i słownika, najlepiej po zakończeniu aktywnych partii. Potem odśwież cache witryny/CDN i sprawdź nową partię. Prywatnych plików pokojów nie dołączaj do publicznego archiwum ani nie przenoś do katalogu WWW.

Gdy coś nie działa

Interfejs jest pusty lub brakuje słownika

Sprawdź pełne wgranie plików oraz ścieżki. Na serwerze nazwy mogą rozróżniać wielkie i małe litery. Prześlij brakujące pliki dictionary/full/; nie wyłączaj sprawdzania słów, aby ukryć błąd.

Komputer działa, ale nie można utworzyć pokoju

Sprawdź api.php?health=1, PHP 8.1 lub nowszy oraz prawo PHP do zapisu poza publicznym katalogiem. Jeśli serwer pokazuje kod PHP zamiast odpowiedzi JSON, najpierw włącz obsługę PHP w tej lokalizacji.

WordPress usuwa kod iframe

Użyj dołączonej opcjonalnej wtyczki i bloku „Shortcode” z [slowogrod]. Samą grę nadal trzeba wgrać oddzielnie do /gry/slowogrod/.

Na telefonie plansza jest za mała

Użyj przycisku powiększenia, pełnego ekranu lub otwórz grę w osobnym oknie. W osadzeniu możesz też zwiększyć wysokość iframe.

Paczka nie oznacza testu obciążenia Twojego hostingu. Po wgraniu sprawdź faktyczną konfigurację dhosting, odtwarzanie partii i dołączenie drugiego urządzenia.

Polski słownik i źródła

3 245 253 dopuszczalne słowa pochodzą z listy SJP.PL do gier z 1 listopada 2026. Odrzucono 787 wpisów zawierających litery q, v lub x. Jest to słownik SJP, nie Oficjalny Słownik Polskiego Scrabblisty (OSPS); wyniki dopuszczalności mogą się różnić.

Popularniejsze długie słowa komputera dobrano na podstawie KWJP100 Instytutu Podstaw Informatyki Polskiej Akademii Nauk. Oba zbiory udostępniono na CC BY 4.0. Pełne oznaczenia, zakres zmian i odnośniki znajdują się w LICENSE-dictionary.txt.

Klasyczne reguły gier krzyżówkowych sprawdzono w zasadach Polskiej Federacji Scrabble. Słowogród ma własny kod, oprawę CSS/SVG, nową ilustrację miasta i dodatki; nie jest oficjalnym produktem Scrabble. Oryginalny kod i oprawa są udostępnione na licencji MIT. Zachowaj informacje o autorstwie słownika przy publikacji.