blob: 267ec4eefe41b3398e6639ad46d67ce1bc1a89d8 (
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
|
---
title: trading
parent: Built-in task types
grand_parent: Task types
---
# trading (task type)
Since v3.15.1
{: .label .label-green }
Minecraft 1.16+ required
{: .label .label-purple }
Paper required
{: .label .label-yellow }
Trade with a Villager or Wandering Trader.
## Options
| Key | Description | Type | Required | Default | Notes |
|---------------------------------|--------------------------------------------------------------------------|----------------------------------|----------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `amount` | The number of items to trade. | Integer | Yes | \- | \- |
| `mob` / `mobs` | The specific mob(s) to trade with. | Entity type, or list of entities | No | \- | Not specifying this field will allow all mob types to count towards the task. Please see [this list](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html) for entity types. |
| `item` | The specific item to trade. | Material, or ItemStack | No | \- | 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. |
| `exact-match` | Whether the item should exactly match what is defined. | Boolean | No | true | \- |
| `first-ingredient` | The specific item to be used as the first ingredient in a trade. | Material, or ItemStack | No | \- | 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. |
| `first-ingredient-exact-match` | Whether the first ingredient item should exactly match what is defined. | Boolean | No | true | \- |
| `second-ingredient` | The specific item to be used as the second ingredient in a trade. | Material, or ItemStack | No | \- | 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. |
| `second-ingredient-exact-match` | Whether the second ingredient item should exactly match what is defined. | Boolean | No | true | \- |
| `mode` | The specific mode of trading. | String | No | result | One of: `result`, `first_ingredient`, `second_ingredient`, `count`. |
| `worlds` | Worlds which should count towards the progress. | List of world names | No | \- | \- |
## Examples
Buy 10 carrots from a Villager:
``` yaml
tradecarrots:
type: "trading"
amount: 10 # amount of items to trade
mob: VILLAGER # (OPTIONAL) trader type
item: CARROT # (OPTIONAL) item to trade
worlds: # (OPTIONAL) restrict to certain worlds
- "world"
```
|
