aboutsummaryrefslogtreecommitdiffstats
path: root/docs/task-types/projectilelaunching-(task-type).md
blob: b8dcc238743dd9926d62f2168f02bf70546df2b1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
---
title: projectilelaunching
parent: Built-in task types
grand_parent: Task types
---

# projectilelaunching (task type)

Since v3.15
{: .label .label-green }

Launch a certain number of projectiles. This happens when 
a player fires a bow, throws a snowball, etc.

## Options

| Key                          | Description                                     | Type                             | Required | Default | Notes                                                                                                                                                                                                 |
|------------------------------|-------------------------------------------------|----------------------------------|----------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `amount`                     | The number of projectiles to launch.            | Integer                          | Yes      | \-      | \-                                                                                                                                                                                                    |
| `projectile` / `projectiles` | The specific projectile(s) to launch.           | Entity type, or list of entities | No       | \-      | Not specifying this field will allow all entity types to count towards the task. Please see [this list](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html) for entity types. |
| `worlds`                     | Worlds which should count towards the progress. | List of world names              | No       | \-      | \-                                                                                                                                                                                                    |

## Examples

Shoot 5 arrows:

``` yaml
projectilelaunching:
  type: "projectilelaunching"
  amount: 5                             # amount of projectiles launched
  projectile: 'ARROW'                   # the projectile to launch
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"
```

Throw 5 snowballs:

``` yaml
projectilelaunching:
  type: "projectilelaunching"
  amount: 5                             # amount of projectiles launched
  projectile: 'SNOWBALL'                # the projectile to launch
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"
```