blob: 38652f9340dea025a855c38b221be62a3724f0b8 (
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
---
title: citizens_deliver
parent: External task types
grand_parent: Task types
---
# citizens_deliver (task type)
Since v2.0.15
{: .label .label-green }
Plugin 'Citizens' required
{: .label }
Deliver a set of items to a Citizens NPC.
## Options
| Key | Description | Type | Required | Default | Notes |
|------------------------------|------------------------------------------------------------------|------------------------|----------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `amount` | The number of items to deliver. | Integer | Yes | \- | \- |
| `item` | The specific item to deliver. | Material, or ItemStack | Yes | \- | Accepts standard [item definition](../configuration/defining-items). Please see [this list](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html) (1.13+) or [this list](https://helpch.at/docs/1.12.2/org/bukkit/Material.html) (1.8-1.12) for material names. |
| `data` | The data code for the item. | Integer | No | 0 | This field is not used in Minecraft versions 1.13+, nor is it compatible with ItemStack definitions. |
| `exact-match` | Whether the item should exactly match what is defined. | Boolean | No | true | \- |
| `remove-items-when-complete` | Whether the items should be taken from the player when complete. | Boolean | No | false | If `allow-partial-completion` is true, then this will also be set to true. |
| `allow-partial-completion` | Whether any number of items counts towards the task progress. | Boolean | No | true | Setting to true will force `remove-items-when-complete` to true as well. If a player obtains any matching item, it will be immediately taken away from them and added towards the quest progress. |
| `npc-name` | The name of the NPC to deliver to. | String | No | \- | Mutually exclusive with `npc-id`. |
| `npc-id` | The id of the NPC to deliver to. | Integer | No | \- | Mutually exclusive with `npc-name`. |
| `worlds` | Worlds which should count towards the progress. | List of world names | No | \- | \- |
## Examples
Deliver 8 of `BEEF` to an NPC named Gerald:
``` yaml
citizensdeliver:
type: "citizens_deliver"
npc-name: "Gerald" # name of NPC
# OR npc-id: "npc1" ID of NPC (mutally exclusive with npc-name)
item: BEEF # name of item (can be id or minecraft name)
amount: 8 # amount of item needed
remove-items-when-complete: false # (OPTIONAL) take the items away from the player on completion - default: false
allow-partial-completion: false # (OPTIONAL) allow partial deliveries - default: false
worlds: # (OPTIONAL) restrict to certain worlds
- "world"
```
Deliver 8 of a specific item to an NPC named Gerald:
``` yaml
beef:
type: "citizens_deliver"
npc-name: "Gerald" # name of NPC
item: # SPECIFIC item with name and lore
name: "&cSpecial Beef"
type: "BEEF"
lore:
- "&7This is a special type of beef"
amount: 8 # amount of item needed
remove-items-when-complete: false # (OPTIONAL) take the items away from the player on completion - default: false
accept-partial-completion: false # (OPTIONAL) allow partial deliveries - default: false
worlds: # (OPTIONAL) restrict to certain worlds
- "world"
```
Deliver 8 of [quest item](../configuration/defining-items#quest-items)
`special_beef` to an NPC named Gerald:
``` yaml
beef:
type: "citizens_deliver"
npc-name: "Gerald" # name of NPC
# OR npc-id: "npc1" ID of NPC (mutally exclusive with npc-name)
item: # USING quest-item
quest-item: "special_beef"
amount: 8 # amount of item needed
remove-items-when-complete: false # (OPTIONAL) take the items away from the player on completion - default: false
accept-partial-completion: false # (OPTIONAL) allow partial deliveries - default: false
worlds: # (OPTIONAL) restrict to certain worlds
- "world"
```
|
