How Viewer Quests Work

Viewer quests are Minecraft goals started from Firebot.

A quest has a viewer name, a Minecraft player, one or more objectives, optional rewards, and a display mode.

Basic flow

  1. Firebot runs Minecraft: Start Viewer Quest.
  2. The server creates the quest for the linked Minecraft player.
  3. The server tracks progress from Minecraft activity.
  4. The server sends quest events back to Firebot.
  5. Optional rewards are given when the quest completes.

Quest parts

  • Quest Name: shown in Firebot events and Minecraft UI.
  • Quest ID: optional stable ID used to identify one quest later.
  • Viewer Name: the viewer attached to the quest, usually $userDisplayName.
  • Objectives: what the player must do.
  • Rewards: optional item or command rewards.
  • Display Mode: whether the quest is only server-side or shown with the client overlay.
ObjectivesEvery supported objective type.RewardsItem rewards, command rewards, random rewards, and visibility.Display ModesNone and Client Overlay.Quest PresetsSave and reuse quest setups.