Operation example

Command

The mission command allows you to specify a name, ID, and Short ID as arguments. Returns a all missions list if no arguments are specified or the specified mission does not exist.

Sub command (/mission)

The edit subcommand allows you to specify a name, ID, and Short ID as arguments. Returns a all missions list if no arguments are specified or the specified mission does not exist.

The list subcommand allows you to specify a group name as arguments. Returns a all missions list if no arguments are specified.

Permission

Usage

Item description

• Maximum number of achievements: Number of times you can complete a mission
• Target step: Target number of steps
• Steptrigger: Trigger to increase mission steps

Mission creation example

• Achieved after breaking blocks 10 times
• The reward is 10 diamonds
• Can be achieved up to once

1. Execute command: /mission edit
2. Select "Add mission"
3. Input the 1 to "Maximum number of achievements" and 10 to "Target step"
4. Select the created mission
5. Select "Edit reward"
6. Select "Add reward"
7. Specify "Item reward" for "Reward type"
8. Input the 264(Diamond ID) to "ID" and 10 to "Amount"
9. Select "Edit steptrigger"
10. Select "Add steptrigger"
11. Specify "Event" for "Steptrigger type"
12. Specify "BlockBreakEvent" for "Event"

If it looks like this, it ’s a success.

Cooperation with Mineflow plugin

Create reward with recipe

1. Add "Mineflow reward" by referring to [Mission creation example](#Mission creation example)
2. Select "MissionReward" with the trigger on the Mineflow plugin side and specify the target mission

Examples

• Recipe

• Mission

Tips

• The variable "target" can be used in Mineflow recipes triggered by mission rewards
• Even if you want to create multiple recipe rewards, please limit the number of "Mineflow reward" to one
• If you want to create multiple rewards based on recipes and want to display the second and subsequent rewards, you can use "Nothing (text show only)"

Use the recipe as a Steptrigger

1. Open the action addition screen on the Mineflow plugin side and select "Mission", "Increase the mission step" to add

Examples

Tips

• No setting is required on the mission side
• By combining conditional expressions on the recipe side, it is possible to make fairly flexible settings

Cooperation with external plugins (for developers)

Prerequisites

• Add this plugin to depend in plugin.yml

Add reward type

1. Create a class that inherits Reward (see existing Reward for implementation example)
2. Add that class to Reward

pjz9n\mission\reward\Rewards::add(ExampleReward::class);

Add Steptrigger type

1. Create a class that inherits Executor (see existing Executor for implementation example)
2. Add that class to Executor

pjz9n\mission\mission\executor\Executors::add(ExampleExecutor::class);

Operate Mission

pjz9n\mission\mission\MissionList

Operate Progress

`pjz9n\mission\mission\progress\ProgressList`

Add event to Event Steptrigger

Instances of PlayerEvent or events with getPlayer methods are added by default. However, you may want to add an EntityDamageByEntityEvent event that has a getDamager method. It can be used in such cases.

pjz9n\mission\mission\executor\EventList::addEvent(EntityDamageByEntityEvent::class, function (Event $event): ?Player {
    /** @var EntityDamageByEntityEvent $event */
    $damager = $event->getDamager();
    return $damager instanceof Player ? $damager : null;
});

See the source code for details

* The timing of each operation does not matter (basically, it is desirable to perform it at the plug-in activation timing)