aboutsummaryrefslogtreecommitdiffstats
path: root/docs/task-types/bartering-(task-type).md
blob: 9ab422402df3951ede5c037cfbbe87d476b1cdc6 (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
---
title: bartering
parent: Built-in task types
grand_parent: Task types
---

# bartering (task type)

Not released yet (dev builds)
{: .label .label-green }

Minecraft 1.16.5+ required
{: .label .label-purple }

Make a bartering interaction with a piglin.

## Options

| Key                  | Description                                                   | Type                   | Required | Default | Notes                                                                                                                                                                                                                                                                        |
|----------------------|---------------------------------------------------------------|------------------------|----------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `amount`             | The number of items.                                          | Integer                | Yes      | \-      | \-                                                                                                                                                                                                                                                                           |
| `input`              | The specific item to be picked up by a piglin.                | 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. |
| `input-exact-match`  | Whether the input item should exactly match what is defined.  | Boolean                | No       | true    | \-                                                                                                                                                                                                                                                                           |
| `output`             | The specific item to be dropped by a piglin.                  | 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. |
| `output-exact-match` | Whether the output item should exactly match what is defined. | Boolean                | No       | true    | \-                                                                                                                                                                                                                                                                           |
| `mode`               | The specific mode of bartering.                               | String                 | No       | output  | One of: `input`, `output`.                                                                                                                                                                                                                                                   |
| `worlds`             | Worlds which should count towards the progress.               | List of world names    | No       | \-      | \-                                                                                                                                                                                                                                                                           |

## Examples

Get 100 spectral arrows for gold ingots from a piglin:

``` yaml
barter_spectral_arrows:
  type: "bartering"
  amount: 100                           # amount of items to be dropped (with output mode) by a piglin
  mode: output                          # (OPTIONAL) whether output or input items should count towards the progress
  input: GOLD_INGOT                     # (OPTIONAL) the item to be picked up by a piglin
  output: SPECTRAL_ARROW                # (OPTIONAL) the item to be dropped by a piglin
  input-exact-match: false              # (OPTIONAL) we don't care about item nbt
  output-exact-match: false             # (OPTIONAL) we don't care about item nbt
  worlds:                               # (OPTIONAL) restrict to certain worlds
    - "world_nether"
```