Classic Missions

📖 Mission Creation Guide for Cobblemissions

This guide will teach you how to create your own custom missions for the Cobblemissions mod. Missions are defined using JSON files located in the config\CobbleMissions\Missions folder.

For example: config\CobbleMissions\Missions\my_custom_mission.json

A mission file has the following general structure:

Field	Description	Example
id	Unique identifier for the mission. Must be different for each mission.	"id": 1
page	The page where the mission appears in the UI menu. Useful for organizing missions by category or pages.	"page": 1
repeatable	Indicates whether the mission can be completed multiple times.	"repeatable": true
cooldown	Indicates whether the mission has a cooldown period after completion.	"cooldown": true
cooldownDuration	Duration of the cooldown. Formats: "15s", "5m", "2h", "1d", "1w". Can be combined: "1d2h30m".	"cooldownDuration": "15s"

{
  "id": 1,
  "page": 1,
  "repeatable": true,
  "cooldown": true,
  "cooldownDuration": "15s",
  "display": { ... },
  "id": 15,
  "tasks": [ ... ],
  "rewards": [ ... ],
  "requirement": [ ... ]
}

🖥️ Display section: UI visualization

Defines how the mission will appear in the user menu.

Field	Description	Example
material	Item material representing the mission in the UI.	"material": "poke_ball"
title	Title displayed in the menu. Can use placeholders like %status%.	"title": "Capture Mission [%status%]"
slot	Position in the user interface where the mission will appear (0–53). Assigning a negative slot will prevent it from being displayed in the UI. Example: -1	"slot": 10
lore	Additional text shown on hover. Can include placeholders and color formatting.	See example in JSON
amount	Amount of the item displayed in the UI.	"amount": 1
customModelData	CustomModelData value for custom models.	"customModelData": 0

"display": {
  "material": "poke_ball",
  "title": "&#B8C8B0✦ Capture Mission &#CDB4DB[%status%]",
  "slot": 10,
  "lore": [
    "&#9FA8B8A calm and focused capture mission.",
    "",
    "&#B8C8B0✦ Objective",
    "&#9FA8B8▸ Pokémon: &#CDB4DB%task_1_spec% &#7F8C8D(x%task_1_amount%)",
    "",
    "&#B8C8B0✦ Progress",
    "&#9FA8B8▸ %progress_bar% &#7F8C8D(%progress_percent%) &#9FA8B8(%progress%)",
    "",
    "&#B8C8B0✦ Details",
    "&#9FA8B8• Repeatable: &#A3C9A8Yes",
    "&#9FA8B8• Cooldown: &#D8DEE9%cooldown%",
    "",
    "&#9FA8B8Complete the task to receive rewards."
  ],
  "amount": 1,
  "customModelData": 0
},

🎯 Tasks section: Mission Objectives

A mission can have one or more tasks. Each task must be defined within an array.

Capture

• Goal: Capture a specific number of Pokémon.

• Fields:

  • mode: "specific" (exact species) or "any" (any Pokémon).

  • spec: Pokémon name (required if mode is "specific").

  • amount: Number to capture.

  "id": 1,
  "tasks": [
    {
      "type": "capture",
      "value": {
        "mode": "specific",
        "spec": "Pikachu",
        "amount": 2
      }
    }
  ],

Defeat

• Goal: Defeat Pokémon in battle.

• Fields:

  • mode: "specific" or "any".

  • spec: Pokémon name.

  • amount: Number to defeat.

  "id": 2,
  "tasks": [
    {
      "type": "defeat",
      "value": {
        "mode": "any",
        "spec": "",
        "amount": 2
      }
    }
  ],

Fish

• Goal: Fish a number of Pokémon.

• Fields:

  • mode: "specific" or "any".

  • spec: Pokémon name.

  • amount: Number to fish.

  "id": 3,
  "tasks": [
    {
      "type": "fish",
      "value": {
        "mode": "specific",
        "spec": "Magikarp",
        "amount": 1
      }
    }
  ],

Scanning

• Goal: Scan Pokémon entries in the Pokédex.

• Fields:

  • mode: "specific" or "any".

  • spec: Pokémon name (if "specific").

  • amount: Number of scans.

  "id": 4,
  "tasks": [
    {
      "type": "scanning",
      "value": {
        "mode": "any",
        "spec": "",
        "amount": 1
      }
    }
  ],

