Custom Crops

experimental

easy

FORMAT & MIN ENGINE VERSION 1.20.30

This tutorial assumes a good understanding of blocks. Check out the blocks guide, block states and block permutations before starting.

EXPERIMENTAL

Requires Holiday Creator Features to trigger block events and for use of block tag Molang queries and the minecraft:unit_cube block component.

Designing custom crops may appear daunting at first, but it's a straightforward process once you understand the initial steps. Our tutorial/template will guide you through the process of creating a unique crop block as well as other blocks like farmland and dirt.

Custom Dirt

Below is an example of a custom dirt block. This custom dirt can be transformed into wiki:custom_farmland by using a hoe or a Dirt Path by using a shovel.

TIP

Add the minecraft:is_hoe or minecraft:is_shovel item tags to any custom tools to make them work with our custom dirt!

Custom Dirt Block JSON

BP/blocks/custom_dirt.jsonCopy

json

{
  "format_version": "1.20.30",
  "minecraft:block": {
    "description": {
      "identifier": "wiki:custom_dirt",
      "menu_category": {
        "category": "nature"
      }
    },
    "components": {
      "tag:dirt": {},
      "tag:fertilize_area": {},
      "minecraft:unit_cube": {},
      "minecraft:map_color": "#6C5746",
      "minecraft:destructible_by_mining": {
        "seconds_to_destroy": 0.6
      },
      "minecraft:material_instances": {
        "*": {
          "texture": "custom_dirt"
        }
      },
      // Convert to farmland or dirt path when interacted with
      "minecraft:on_interact": {
        "event": "wiki:transform",
        "condition": "q.block_face && q.equipped_item_any_tag('slot.weapon.mainhand', 'minecraft:is_hoe', 'minecraft:is_shovel')"
      }
    },
    "events": {
      "wiki:transform": {
        "sequence": [
          {
            "damage": {
              "type": "durability",
              "amount": 1,
              "target": "item"
            }
          },
          // Transform into farmland (hoe is used)
          {
            "condition": "q.equipped_item_any_tag('slot.weapon.mainhand', 'minecraft:is_hoe')",
            // Play use sound
            "run_command": {
              "command": "playsound use.gravel @a ~~~ 1 0.8"
            },
            // Replace this block with "wiki:custom_farmland"
            "set_block": {
              "block_type": "wiki:custom_farmland"
            }
          },
          // Tranform into path (shovel is used)
          {
            "condition": "q.equipped_item_any_tag('slot.weapon.mainhand', 'minecraft:is_shovel')",
            // Play use sound
            "run_command": {
              "command": "playsound use.grass @a ~~~ 1 0.8"
            },
            // Replace this block with Dirt Path
            "set_block": {
              "block_type": "minecraft:grass_path"
            }
          }
        ]
      }
    }
  }
}

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

Custom Farmland

