Snowy Cosmic Adventure (Snowy: Kosmiczna Przygoda) - Multiplatform Recompilation & Launcher

An open offline project and recompiled engine wrapper for the classic PC arcade game "Snowy: Cosmic Adventure" (Snowy: Space Trip).

This repository provides an offline build setup, asset extraction pipeline, input emulation layer, and platform toolchain configurations for modern desktop, mobile, and console systems.

---

Features & Highlights

• Zero-Dependency Asset Extractor:
  • Automatically unpacks and decrypts all 464 authentic DDS textures, OGG audio tracks, INI game settings, and TPK level packs directly from your legitimate SnowyKosmicznaPrzygodaSetup.exe installer without requiring external tools like innoextract.
  • Pure Python 3 standard library implementation (scripts/extract_assets.py & scripts/extract_assets.sh).
• Comprehensive Input Emulation Layer:
  • Translates traditional PC keyboard controls into gamepad (XInput / SDL GameController) and on-screen touch controls (virtual D-Pad, Jump, and Action buttons) for smartphones, tablets, and handheld consoles.
• Embedded DDS Texture Loader:
  • Pure C++ DirectDraw Surface (DXT1 / DXT3 / DXT5) decompression to render authentic original sprites natively on modern OpenGL, Metal, DirectX, and software renderers across all platforms.
• Cross-Platform Toolchains:
  • Ready-to-build configuration covering desktop, mobile, and homebrew console platforms.

---

Controls & Input Mapping

The input emulation layer unifies all control schemes into standard game actions:

Action Keyboard (PC) Gamepad (Xbox / PS / Switch / Handhelds) Touch Screen (Mobile / 3DS / Vita) Move Left Left Arrow / A D-Pad Left / Left Stick Left Virtual D-Pad Left Move Right Right Arrow / D D-Pad Right / Left Stick Right Virtual D-Pad Right Look Up / Ladder Up Arrow / W D-Pad Up / Left Stick Up Virtual D-Pad Up Duck / Down Down Arrow / S D-Pad Down / Left Stick Down Virtual D-Pad Down Jump Space Button A / Cross (✕) Right Virtual Button [Jump] Fire / Kick Left Ctrl / Z Button X / Square (□) Inner Virtual Button [Fire] Pause P Start / Menu Top Virtual Button [Pause] Back / Exit Esc Button B / Circle (◯) Bottom / Back button

---

📦 Asset Extraction

Place your authentic installer SnowyKosmicznaPrzygodaSetup.exe into the project root directory and run:

# Using Python directly (zero third-party dependencies required):
python3 scripts/extract_assets.py

# Or using the shell wrapper:
./scripts/extract_assets.sh

All 464 game assets (sounds, music, sprites, level files) will be decrypted into ./assets/.

---

🖥️ Building for Supported Platforms

1. Windows 10 (x86) & Windows 11 (x64)

• Install CMake and Visual Studio 2019/2022 (or MinGW-w64).

# 64-bit build
cmake -B build -A x64
cmake --build build --config Release

# 32-bit build (Win10 x86)
cmake -B build -A Win32
cmake --build build --config Release

2. Linux & BSD

• Install libsdl2-dev and cmake:

cmake -B build
cmake --build build
./build/snowy

3. macOS

brew install sdl2 cmake
cmake -B build
cmake --build build

4. Android & iOS

• Use the standard SDL2 Android/iOS project template with CMake.
• Set -DSNOWY_TOUCH_UI=ON during configuration to enable virtual touch overlays.

5. Consoles & Handhelds (Homebrew)

• Nintendo 3DS: Build using devkitARM + 3ds-sdl2.
• PlayStation Vita: Build using VitaSDK + vita-sdl2.
• Nintendo Wii: Build using devkitPPC + wii-sdl2.
• HaikuOS: Install SDL2 from HaikuDepot and build using CMake.

See docs/PLATFORMS.md for full toolchain instructions and platform matrix. Made With SI. Please Support The Snowy Creators.