Apricorn

• Goal: Harvest Apricorns from trees.

• Fields:

  • apricorn: Apricorn color ("red", "blue", etc.) or "any".

  • amount: Number to harvest.

  "id": 5,
  "tasks": [
    {
      "type": "apricorn_harvest",
      "value": {
        "apricorn": "red",
        "amount": 3
      }
    }
  ],

Berry

• Goal: Harvest berries from plants.

• Fields:

  • berry: Berry ID (e.g., "oran", "cobblemon:oran_berry") or "any".

  • amount: Number to harvest.

  "id": 6,
  "tasks": [
    {
      "type": "berry_harvest",
      "value": {
        "berry": "any",
        "amount": 3
      }
    }
  ],

Evolution

• Goal: Evolve Pokémon.

• Fields:

  • mode: "specific" or "any".

  • spec: Pre-evolution Pokémon name.

  • evolutionType: "level", "trade", "item", "block", or "any".

  • amount: Number of evolutions.

  "id": 7,
  "tasks": [
    {
      "type": "evolution",
      "value": {
        "mode": "specific",
        "evolutiontype": "LEVEL",
        "spec": "Magikarp",
        "amount": 1
      }
    }
  ],

Fossil

• Goal: Revive Pokémon from fossils.

• Fields:

  • mode: "specific" or "any".

  • spec: Resulting Pokémon name.

  • amount: Number to revive.

  "id": 8,
  "tasks": [
    {
      "type": "fossil_revive",
      "value": {
        "mode": "any",
        "spec": "",
        "amount": 1
      }
    }
  ],

Held Item

• Goal: Give held items to Pokémon

• Fields:

  • mode: "specific" or "any".

  • item: Item ID (e.g., "rare_candy") or "any".

  • amount: Number of times.

  "id": 9,
  "tasks": [
    {
      "type": "held_item",
      "value": {
        "mode": "specific",
        "item": "minecraft:diamond_sword",
        "amount": 1
      }
    }
  ],

Candy Use

• Goal: Use experience candies.

• Fields:

  • candy: Candy ID (e.g., "exp_candy_s", "rare_candy") or "any".

  • amount: Number used.

  "id": 10,
  "tasks": [
    {
      "type": "candy_use",
      "value": {
        "candy": "rare_candy",
        "amount": 3
      }
    }
  ],

Hatch

• Goal: Hatch eggs.

• Fields:

  • mode: "specific" or "any".

  • spec: Pokémon hatched.

  • amount: Number of eggs.

  "id": 11,
  "tasks": [
    {
      "type": "hatch",
      "value": {
        "mode": "specific",
        "spec": "Pikachu",
        "amount": 1
      }
    }
  ],

Level Up

• Goal: Raise Pokémon to a specific level.

• Fields:

  • spec: Pokémon name (optional; omit or use "any" for any Pokémon).

  • level: Target level (e.g., 50).

  • amount: Number of Pokémon to level up.

  "id": 13,
  "tasks": [
    {
      "type": "level_up",
      "value": {
        "spec": "Pikachu",
        "level": 50
      }
    }
  ],

Gained

• Goal: Obtain Pokémon through non-capture means (trades, gifts, events, etc.).

• Fields:

  • spec: Pokémon name or "any".

  • amount: Number obtained.

  "id": 12,
  "tasks": [
    {
      "type": "gained",
      "value": {
        "spec": "Pikachu",
        "amount": 1
      }
    }
  ],

Battle

• Goal: Win or lose battles against NPCs or players.

• Fields:

  • battleType: "battle_winners" (wins) or "battle_losers" (losses).

  • mode: "specific" or "any".

  • actor: "npc", "player", or "pokemon" (wild).

  • spec: Specific opponent name (if "specific").

  • amount: Number of battles.

  "id": 14,
  "tasks": [
    {
      "type": "battle",
      "value": {
        "battleType": "battle_winners",
        "mode": "specific",
        "actor": "npc",
        "spec": "Ash Ketchum",
        "amount": 1
      }
    }
  ],

Break Block

break_block (Break Blocks)

• Goal: Break Minecraft blocks.

