Sky Ring Flyer

CMPT 461 – Immersive Computing Final Project

A whimsical VR sky journey about guiding dreams through clouds and glowing rings.

---

Live Demo + Repository

• Play the Game
• View Repository

---

How to Run

Option 1: GitHub Pages

Open the live game using the GitHub Pages link above.

Option 2: Run Locally

1. Clone or download this repository.
2. Open the project folder in VS Code.
3. Run the project using the Live Server extension.
4. Open the local URL in a browser.

Recommended Browsers

• Chrome
• Safari
• Mobile browser on phone for VR mode

For the best mobile VR experience, open the game on a phone browser.

---

Controls

Desktop

• Move the mouse / look direction to steer the paper plane
• Click buttons to navigate the splash screen, story intro, and menus

Mobile VR

• Move or tilt the phone to control the plane direction
• Use the gaze cursor to activate buttons
• Tap the VR goggles icon for stereoscopic split-screen mode
• Insert the phone into a cardboard headset for immersive VR play

This project supports:

• gaze-based controls
• head-direction controls
• stereoscopic mobile VR support

---

Game Modes

Story Mode

• Begins with a 3-slide emotional story intro
• Progresses through:
• Level 1
• Level 2
• Level 3
• Ends at the magical Dream Finish gate

Endless Mode

• Infinite ring-flying gameplay
• Difficulty increases over time
• Selectable Day / Sunset / Night themes
• High score tracking using local storage

---

Features Checklist

• Custom original game idea
• Flash screen
• Setup menu
• At least 2 levels
• Sound effects and music
• Always-visible scoreboard
• Gaze and head-direction controls
• Stereoscopic mobile VR
• Custom textured objects
• Collision detection
• No violence
• Bonus Level 3
• Endless Mode
• Emotional story intro

---

Story Theme

The paper plane represents dreams that begin in childhood and continue through adulthood. Rings symbolize milestones, clouds represent obstacles, and the endless sky reflects how far belief can carry us.

---

Technical Highlights

• Built with A-Frame
• Custom procedural textures for rings and clouds
• Custom paper plane model
• localStorage high score saving
• HTML/CSS cinematic overlays for splash, story intro, and menu
• VR fallback UI inside the A-Frame scene
• Mobile orientation support for head-directed control
• Endless scenery recycling for infinite background continuity

---

AI Usage Disclosure

AI tools were used during brainstorming, gameplay polishing, UI refinement, README writing assistance, and debugging support.

All prompts used during development are documented separately for Moodle submission as required.

---

Author

• Name: Ratna Kosuhik Appasani
• Student ID: 650811