Multiple 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":31
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": 31,
  "page": 1,
  "repeatable": true,
  "cooldown": true,
  "cooldownDuration": "15s",
  "display": { ... },
  "id": 31,
  "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": "relic_coin_pouch"
title	Title displayed in the menu. Can use placeholders like %status%.	"title": "✦ Multi 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": 28
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": "relic_coin_pouch",
    "title": "&#B8C8B0✦ Multi Mission &#CDB4DB[%status%]",
    "slot": 28,
    "lore": [
      "&#9FA8B8A complex mission requiring multiple objectives.",
      "",
      "&#B8C8B0✦ Objectives",
      "&#9FA8B8▸ Defeat: &#CDB4DB%task_1_spec% &#7F8C8D(x%task_1_amount%)",
      "&#9FA8B8▸ Capture: &#CDB4DB%task_2_spec% &#7F8C8D(x%task_2_amount%)",
      "",
      "&#B8C8B0✦ Progress",
      "&#9FA8B8▸ Defeat: &#9FA8B8(%task_1_progress%)",
      "&#9FA8B8▸ Capture: &#9FA8B8(%task_2_progress%)",
      "&#9FA8B8▸ %progress_bar% &#7F8C8D(%progress_percent%) &#9FA8B8(%progress%)",
      "",
      "&#B8C8B0✦ Details",
      "&#9FA8B8• Repeatable: &#A3C9A8Yes",
      "&#9FA8B8• Cooldown: &#D8DEE9%cooldown%",
      "",
      "&#9FA8B8Complete all objectives 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.

Multiple

You can add any task, you can see these in

Missions

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

🎨 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

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": 31,
  "page": 1,
  "repeatable": true,
  "cooldown": true,
  "cooldownDuration": "15s",
  "display": {
    "material": "relic_coin_pouch",
    "title": "&#B8C8B0✦ Multi Mission &#CDB4DB[%status%]",
    "slot": 28,
    "lore": [
      "&#9FA8B8A complex mission requiring multiple objectives.",
      "",
      "&#B8C8B0✦ Objectives",
      "&#9FA8B8▸ Defeat: &#CDB4DB%task_1_spec% &#7F8C8D(x%task_1_amount%)",
      "&#9FA8B8▸ Capture: &#CDB4DB%task_2_spec% &#7F8C8D(x%task_2_amount%)",
      "",
      "&#B8C8B0✦ Progress",
      "&#9FA8B8▸ Defeat: &#9FA8B8(%task_1_progress%)",
      "&#9FA8B8▸ Capture: &#9FA8B8(%task_2_progress%)",
      "&#9FA8B8▸ %progress_bar% &#7F8C8D(%progress_percent%) &#9FA8B8(%progress%)",
      "",
      "&#B8C8B0✦ Details",
      "&#9FA8B8• Repeatable: &#A3C9A8Yes",
      "&#9FA8B8• Cooldown: &#D8DEE9%cooldown%",
      "",
      "&#9FA8B8Complete all objectives to receive rewards."
    ],
    "amount": 1,
    "customModelData": 0
  },
  "id": 31,
  "tasks": [
    {
      "type": "defeat",
      "value": {
        "mode": "any",
        "spec": "",
        "amount": 2
      }
    },
    {
      "type": "capture",
      "value": {
        "mode": "any",
        "spec": "",
        "amount": 1
      }
    }
  ],
  "rewards": [
    {
      "type": "message",
      "value": {
        "messages": [
          "",
          "&#A3C9A8✦ Mission Completed",
          "&#9FA8B8You completed all objectives successfully",
          "",
          "&#F1DCA7Rewards",
          "&#9FA8B8▸ &#B8C8B0+1 Diamond",
          ""
        ]
      }
    },
    {
      "type": "command",
      "value": {
        "commands": [
          "give %player% diamond 1"
        ]
      }
    }
  ],
  "requirement": [
    {
      "type": "mission",
      "value": {
        "id": []
      }
    }
  ]
}