Farmland is a tricky block… it reacts to water (changing it's texture when water is nearby), dries out and turns back into our dirt block randomly if water does not reach it in time, and supports crops to be placed on top.

Nevertheless, it's just special dirt. Let's walk through how it works:

The first thing that you will want to do is make a basic block, just like our dirt.
Create a "farmland" texture for the top of the block (both wet and dry) and then assign it a dirt texture to the sides. You will also need to make a custom block geometry that is 16×15×16 pixels in height, one row smaller then a normal block.
After that we can add our moisture logic to our block to emulate vanilla functionality.

Download Custom Farmland Geometry

Farmland Moisture

Vanilla farmland has 8 moisture stages:

0 - Shows a dry top texture and decays into dirt on random tick if not near water.
1-7 - Shows a wet top texture and will gradually count down to 0 after each random tick if not near water.
If the farmland is near water, the moisture value is set to 7 on random tick.

Add a moisture state to your block to get started with our custom logic.

minecraft:block > descriptionCopy

json

"states": {
  "wiki:moisture": {
    "values": { "min": 0, "max": 7 }
  }
}

1
2
3
4
5

The following permutation sets top texture to be wet when the wiki:moisture value is not 0.

minecraft:blockCopy

json

"permutations": [
  {
    "condition": "q.block_state('wiki:moisture')",
    "components": {
      "minecraft:material_instances": {
        "*": {
          "texture": "custom_dirt",
          "render_method": "alpha_test"
        },
        "up": {
          "texture": "custom_farmland_wet",
          "render_method": "alpha_test"
        }
      }
    }
  }
]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

Hydration

Each random tick, our farmland should trigger an event to determine the block's current moisture state.

minecraft:blockCopy

json

"components": {
  ...
  "minecraft:random_ticking": {
    "on_tick": {
      "event": "wiki:set_moisture"
    }
  }
},
"events": {
  "wiki:set_moisture": {
    // If near water, sets `wiki:moisture` to `7`, else takes 1 away from current value to count down to `0` (dry).
    "set_block_state": {
      "wiki:moisture": "q.block_neighbor_has_any_tag(4,0,0,'water') || q.block_neighbor_has_any_tag(3,0,0,'water') || q.block_neighbor_has_any_tag(2,0,0,'water') || q.block_neighbor_has_any_tag(1,0,0,'water') || q.block_neighbor_has_any_tag(-1,0,0,'water') || q.block_neighbor_has_any_tag(-2,0,0,'water') || q.block_neighbor_has_any_tag(-3,0,0,'water') || q.block_neighbor_has_any_tag(-4,0,0,'water') || q.block_neighbor_has_any_tag(4,0,-4,'water') || q.block_neighbor_has_any_tag(3,0,-4,'water') || q.block_neighbor_has_any_tag(2,0,-4,'water') || q.block_neighbor_has_any_tag(1,0,-4,'water') || q.block_neighbor_has_any_tag(0,0,-4,'water') || q.block_neighbor_has_any_tag(-1,0,-4,'water') || q.block_neighbor_has_any_tag(-2,0,-4,'water') || q.block_neighbor_has_any_tag(-3,0,-4,'water') || q.block_neighbor_has_any_tag(-4,0,-4,'water') || q.block_neighbor_has_any_tag(4,0,-3,'water') || q.block_neighbor_has_any_tag(3,0,-3,'water') || q.block_neighbor_has_any_tag(2,0,-3,'water') || q.block_neighbor_has_any_tag(1,0,-3,'water') || q.block_neighbor_has_any_tag(0,0,-3,'water') || q.block_neighbor_has_any_tag(-1,0,-3,'water') || q.block_neighbor_has_any_tag(-2,0,-3,'water') || q.block_neighbor_has_any_tag(-3,0,-3,'water') || q.block_neighbor_has_any_tag(-4,0,-3,'water') || q.block_neighbor_has_any_tag(4,0,-2,'water') || q.block_neighbor_has_any_tag(3,0,-2,'water') || q.block_neighbor_has_any_tag(2,0,-2,'water') || q.block_neighbor_has_any_tag(1,0,-2,'water') || q.block_neighbor_has_any_tag(0,0,-2,'water') || q.block_neighbor_has_any_tag(-1,0,-2,'water') || q.block_neighbor_has_any_tag(-2,0,-2,'water') || q.block_neighbor_has_any_tag(-3,0,-2,'water') || q.block_neighbor_has_any_tag(-4,0,-2,'water') || q.block_neighbor_has_any_tag(4,0,-1,'water') || q.block_neighbor_has_any_tag(3,0,-1,'water') || q.block_neighbor_has_any_tag(2,0,-1,'water') || q.block_neighbor_has_any_tag(1,0,-1,'water') || q.block_neighbor_has_any_tag(0,0,-1,'water') || q.block_neighbor_has_any_tag(-1,0,-1,'water') || q.block_neighbor_has_any_tag(-2,0,-1,'water') || q.block_neighbor_has_any_tag(-3,0,-1,'water') || q.block_neighbor_has_any_tag(-4,0,-1,'water') || q.block_neighbor_has_any_tag(4,0,1,'water') || q.block_neighbor_has_any_tag(3,0,1,'water') || q.block_neighbor_has_any_tag(2,0,1,'water') || q.block_neighbor_has_any_tag(1,0,1,'water') || q.block_neighbor_has_any_tag(0,0,1,'water') || q.block_neighbor_has_any_tag(-1,0,1,'water') || q.block_neighbor_has_any_tag(-2,0,1,'water') || q.block_neighbor_has_any_tag(-3,0,1,'water') || q.block_neighbor_has_any_tag(-4,0,1,'water') || q.block_neighbor_has_any_tag(4,0,2,'water') || q.block_neighbor_has_any_tag(3,0,2,'water') || q.block_neighbor_has_any_tag(2,0,2,'water') || q.block_neighbor_has_any_tag(1,0,2,'water') || q.block_neighbor_has_any_tag(0,0,2,'water') || q.block_neighbor_has_any_tag(-1,0,2,'water') || q.block_neighbor_has_any_tag(-2,0,2,'water') || q.block_neighbor_has_any_tag(-3,0,2,'water') || q.block_neighbor_has_any_tag(-4,0,2,'water') || q.block_neighbor_has_any_tag(4,0,3,'water') || q.block_neighbor_has_any_tag(3,0,3,'water') || q.block_neighbor_has_any_tag(2,0,3,'water') || q.block_neighbor_has_any_tag(1,0,3,'water') || q.block_neighbor_has_any_tag(0,0,3,'water') || q.block_neighbor_has_any_tag(-1,0,3,'water') || q.block_neighbor_has_any_tag(-2,0,3,'water') || q.block_neighbor_has_any_tag(-3,0,3,'water') || q.block_neighbor_has_any_tag(-4,0,3,'water') || q.block_neighbor_has_any_tag(4,0,4,'water') || q.block_neighbor_has_any_tag(3,0,4,'water') || q.block_neighbor_has_any_tag(2,0,4,'water') || q.block_neighbor_has_any_tag(1,0,4,'water') || q.block_neighbor_has_any_tag(0,0,4,'water') || q.block_neighbor_has_any_tag(-1,0,4,'water') || q.block_neighbor_has_any_tag(-2,0,4,'water') || q.block_neighbor_has_any_tag(-3,0,4,'water') || q.block_neighbor_has_any_tag(-4,0,4,'water') || q.block_neighbor_has_any_tag(4,1,0,'water') || q.block_neighbor_has_any_tag(3,1,0,'water') || q.block_neighbor_has_any_tag(2,1,0,'water') || q.block_neighbor_has_any_tag(1,1,0,'water') || q.block_neighbor_has_any_tag(-1,1,0,'water') || q.block_neighbor_has_any_tag(-2,1,0,'water') || q.block_neighbor_has_any_tag(-3,1,0,'water') || q.block_neighbor_has_any_tag(-4,1,0,'water') || q.block_neighbor_has_any_tag(4,1,-4,'water') || q.block_neighbor_has_any_tag(3,1,-4,'water') || q.block_neighbor_has_any_tag(2,1,-4,'water') || q.block_neighbor_has_any_tag(1,1,-4,'water') || q.block_neighbor_has_any_tag(0,1,-4,'water') || q.block_neighbor_has_any_tag(-1,1,-4,'water') || q.block_neighbor_has_any_tag(-2,1,-4,'water') || q.block_neighbor_has_any_tag(-3,1,-4,'water') || q.block_neighbor_has_any_tag(-4,1,-4,'water') || q.block_neighbor_has_any_tag(4,1,-3,'water') || q.block_neighbor_has_any_tag(3,1,-3,'water') || q.block_neighbor_has_any_tag(2,1,-3,'water') || q.block_neighbor_has_any_tag(1,1,-3,'water') || q.block_neighbor_has_any_tag(0,1,-3,'water') || q.block_neighbor_has_any_tag(-1,1,-3,'water') || q.block_neighbor_has_any_tag(-2,1,-3,'water') || q.block_neighbor_has_any_tag(-3,1,-3,'water') || q.block_neighbor_has_any_tag(-4,1,-3,'water') || q.block_neighbor_has_any_tag(4,1,-2,'water') || q.block_neighbor_has_any_tag(3,1,-2,'water') || q.block_neighbor_has_any_tag(2,1,-2,'water') || q.block_neighbor_has_any_tag(1,1,-2,'water') || q.block_neighbor_has_any_tag(0,1,-2,'water') || q.block_neighbor_has_any_tag(-1,1,-2,'water') || q.block_neighbor_has_any_tag(-2,1,-2,'water') || q.block_neighbor_has_any_tag(-3,1,-2,'water') || q.block_neighbor_has_any_tag(-4,1,-2,'water') || q.block_neighbor_has_any_tag(4,1,-1,'water') || q.block_neighbor_has_any_tag(3,1,-1,'water') || q.block_neighbor_has_any_tag(2,1,-1,'water') || q.block_neighbor_has_any_tag(1,1,-1,'water') || q.block_neighbor_has_any_tag(0,1,-1,'water') || q.block_neighbor_has_any_tag(-1,1,-1,'water') || q.block_neighbor_has_any_tag(-2,1,-1,'water') || q.block_neighbor_has_any_tag(-3,1,-1,'water') || q.block_neighbor_has_any_tag(-4,1,-1,'water') || q.block_neighbor_has_any_tag(4,1,1,'water') || q.block_neighbor_has_any_tag(3,1,1,'water') || q.block_neighbor_has_any_tag(2,1,1,'water') || q.block_neighbor_has_any_tag(1,1,1,'water') || q.block_neighbor_has_any_tag(0,1,1,'water') || q.block_neighbor_has_any_tag(-1,1,1,'water') || q.block_neighbor_has_any_tag(-2,1,1,'water') || q.block_neighbor_has_any_tag(-3,1,1,'water') || q.block_neighbor_has_any_tag(-4,1,1,'water') || q.block_neighbor_has_any_tag(4,1,2,'water') || q.block_neighbor_has_any_tag(3,1,2,'water') || q.block_neighbor_has_any_tag(2,1,2,'water') || q.block_neighbor_has_any_tag(1,1,2,'water') || q.block_neighbor_has_any_tag(0,1,2,'water') || q.block_neighbor_has_any_tag(-1,1,2,'water') || q.block_neighbor_has_any_tag(-2,1,2,'water') || q.block_neighbor_has_any_tag(-3,1,2,'water') || q.block_neighbor_has_any_tag(-4,1,2,'water') || q.block_neighbor_has_any_tag(4,1,3,'water') || q.block_neighbor_has_any_tag(3,1,3,'water') || q.block_neighbor_has_any_tag(2,1,3,'water') || q.block_neighbor_has_any_tag(1,1,3,'water') || q.block_neighbor_has_any_tag(0,1,3,'water') || q.block_neighbor_has_any_tag(-1,1,3,'water') || q.block_neighbor_has_any_tag(-2,1,3,'water') || q.block_neighbor_has_any_tag(-3,1,3,'water') || q.block_neighbor_has_any_tag(-4,1,3,'water') || q.block_neighbor_has_any_tag(4,1,4,'water') || q.block_neighbor_has_any_tag(3,1,4,'water') || q.block_neighbor_has_any_tag(2,1,4,'water') || q.block_neighbor_has_any_tag(1,1,4,'water') || q.block_neighbor_has_any_tag(0,1,4,'water') || q.block_neighbor_has_any_tag(-1,1,4,'water') || q.block_neighbor_has_any_tag(-2,1,4,'water') || q.block_neighbor_has_any_tag(-3,1,4,'water') || q.block_neighbor_has_any_tag(-4,1,4,'water') ? 7 : q.block_state('wiki:moisture') ? q.block_state('wiki:moisture') - 1"
    },
    // Triggers the event which decays farmland into dirt if dry.
    "trigger": "wiki:try_decay"
  },
  "wiki:try_decay": {
    "sequence": [
      {
        "condition": "!q.block_state('wiki:moisture')",
        "trigger": "wiki:decay"
      }
    ]
  },
  // Tranform block into `wiki:custom_dirt` when dry or trampled.
  "wiki:decay": {
    "set_block": {
      "block_type": "wiki:custom_dirt"
    }
  }
}

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

This is the tricky part of our farmland block, water detection. In vanilla Minecraft, water can wet farmland in a giant 9x9 square if it's smack dab in the middle of all the blocks. We are replicating that behavior here for each coordinate relative to our farmland on the same Y level, or 1 above. For example, q.block_neighbor_has_any_tag(-3,0,4,'water') is saying that if our farmland block has a block with the water tag 3 blocks east and 4 blocks south, then the wiki:moisture state will be 7. The || stands for 'or', which means that we can have a water block at any of these relative coordinates.

Trampling

If our custom farmland is fallen onto, it should have a chance to decay.

minecraft:blockCopy

json

"components": {
  ...
  "minecraft:on_fall_on": {
    "min_fall_distance": 1,
    "event": "wiki:trample"
  }
},
"events": {
  ...
  // 50% chance for farmland to decay if trampled.
  "wiki:trample": {
    "randomize": [
      {
        "weight": 1
      },
      {
        "weight": 1,
        "trigger": "wiki:decay"
      }
    ]
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

Here is the full wiki:custom_farmland json for reference.

Custom Farmland Block JSON

BP/blocks/custom_farmland.jsonCopy

json

{
  "format_version": "1.20.30",
  "minecraft:block": {
    "description": {
      "identifier": "wiki:custom_farmland",
      "menu_category": {
        "category": "nature"
      },
      "states": {
        "wiki:moisture": {
          "values": { "min": 0, "max": 7 }
        }
      }
    },
    "components": {
      "minecraft:map_color": "#0A5E20",
      "minecraft:geometry": "geometry.farmland",
      "minecraft:light_dampening": 0,
      "minecraft:destructible_by_mining": {
        "seconds_to_destroy": 0.6
      },
      "minecraft:selection_box": {
        "origin": [-8, 0, -8],
        "size": [16, 15, 16]
      },
      "minecraft:collision_box": {
        "origin": [-8, 0, -8],
        "size": [16, 15, 16]
      },
      "minecraft:material_instances": {
        "*": {
          "texture": "custom_dirt",
          "render_method": "alpha_test"
        },
        "up": {
          "texture": "custom_farmland",
          "render_method": "alpha_test"
        }
      },
      "minecraft:random_ticking": {
        "on_tick": {
          "event": "wiki:set_moisture"
        }
      },
      "minecraft:on_fall_on": {
        "min_fall_distance": 1,
        "event": "wiki:trample"
      }
    },
    "events": {
      "wiki:set_moisture": {
        "set_block_state": {
          "wiki:moisture": "q.block_neighbor_has_any_tag(4,0,0,'water') || q.block_neighbor_has_any_tag(3,0,0,'water') || q.block_neighbor_has_any_tag(2,0,0,'water') || q.block_neighbor_has_any_tag(1,0,0,'water') || q.block_neighbor_has_any_tag(-1,0,0,'water') || q.block_neighbor_has_any_tag(-2,0,0,'water') || q.block_neighbor_has_any_tag(-3,0,0,'water') || q.block_neighbor_has_any_tag(-4,0,0,'water') || q.block_neighbor_has_any_tag(4,0,-4,'water') || q.block_neighbor_has_any_tag(3,0,-4,'water') || q.block_neighbor_has_any_tag(2,0,-4,'water') || q.block_neighbor_has_any_tag(1,0,-4,'water') || q.block_neighbor_has_any_tag(0,0,-4,'water') || q.block_neighbor_has_any_tag(-1,0,-4,'water') || q.block_neighbor_has_any_tag(-2,0,-4,'water') || q.block_neighbor_has_any_tag(-3,0,-4,'water') || q.block_neighbor_has_any_tag(-4,0,-4,'water') || q.block_neighbor_has_any_tag(4,0,-3,'water') || q.block_neighbor_has_any_tag(3,0,-3,'water') || q.block_neighbor_has_any_tag(2,0,-3,'water') || q.block_neighbor_has_any_tag(1,0,-3,'water') || q.block_neighbor_has_any_tag(0,0,-3,'water') || q.block_neighbor_has_any_tag(-1,0,-3,'water') || q.block_neighbor_has_any_tag(-2,0,-3,'water') || q.block_neighbor_has_any_tag(-3,0,-3,'water') || q.block_neighbor_has_any_tag(-4,0,-3,'water') || q.block_neighbor_has_any_tag(4,0,-2,'water') || q.block_neighbor_has_any_tag(3,0,-2,'water') || q.block_neighbor_has_any_tag(2,0,-2,'water') || q.block_neighbor_has_any_tag(1,0,-2,'water') || q.block_neighbor_has_any_tag(0,0,-2,'water') || q.block_neighbor_has_any_tag(-1,0,-2,'water') || q.block_neighbor_has_any_tag(-2,0,-2,'water') || q.block_neighbor_has_any_tag(-3,0,-2,'water') || q.block_neighbor_has_any_tag(-4,0,-2,'water') || q.block_neighbor_has_any_tag(4,0,-1,'water') || q.block_neighbor_has_any_tag(3,0,-1,'water') || q.block_neighbor_has_any_tag(2,0,-1,'water') || q.block_neighbor_has_any_tag(1,0,-1,'water') || q.block_neighbor_has_any_tag(0,0,-1,'water') || q.block_neighbor_has_any_tag(-1,0,-1,'water') || q.block_neighbor_has_any_tag(-2,0,-1,'water') || q.block_neighbor_has_any_tag(-3,0,-1,'water') || q.block_neighbor_has_any_tag(-4,0,-1,'water') || q.block_neighbor_has_any_tag(4,0,1,'water') || q.block_neighbor_has_any_tag(3,0,1,'water') || q.block_neighbor_has_any_tag(2,0,1,'water') || q.block_neighbor_has_any_tag(1,0,1,'water') || q.block_neighbor_has_any_tag(0,0,1,'water') || q.block_neighbor_has_any_tag(-1,0,1,'water') || q.block_neighbor_has_any_tag(-2,0,1,'water') || q.block_neighbor_has_any_tag(-3,0,1,'water') || q.block_neighbor_has_any_tag(-4,0,1,'water') || q.block_neighbor_has_any_tag(4,0,2,'water') || q.block_neighbor_has_any_tag(3,0,2,'water') || q.block_neighbor_has_any_tag(2,0,2,'water') || q.block_neighbor_has_any_tag(1,0,2,'water') || q.block_neighbor_has_any_tag(0,0,2,'water') || q.block_neighbor_has_any_tag(-1,0,2,'water') || q.block_neighbor_has_any_tag(-2,0,2,'water') || q.block_neighbor_has_any_tag(-3,0,2,'water') || q.block_neighbor_has_any_tag(-4,0,2,'water') || q.block_neighbor_has_any_tag(4,0,3,'water') || q.block_neighbor_has_any_tag(3,0,3,'water') || q.block_neighbor_has_any_tag(2,0,3,'water') || q.block_neighbor_has_any_tag(1,0,3,'water') || q.block_neighbor_has_any_tag(0,0,3,'water') || q.block_neighbor_has_any_tag(-1,0,3,'water') || q.block_neighbor_has_any_tag(-2,0,3,'water') || q.block_neighbor_has_any_tag(-3,0,3,'water') || q.block_neighbor_has_any_tag(-4,0,3,'water') || q.block_neighbor_has_any_tag(4,0,4,'water') || q.block_neighbor_has_any_tag(3,0,4,'water') || q.block_neighbor_has_any_tag(2,0,4,'water') || q.block_neighbor_has_any_tag(1,0,4,'water') || q.block_neighbor_has_any_tag(0,0,4,'water') || q.block_neighbor_has_any_tag(-1,0,4,'water') || q.block_neighbor_has_any_tag(-2,0,4,'water') || q.block_neighbor_has_any_tag(-3,0,4,'water') || q.block_neighbor_has_any_tag(-4,0,4,'water') || q.block_neighbor_has_any_tag(4,1,0,'water') || q.block_neighbor_has_any_tag(3,1,0,'water') || q.block_neighbor_has_any_tag(2,1,0,'water') || q.block_neighbor_has_any_tag(1,1,0,'water') || q.block_neighbor_has_any_tag(-1,1,0,'water') || q.block_neighbor_has_any_tag(-2,1,0,'water') || q.block_neighbor_has_any_tag(-3,1,0,'water') || q.block_neighbor_has_any_tag(-4,1,0,'water') || q.block_neighbor_has_any_tag(4,1,-4,'water') || q.block_neighbor_has_any_tag(3,1,-4,'water') || q.block_neighbor_has_any_tag(2,1,-4,'water') || q.block_neighbor_has_any_tag(1,1,-4,'water') || q.block_neighbor_has_any_tag(0,1,-4,'water') || q.block_neighbor_has_any_tag(-1,1,-4,'water') || q.block_neighbor_has_any_tag(-2,1,-4,'water') || q.block_neighbor_has_any_tag(-3,1,-4,'water') || q.block_neighbor_has_any_tag(-4,1,-4,'water') || q.block_neighbor_has_any_tag(4,1,-3,'water') || q.block_neighbor_has_any_tag(3,1,-3,'water') || q.block_neighbor_has_any_tag(2,1,-3,'water') || q.block_neighbor_has_any_tag(1,1,-3,'water') || q.block_neighbor_has_any_tag(0,1,-3,'water') || q.block_neighbor_has_any_tag(-1,1,-3,'water') || q.block_neighbor_has_any_tag(-2,1,-3,'water') || q.block_neighbor_has_any_tag(-3,1,-3,'water') || q.block_neighbor_has_any_tag(-4,1,-3,'water') || q.block_neighbor_has_any_tag(4,1,-2,'water') || q.block_neighbor_has_any_tag(3,1,-2,'water') || q.block_neighbor_has_any_tag(2,1,-2,'water') || q.block_neighbor_has_any_tag(1,1,-2,'water') || q.block_neighbor_has_any_tag(0,1,-2,'water') || q.block_neighbor_has_any_tag(-1,1,-2,'water') || q.block_neighbor_has_any_tag(-2,1,-2,'water') || q.block_neighbor_has_any_tag(-3,1,-2,'water') || q.block_neighbor_has_any_tag(-4,1,-2,'water') || q.block_neighbor_has_any_tag(4,1,-1,'water') || q.block_neighbor_has_any_tag(3,1,-1,'water') || q.block_neighbor_has_any_tag(2,1,-1,'water') || q.block_neighbor_has_any_tag(1,1,-1,'water') || q.block_neighbor_has_any_tag(0,1,-1,'water') || q.block_neighbor_has_any_tag(-1,1,-1,'water') || q.block_neighbor_has_any_tag(-2,1,-1,'water') || q.block_neighbor_has_any_tag(-3,1,-1,'water') || q.block_neighbor_has_any_tag(-4,1,-1,'water') || q.block_neighbor_has_any_tag(4,1,1,'water') || q.block_neighbor_has_any_tag(3,1,1,'water') || q.block_neighbor_has_any_tag(2,1,1,'water') || q.block_neighbor_has_any_tag(1,1,1,'water') || q.block_neighbor_has_any_tag(0,1,1,'water') || q.block_neighbor_has_any_tag(-1,1,1,'water') || q.block_neighbor_has_any_tag(-2,1,1,'water') || q.block_neighbor_has_any_tag(-3,1,1,'water') || q.block_neighbor_has_any_tag(-4,1,1,'water') || q.block_neighbor_has_any_tag(4,1,2,'water') || q.block_neighbor_has_any_tag(3,1,2,'water') || q.block_neighbor_has_any_tag(2,1,2,'water') || q.block_neighbor_has_any_tag(1,1,2,'water') || q.block_neighbor_has_any_tag(0,1,2,'water') || q.block_neighbor_has_any_tag(-1,1,2,'water') || q.block_neighbor_has_any_tag(-2,1,2,'water') || q.block_neighbor_has_any_tag(-3,1,2,'water') || q.block_neighbor_has_any_tag(-4,1,2,'water') || q.block_neighbor_has_any_tag(4,1,3,'water') || q.block_neighbor_has_any_tag(3,1,3,'water') || q.block_neighbor_has_any_tag(2,1,3,'water') || q.block_neighbor_has_any_tag(1,1,3,'water') || q.block_neighbor_has_any_tag(0,1,3,'water') || q.block_neighbor_has_any_tag(-1,1,3,'water') || q.block_neighbor_has_any_tag(-2,1,3,'water') || q.block_neighbor_has_any_tag(-3,1,3,'water') || q.block_neighbor_has_any_tag(-4,1,3,'water') || q.block_neighbor_has_any_tag(4,1,4,'water') || q.block_neighbor_has_any_tag(3,1,4,'water') || q.block_neighbor_has_any_tag(2,1,4,'water') || q.block_neighbor_has_any_tag(1,1,4,'water') || q.block_neighbor_has_any_tag(0,1,4,'water') || q.block_neighbor_has_any_tag(-1,1,4,'water') || q.block_neighbor_has_any_tag(-2,1,4,'water') || q.block_neighbor_has_any_tag(-3,1,4,'water') || q.block_neighbor_has_any_tag(-4,1,4,'water') ? 7 : q.block_state('wiki:moisture') ? q.block_state('wiki:moisture') - 1"
        },
        "trigger": "wiki:try_decay"
      },
      "wiki:trample": {
        "randomize": [
          {
            "weight": 1
          },
          {
            "weight": 1,
            "trigger": "wiki:decay"
          }
        ]
      },
      "wiki:try_decay": {
        "sequence": [
          {
            "condition": "!q.block_state('wiki:moisture')",
            "trigger": "wiki:decay"
          }
        ]
      },
      "wiki:decay": {
        "set_block": {
          "block_type": "wiki:custom_dirt"
        }
      }
    },
    "permutations": [
      {
        "condition": "q.block_state('wiki:moisture')",
        "components": {
          "minecraft:material_instances": {
            "*": {
              "texture": "custom_dirt",
              "render_method": "alpha_test"
            },
            "up": {
              "texture": "custom_farmland_wet",
              "render_method": "alpha_test"
            }
          }
        }
      }
    ]
  }
}

Custom Crop

If you aren't a fan of carrots - that's fine. You can make your own (far superior) crop!

Making crops is not as difficult as you may think, it just takes a little practice and forethought in coding a specific series of events.

To start with, we want our crops to have 4 stages of growth, so the crop should include a state with four values.

BP/blocks/custom_crop.jsonCopy

json

{
  "format_version": "1.20.30",
  "minecraft:block": {
    "description": {
      "identifier": "wiki:custom_crop",
      "menu_category": {
        "category": "none" // Hide from creative inventory - seeds should be used to place
      },
      "states": {
        "wiki:growth_stage": [0, 1, 2, 3]
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

Model

If you look at crops like carrots and potatoes in-game, you will see that they are made up of four planes and are situated 4 pixels from each edge as shown in the screenshot below.

It is noteworthy to mention that each plane sits 1 pixel down, unlike traditional blocks. If you forgot to lower the planes down by one, then the crops will appear to grow one pixel higher then the top of our farmland which was lowered in our previous tutorial.

By lowering the position down a pixel, it will sit above our custom farmland perfectly making everything right in our blocky world. Here is a template model for the crop.

Download Custom Crop Geometry

Components

Below are the components our custom crop will use.

NOTE: This is not a perfect replica of vanilla crops as lava will not destroy the crops and water destruction behaves differently.

minecraft:blockCopy

json

"components": {
  "minecraft:flammable": true,
  "minecraft:collision_box": false,
  "minecraft:geometry": "geometry.crop",
  "minecraft:light_dampening": 0,
  // Break if not placed on farmland
  "minecraft:placement_filter": {
    "conditions": [
      {
        "allowed_faces": ["up"],
        "block_filter": ["wiki:custom_farmland"]
      }
    ]
  },
  // Loot table for when the crop is not fully grown. Vanilla crops only drop seeds when young.
  "minecraft:loot": "loot_tables/blocks/custom_crop_young.json",
  // Trigger growth every random tick
  "minecraft:random_ticking": {
    "on_tick": {
      "event": "wiki:grow",
      "condition": "q.block_state('wiki:growth_stage') < 3"
    }
  },
  // Break crop when in contact with water
  "minecraft:queued_ticking": {
    // Check every 10 ticks
    "interval_range": [10, 10],
    "looping": true,
    "on_tick": {
      "event": "wiki:destroy",
      "condition": "q.block_neighbor_has_any_tag(1,0,0,'water') || q.block_neighbor_has_any_tag(-1,0,0,'water') || q.block_neighbor_has_any_tag(0,0,1,'water') || q.block_neighbor_has_any_tag(0,0,-1,'water') || q.block_neighbor_has_any_tag(0,1,0,'water')"
    }
  },
  // Trigger growth with bone meal
  "minecraft:on_interact": {
    "event": "wiki:fertilize",
    "condition": "q.is_item_name_any('slot.weapon.mainhand', 'minecraft:bone_meal') && q.block_state('wiki:growth_stage') < 3"
  }
}

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

Events

The events below do three important functions to make your crop work:

The first event is used to destroy the block if it's in contact with water.
The second event adds a stage to the crop growth when activated. It adds one to wiki:growth_stage if less than 3.
The final event is for bonemeal support, adding a random value to wiki:growth_stage.

minecraft:blockCopy

json

"events": {
  "wiki:destroy": {
    "run_command": {
      "command": "setblock ~~~ air destroy"
    }
  },
  // Adds to "wiki:growth_stage" (grows crop)
  "wiki:grow": {
    "set_block_state": {
      "wiki:growth_stage": "q.block_state('wiki:growth_stage') + 1"
    }
  },
  // Bonemeal the crop (grow crop a random amount)
  "wiki:fertilize": {
    // Take bonemeal
    "decrement_stack": {},
    // Trigger random growth
    "set_block_state": {
      "wiki:growth_stage": "q.block_state('wiki:growth_stage') + Math.random(1, 3 - q.block_state('wiki:growth_stage'))"
    },
    // Trigger effects
    "run_command": {
      "command": ["particle minecraft:crop_growth_emitter ~~~", "playsound item.bone_meal.use @a ~~~"]
    }
  }
}

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

So we know how to set our block states, what happens when our block is on a particular state value?

The permutations below set a certain "minecraft:selection_box" and texture to the block based on the q.block_state('wiki:growth_stage') or "wiki:growth_stage" value. For example, if "wiki:growth_stage" is 3, the permutation sets the texture to "custom_crop_3".

Permutations

minecraft:blockCopy

json

"permutations": [
  {
    "condition": "q.block_state('wiki:growth_stage') == 0",
    "components": {
      "minecraft:material_instances": {
        "*": {
          "texture": "custom_crop_0",
          "render_method": "alpha_test",
          "face_dimming": false,
          "ambient_occlusion": false
        }
      },
      "minecraft:selection_box": {
        "origin": [-8, 0, -8],
        "size": [16, 2, 16]
      }
    }
  },
  {
    "condition": "q.block_state('wiki:growth_stage') == 1",
    "components": {
      "minecraft:material_instances": {
        "*": {
          "texture": "custom_crop_1",
          "render_method": "alpha_test",
          "face_dimming": false,
          "ambient_occlusion": false
        }
      },
      "minecraft:selection_box": {
        "origin": [-8, 0, -8],
        "size": [16, 5, 16]
      }
    }
  },
  {
    "condition": "q.block_state('wiki:growth_stage') == 2",
    "components": {
      "minecraft:material_instances": {
        "*": {
          "texture": "custom_crop_2",
          "render_method": "alpha_test",
          "face_dimming": false,
          "ambient_occlusion": false
        }
      },
      "minecraft:selection_box": {
        "origin": [-8, 0, -8],
        "size": [16, 9, 16]
      }
    }
  },
  {
    "condition": "q.block_state('wiki:growth_stage') == 3",
    "components": {
      "minecraft:material_instances": {
        "*": {
          "texture": "custom_crop_3",
          "render_method": "alpha_test",
          "face_dimming": false,
          "ambient_occlusion": false
        }
      },
      "minecraft:selection_box": {
        "origin": [-8, 0, -8],
        "size": [16, 13, 16]
      },
      // Drop different loot when fully grown
      "minecraft:loot": "loot_tables/blocks/custom_crop_mature.json"
    }
  }
]

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

You can add more permutations depending on how many stages you want your crop to have. But don't forget to also change the events and states limit.

Here is the entire wiki:custom_crop file for reference.

Custom Crop Block JSON

BP/blocks/custom_crop.jsonCopy

json

{
  "format_version": "1.20.30",
  "minecraft:block": {
    "description": {
      "identifier": "wiki:custom_crop",
      "menu_category": {
        "category": "none" // Hide from creative inventory - seeds should be used to place
      },
      "states": {
        "wiki:growth_stage": [0, 1, 2, 3]
      }
    },
    "components": {
      "minecraft:flammable": true,
      "minecraft:collision_box": false,
      "minecraft:geometry": "geometry.crop",
      "minecraft:light_dampening": 0,
      // Break if not placed on farmland
      "minecraft:placement_filter": {
        "conditions": [
          {
            "allowed_faces": ["up"],
            "block_filter": ["wiki:custom_farmland"]
          }
        ]
      },
      // Loot table for when the crop is not fully grown. Vanilla crops only drop seeds when young.
      "minecraft:loot": "loot_tables/blocks/custom_crop_young.json",
      // Trigger growth every random tick
      "minecraft:random_ticking": {
        "on_tick": {
          "event": "wiki:grow",
          "condition": "q.block_state('wiki:growth_stage') < 3"
        }
      },
      // Break crop when in contact with water
      "minecraft:queued_ticking": {
        // Check every 10 ticks
        "interval_range": [10, 10],
        "looping": true,
        "on_tick": {
          "event": "wiki:destroy",
          "condition": "q.block_neighbor_has_any_tag(1,0,0,'water') || q.block_neighbor_has_any_tag(-1,0,0,'water') || q.block_neighbor_has_any_tag(0,0,1,'water') || q.block_neighbor_has_any_tag(0,0,-1,'water') || q.block_neighbor_has_any_tag(0,1,0,'water')"
        }
      },
      // Trigger growth with bone meal
      "minecraft:on_interact": {
        "event": "wiki:fertilize",
        "condition": "q.is_item_name_any('slot.weapon.mainhand', 'minecraft:bone_meal') && q.block_state('wiki:growth_stage') < 3"
      }
    },
    "events": {
      "wiki:destroy": {
        "run_command": {
          "command": "setblock ~~~ air destroy"
        }
      },
      // Adds to "wiki:growth_stage" (grows crop)
      "wiki:grow": {
        "set_block_state": {
          "wiki:growth_stage": "q.block_state('wiki:growth_stage') + 1"
        }
      },
      // Bonemeal the crop (grow crop a random amount)
      "wiki:fertilize": {
        // Take bonemeal
        "decrement_stack": {},
        // Trigger random growth
        "set_block_state": {
          "wiki:growth_stage": "q.block_state('wiki:growth_stage') + Math.random(1, 3 - q.block_state('wiki:growth_stage'))"
        },
        // Trigger effects
        "run_command": {
          "command": ["particle minecraft:crop_growth_emitter ~~~", "playsound item.bone_meal.use @a ~~~"]
        }
      }
    },
    "permutations": [
      {
        "condition": "q.block_state('wiki:growth_stage') == 0",
        "components": {
          "minecraft:material_instances": {
            "*": {
              "texture": "custom_crop_0",
              "render_method": "alpha_test",
              "face_dimming": false,
              "ambient_occlusion": false
            }
          },
          "minecraft:selection_box": {
            "origin": [-8, 0, -8],
            "size": [16, 2, 16]
          }
        }
      },
      {
        "condition": "q.block_state('wiki:growth_stage') == 1",
        "components": {
          "minecraft:material_instances": {
            "*": {
              "texture": "custom_crop_1",
              "render_method": "alpha_test",
              "face_dimming": false,
              "ambient_occlusion": false
            }
          },
          "minecraft:selection_box": {
            "origin": [-8, 0, -8],
            "size": [16, 5, 16]
          }
        }
      },
      {
        "condition": "q.block_state('wiki:growth_stage') == 2",
        "components": {
          "minecraft:material_instances": {
            "*": {
              "texture": "custom_crop_2",
              "render_method": "alpha_test",
              "face_dimming": false,
              "ambient_occlusion": false
            }
          },
          "minecraft:selection_box": {
            "origin": [-8, 0, -8],
            "size": [16, 9, 16]
          }
        }
      },
      {
        "condition": "q.block_state('wiki:growth_stage') == 3",
        "components": {
          "minecraft:material_instances": {
            "*": {
              "texture": "custom_crop_3",
              "render_method": "alpha_test",
              "face_dimming": false,
              "ambient_occlusion": false
            }
          },
          "minecraft:selection_box": {
            "origin": [-8, 0, -8],
            "size": [16, 13, 16]
          },
          // Drop different loot when fully grown
          "minecraft:loot": "loot_tables/blocks/custom_crop_mature.json"
        }
      }
    ]
  }
}

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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

Crop Loot

Below are some example loot tables that your custom crop could use:

BP/loot_tables/blocks/custom_crop_young.jsonCopy

json

{
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "item",
          "name": "wiki:custom_seeds"
        }
      ]
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13

BP/loot_tables/blocks/custom_crop_mature.jsonCopy

json

{
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "item",
          "name": "wiki:custom_food",
          "functions": [
            {
              "function": "set_count",
              "count": { "min": 2, "max": 5 }
            }
          ]
        }
      ]
    },
    {
      "rolls": 1,
      "entries": [
        {
          "type": "item",
          "name": "wiki:custom_seeds",
          "functions": [
            {
              "function": "set_count",
              "count": { "min": 0, "max": 3 }
            }
          ]
        }
      ]
    }
  ]
}

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

Custom Seeds

Holding a crop block in your hand wouldn't look right, so we place the crop with seeds! Below is the JSON for a custom item that places your crop.

BP/items/custom_seeds.jsonCopy

json

{
  "format_version": "1.20.30",
  "minecraft:item": {
    "description": {
      "identifier": "wiki:custom_seeds", // Make sure this is different from your crop's ID
      "menu_category": {
        "category": "nature",
        "group": "itemGroup.name.seed"
      }
    },
    "components": {
      "minecraft:icon": {
        "texture": "custom_seeds"
      },
      "minecraft:block_placer": {
        "block": "wiki:custom_crop" // The block this item is placing
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

Custom Food

Your crop can't only drop seeds! Create a custom food using the template below.

BP/items/custom_food.jsonCopy

json

{
  "format_version": "1.20.30",
  "minecraft:item": {
    "description": {
      "identifier": "wiki:custom_food", // Make sure this is different from your crop and food's ID
      "menu_category": {
        "category": "nature",
        "group": "itemGroup.name.crop"
      }
    },
    "components": {
      "minecraft:icon": {
        "texture": "custom_food"
      },
      "minecraft:food": {
        "nutrition": 4,
        "saturation_modifier": 0.6
      },
      "minecraft:use_animation": "eat",
      "minecraft:use_duration": 1.6
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

Result

Your pack should now contain the following files:

📁BP

📁blocks

📝custom_dirt.json

📝custom_crop.json

📝custom_farmland.json

📁items

📝custom_food.json

📝custom_seeds.json

📁loot_tables

📁blocks

📝custom_crop_mature.json

📝custom_crop_young.json

In conclusion, with the help of this tutorial/template, you now have the knowledge and skills to create your own custom crop, as well as other farming-related blocks such as farmland and dirt.

Download Example Pack

If you require further assistance or would like to access the complete template files, please use the download button provided below. Happy designing!

Download MCADDON

Edit Custom Crops on Github.

Custom Crops

Custom Dirt #

Custom Farmland #

Farmland Moisture #

Hydration #

Trampling #

Custom Crop #

Model #

Components #

Events #

Permutations #

Crop Loot #

Custom Seeds #

Custom Food #

Result #

Download Example Pack #

Contributors

Custom Dirt

Custom Farmland

Farmland Moisture

Hydration

Trampling

Custom Crop

Model

Components

Events

Permutations

Crop Loot

Custom Seeds

Custom Food

Result

Download Example Pack