Minecraft: Start Viewer Quest

Starts a viewer quest for the linked Minecraft player.

Use this effect in a command, Channel Point Redemption, timer, event, or preset effect list when you want Firebot to create a Minecraft quest for the viewer.

Fields

Target

The target section decides which linked Minecraft player gets the quest.

Use the viewer's saved Player Code for normal viewer-triggered quests.

Quest Preset

  • Load Quest Preset: loads a saved quest preset JSON file into this effect.
  • Save Quest Preset: saves the current quest setup as a JSON preset file you can share or load later.

Quest

  • Quest Name: name shown in Firebot events and Minecraft UI.
  • Quest ID: optional stable ID. Leave empty to generate one automatically. Use a stable ID if another effect needs to abandon that exact quest later.
  • Viewer Name: viewer attached to the quest. Usually $userDisplayName.

Objectives

A quest can have one or more objectives. The quest completes when every objective is finished.

Common objective fields:

  • Quest Type: what Minecraft should track.
  • Target Amount: how much progress is needed.
  • Target IDs: shown only for objective types that need block, item, or mob targets.
  • Use Specific Damage Filter: shown for Deal Damage, Deal Damage to Specific Mob, and Take Damage.
  • Damage Filter: the damage type or weapon condition that counts when Use Specific Damage Filter is enabled.

Damage filter examples:

Any
Projectile
Bow / Arrow
Trident
Holding Sword
Holding Axe
Holding Bow
Holding Crossbow
Fire
Explosion
Fall
Magic

Rewards

Rewards are optional. Turn on Has Reward if the player should receive item rewards or command rewards when the quest completes.

Display

  • None: the quest runs silently. Firebot events and variables still work.
  • Client Overlay: sends quest data to the client mod so the player can see the overlay and questbook.

Examples

Simple jump quest

Quest Name: Jump for chat
Viewer Name: $userDisplayName
Quest Type: Jump Count
Jumps Needed: 25
Has Reward: Off
Display Mode: Client Overlay

Mine stone quest with reward

Quest Name: Stone Collector
Viewer Name: $userDisplayName
Quest Type: Mine Specific Block
Blocks To Mine: 64
Block IDs: minecraft:stone
Has Reward: On
Reward Type: Item Reward
Item ID: minecraft:diamond
Amount: 3
Display Mode: Client Overlay

Fall damage quest

Quest Name: Watch Your Step
Viewer Name: $userDisplayName
Quest Type: Take Damage
Damage To Take: 10
Use Specific Damage Filter: On
Damage Filter: Fall
Display Mode: Client Overlay

Related pages

Viewer Quest ObjectivesEvery objective type and what its fields mean.Quest RewardsItem rewards, command rewards, random rewards, and reward visibility.Display ModesNone and Client Overlay explained.Quest PresetsSave and load reusable quest setups.