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

# smelting (task type)

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

Cook a set amount of an item.

{: .note }
Since Quests v3.13, `smeltingcertain` and `smelting` have been merged
into one. Both names can be used to refer to this task.

## Options

| Key           | Description                                            | Type                   | Required | Default | Notes                                                                                                                                                                                                                                                                                                                       |
|---------------|--------------------------------------------------------|------------------------|----------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `amount`      | The number of items to smelt.                          | Integer                | Yes      | \-      | \-                                                                                                                                                                                                                                                                                                                          |
| `item`        | The specific item to smelt.                            | 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. If this is not specified, any item will count. |
| `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    | \-                                                                                                                                                                                                                                                                                                                          |
| `mode`        | The specific mode of smelting.                         | String                 | No       | \-      | One of: `smoker`, `blast_furnace`, `furnace`. If this is not specified, any furnace will count.                                                                                                                                                                                                                             |
| `worlds`      | Worlds which should count towards the progress.        | List of world names    | No       | \-      | \-                                                                                                                                                                                                                                                                                                                          |

## Examples

Smelt 10 items:

``` yaml
smelting:
  type: "smelting"
  amount: 10                            # amount to smelt
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"
```

Cook 10 steak:

``` yaml
smeltingcertain:
  type: "smeltingcertain"
  amount: 10                            # amount to smelt
  item: STEAK                           # type of item 
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"
```

Cook 10 of a specific item:

``` yaml
smeltingcertain:
  type: "smeltingcertain"
  amount: 10                            # amount to smelt
  item:                                 # SPECIFIC item with name and lore
    name: "&cSpecial Beef"
    type: "RAW_BEEF"
    lore:
     - "&7This is a special type of beef"
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"
```

Cook 10 of [quest item](../configuration/defining-items#quest-items)
`special_beef`:

``` yaml
smeltingcertain:
  type: "smeltingcertain"
  amount: 10                            # amount to smelt
  item:                                 # type of item 
    quest-item: "special_beef"
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"
```