πŸ—οΈ

Hunt Creator Guide

Everything you need to build unforgettable scavenger hunts β€” from your first stop to a live event with a full team.

In this guide

  1. Two Ways to Build a Hunt
  2. Starting on the Web (Recommended for Planning)
  3. Starting on Mobile (Recommended for Field Work)
  4. Syncing Between Web and Mobile
  5. The Four Validation Modes
  6. Tips for Great Hunts

Two Ways to Build a Hunt

Questing RL is designed so you can build hunts from wherever you are β€” at your desk writing riddles, or standing at the very spot you want players to discover. The web editor and the mobile app are two windows into the same hunt. Changes in one appear in the other.

πŸ–₯️ Web Editor (questingrl.com/portal)

  • Full-screen writing space for riddles and narration
  • Spellcheck and reading level feedback
  • Quiz question builder
  • Hunt settings and event scheduling
  • Photo upload from your computer
  • Publish and share with a join code

πŸ“± Mobile App

  • Mark GPS locations in the field
  • Capture reveal photos on the spot
  • Test the hunt as a player before publishing
  • Add or edit clues while you walk the route
  • Download web-created hunts for field finishing
  • Push GPS coordinates back to the web editor
The golden workflow: Write on the web. Walk on mobile. Draft your riddles and narration at your desk where you can think clearly. Then walk the route with the app, mark each stop, and the coordinates sync back to the web automatically.

Starting on the Web

The web editor is the best place to begin when you know the route but want to write content before visiting the locations. It's also ideal when you're building an indoor hunt, a knowledge challenge, or any event where the writing matters more than GPS precision.

Creating your first hunt

1
Sign in at questingrl.com

Click Creator Portal in the top navigation. You'll need a Creator account β€” subscribe at questingrl.com/subscribe.

2
Click "New Hunt" and give it a name

Your hunt starts as a Draft β€” nothing is visible to players yet. You can rename it any time by clicking the title.

3
Add stops

Click "+ Add Stop" for each location in your hunt. Give each stop a name, write the riddle players will read while searching, and write the narration they'll hear when they find it.

4
Write riddles and narration

The riddle is what players read while searching β€” make them think, not just follow. The narration is read aloud by the app when a player finds the stop β€” tell the story of the place. Both fields have spellcheck and word count.

5
Add GPS coordinates later

If you haven't walked the route yet, leave the location blank. The stop will show a ⚠️ indicator but will still save. Finish GPS placement in the field with the mobile app.

6
Publish when ready

Once at least two stops have a riddle, narration, and GPS coordinates, the Publish button activates. Publishing generates a 6-character join code your players use to join the hunt from the mobile app.

The stop editor

Click any stop in the left column to open it in the editor panel. Each stop has two tabs:

Autosave is always on. Every change saves automatically after a brief pause. You'll see "Saving…" and then "Saved 10:42" in the top bar. There's no Save button β€” you can never lose your work.

Hunt settings

The right panel holds settings that apply to the whole hunt:

Starting on Mobile

The mobile app is the best starting point when you want to walk the route first and capture locations as you go β€” adding content as inspiration strikes. Everything you create on mobile syncs to the web editor automatically when you download or refresh from the Creator Portal.

Building a hunt while walking the route

1
Open the Hunts tile on the home screen

Tap "Create New Hunt" and give it a name. Your hunt starts as a Draft.

2
Walk to your first stop

Tap "+ Add Stop" when you're standing at the location. The app reads your GPS position and saves it to the stop automatically.

3
Use Field Mode for speed

In Field Mode you can quickly add a name and photo for each stop and come back later to write the riddle and narration. Each stop shows ⚠️ indicators for anything that's still missing.

4
Switch to Full Details to write content

Tap the Full Details toggle to access the guided editor with all fields β€” riddle, narration, hint, and validation questions. Write at the stop or come back to it later from anywhere.

5
Open in the web editor when you're back at your desk

Sign in to questingrl.com/portal from a browser. Your hunt will appear in your hunt list β€” click Edit to open the full web editor where you can polish the writing with spellcheck and a larger screen.

Reveal photos: Take photos in the field at each stop β€” the app captures them directly from your camera. These are shown to players when they successfully find the stop. You can also upload photos from your computer in the web editor.

Syncing Between Web and Mobile

The web editor and mobile app share the same cloud hunt. Here's how to move between them smoothly.

Downloading a web-created hunt to mobile

When you've built a hunt in the web editor and need to walk the route to add GPS coordinates or take photos:

  1. Open the mobile app and sign in with your Creator account.
  2. Tap the ☁️ My Cloud Hunts tile on the home screen.
  3. Your web hunts appear with a download button. Tap πŸ“₯ Download to App.
  4. Tap Open in Builder β†’ once downloaded.
  5. Walk to each stop and tap it to mark your GPS location.
  6. GPS coordinates automatically push back to the web editor β€” open the web portal and you'll see them appear on each stop.

