Skip to content

Spatial-Six/keepit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 

Repository files navigation

KeepIt

KeepIt is an immersive Apple Vision Pro goalkeeping game that challenges players to defend a goal against progressively faster ball shots. Test and improve your reaction time in a 360° field environment.

Game Overview

Train your reflexes as a goalkeeper in this progressive difficulty game. Each level increases ball speed and reduces your reaction time window, helping you build faster, healthier responses to dynamic surroundings.

Gameplay Demo

Gameplay demonstration showing hand tracking saves

Key Features

  • Progressive 5-Level System: Ball speeds increase from 8.0 m/s to 27.0 m/s
  • Reaction Time Measurement: Precise calculation and tracking of your response times
  • Immersive 360° Environment: Full RealityKit football field with spatial audio
  • Hand Tracking Saves: Use natural hand movements to block incoming balls
  • Visual Feedback System: Real-time "SAVE!" and "MISS!" notifications with screen flash
  • Scoring System: Earn points for saves (500+ points required to advance)
  • Audio Controls: Toggle background music on/off
  • Game State Management: Pause, resume, and level progression

Game Mechanics

  • 10 balls per level with 3-second countdown before each ball
  • Random ball trajectories from various angles and heights
  • Target goal dimensions: 2m wide × 2m tall opening
  • Level progression: Must score 500+ points (5+ saves) to advance
  • Reaction time calculation: Based on ball flight distance (23.8m) and speed

Level Progression

Level Ball Speed Target Reaction Time
1 8.0 m/s 2.98 seconds
2 15.0 m/s 1.59 seconds
3 20.0 m/s 1.19 seconds
4 24.0 m/s 0.99 seconds
5 27.0 m/s 0.88 seconds

Technical Specifications

  • Platform: visionOS (Apple Vision Pro)
  • Language: Swift + SwiftUI
  • Frameworks: RealityKit, ARKit, Combine
  • 3D Assets: USDZ models for ball, goal, and grass field
  • Audio: MP3 background music with spatial audio support
  • Hand Tracking: ARKit pose detection for save gestures

Project Structure

KeepIt/
├── KeepIt/
│   ├── KeepItApp.swift          # Main app entry point
│   ├── GameState.swift          # Core game logic and state management
│   ├── ContentView.swift        # UI coordination and game phases
│   ├── ImmersiveView.swift      # 360° RealityKit environment
│   ├── MainMenuView.swift       # Menu interface
│   ├── AudioManager.swift       # Audio system management
│   └── Assets.xcassets/         # Visual assets and app icons
└── Packages/RealityKitContent/  # 3D models and materials

Getting Started

Requirements

  • Xcode 15+ with visionOS SDK
  • Apple Vision Pro device or simulator
  • macOS Sonoma 14.0+

Installation

  1. Clone the repository
  2. Open KeepIt/KeepIt.xcodeproj in Xcode
  3. Select your Vision Pro device or simulator
  4. Build and run the project

Value Proposition

KeepIt helps players develop faster, more accurate reactions to dynamic visual stimuli. By progressively challenging your response time in an engaging VR environment, the game promotes healthier brain responses and improved hand-eye coordination.

About

apple vision reaction game

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages