Objective Types

SpContentQuests supports a wide range of objective types, from basic vanilla actions to custom plugin integrations.

Built-in Types

Type	Description	required Value
none	Manual tracking only (use commands to add progress)	—
BREAK_BLOCK	Break specific blocks	Material name (e.g. DIAMOND_ORE)
PLACE_BLOCK	Place specific blocks	Material name
CRAFT	Craft vanilla items (skips items with lore/name/enchants)	Material name (e.g. BREAD)
CRAFT_CUSTOM	Craft custom items (matched by stripped display name)	Display name or CONTAINS:...
PICKUP_ITEM	Pick up items	—
CONSUME	Eat/drink items	Material name
SMELT	Smelt items in a furnace	Material name
SMELT_CUSTOM	Smelt custom items (matched by stripped display name)	Material name
ENCHANT	Enchant items	—
FISHING	Catch fish	—
THROW	Throw projectiles (eggs, ender pearls, etc.)	—
KILL	Kill mobs	Entity type (e.g. ZOMBIE)
BREED	Breed animals	Entity type
TAME	Tame animals	Entity type
SHEAR	Shear sheep	—

Examples

# Break 10 diamond ore blocks
objective:
  - type: BREAK_BLOCK
    amount: 10
    required:
      - DIAMOND_ORE
    display: '&fMine Diamonds'

# Kill 5 zombies
objective:
  - type: KILL
    amount: 5
    required:
      - ZOMBIE
    display: '&fKill Zombies'

# Craft 10 bread (vanilla recipe only)
objective:
  - type: CRAFT
    amount: 10
    required:
      - BREAD
    display: '&fCraft Bread'

# Craft a custom item named "Excalibur"
objective:
  - type: CRAFT_CUSTOM
    amount: 1
    required:
      - Excalibur
    display: '&fCraft Excalibur'

Integration Types

These types require their respective plugin to be installed on the server.

MMOItems

Requires MMOItems plugin. Format: TYPE|ID

Type	Description
MMOITEMS_STATIONS_TRADE	Trade at an MMOItems crafting station
MMOITEMS_CRAFT	Craft an MMOItems item
MMOITEMS_CONSUME	Consume an MMOItems item
MMOITEMS_APPLY_GEMSTONE	Apply a gem stone to an item
MMOITEMS_APPLY_UPGRADE	Use an upgrade item
MMOITEMS_APPLY_SOULBOUND	Apply soulbound to an item
MMOITEMS_APPLY_REPAIR	Repair an MMOItems item
MMOITEMS_UNSOCKET_GEMSTONE	Remove a gem stone from an item

objective:
  - type: MMOITEMS_STATIONS_TRADE
    amount: 1
    required:
      - GREATSWORD|STEEL_GREATSWORD
    display: '&fCraft the Steel Greatsword'

ItemsAdder

Requires ItemsAdder plugin. required value is the namespaced ID.

Type	Description
ITEMSADDER_BREAK_BLOCK	Break a custom block
ITEMSADDER_PLACE_BLOCK	Place a custom block

objective:
  - type: ITEMSADDER_BREAK_BLOCK
    amount: 10
    required:
      - myitems:ruby_ore
    display: '&fMine Ruby Ore'

MythicMobs

Requires MythicMobs plugin.

Type	Description
MYTHICMOBS_KILL	Kill a MythicMobs mob

objective:
  - type: MYTHICMOBS_KILL
    amount: 5
    required:
      - SkeletalKnight
    display: '&fKill Skeletal Knights'

Slimefun

Requires Slimefun plugin.

Type	Description
SLIMEFUN_MULTIBLOCK_{ID}	Use a Slimefun multiblock machine
SLIMEFUN_ANCIENT_ALTAR	Use the Slimefun Ancient Altar

objective:
  - type: SLIMEFUN_MULTIBLOCK_SMELTERY
    amount: 10
    required:
      - MAGNET
    display: '&fSmelt 10 Magnets'

objective:
  - type: SLIMEFUN_ANCIENT_ALTAR
    amount: 1
    required:
      - MAGICAL_LUMP_1
    display: '&fUse the Ancient Altar'

CONTAINS: Matching

For CRAFT_CUSTOM and integration types, prefix the required value with CONTAINS: to match partial names instead of exact matches:

objective:
  - type: CRAFT_CUSTOM
    amount: 2
    required:
      - CONTAINS:Katana
    display: 'Craft 2 Katanas'

This matches any item whose stripped display name contains "Katana" — e.g., "Katana of Fire", "Frost Katana", "Obsidian Katana", etc.

Note: Stripped display name means all color codes (&a, §a, etc.) are removed before comparison.