Terra Raccoons — Telegram Idle Clicker
Przeglądarkowa gra idle w Telegramie. Gracz buduje kosmiczną kolonię szopów: terraformuje planety, wydobywa zasoby, zbiera statki, wysyła ekspedycje, łapie rzadkie wydarzenia. Zrobiłem to samodzielnie od zera — od pomysłu do sprzedaży.
Graj → @TerraRaccoonsBot
Mechaniki gry (30+)
1. Terraformowanie planet — przekształcanie martwych światów w zamieszkałe
2. 10 unikalnych planet (3D-kanał, 4 stany na każdą)
3. Drony G1–G5 — wydobywają zasoby, gdy jesteś offline
4. Ulepszanie dronów na poziomach
5. 11 umiejętności z losową generacją nazw przez gacha, umiejętności się łączą
6. Klikacz na dronach do aktywnej gry
7. Stacje — ulepszanie magazynów i produkcji
8. Przemieszczanie dronów między stacjami
9. Statki 5 rzadkości (G1–G5) z unikalną grafiką
10. Gacha-skrzynki na statki
11. System Merge — łączenie duplikatów w bardziej rzadkie
12. Hangar statków i dronów z sortowaniem i filtrami
13. Ekspedycje — 8 typów o różnej długości i nagrodzie, bezpośrednia zależność z mechaniką statków
15. Przyspieszenie i wcześniejsze zakończenie ekspedycji
16. System VIP
17. Tablica liderów
18. Rynek — transakcje online między graczami
19. Globalne wydarzenia z powiadomieniami w bocie (kontrakt szopów, anomalia, starożytny sygnał, zniekształcenie czasu)
20. 20+ misji, codziennych i długoterminowych
21. Postęp po planetach — odblokowują się w miarę wzrostu
22. Sklep z pakietami zasobów
23. Waluta premium Terrafract
24. Konwersja zasobów
25. Reklama do przyspieszania postępu
26. Płatności przez Telegram Stars i TON Wallet (w trakcie)
27. 14 języków (ru, en, zh, tr, it, pl, pt, es, de, fr, ja, uk, ar, hi)
28. Autoryzacja jednym dotknięciem przez Telegram
29. Offline-postęp — nagrody gromadzą się, gdy cię nie ma
30. Onboarding dla nowych graczy
31. Animacje i efekty przy zbieraniu nagród
32. Adaptacyjny mobilny interfejs
33. Powiadomienia o gotowości dronów i statków
Co czuje gracz: wchodzisz na kilka minut pięć razy dziennie i za każdym razem dostajesz coś nowego — zasoby się zgromadziły, ekspedycja wróciła, wypadł rzadki statek. Bez agresywnych paywalli: można grać za darmo, donacja przyspiesza, ale nie jest obowiązkowa.
## Część techniczna
Stos: React 18, Vite, Zustand, Tailwind CSS / Node.js, Express, TypeScript, SQLite / JWT na Telegram initData / Winston / VDS na Linux, nginx, PM2 cluster.
Architektura:
- SSOT na froncie. Jeden Zustand-store przechowuje cały stan, komponenty subskrybują na wycinki. Żadne duplikowanie między useState a serwerem.
- Hot-domain na backendzie. In-memory cache nad SQLite dla gorących operacji (zbieranie zasobów, przemieszczanie dronów, ticki stacji) z opóźnionym zapisem przez FlushScheduler — baza danych nie dusi się pod obciążeniem.
- Cienkie kontrolery, gruby domen. Trasy tylko analizują zapytanie i wywołują funkcje domenowe, logika biznesowa testowana bez HTTP.
- Dynamiczne chunkowanie i18n. Każdy język w osobnym pliku, ładowany na żądanie — startowy pakiet nie jest napuchnięty na 14 lokalizacji.
- ErrorBoundary z czytelnym wyjściem. Błędy renderowania są łapane i pokazywane na ekranie ze stosem, zamiast niebieskiego ekranu. Krytyczne dla Telegram WebView bez DevTools.
- Anti-abuse wielowarstwowy. Ekspedycje chronione bramką według postępu, wymaganiem terraformowania, ponowną weryfikacją zdarzenia przy zbieraniu, nerfem typów exploitowych.
Symulator ekonomii. Oddzielne narzędzie, uruchamiające setki wirtualnych graczy i obliczające ROI źródeł, retention, convergence, profitability gap dla F2P i płacących. Używane do trzech dużych rebalance'ów (V1→V2→V3→soft-deficit), aby osiągnąć równy ROI wszystkich 11 źródeł i zapasów przy okrągłych liczbach.
Deploy. Jedna komenda: git pull && pm2 restart terra-backend && cd terra-gaming && npm run build. Front i back na jednym VDS, nginx serwuje statykę, proxy /api na Express. Bez Dockera i CI/CD — można naprawić ręcznie w minutę.
Co zrobiłem: prototyp w figmie, 3D zasoby, architektura, baza danych, API, frontend, UI/UX, ekonomia, balansowanie, deploy, panel administracyjny. Gra w zamkniętej becie.
Graj → @TerraRaccoonsBot
Mechaniki gry (30+)
1. Terraformowanie planet — przekształcanie martwych światów w zamieszkałe
2. 10 unikalnych planet (3D-kanał, 4 stany na każdą)
3. Drony G1–G5 — wydobywają zasoby, gdy jesteś offline
4. Ulepszanie dronów na poziomach
5. 11 umiejętności z losową generacją nazw przez gacha, umiejętności się łączą
6. Klikacz na dronach do aktywnej gry
7. Stacje — ulepszanie magazynów i produkcji
8. Przemieszczanie dronów między stacjami
9. Statki 5 rzadkości (G1–G5) z unikalną grafiką
10. Gacha-skrzynki na statki
11. System Merge — łączenie duplikatów w bardziej rzadkie
12. Hangar statków i dronów z sortowaniem i filtrami
13. Ekspedycje — 8 typów o różnej długości i nagrodzie, bezpośrednia zależność z mechaniką statków
15. Przyspieszenie i wcześniejsze zakończenie ekspedycji
16. System VIP
17. Tablica liderów
18. Rynek — transakcje online między graczami
19. Globalne wydarzenia z powiadomieniami w bocie (kontrakt szopów, anomalia, starożytny sygnał, zniekształcenie czasu)
20. 20+ misji, codziennych i długoterminowych
21. Postęp po planetach — odblokowują się w miarę wzrostu
22. Sklep z pakietami zasobów
23. Waluta premium Terrafract
24. Konwersja zasobów
25. Reklama do przyspieszania postępu
26. Płatności przez Telegram Stars i TON Wallet (w trakcie)
27. 14 języków (ru, en, zh, tr, it, pl, pt, es, de, fr, ja, uk, ar, hi)
28. Autoryzacja jednym dotknięciem przez Telegram
29. Offline-postęp — nagrody gromadzą się, gdy cię nie ma
30. Onboarding dla nowych graczy
31. Animacje i efekty przy zbieraniu nagród
32. Adaptacyjny mobilny interfejs
33. Powiadomienia o gotowości dronów i statków
Co czuje gracz: wchodzisz na kilka minut pięć razy dziennie i za każdym razem dostajesz coś nowego — zasoby się zgromadziły, ekspedycja wróciła, wypadł rzadki statek. Bez agresywnych paywalli: można grać za darmo, donacja przyspiesza, ale nie jest obowiązkowa.
## Część techniczna
Stos: React 18, Vite, Zustand, Tailwind CSS / Node.js, Express, TypeScript, SQLite / JWT na Telegram initData / Winston / VDS na Linux, nginx, PM2 cluster.
Architektura:
- SSOT na froncie. Jeden Zustand-store przechowuje cały stan, komponenty subskrybują na wycinki. Żadne duplikowanie między useState a serwerem.
- Hot-domain na backendzie. In-memory cache nad SQLite dla gorących operacji (zbieranie zasobów, przemieszczanie dronów, ticki stacji) z opóźnionym zapisem przez FlushScheduler — baza danych nie dusi się pod obciążeniem.
- Cienkie kontrolery, gruby domen. Trasy tylko analizują zapytanie i wywołują funkcje domenowe, logika biznesowa testowana bez HTTP.
- Dynamiczne chunkowanie i18n. Każdy język w osobnym pliku, ładowany na żądanie — startowy pakiet nie jest napuchnięty na 14 lokalizacji.
- ErrorBoundary z czytelnym wyjściem. Błędy renderowania są łapane i pokazywane na ekranie ze stosem, zamiast niebieskiego ekranu. Krytyczne dla Telegram WebView bez DevTools.
- Anti-abuse wielowarstwowy. Ekspedycje chronione bramką według postępu, wymaganiem terraformowania, ponowną weryfikacją zdarzenia przy zbieraniu, nerfem typów exploitowych.
Symulator ekonomii. Oddzielne narzędzie, uruchamiające setki wirtualnych graczy i obliczające ROI źródeł, retention, convergence, profitability gap dla F2P i płacących. Używane do trzech dużych rebalance'ów (V1→V2→V3→soft-deficit), aby osiągnąć równy ROI wszystkich 11 źródeł i zapasów przy okrągłych liczbach.
Deploy. Jedna komenda: git pull && pm2 restart terra-backend && cd terra-gaming && npm run build. Front i back na jednym VDS, nginx serwuje statykę, proxy /api na Express. Bez Dockera i CI/CD — można naprawić ręcznie w minutę.
Co zrobiłem: prototyp w figmie, 3D zasoby, architektura, baza danych, API, frontend, UI/UX, ekonomia, balansowanie, deploy, panel administracyjny. Gra w zamkniętej becie.
Ukraina 
Gotowy do podjęcia pracy