Wróć do roadmapu
GłosowanieGra Kolejka

Sterowanie klawiaturą - pełna obsługa akcji i nawigacji

Autor: kotmin22Utworzono: 2026-04-09Ostatnia zmiana statusu: 2026-04-09

title: Sterowanie klawiaturą - pełna obsługa akcji i nawigacji author: Kotmin created: 2026-04-09 updated: 2026-04-09

Opis

Historia użytkownika

Jako gracz, chcę móc sterować grą za pomocą klawiatury (bez użycia myszy), żeby przyspieszyć rozgrywkę i mieć bardziej precyzyjną kontrolę nad akcjami.


Kontekst i problem

Obecne problemy

  • Brak spójnego systemu focus dla elementów interaktywnych
  • Brak skrótów klawiszowych dla głównych akcji w turze
  • Brak możliwości wyboru tras i miast przy pomocy klawiatury
  • Nawigacja UI wymaga głównie myszy

Dlaczego to problem

  • Spowalnia to zaawansowanych graczy
  • Utrudnia dostępność (accessibility)
  • Zmniejsza "game feel" i rytm rozgrywki

Rozwiązanie

Wprowadzenie pełnego sterowania klawiaturą:

System focus

  • Wszystkie interaktywne elementy dostępne przez TAB
  • Widoczny, czytelny stan focus (outline / highlight)

Skróty dla akcji w turze

  • Q / W / E / R - wybór jednej z 4 głównych akcji
  • ESC - powrót / anulowanie / wyjście z aktualnego trybu

Tryb wyboru mapy (ALT mode)

  • Przytrzymanie ALT aktywuje overlay z oznaczeniami:
    • Trasy: "A1, A2, A3..." (lub inny system indeksowania)
    • Dworce: "D1, D2..."
  • Wpisanie kombinacji z klawiatury wybiera element

Kluczowe zasady

  • Skróty muszą być intuicyjne i łatwe do zapamiętania
  • System nie może kolidować z inputami tekstowymi (np. chat)
  • Overlay klawiaturowy powinien być lekki wizualnie i tymczasowy

Acceptance Criteria

  • [ ] Wszystkie interaktywne elementy UI są dostępne przez TAB
  • [ ] Widoczny stan focus (np. outline zgodny z theme)
  • [ ] Klawisze Q/W/E/R wybierają odpowiadające akcje w turze
  • [ ] ESC cofa aktualną akcję lub wraca do poprzedniego stanu
  • [ ] Przytrzymanie ALT aktywuje overlay z oznaczeniami na mapie
  • [ ] Overlay znika po puszczeniu ALT
  • [ ] Gracz może wybrać trasę/dworzec wpisując przypisaną kombinację
  • [ ] System nie aktywuje się podczas wpisywania tekstu (np. input, chat)
  • [ ] Brak konfliktów z domyślnymi skrótami przeglądarki

To było by definitywnie usprawnienie dla wszystkich bazujących na klawiaturze! Dzięki za zgłoszenie! <3

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ń.