Runner 2D · pixel art · Android i przeglądarka

UFOLUDW NOGI

Rozbity ufolud Zorp ucieka przed wojskiem. Bieg trwa, dopóki jego prędkość nie spadnie do zera.

Phaser 3 · TypeScript · Capacitor · 480×270 px skalowane ×2, ×3, ×4

Menu główne gry: Zorp stoi przy rozbitym spodku na farmie o zachodzie słońca, obok przyciski Graj, Warsztat, Skrzynki i Skórki.

Zagraj

W przeglądarce albo z APK

Wersja przeglądarkowa działa od razu, na komputerze i na telefonie obróconym poziomo. Postęp zapisuje się w tej przeglądarce. APK to pełna aplikacja na Androida: pełny ekran, wibracje i reklamy testowe.

Najnowszy build: 9 · 16.11.2026, 15:58

KomputerKlawiatura

Spacja lub ↑ to skok (przytrzymanie = wyżej), ↓ to ślizg albo szybkie lądowanie, E to gadżet, Esc pauza.

TelefonDotyk

Stuknięcie to skok, przytrzymanie wyższy skok, przesunięcie w dół to ślizg. Gadżet jest w prawym dolnym rogu.

APKAplikacja na Androida

Pobierz ufolud-w-nogi.apk na telefonie i otwórz plik. Kolejne wersje instalują się jako aktualizacja, a numer buildu widać w grze w Ustawieniach.

APK: nowy klucz podpisu od buildu 1

Jeśli na telefonie jest wersja zainstalowana przed buildem 1, odinstaluj ją przed instalacją nowej. Postęp wyzeruje się ten jeden raz. Za pierwszym razem Android zapyta też o zgodę na instalację z nieznanych źródeł.

Aktualizacje

Co się zmieniło

Najnowsze na górze. Opis każdej zmiany dopisujemy przy pracy nad grą, a poniżej widać też surową listę ostatnich commitów.

  1. naprawaprojekt

    Trasę zawsze da się przejść

    • Nowe sprawdzanie (npm run check:chunks) szuka drogi bez trafienia przez każdy kawałek trasy, w każdej strefie i przy każdej prędkości — także z zapasem na reakcję człowieka.
    • Helikopter rzuca siatkę tylko tam, gdzie da się ją przeskoczyć; wcześniej potrafił ją położyć np. pod praniem, pod którym trzeba się ślizgać.
    • Spanikowana kura nie ucieka już pod następną przeszkodę.
    • Las jest łagodniejszy (opór 13 zamiast 15): więcej biegów dociera do bazy wojskowej.
    • Sprawdzanie trasy działa przy każdym pushu na GitHubie.
  2. projekt

    Audyt gry: co poprawić i co dodać

    • Sprawdziliśmy balans w symulacjach, wszystkie ekrany na telefonach, wydajność i gotowość do Google Play.
    • Najważniejsze plany: cele na dłużej (zadania, znacznik rekordu na trasie), łagodniejszy las, zgoda RODO na reklamy.
  3. narzędzia

    Strona aktualizuje się przy każdej zmianie

    • Lista zmian jest w pliku ZMIANY.md, więc łatwo ją uzupełnić, także bez Claude.
    • Pod listą widać ostatnie zmiany w kodzie, dopisywane same przy każdym pushu.
    • Każdy push na main odświeża stronę, grę w przeglądarce i APK.
  4. narzędzia

    Strona i gra pod stałym, publicznym adresem

    • Strona, gra w przeglądarce i APK odświeżają się same po każdej zmianie w grze.
    • APK pobierze każdy, bez konta na GitHubie.
    • Grę w przeglądarce można dodać do ekranu głównego telefonu.
  5. nowość

    Gra działa w przeglądarce

    • Przycisk „Zagraj w przeglądarce” otwiera grę od razu, bez instalowania.
    • Postęp zapisuje się w przeglądarce, osobno od aplikacji na telefon.
    • Ta strona jest gotowa do udostępnienia innym osobom.
  6. narzędziabuild 1

    Automatyczne APK i strona gry

    • Każdy push buduje APK na GitHubie; przycisk „Pobierz APK” prowadzi zawsze do najnowszego.
    • Wszystkie APK mają wspólny klucz testowy, więc kolejne wersje instalują się jako aktualizacja.
    • Numer buildu widać w grze: Ustawienia, prawy górny róg.
  7. naprawa

    Gra nie zawiesza się już po drugim życiu z reklamy

    • Po obejrzeniu reklamy i ponownym złapaniu gra stawała bez okna podsumowania i bez powrotu do menu.
    • Teraz po drugim złapaniu od razu pojawia się podsumowanie biegu.
  8. nowość

    Pierwsza wersja gry (etapy 1–8)

    • Bieg, skok, podwójny skok, ślizg i szybkie lądowanie; koniec biegu, gdy prędkość spadnie do zera.
    • Cztery strefy (farma, miasteczko, las, baza) i pętla trudności od 4000 m.
    • Warsztat z 8 ulepszeniami, skrzynki, 4 gadżety z części statku i 5 skórek.
    • Muzyka i efekty generowane w kodzie, wersje PL i EN, samouczek i intro.
    • Aplikacja na Androida (Capacitor) z AdMobem w trybie testowym.

