8000 GitHub - bazarkua/final-project-objecthunt: final-project-objecthunt created by GitHub Classroom
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

bazarkua/final-project-objecthunt

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ObjectHunt

A real-time multiplayer game where players race to find and photograph objects in specific locations. Built with Android, Node.js, and Google's ML technologies.

Gameplay Demo

Camera UI

Features 🎮

  • 2-Player Real-Time Competition using Socket.IO
  • Object Detection with Android ML Kit (client) + Google Vision API (server)
  • Location-Based Challenges
  • Live Score Tracking
  • Custom Game Rooms with Join Codes

Setup 🛠️

Server (Node.js)

  1. Clone repo:
    git clone https://github.com/bazarkua/final-project-objecthunt.git
    cd final-project-objecthunt/server
  2. Install dependencies:
    npm install
  3. Configure .env:
    GOOGLE_APPLICATION_CREDENTIALS="path/to/service-account.json"
    PORT=3000
  4. Start server:
    npm start

Client (Android)

  1. Open client/android-project in Android Studio
  2. Add google-services.json to app/ directory
  3. Build and run on device/emulator

Gameplay 🎯

// Example game flow:
1. Player A creates roomgets code "ABC123"
2. Player B joins with code "ABC123"
3. System generates challenge: "Find a [laptop] in the [library]"
4. First player to snap a valid photo wins the round!
5. Game continues until all objects are found

Tech Stack 💻

Component Technologies
Frontend Android (Kotlin), ML Kit, CameraX
Backend Node.js, Socket.IO, Google Vision API
Database Firebase Realtime Database
Auth Google Sign-In

About

final-project-objecthunt created by GitHub Classroom

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Kotlin 61.8%
  • JavaScript 34.8%
  • HTML 3.2%
  • CSS 0.2%
0