Objective Types

QuestForge supports 8 objective types. Objectives are completed in sequence — players must finish objective 1 before objective 2 unlocks. Progress messages use the TTS-Studio chat prefix QuestForge:.

KILL

Kill a specified number of mobs or players. Supports both vanilla entities and MythicMobs.

objectives:
  - type: KILL
    target: ZOMBIE          # Bukkit EntityType name
    amount: 10
    description: "Kill 10 Zombies"

  - type: KILL
    target: PLAYER          # For PvP quests
    amount: 3
    description: "Defeat 3 players in combat"

Valid vanilla targets: Any org.bukkit.entity.EntityType name — ZOMBIE, SKELETON, CREEPER, PLAYER, ENDER_DRAGON, etc.

MythicMobs Variant

If MythicMobs is installed, you can target a MythicMob by its internal ID using mythic-mob:

  - type: KILL
    mythic-mob: SkeletonKing   # MythicMobs internal name
    amount: 1
    description: "Slay the Skeleton King"

The MythicMobs hook listens to MythicMobDeathEvent via reflection — no compile-time dependency, so the plugin loads cleanly even if MythicMobs is absent. If MythicMobs isn't installed, this variant is simply ignored at load time.

COLLECT

Gather a specified amount of a material into the player's inventory.

objectives:
  - type: COLLECT
    material: ROTTEN_FLESH   # Bukkit Material name
    amount: 10
    description: "Collect 10 Rotten Flesh"

Note: Progress tracks items entering the inventory after quest start. Items already held when the quest is accepted do NOT count.

REACH_LOCATION

Travel to a specific coordinate in a world. Checked on a tunable interval (default every 20 ticks = 1 s — set via reach-check-interval in config.yml).

objectives:
  - type: REACH_LOCATION
    world: world
    x: 100
    y: 64
    z: -200
    radius: 10              # How close the player must get (blocks)
    description: "Reach the ancient ruins"

INTERACT_NPC

Right-click a specific Citizens NPC.

objectives:
  - type: INTERACT_NPC
    npc-id: 5               # Citizens NPC ID
    description: "Speak with the Village Elder"

Requires Citizens. If Citizens is not installed, this objective type is skipped — the quest still loads, but players can't progress past this step. Avoid mixing INTERACT_NPC objectives into quests intended for Citizens-less servers.

CRAFT

Craft a specific item via crafting table or inventory recipe.

objectives:
  - type: CRAFT
    material: IRON_SWORD
    amount: 1
    description: "Craft an Iron Sword"

MINE

Mine a specific number of blocks of the given material.

objectives:
  - type: MINE
    material: DIAMOND_ORE
    amount: 5
    description: "Mine 5 Diamond Ore"

Tip: Use DEEPSLATE_DIAMOND_ORE as a separate objective if both should count, or switch to COLLECT with DIAMOND to track the resulting drop instead.

FISH

Catch fish by fishing rod.

objectives:
  - type: FISH
    amount: 20
    description: "Catch 20 fish"

TAME

Tame animals (wolves, cats, horses, etc.).

objectives:
  - type: TAME
    amount: 3
    description: "Tame 3 animals"

Multi-Objective Example

objectives:
  - type: MINE
    material: COAL_ORE
    amount: 32
    description: "Mine 32 Coal Ore"

  - type: CRAFT
    material: TORCH
    amount: 16
    description: "Craft 16 Torches"

  - type: REACH_LOCATION
    world: world
    x: 0
    y: 64
    z: 0
    radius: 20
    description: "Return to spawn"

_{QuestForge is part of the TTS-Studio Minecraft plugin suite.}

Home | Quest Format | Rewards