Pushing a mobile hunt to the web for editing

Hunts created on mobile are visible in the web Creator Portal automatically as long as you're signed in with the same Creator account on both. Open questingrl.com/portal in a browser, find your hunt, and click Edit.

Why switch between them?

Use the Web When…

  • Writing long riddles or narration
  • Building quiz questions
  • Uploading photos from your computer
  • Scheduling an event window
  • Publishing and sharing the join code
  • Reviewing all stops at a glance

Use Mobile When…

  • Walking the route for the first time
  • Marking GPS coordinates precisely
  • Taking reveal photos on location
  • Testing the hunt as a player
  • Making quick edits in the field
  • Running the live event on the day
One hunt, two tools. You never need to choose one or the other. The best hunts are built with both β€” planned thoughtfully on the web, finished precisely in the field.

The Four Validation Modes

Validation mode controls how a player proves they've found a stop. You can set a different mode for every stop in your hunt β€” mix and match to create variety and challenge.

πŸ“ GPS Only Default

The player must be physically standing within range of the stop. The app checks their position and unlocks the stop automatically when they're close enough. No interaction required beyond being there.

Best for: Standard stops where presence is the only requirement. Landmarks, viewpoints, outdoor locations with clear open sky.

Set the radius thoughtfully. 8–15 meters works well for open outdoor spots. 20–30 meters is better near buildings or inside areas where GPS can drift.

❓ Quiz Only Knowledge Challenge

No GPS check β€” the stop is unlocked entirely by answering questions correctly. Players could answer from anywhere, so this works for indoor stops, knowledge-based challenges, or situations where GPS isn't reliable.

Best for: Indoor locations, areas with poor GPS signal, knowledge trivia stops, or hunts where the challenge is intellectual rather than physical.

Tip: Write questions that require actually reading something at the location β€” a plaque, a sign, a piece of art β€” so the knowledge proves they were really there.

πŸ”€ Either β€” GPS First, Questions as Fallback Flexible

The app tries GPS first. If the player is within range, the stop unlocks. If GPS fails β€” poor signal, a cloudy day, a canyon β€” the app offers the quiz questions as an alternative path to completing the stop. Either method counts as a successful find.

Best for: Stops where GPS can be unreliable β€” near tall buildings, under heavy tree cover, or in urban canyons. Gives players a way through without feeling stuck.

Note: In this mode, questions are a consolation path, not an additional challenge. Players who succeed on GPS never see the questions.

πŸ” GPS + Questions β€” Both Required Puzzle Station

GPS confirms the player is physically present at the location. Then β€” only after GPS succeeds β€” the quiz questions are presented. The player must answer correctly to complete the stop. GPS failure blocks progress entirely; there is no fallback.

Best for: Stops where you want to verify both location and task completion β€” buried treasure hunts where players dig or search for something, puzzle boxes where the questions are part of the challenge, or multi-step stops where players must interact with something at the location and report back what they found.

Example: Players arrive at a location (GPS confirmed), find the hidden lockbox, open it, and read the message inside. The questions ask "What was the first word on the note?" and "How many coins were in the box?" Only someone who was there and completed the task can answer correctly.

Quiz questions don't have to be trivia. The best questions are ones that require players to do something β€” read a sign, count objects, find a specific detail, or open something. Use questions to prove engagement, not just presence.

Building quiz questions

Questions are built in the ❓ Questions tab of the stop editor β€” available in both the web editor and the mobile app. Each stop supports multiple questions with two formats:

Additional question settings per stop:

Tips for Great Hunts

Write riddles that make people think

The best riddle doesn't describe the destination β€” it makes players figure it out. "Walk to where the town's history began" is more interesting than "Go to the old courthouse." Give enough to search, not enough to simply follow.

Make the narration worth hearing

The narration plays when a player finds the stop β€” it's your voice in their ear at the moment of discovery. Don't just say "Good job, you found it." Tell them something they wouldn't have known. The history of the building. The story behind the statue. The reason this place matters. That's what people remember.

Use the reading level indicator

The web editor shows the reading level of your narration as you type. "Very Easy" or "Easy" is ideal for family hunts and groups with mixed ages. "Moderate" works well for adult events. Aim for the level that fits your audience.

Set GPS radius based on the environment

Walk the route as a player before publishing

Before you publish, walk the entire hunt using the mobile app in player mode. You'll find riddles that are too vague, GPS radii that are too tight, and stops that are harder to find than you intended. The best hunts are the ones that have been tested by the person who made them.

Draft freely, publish when ready

Your hunt stays in Draft until you choose to publish it. Drafts don't need complete stops β€” add GPS later, finish the writing later, upload photos later. The ⚠️ indicators tell you what's still needed. Nothing has to be perfect to save.

Questions? We're here to help.

Visit Support β†’
← Back to Questing RL

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.