Engagement & games

Discord scavenger hunt bot: clues, secret codes and hidden buttons

Scavenger Hunt sends your members exploring your own server. Build a hunt of steps with clues in the console, start it now or schedule it, and players solve the steps in order with /clue: type a secret code, react to the right message or find a hidden button BotGG placed in a channel. Stuck players can buy a hint, and the first finishers win coins, a placement bonus and a role.

  • Works on the Free plan
  • 1 slash command
  • Set up in the web console
eventsDiscord preview

BotGGBOTToday at 20:14

🗺️ The Lost Server Map
Someone tore our server map into pieces and hid them everywhere.

Follow 6 clues through the server. Press Start hunting to get the first one!
Finish reward
🪙 500
Ends
in 2 days
Start huntingLeaderboard
The announcement when a hunt starts

What you get

Secret codes

A code step accepts up to five answers. Answers are compared without accents, case, spaces or punctuation, so “Dragon’s Lair” and “dragonslair” both count. Wrong answers start a short cooldown.

React to find it

A reaction step is solved by reacting in a channel, on one particular message or with one particular emoji. The next clue arrives by DM.

Hidden buttons

BotGG posts a button somewhere in your server when the hunt starts. It only works for players on that step; everyone else just reads “Nothing happens…”.

Hints for coins

Each step can have a hint. Players buy it once with Bank coins (free if the Bank is off), and you choose the price per step.

Rewards for the fastest

Finishers get the finish reward plus a bonus for 1st, 2nd and 3rd place, and a finish role. The first finishers are shouted out and the end post shows the podium.

Schedule it ahead

Set a start and end time and the hunt opens and closes by itself, with announcements in the channel you choose.

How it works

  1. Turn on Scavenger Hunt

    Open https://console.botgg.app, choose your server and turn on Scavenger Hunt in the Engagement section. Pick an announcement channel and the default hint price.

  2. Build the hunt

    Add a title and a description, then steps in order: the clue, how it is solved (code, reaction or hidden button) and an optional hint. Live previews show every clue and button.

  3. Start or schedule it

    Start it now or set a start and end time. The start post has Start hunting and Leaderboard buttons, and hidden buttons appear in their channels.

  4. Players follow the clues

    Players use /clue play for their current clue, /clue answer for codes and /clue hint when stuck. /clue leaderboard shows who finished first.

A server-wide adventure for events and launches

Hunts are perfect for anniversaries, holiday events, a new channel launch or simply showing newcomers around. Clues never give away where an action step happens (the clue text does), and everything a player sees is private to them, so nobody can copy the next answer from the chat.

Free servers can have 3 scheduled or running hunts at a time and Pro servers 25; a hunt can have up to 25 steps. While a hunt runs you can still fix clue texts, answers, hints, rewards and the end time. The console shows a step funnel so you can see where players get stuck.

  • /clue play and /clue list: your current clue and the hunts running now
  • /clue answer and /clue hint: answer a code step or buy a hint
  • /clue leaderboard: who finished first

Slash commands

Generated from the bot’s real command definitions. Full list on the commands page.

/clueScavenger hunts: follow the clues, solve the steps, win rewards5 subcommands
  • /clue playhunt?Show your current clue (joins the hunt)
  • /clue answercodehunt?Answer your current clue with a code
  • /clue hinthunt?Get a hint for your current step
  • /clue leaderboardhunt?Who finished first
  • /clue listHunts running right now

Commands

Free vs Pro

Every feature works on the Free plan. Pro raises the limits and unlocks extras.

LimitFreePro
Live scavenger hunts325

What Pro adds See pricing

Frequently asked questions

How do I make a scavenger hunt on Discord?

Turn on Scavenger Hunt in the BotGG console, create a hunt and add steps with clues and answers. Start it now or schedule it, and members play with /clue play.

Why is the command /clue and not /hunt?

BotGG already uses /hunt for the economy game, so scavenger hunts live under /clue: play, answer, hint, leaderboard and list.

What kinds of steps can a hunt have?

Three: a code to type, a reaction to add (anywhere, in a channel, on a message or with a specific emoji) and a hidden button to find in a channel.

Can players cheat by sharing answers?

Clues and answers are shown only to each player, steps must be solved in order, hidden buttons work only for players on that step and wrong codes start a cooldown. Sharing in DMs is always possible, so rewards go to the fastest finishers.

Do hints and rewards cost real money?

No. Hints are paid and rewards are given in the server’s virtual Bank coins, which have no real-world value. Without the Bank, hints are free.

Ready to level up your server?

Add BotGG for free, then switch features on in the web console.