Mickey's Retro Adventure Run

A premium, modern side-scrolling platformer game (Mario-style) featuring Mickey Mouse. Built using an HTML5 Canvas frontend, synthesized 8-bit sound effects (via Web Audio API), a glassmorphic user interface, and a Python Flask server backend.

Game Features

• Custom Player Physics: Double-buffering canvas rendering with acceleration, gravity, deceleration, and bounds collision detection.
• Dynamic Mickey Vector Sprite: Renders Mickey Mouse dynamically on the canvas using coordinate-offset vector paths (legs, body, ears, face, buttons, and shoes) that animate when running or jumping.
• Retro Audio Synthesizer: Uses the browser's Web Audio API to create authentic 8-bit sounds (jump, coin collection, stomping enemies, losing lives, game over, and victory tunes) without loading heavy audio assets.
• Parallax Background: Multi-layer background (Sky, Mountain Silhouette, Hills) scrolling at different rates to create depth.
• Interactive Hazards & Enemies: Collect coins, jump on walking Shadow Blots (Goombas) to defeat them with sparkle particles, avoid falling into bottomless pits, and reach the Golden Star to win!

---

How to Run & Deploy

You can run the game in three different ways depending on your system:

Option 1: Run Natively using Python (No Docker Required)

If you already have Python installed (since you run Dash apps, this will work out-of-the-box):

1. Open PowerShell and navigate to the project directory:

   cd "C:\Users\Admin\OneDrive\문서\my_first_project\mickey-mario-game"

2. Run the helper script to verify/install Flask and start the web server:

   .\run_local.ps1

3. The game will automatically open in your browser at http://localhost:8080.

Option 2: Run in a Local Docker Container

If you decide to install Docker in the future:

1. Open PowerShell in this directory.
2. Run the Docker launcher script:

   .\run_docker.ps1

3. This builds the Docker image and runs the container, binding it to port 8080 (accessible at http://localhost:8080).

Option 3: Deploy to Google Cloud Run (No Local Docker Needed!)

You can deploy this game directly to the web on Google Cloud Run. By using the --source option, Google Cloud Build compiles the Docker image remotely, meaning you do not need Docker installed locally:

1. Make sure you have the Google Cloud SDK installed.
2. Open PowerShell in this directory.
3. Run the deployment script:

   .\deploy.ps1

4. Once completed, the script will display your live, secure, publicly accessible HTTPS URL.