Keyboard Control - Full Action and Navigation Support
Description
title: Keyboard Control - Full Action and Navigation Support author: Kotmin created: 2026-04-09 updated: 2026-04-09
Description
User Story
As a player, I want to control the game using the keyboard (without using the mouse) to speed up gameplay and have more precise control over actions.
Context and Problem
Current Issues
- Lack of a consistent focus system for interactive elements
- No keyboard shortcuts for main actions during a turn
- No ability to select routes and cities using the keyboard
- UI navigation primarily requires the mouse
Why This Is a Problem
- It slows down advanced players
- It hinders accessibility
- It reduces "game feel" and the rhythm of gameplay
Solution
Introducing full keyboard control:
Focus System
- All interactive elements accessible via TAB
- Visible, readable focus state (outline / highlight)
Shortcuts for Turn Actions
- Q / W / E / R - select one of the 4 main actions
- ESC - return / cancel / exit current mode
Map Selection Mode (ALT mode)
- Holding ALT activates an overlay with markings:
- Routes: "A1, A2, A3..." (or another indexing system)
- Stations: "D1, D2..."
- Typing a combination on the keyboard selects the element
Key Principles
- Shortcuts must be intuitive and easy to remember
- The system must not conflict with text inputs (e.g., chat)
- The keyboard overlay should be visually lightweight and temporary
Acceptance Criteria
- [ ] All interactive UI elements are accessible via TAB
- [ ] Visible focus state (e.g., outline matching the theme)
- [ ] Keys Q/W/E/R select corresponding actions during a turn
- [ ] ESC undoes the current action or returns to the previous state
- [ ] Holding ALT activates an overlay with markings on the map
- [ ] Overlay disappears after releasing ALT
- [ ] The player can select a route/station by typing the assigned combination
- [ ] The system does not activate while typing text (e.g., input, chat)
- [ ] No conflicts with default browser shortcuts
Admin comment
That would definitely be an improvement for everyone relying on the keyboard! Thanks for the report! <3
Implementation plan
Plan wdrożenia (wersja publiczna, finalna) 2026-04-09
Wersja do osadzenia w metadanych zgłoszenia. Wyświetlana publicznie w fazie "Zaplanowane" roadmapy, gdzie komentarze są wyłączone, a gracze mogą tylko zareagować emoji. Dlatego treść jest deklaratywna: ogłaszamy decyzje, nie prosimy o głos. Poprzednie wersje planu powyżej zostawione dla historii.
W skrócie
Dodamy pełne sterowanie klawiaturą w czterech niezależnych etapach, wydawanych po kolei. Każdy etap przynosi konkretną, wyczuwalną zmianę - nie musisz czekać na całość, żeby poczuć poprawę. Mysz nadal działa jak dotąd. Żadna zasada gry się nie zmienia.
Czego dotyczy
Poprawiamy sposób sterowania grą. Dodajemy klawiaturę jako pełnoprawną, równoległą ścieżkę do myszy. To wszystko.
Czego NIE zmieniamy
- Żadnych zasad gry - punktacja, kolejność tur, akcje w turze, warunki końca gry, reguły tras podwójnych - wszystko pozostaje identyczne.
- Wyglądu planszy, kart i dialogów (poza jedną nowością: neonową obwódką w motywie Pendolino na elemencie, na którym aktualnie "stoisz" klawiszem TAB).
- Sterowania myszą - całe obecne działa jak dotąd, niczego nie odbieramy.
Etapy wdrożenia
Etap 1: Widoczny wskaźnik "tutaj jestem"
Po tym etapie każdy element, na który przeskoczysz klawiszem TAB, dostanie wyraźną, neonową obwódkę w duchu motywu Pendolino. Zobaczysz ją na:
- czterech głównych przyciskach akcji w turze,
- kartach wagonów i biletów w ręce,
- kartach dworców,
- przyciskach we wszystkich dialogach w grze (pomoc, ustawienia, polityka prywatności, feedback),
- przyciskach w panelach bocznych i na ekranie końca gry.
Efekt dla gracza: już dziś możesz dojść TAB-em do wielu przycisków, ale nie widać, na którym stoisz. Po tym etapie - widać wyraźnie.
Etap 2: Pełna dostępność mapy z klawiatury
Trasy i miasta na planszy stają się "klikalne" z klawiatury. Są:
- osiągalne TAB-em w przewidywalnej kolejności - idziemy z zachodu na wschód, a w ramach tej samej pionowej linii z północy na południe (porządek "czytania mapy"),
- opisane dla osób korzystających z czytników ekranu (np. "Trasa Warszawa-Kraków, długość 4, kolor niebieski, wolna"),
- uruchamialne klawiszem Enter lub Spacja dokładnie tak samo jak kliknięciem myszą,
- podświetlane tą samą obwódką z Etapu 1, żeby było widać, na której trasie lub mieście stoisz.
Efekt dla gracza: możesz zagrać całą grę bez dotykania myszy. Wybór trasy i miasta przestaje być wąskim gardłem.
Etap 3: Skróty dla głównych akcji w turze
Dodajemy zestaw skrótów aktywnych tylko w trakcie Twojej tury i tylko dla dostępnych akcji:
- Q - Dobierz karty wagonów
- W - Zajmij trasę
- E - Dobierz bilety
- R - Postaw dworzec
- ESC - Anuluj bieżącą akcję / cofnij o krok
Zasady bezpieczeństwa:
- skróty nie działają, gdy piszesz w jakimkolwiek polu tekstowym - nic Ci się nie wywoła, kiedy np. wpisujesz wiadomość w chacie,
- akcja zablokowana (np. "Postaw dworzec", gdy już nie masz dworców) nie reaguje na swój skrót - tak samo jak wyszarzony przycisk nie reaguje na kliknięcie,
- skróty nie kolidują z klawiszem ESC używanym do zamykania dialogów - w trakcie otwartego dialogu pierwszeństwo ma zamknięcie dialogu.
Efekt dla gracza: zamiast celować myszą w przycisk, wciskasz jedną literę. Tura idzie zauważalnie szybciej, szczególnie przy długich rozgrywkach.
Etap 4: Tryb szybkiego wyboru (przytrzymaj ALT)
Gdy przytrzymasz ALT, nad planszą pojawia się lekki, półprzezroczysty overlay z krótkimi etykietami:
- nad każdą dostępną trasą - kod typu
A1,A2,A3... (posortowane w przewidywalny sposób, od lewej do prawej i od góry do dołu), - nad każdym miastem, w którym można jeszcze postawić dworzec - kod typu
D1,D2...
Wpisanie kodu od razu wybiera dany element (np. A + 1 + 2 -> wybiera trasę o kodzie A12). Puszczasz ALT - overlay znika, wracasz do normalnego widoku.
Dodatkowe zasady:
- overlay pokazuje tylko elementy aktualnie dostępne do wybrania w kontekście Twojej bieżącej akcji (np. podczas stawiania dworca widzisz tylko kody miast, a nie tras),
- overlay jest wizualnie lekki - nie zakrywa planszy, nie psuje rytmu gry,
- krótka podpowiedź ("Przytrzymaj ALT, aby zobaczyć skróty") pojawi się raz, przy pierwszym uruchomieniu tej wersji, i da się ją wyłączyć.
Efekt dla gracza: najszybszy możliwy sposób wyboru trasy lub miasta - bez patrzenia w kolejność TAB, bez celowania myszą. Dla zaawansowanego gracza to kilka sekund oszczędności na turę.
Kolejność i niezależność etapów
| Etap | Zależy od | Czy można wydać osobno? | | ---------------------- | ---------------------------------------- | ----------------------- | | 1 - Widoczna obwódka | nic | tak | | 2 - Mapa z klawiatury | Etap 1 (żeby było widać, na czym stoisz) | tak, po Etapie 1 | | 3 - Skróty Q/W/E/R/ESC | nic | tak | | 4 - Tryb ALT | Etap 2 (logika wyboru tras i miast) | tak, po Etapie 2 |
Idziemy w kolejności 1 -> 2 -> 3 -> 4. Etap 3 może się pojawić równolegle z Etapami 1-2, jeśli będzie gotowy wcześniej. Nie musisz czekać na całość - każdy etap to osobne wydanie, które zobaczysz w grze.
Podjęte decyzje
Tutaj krótko odpowiadamy na pytania, które naturalnie mogą się pojawić przy czytaniu planu:
- Dlaczego Q/W/E/R, a nie polskie skróty literowe (np. K/T/B/D)? Cztery sąsiednie klawisze pod lewą dłonią to szybsze i wygodniejsze wprowadzanie akcji niż litery rozrzucone po klawiaturze. Wzór znany z wielu gier strategicznych.
- Dlaczego akurat ALT jako modyfikator trybu szybkiego wyboru? ALT jest łatwo dostępny kciukiem lewej dłoni, nie koliduje z literami akcji (Q/W/E/R) i jest rzadko używany w samej grze. Jeśli w testach któraś przeglądarka okaże się na niego zbyt czuła (otwieranie menu), zamienimy go na alternatywny modyfikator - ale tylko jeśli to będzie naprawdę przeszkadzać.
- Dlaczego kolejność TAB "od zachodu na wschód"? To naturalny porządek czytania mapy Polski, który minimalizuje zaskoczenie - kursor wędruje w sensownej, przewidywalnej trajektorii.
- Dlaczego nie ma konfiguracji własnych skrótów? Żeby nie rozbudowywać pierwszej wersji. Jeśli zobaczymy, że gracze naprawdę tego potrzebują, dodamy to jako osobny krok.
- Czy to zepsuje grę osobom, które do tej pory grały myszą? Nie. Mysz działa dokładnie tak jak dotąd, nic jej nie odbieramy - klawiatura to dodatkowa warstwa.
Co zostaje poza zakresem
Żeby nie rozciągać zgłoszenia w nieskończoność, poza zakresem tego planu zostaje:
- Przebudowa całego interfejsu na tryb "klawiatury na pierwszym miejscu" - obecne sterowanie myszą pozostaje priorytetem, klawiatura to pełnoprawna alternatywa, nie zamiennik.
- Zmiana przypisań skrótów przez gracza - skróty są stałe. Jeśli pojawi się na to wyraźne zapotrzebowanie, wróci jako osobne zgłoszenie.
- Skróty dla akcji w ramach akcji (np. wybór konkretnej karty z ręki cyframi 1-9, szybki wybór koloru kart). To naturalny kolejny krok, ale wyjdzie jako osobna iteracja po Etapach 1-4.
- Sterowanie kontrolerem / padem - to inna kategoria usprawnienia i zasługuje na własne zgłoszenie.
Jak poznasz, że etap jest gotowy
Każdy etap uznajemy za zakończony, gdy:
- Etap 1: da się przejść TAB-em przez wszystkie interaktywne elementy gry i na każdym widać wyraźną obwódkę.
- Etap 2: da się rozegrać pełną turę (dobranie kart -> zajęcie trasy -> dobranie biletów -> postawienie dworca) bez dotykania myszy.
- Etap 3: skróty Q/W/E/R/ESC wykonują odpowiednie akcje, są zablokowane podczas pisania w polach tekstowych i nie kolidują z zamykaniem dialogów.
- Etap 4: przytrzymanie ALT pokazuje overlay, wpisanie kodu wybiera element, puszczenie ALT chowa overlay, a overlay pokazuje tylko elementy dostępne w bieżącym kontekście.
Gdzie znajdziesz informację o skrótach w samej grze
Równolegle z Etapem 3 dodamy w dialogu pomocy nową sekcję "Skróty klawiszowe" z prostą tabelką wszystkich dostępnych skrótów (polska i angielska wersja językowa). Na ekranie powitalnym pojawi się jednoliniowa wzmianka, że gra wspiera pełne sterowanie klawiaturą.
Zasady gry pozostają dokładnie takie same jak dotąd - skróty to wyłącznie nowy sposób wydawania tych samych poleceń.