aboutsummaryrefslogtreecommitdiff
path: root/src/Java/powercrystals/minefactoryreloaded/api/IFactoryPlantable.java
blob: 1d620b37ede4949846ca3f3797989f1b9c561b0f (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
82
83
84
85
86
87
88
89
90
91
92
93
94
package powercrystals.minefactoryreloaded.api;

import net.minecraft.item.Item;
import net.minecraft.item.ItemStack;
import net.minecraft.world.World;

/**
 * Defines a plantable object for use in the Planter.
 *
 * @author PowerCrystals
 */
public interface IFactoryPlantable {

	/**
	 * @return The item this plantable is managing.
	 */
	public Item getSeed();

	/**
	 * @param stack
	 *            The stack being planted.
	 * @param forFermenting
	 *            True if this stack will be converted to biofuel
	 *
	 * @return True if this plantable can be planted (useful for metadata
	 *         items).
	 */
	public boolean canBePlanted(ItemStack stack, boolean forFermenting);

	/**
	 * @param world
	 *            The world instance this block or item will be placed into.
	 * @param x
	 *            The destination X coordinate.
	 * @param y
	 *            The destination Y coordinate.
	 * @param z
	 *            The destination Z coordinate.
	 * @param stack
	 *            The stack being planted.
	 *
	 * @return The block that will be placed into the world.
	 */
	public ReplacementBlock getPlantedBlock(World world, int x, int y, int z, ItemStack stack);

	/**
	 * @param world
	 *            The world instance this block or item will be placed into.
	 * @param x
	 *            The destination X coordinate.
	 * @param y
	 *            The destination Y coordinate.
	 * @param z
	 *            The destination Z coordinate.
	 * @param stack
	 *            The stack being planted.
	 *
	 * @return True if this plantable can be placed at the provided coordinates.
	 */
	public boolean canBePlantedHere(World world, int x, int y, int z, ItemStack stack);

	/**
	 * Called before planting is performed. Used to till soil, for example.
	 *
	 * @param world
	 *            The world instance this block or item will be placed into.
	 * @param x
	 *            The destination X coordinate.
	 * @param y
	 *            The destination Y coordinate.
	 * @param z
	 *            The destination Z coordinate.
	 * @param stack
	 *            The stack being planted.
	 */
	public void prePlant(World world, int x, int y, int z, ItemStack stack);

	/**
	 * Called after planting is performed. Usually empty.
	 *
	 * @param world
	 *            The world instance this block or item will be placed into.
	 * @param x
	 *            The destination X coordinate.
	 * @param y
	 *            The destination Y coordinate.
	 * @param z
	 *            The destination Z coordinate.
	 * @param stack
	 *            The stack being planted.
	 */
	public void postPlant(World world, int x, int y, int z, ItemStack stack);

}