Welcome to QR Scavenger Hunt
⚡ Quick Start (30 Seconds)
- Click Start Game
- Add at least 5–10 items (locations or objects)
- Print QR codes for each item
- Players scan QR codes to unlock items
- First players to complete all items win 🎉
What is QR Scavenger Hunt?
QR Scavenger Hunt is a live, interactive game where players:
- Scan QR codes
- Unlock clues and locations
- Progress through a hunt or story
- Compete to finish first
Perfect for:
- Bars & venues
- Team-building events
- Corporate activations
- Parties & festivals
- Escape-room style experiences
What Makes It Unique
Unlike traditional scavenger hunts:
Players use their phones to scan QR codes
The host controls the entire experience
Each item can include:
- Clues (riddles, hints)
- Images
- Reveal messages
- Videos
You can run:
- Free exploration hunts
- Step-by-step story adventures
👉 The game can feel like:
- A scavenger hunt
- A puzzle game
- A mini escape room
- A story-driven quest
The Main Parts of QR Scavenger Hunt
The Host Console (YOU use this)
What it is: Your control panel for building and running the hunt.
What you do:
- Create scavenger items (locations/challenges)
- Add clues, images, and reveal content
- Generate QR codes for each item
- Start and control the game
- Track players and winners
- Manage themes and ads
👉 You build the entire experience here.
The Controller (Players’ Phones)
What it is: The player’s mobile game interface.
What players do:
- Scan QR codes to unlock items
- Read clues and hints
- View images and content
- Watch reveal videos
- Track progress through the hunt
👉 Everything runs in the browser — no app required.
The HUD (Big Screen Display)
What it is: The shared event screen.
Shows:
- Join instructions + QR code
- Game activity
- Recently unlocked items
- Player events
- Visual themes and ads
👉 Think: scoreboard + live event screen
Typical Game Flow
- Create your scavenger hunt (items + clues)
- Print or place QR codes in real locations
- Start the game
- Players join on their phones
- Players scan QR codes to unlock items
- Clues guide them to the next item
- First players to complete all items win
- Winners are displayed
How to Create a Scavenger Hunt
Step 1: Add Items (Challenges or Locations)
In the Host Console:
- Enter an item (example: “Front Desk”)
- Click + Add
Each item becomes a step in the hunt
👉 These are the actual things players must find or scan
Step 2: Customize Each Item
For each item, you can add:
Clue (Hint)
- Written in Markdown
- Can be a riddle or direction
- Optional AI riddle generator available
👉 You can even auto-generate riddles using AI
Reveal Message
Shown after the item is unlocked
Can:
- Confirm success
- Give the next hint
- Continue a story
Image (Optional)
- Upload your own image
- Or generate one with AI
Video Reveal (Optional)
- Upload an MP4 video
- Plays when the item is unlocked
👉 Great for storytelling or sponsor content
Step 3: Arrange the Order
- Drag items up/down
- Order matters for progressive mode
Game Modes (How Players Progress)
1. Free Exploration
Players can unlock items in any order
Works best for:
- Open environments
- Casual play
2. Progressive (Story Mode)
- Players must unlock items in sequence
- Each clue leads to the next
👉 This creates a guided adventure or escape-room experience
AI Adventure Builder (Power Feature)
You can generate an entire game instantly.
How it works:
- Click AI Adventure Builder
- Enter a theme (example: “Pirate Treasure”)
- Choose number of steps
- Click Generate
The system creates:
- A full storyline (prologue)
- Connected challenges
- Reveal messages that guide players forward
👉 This turns your game into a narrative experience
QR Codes (Core Gameplay)
Each item has a unique QR code.
How it works:
- Players scan a QR code
- The system validates it
- The item is unlocked instantly
👉 QR codes are securely tied to each item (not guessable)
Printing QR Codes
From the Host Console:
- Click the QR icon next to an item
- Print or display the QR code
- Place it at the real-world location
How Players Play
- Join the game
- Tap Scan QR
- Find a location or object
- Scan the QR code
- Unlock the clue or reveal
- Continue until complete
Player Experience Includes:
- Locked/unlocked items
- Clues and images
- Progress tracking
- Reveal messages and videos
👉 Locked items stay hidden until unlocked (in progressive mode)
Winning the Game
A player wins when:
- All items are unlocked
The system tracks:
- Completion time
- Rank (1st, 2nd, etc.)
👉 Winners are automatically recorded and displayed
Saving & Reusing Scavenger Hunts
Save a Set
- Click Save Set
- Enter a title
- Save
Load a Set
- Click Load Set
- Choose a saved game
- Start instantly
👉 Great for recurring events
Printing Game Cards (Optional)
You can print:
- Item lists
- Clues
- Images
Useful for:
- Hybrid (digital + physical) games
- Backup play
Themes & Visuals
Background Themes
You can:
- Generate with AI
- Upload your own image
- Change during gameplay
HUD Display Modes
Choose how the screen behaves:
- Dashboard
- Player Events
- Alternating
👉 Keeps the event visually engaging
Promo Ads (Optional)
You can play:
- Video ads
- Audio + image ads
Used for:
- Sponsors
- Announcements
- Promotions
Host Tips
👉 Use progressive mode for story-driven experiences 👉 Use free mode for large, open environments 👉 Keep clues short and fun (not too hard) 👉 Mix visual + text clues for better engagement 👉 Add a video reveal for big moments
Common Mistakes to Avoid
- Not placing QR codes clearly in locations
- Making clues too vague or too hard
- Mixing progressive and free expectations
- Forgetting to test QR codes before the event
- Not having enough items (aim for 5–15 minimum)
First-Time Host Checklist
- Add 5–10 items
- Add clues (or use AI)
- Generate QR codes
- Place QR codes physically
- Start the game
- Have players scan and play
- Watch the winners roll in 🎉