Ostatnie zmiany w kodzie

Uzupełnia się samo przy każdym pushu. Ta wersja strony: build 9.

  1. Trasę zawsze da się przejść: sprawdzanie kawałków, bezpieczne siatki, łagodniejszy las
  2. Audyt gry: usterki, balans, pomysły i lista do Google Play
  3. Lista zmian w ZMIANY.md i automatyczna historia commitów na stronie
  4. CLAUDE.md: pushuj zawsze na main
  5. Workflow: ponowne uruchomienie buildu nie wywala się na istniejącym wydaniu
  6. Strona gry na Cloudflare Pages zamiast GitHub Pages
  7. Strona gry na GitHub Pages: gra w przeglądarce i publiczne APK
  8. Wersja przeglądarkowa do strony z grą (npm run build:web)
  9. README i CLAUDE.md: strona gry, gotowe APK, wspólny klucz testowy
  10. Automatyczne APK na GitHubie i wspólny klucz testowy
  11. Naprawa zawieszenia gry po drugim życiu z reklamy
  12. Pierwsza wersja gry „Ufolud w Nogi” (etapy 1–8)

Zamysły

Jak gra ma działać

Zasady, liczby i decyzje z dokumentu projektowego oraz z tego, co już jest w kodzie. Wszystkie liczby siedzą w src/config/balance.ts.

Pętla gry

Bieg→ Kasa→ Warsztat→ Dalszy bieg

Bieg ma trwać 30–120 sekund. Za każde 10 m jest 1 moneta, do tego monety z trasy, 10 za przewróconego wroga i 50 za pobity rekord.

Seria ominiętych przeszkód mnoży kasę: 5 → ×1,2, 10 → ×1,5, 20 → ×2.

Po biegu od 500 m jest darmowa skrzynka. Ze skrzynek wypadają części statku, z których Zorp buduje gadżety.

Warsztat: osiem ulepszeń z cenami, Zorp na środku, przyciski Gadżety i Biegnij.

Mechanika

Prędkość i tempo

Tempo to prędkość, do której Zorp wraca czystym biegiem. Opór strefy stale je obniża, a boosty podnoszą. Zderzenie zabiera prędkość, a połowa tej straty obniża też tempo. Gdy prędkość spadnie do zera, jeep sierżanta dogania Zorpa.

Szeroka złota linia to tempo, cienka zielona to prędkość. Schemat, nie wykres z gry.

+80puszka energii, co ok. 170–250 m
+50trampolina przy lądowaniu
+20Perfect: do 8 px nad przeszkodą
+30skok wrogowi na głowę
−5…−20opór stref 1–4, px/s²
−25opór pętli, +5 co pętlę
+40odzyskiwanie, px/s²
2 snietykalność po drugim życiu

Trasa

Cztery strefy po 1000 m

Każda strefa ma własny opór, przeszkody, wrogów, paletę, oświetlenie i motyw muzyczny. Po 4000 m strefy wracają w pętli: ciemniejsze, gęstsze, a wrogowie są o 15% szybsi co pętlę.

Strefa Farma: zachód słońca, płot, Zorp ucieka przed szeregowym z siatką i jeepem.

Farma

0–1 000 m
Opór
5 px/s²
Muzyka
148 BPM
Przeszkody
pachołki, kury, siano, skrzynki, płot, beczka, pranie na sznurku
Pościg
sierżant w jeepie z megafonem
Strefa Miasteczko: nocne bloki z oświetlonymi oknami, sklep, księżyc.

Miasteczko

1 000–2 000 m
Opór
10 px/s²
Muzyka
140 BPM
Przeszkody
hydranty, kosze, barierki, kontenery, transparenty
Nowi wrogowie
szeregowi z siatką biegnący naprzeciw
Strefa Las: sosny we mgle, wielki zielonkawy księżyc, monety nad drogą.

Las

