World Wide Whale

Gamifying computer architecture into bite sized information

Comment

🐳 World Wide Whale

A friendly virus navigating the treacherous ocean of Computer Architecture.
“Why just read about how a CPU works when you can swim through it?”

💡 Inspiration

We wanted to make Cybersecurity and Computer Architecture feel a little less intimidating—and a lot more fun. The pun “World Wide Web” → “World Wide Whale” sparked the idea, and from there we imagined a data packet as a tiny whale swimming through the computer’s “ocean.”

We also drew inspiration from classic flash games like Flappy Bird and Fireboy & Watergirl. We aimed for that nostalgic, pick-up-and-play vibe, but with a modern EdTech twist.

🎮 What It Does

World Wide Whale is an educational infinite swimmer game that runs directly in your browser.

  • Your Mission: Play as a friendly virus (the Whale) injecting “knowledge” into the system. Navigate through L1 Cache, RAM, and HDD while avoiding Firewalls.
  • The Twist: Crashing into a Firewall doesn’t end the game—it launches a quiz challenge you must answer to break through.
  • AI-Powered Infinite Levels: Using the Gemini API, players can enter any topic (“Biology,” “Swiftie trivia,” “Quantum physics”), and the game instantly generates a custom level.
  • AI Tutor: After each question, Gemini appears as a witty “Decryptor,” explaining the answer in simple terms.

⚙️ How We Built It

We started in Godot, but when our web export failed, we made a last-minute pivot to a fully web-native build—with less than 12 hours left.

  • Frontend: Built from scratch with HTML5 Canvas and Vanilla JavaScript. We wrote our own lightweight physics engine for gravity, velocity, and collision detection.
  • AI Integration: Google Gemini 2.5 Flash generates structured JSON for questions and explanations.
  • Security & Backend: We deployed a Cloudflare Worker to securely proxy API requests without exposing credentials.
  • Art & Aesthetic: Custom pixel art animations (including a blinking whale) and CRT-style scanline effects for a retro hacker-terminal look.

🚧 Challenges We Ran Into

  • The Great Pivot: Godot Web Export kept crashing, forcing us to rebuild the entire game in JavaScript overnight. Stressful but worth it.
  • AI Hallucinations: Ensuring Gemini returned valid JSON required strict schema prompting and lots of testing.
  • Cross-Device Controls: Fine-tuning jump mechanics to feel smooth on both keyboard (Spacebar) and mobile touch.

🏆 Accomplishments We’re Proud Of

  • Education Through Resilience: Turning “game over” into a learning opportunity. Failure becomes a chance to understand the system better.
  • Seamless AI Integration: Gameplay flows naturally into AI-powered quizzes with minimal delay.
  • Cyber-Ocean Aesthetic: A visual identity that blends deep-sea blues with neon cyberpunk energy.

🧠 What We Learned

  • Serverless architecture and secure API proxying with Cloudflare Workers
  • Prompt engineering for reliable structured-output generation
  • Managing game state (Running, Paused, Quiz Mode) in raw JavaScript

🚀 What’s Next for World Wide Whale

  • Voice Mode: Integrating ElevenLabs so players can yell “Swim!” or answer quizzes by voice.
  • Multiplayer Mode: A race between two viruses to infect the kernel first.
  • Deep Dive Zones: Themed regions like a GPU heat core, a motherboard grid, and more.

Built With

Share this project:

Updates