← Back to docs
Setup Docs

How to Build a Challenge

Step-by-step. See Challenges — Concept if you haven't decided whether you want a Challenge or a Milestone, and How to Build a Milestone for the other route.

  1. Create it. Open New Challenge from the menu (it appears when the adventure's Challenges feature is on). On the General tab give it a Name, Color, Icon and Main Image, then press Create Challenge in the bottom bar. The Questions tab reads "Please save the challenge before adding questions" until you do.
  2. Write your question bank. On the Questions tab, Add Question opens a question with its Question Text, optional Media, an Explanation, and its Answer Options. Add each option with Add Option, switch Correct on for the right one (or ones), and give it an image if you like. Each question also has Remove and Duplicate.
  3. Write the explanations. The Explanation is shown on review, and only to a player who got that question right. Say why the answer is right, not "well done". Blank is fine.
  4. Set the Challenge Mechanics on the Mechanics tab: Questions to display, Answers to win, Time Limit in seconds (blank for none), Max Chances (0 for unlimited), Free Attempts, and the Attempt Cost in BLOO for each attempt after those. The same tab carries the Tabi, Level, XP/BLOO/EP reward, Start Date and Deadline, just as a Milestone does.
  5. Write the Content. The Short Description is the preview players read when they click the Challenge on the map. The Success Message lands on the player's Secrets & Clues page once they pass.
  6. Set requirements and extra rewards on the Advanced tab: the Conditions drawer for prerequisites, and the Skill, Item and Achievement rewards. See Designing Milestones; they work the same way here.
  7. Pick a status and save. Choose Publish, Draft or Locked in the bottom bar and press Update Challenge.
  8. Place it on the Journey Map, into a Tabi, or positioned directly in the Journey Builder.

What the Player Gets

A player presses Start! (the panel beside it says whether the attempt is free or what it costs), answers, and presses Submit answers!. The attempt ends on a review pass rather than a results screen: a score panel whose only button is Review my answers, the graded questions with your explanations on the ones they got right, and a bottom bar with Back to the journey and, after a fail, Try again. Costs, the attempt cap and grading are enforced by the server, and the answer key is never sent to the player's browser.

Sizing the Question Bank

Write more questions than you show. A bank of fifteen with five shown per attempt means a retry is a genuinely different test, which is what makes limited retries fair rather than a memory exercise. Leave Questions to display blank (or set it higher than the bank) and every question is shown. An Answers to win higher than the number shown is treated as "all of them".

Related