📖 Game Guide

HOW TO PLAY

VisionHunt uses your device camera and YOLOv8 AI to detect real-world objects. Here's everything you need to know to start hunting.

STEP-BY-STEP GUIDE

01

Launch the Game

Open VisionHunt on your mobile device. Grant camera permissions when prompted — the game needs your camera to detect real-world objects.

💡Make sure you're in a well-lit environment for best detection accuracy.
02

Choose Your Difficulty

Select Easy (3 objects, 3 min), Medium (5 objects, 2 min), or Hard (8 objects, 90 sec). Harder modes give more points but require faster hunting!

💡Start with Easy to get familiar with how detection works.
03

Get Your Hunt List

The game generates a randomized list of everyday objects for you to find. These are common COCO dataset objects that YOLOv8 can detect.

💡Objects are drawn from 80+ COCO categories including people, furniture, food, vehicles, and more.
04

Point & Detect

Point your camera at objects around you. YOLOv8 runs inference in real-time, drawing bounding boxes around detected objects with confidence scores.

💡Hold the camera steady for 1-2 seconds to get a stable detection reading.
05

Earn Points & Streaks

When a target object is detected with ≥70% confidence, it's marked as found. Higher confidence = more points. Find objects consecutively to build streaks for multipliers (×1.5 at 2, ×2 at 3+).

💡Plan your route to find objects in quick succession for maximum streak bonuses.
06

Complete the Hunt

Find all objects before the timer runs out! Completing the full list earns a completion bonus. Your final score is submitted to the global leaderboard.

💡Even partial completions earn points — every object found counts!

SCORING SYSTEM

Understand how points are calculated

100–200 pts
Base Detection
Per object found (varies by rarity)
+0–50 pts
Confidence Bonus
Higher confidence = more points
2 in a row
Streak ×1.5
Find 2 objects consecutively
3+ in a row
Streak ×2
Find 3 or more consecutively
+500 pts
Completion Bonus
Find all objects in the hunt
+100–300 pts
Speed Bonus
Finish with time remaining

DETECTABLE OBJECTS

VisionHunt uses the COCO dataset — 80+ object categories that YOLOv8 can recognize

People & Animals

personcatdogbirdhorse+more

Furniture

chaircouchbeddining tabletoilet+more

Electronics

laptopphoneTVkeyboardmouse+more

Kitchen

cupforkknifespoonbowlbottle+more

Vehicles

carbicyclemotorcyclebustruck+more

Outdoor

benchfire hydrantstop signtraffic light+more

TIPS & TRICKS

💡

Good Lighting

YOLOv8 performs best in well-lit environments. Natural daylight or bright indoor lighting gives the highest confidence scores.

📐

Proper Distance

Keep objects at a comfortable distance — not too close, not too far. About 1-3 meters works best for most objects.

🎯

Center the Object

Try to center the target object in your camera frame. The model detects objects across the full frame but centered objects tend to score higher.

Plan Your Route

Before starting, think about where you might find the objects on your list. A good plan saves precious seconds.

🔄

Build Streaks

Find objects in quick succession to build your streak multiplier. A ×2 multiplier doubles all your points!

🏃

Speed Matters

Finishing the hunt quickly earns a speed bonus. But don't rush so much that you miss objects — accuracy matters too.

THE TECHNOLOGY

VisionHunt is a capstone project exploring real-time computer vision in mobile gaming

YOLOv8 Model

You Only Look Once (YOLO) is a state-of-the-art, real-time object detection algorithm. YOLOv8 by Ultralytics processes images in a single forward pass, making it fast enough for real-time mobile inference. It can detect 80 object categories from the COCO dataset with high accuracy.

How Detection Works

Each camera frame is passed through the YOLOv8 neural network, which outputs bounding boxes, class labels, and confidence scores for all detected objects. The game checks if any detected object matches your hunt list with a confidence threshold of ≥70%.

Project Stack

YOLOv8 (Ultralytics)PythonReact NativeOpenCVFastAPITensorFlow LiteCOCO DatasetComputer Vision

READY TO START?

You know the rules. Now go hunt!

PLAY NOW