2 000–3 000 m
Opór
13 px/s²
Muzyka
132 BPM
Przeszkody
pniaki, mgła, ciemniejsza droga
Nowi wrogowie
helikopter: reflektor przez 1 s oznacza miejsce, potem spada siatka — zawsze tam, gdzie da się ją przeskoczyć
Strefa Baza wojskowa: hangary, radar, światła alarmowe, drut.

Baza wojskowa

3 000–4 000 m
Opór
20 px/s²
Muzyka
160 BPM
Przeszkody
drut, zapory, skrzynie
Nowi wrogowie
agenci w garniturach skaczący razem z graczem, czołg strzelający gumowymi piłkami

Postęp

Ulepszenia, skrzynki, gadżety, skórki

Ulepszenia w Warsztacie

UlepszenieNa poziomPoziomyOd
Szybkość+12 px/s prędkości maks.1040
Przyspieszenie+6 px/s², mniejszy opór1040
Wytrzymałość−5% kary za zderzenie1060
Skok+4% wysokości1050
Magnes+8 px zasięgu monet1080
Szczęściarz+10% kasy z biegu10100
Podwójny skokdrugi skok w powietrzu1500
Bateria gadżetu+1 użycie na bieg2300

Każdy kolejny poziom kosztuje ×1,6 poprzedniego. Buty, sprężyny i kask zmieniają wygląd Zorpa na poziomach 1, 3, 6 i 8.

Skrzynki

RzadkośćSzansaZawartość
Zwykła70%50–150 monet
Rzadka25%200–400 monet albo część statku (40%)
Kosmiczna5%skórka lub gadżet

Gadżety z części statku

  • Tarcza · 1 częśćjedno zderzenie bez kary
  • Jetpack · 2 częścilot nad przeszkodami przez 3 s
  • Promień · 3 częściprzewraca wrogów na ekranie
  • Teleport · 3 częściprzeskok 150 m do przodu

Skórki

  • Zorpod początku
  • Zorp w dresie1 500 m w jednym biegu
  • Kowboj40 przewróconych wrogów
  • Krakusłącznie 25 000 m
  • Szary z Roswelltylko ze skrzynek kosmicznych

Reklamy tylko z nagrodą

Żadna reklama nie przerywa biegu. Gracz sam decyduje, czy obejrzy.

  • Drugie życie1 na bieg, 5 s na decyzję
  • ×2 kasy z biegu1 na bieg
  • +2 skrzynki3 razy dziennie
  • Darmowa rzadka skrzynkaraz na 4 godziny

Grafika i dźwięk

Wszystko powstaje w kodzie

Grafika zastępcza jest od razu w docelowych rozmiarach i palecie, więc docelowe sprite'y z Aseprite podmienia się bez zmian w grze.

Sprite'y

Kuźnia sprite'ów rysuje pixel art z prostych brył i od razu tworzy mapy normalnych. Dzięki temu działa oświetlenie 2D: antenka Zorpa, reflektory jeepa, latarnie, ogień wraku i lampy alarmowe.

Ekran

Bazowa rozdzielczość to 480×270, skalowana zawsze o całą wielokrotność, np. 600×270 ×4 na telefonie 2400×1080. Parallax ma 6 warstw. Czcionka 5×7 px z polskimi znakami jest własna.

Dźwięk

Efekty powstają jak w jsfxr, a muzyka z małego sekwencera: każda strefa ma swój motyw. Perkusja, arpeggio i melodia dochodzą wraz z prędkością.

Plan

Etapy z dokumentu projektowego

  1. 1Prototyp ruchubieg, skok, podwójny skok, ślizg, szybkie lądowanie, koniec przy zerzegotowe
  2. 2Pętla grykasa za dystans, podsumowanie, Warsztat, zapis postępugotowe
  3. 3Treść strefy 1kawałki trasy, monety, puszki, trampoliny, Perfect, combo, jeepgotowe
  4. 4Grafikasprite'y, parallax, oświetlenie 2D, hit-stop, kurz, trzęsienie ekranugotowe
  5. 5Kolejne strefymiasteczko, las, baza; szeregowy, helikopter, czołg, agent; pętlagotowe
  6. 6Skrzynki, gadżety, skórki3 rzadkości, 4 gadżety, skórki za osiągnięciagotowe
  7. 7Interfejs i dźwiękwszystkie ekrany, PL/EN, muzyka, samouczek, introgotowe
  8. 8Wersja na telefonCapacitor, dotyk, pełny ekran, AdMob testowy, APKgotowe
  9. 9Balans i publikacjatesty z ludźmi, poprawki liczb, docelowe sprite'y i dźwięki, własne AdMob, Google Playw toku