• Fields:

  • block: Block ID (e.g., "minecraft:stone", "cobblemon:apricorn_tree_red").

  • amount: Number broken.

  "id": 15,
  "tasks": [
    {
      "type": "break_block",
      "value": {
        "block": "minecraft:stone",
        "amount": 64
      }
    }
  ],

🎨 Specs, Further customize and specify your missions

Spec Key	Description	Example
species	Pokémon species name. This is written without a key and should be the first value.	Pikachu
level / lvl	Exact Pokémon level required.	lvl:25
shiny	Whether the Pokémon must be shiny.	shiny:true
move / moves	Pokémon must know all listed moves.	moves:Thunderbolt,Quick Attack
ability	Required active ability.	ability:Static
abilities	Pokémon must have all listed abilities.	abilities:Static,Lightning Rod
friendship	Required friendship value.	friendship:200
gender	Pokémon gender. Automatically capitalized.	gender:Male
type	Pokémon must contain this elemental type.	type:Electric
types	Pokémon must contain all listed types.	types:Electric,Steel
nature	Pokémon nature. Automatically capitalized.	nature:Timid

  "id": 1,
  "tasks": [
    {
      "type": "capture",
      "value": {
        "mode": "specific",
        "spec": "Pikachu, lvl:20, nature:Bold",
        "amount": 2
      }
    }
  ],

Rewards

A mission can grant multiple rewards.

Title

  "rewards": [
    {
      "type": "title",
      "value": {
        "messages": [
          "&#A3C9A8Global Win!",
          "&#9FA8B8%player_global_progress% captured the goal"
        ]
      }
    }
  ]

Broadcast

Message

Command

ALL

Requeriments

Defines conditions a player must meet to accept the mission.

"requirement": [
  {
    "type": "mission",
    "value": {
      "id": []
    }
  }
]

1. mission (Complete Prior Missions)

• Description: Player must have completed one or more prior missions.

• Value: Array of mission IDs. Empty ([]) means no mission requirement.

• Example:

{
  "type": "mission",
  "value": {
    "id": [1, 2, 3]
  }
}

2. permission (Player Permission)

• Description: Player must have specified permission node (requires LuckPerms or similar).

• Value: Array of permission strings.

• Example:

{
  "type": "permission",
  "value": {
    "permission": ["cobblemisions.premium"]
  }
}

✔️ Full Example Mission

{
  "id": 1,
  "page": 1,
  "repeatable": true,
  "cooldown": true,
  "cooldownDuration": "15s",
  "display": {
    "material": "poke_ball",
    "title": "&#B8C8B0✦ Capture Mission &#CDB4DB[%status%]",
    "slot": 10,
	"lore": [
      "&#9FA8B8A calm and focused capture mission.",
      "",
      "&#B8C8B0✦ Objective",
      "&#9FA8B8▸ Pokémon: &#CDB4DB%task_1_spec% &#7F8C8D(x%task_1_amount%)",
      "",
      "&#B8C8B0✦ Progress",
      "&#9FA8B8▸ %progress_bar% &#7F8C8D(%progress_percent%) &#9FA8B8(%progress%)",
      "",
      "&#B8C8B0✦ Details",
      "&#9FA8B8• Repeatable: &#A3C9A8Yes",
      "&#9FA8B8• Cooldown: &#D8DEE9%cooldown%",
      "",
      "&#9FA8B8Complete the task to receive rewards."
    ],
    "amount": 1,
    "customModelData": 0
  },
  "id": 1,
  "tasks": [
    {
      "type": "capture",
      "value": {
        "mode": "specific",
        "spec": "Pikachu",
        "amount": 2
      }
    }
  ],
  "rewards": [
    {
      "type": "message",
      "value": {
		"messages": [
          "",
          "&#A3C9A8✦ Mission Completed",
          "&#9FA8B8You captured &#CDB4DBx2 &#9FA8B8Pikachu",
          "",
          "&#F1DCA7Rewards",
          "&#9FA8B8▸ &#B8C8B0+1 Diamond",
          ""
        ]
      }
    },
    {
      "type": "command",
      "value": {
        "commands": [
          "give %player% diamond 1"
        ]
      }
    }
  ],
  "requirement": [
    {
      "type": "mission",
      "value": {
        "id": []
      }
    }
  ]
}