Robot Planter

The Robot Planter is a Robot added by BuildCraft. It is able to plant seeds on Farmland (see Usage) and can subsequently be used in combination with the Robot Harvester and Robot Farmer for automated farming. The robot can handle any type of seed from vanilla Minecraft and mods. 
== Recipe ==
== Usage ==
The Robot takes seeds out of a chest on and plants them on Farmland.
The procedure below describes how to set up a Robot Planter, using the example farm showin in Fig. 1.
The following items are needed for the setup:
* 4 s, the or a predefined work zone (for example from the Robot Farmer)
* 1 
* 1 
* 1 
* 1 
* 1 (or another type of Emerald Gate if special functions are needed)
* 1 
* Seeds of the desired plant(s)
* 1 
=== Step 1: Demarcating the work zone ===
The player must demarcate the area in which the Robot should plant the seeds. This can be done with either the Zone Planner (Step 1.1) or with Land Marks (Step 1.2). If the player does not demarcate a work zone and configure the Robot's behavior in Step 3, the robot will fly to every active chunk around the player and plant seeds on each vacant Farmland block.
==== Step 1.1: With the Zone Planner ====
The easier method of demarcating a work zone is to use the Zone Planner. It can be used to draw a specific region on the interactive map and have it saved to a Map Location.
If multiple types of seeds are used, the player can use different colors in the Zone Planner for quick marking of their respective zones.
==== Step 1.2: With Land Marks ====
A second way is to use Land Marks to define the work zone. Place three Land Marks in a 90° angle which defines the base of the farm. Right-click on one of the Marks to display red borders (shown in Fig. 2) which shows the ground area of the work zone. As shown in the figure the Land Marks must stand one block deeper to include the surface blocks.
The two marks on the left and top in the figure may not be more than 64 blocks away from the center mark in the right corner. To define height place the fourth Land Mark above the central Land Mark (some Dirt may need to be used to reach the desired height).
Right-click on any Land Mark and red borders will appear framing a 3-dimensional work zone (shown in Fig. 3). If no red border appears, then the Land Marks are not in a 90° angle to each other.
To plant at all height levels in the work zone, the Robot Planter needs a 3-dimensional zone. If the player uses the 2-dimensional zone defined by the three ground Marks, the robot will only plant seeds at the ground level. Farmland blocks outside of the work zone will not be planted on.
=== Step 2: Control station ===
Next, the control station for the Robot should be built. It can be placed anywhere but it is recommended to be near the work zone for easier access.
The following described control station is the simplest and can be extended.
The station includes a Chest with a connected Wooden Transport Pipe, a Docking Station, and an Emerald AND Gate which can be placed anywhere on the Pipe (without disconnecting the chest).
Place the Lever in front of the Gate and all seeds in the Chest. The station should resemble Fig. 4.
=== Step 3: Configuration ===
The Robot's behavior can be controlled by configuring the Emerald Gate. The example given is one of many configurations for the Gate.
Right-click the Emerald Gate to open its GUI which shows two 4x4 slotted fields (one left, one right).
Configure the fields so that they resemble Fig. 5. In the first and third row on the right side are signalling that they are missing items in those slots.
The important configurations to control the robot shown in Fig. 5 are explained here:
 	Left slot	Left slot 	 	Right slot	Right slot	Right slot
Row	Icon 	Explanation 	do following	Icon 	Icon 	Explanation
1 	 	If a redstone signal is provided to the gate 	>>> 	 	 	Work in the work zone => work zone undefined
1 	 	If a redstone signal is provided to the gate 	>>> 	 	 	Work in the work zone => coordinates of the zone
2 	 	If a redstone signal is provided to the gate 	>>> 	 	 	Provide Items => item not defined
2 	 	If a redstone signal is provided to the gate 	>>> 	 	 	Provide Items => Seeds
3 	 	If no redstone signal is provided to the gate	>>> 	 	 	Go to station => station undefined
3 	 	If no redstone signal is provided to the gate	>>> 	 	 	Go to station => coordinates of the station
4 	 	If a redstone signal is provided to the gate 	>>> 	 	 	Wakeup
A full explanation of all possible functions can be found in the Emerald Gate article.
The sequence of rows does not matter.
Slots requiring coordinates can be added by the Map Location.
## With the Zone Planner: Take the Map Location and save the desired zone in the Zone Planner on the map. The Map Location will now have a rectangle on its icon. Place it in the in the first row of the Emerald Gate's GUI ("Working area" option). The coordinates will be stored and the Map Location can be reused for the second coordinates.
## With the Land Marks:Take the Map Location and right-click on one of the Land Marks to receive the coordinates of the work zone (shown in Fig. 6). The Map Location will now have a rectangle on the icon. Place the Map Location in the in the first row in the Emerald Gate's GUI ("Working area" option). The coordinates will be stored and the Map Location can be reused for the second coordinates.
# Take the Map Location and right-click on the Docking Station to receive its coordinates. Note: It is important which side is indicated at the coordinates for the Docking Station. This is displayed in the player inventory if the cursor is hovered over the Map Location. Check that the specified side is the same as the docking station ; for example "UP" if the docking station is on top of the pipe. Place the Map Location in the in the third row of the Emerald Gate's GUI ("Go to station" option).
# Put up to 3 different types of seeds in the empty slots in the second row on the right side.
The configuration should match Fig. 5 and the control station is fully configured. The Land Marks and their respective frame are no longer needed and can be removed. If the player wants to use the frame for other Robots (for example for the Robot Harvester, make sure to have the coordinates stored in a Map Location.
=== Step 4: Starting and stopping ===
Place the Robot Planter on top of the Docking Station (shown in Fig. 7). The robot will initially do nothing because the logic statement in the third row instructs the robot to stay on the station when no redstone signal is provided to the Emerald Gate.
If the Lever in front of the Gate is switched and a redstone signal is provided to the Gate, the first and the second logic statements become true and activate.
After a short time (the update time of the robot), the robot will take a seed out of the chest (second logic statement in the Emerald Gate) and start the working in the work zone (first logic statement in the Emerald Gate) (shown in Fig. 8) until there are no free Farmland blocks available.
Note: The Robot can only carry one seed at a time. If the Robot plants the seed it will return back to the station automatically. Once there, the function on the second logic statement is called upon again after a while (the update time) and the Robot will take a new seed out of the chest (if any are available) and resume work. To shorten update time so that the robot works continuously, the logic statement on the fourth row can be used. This logic statement causes the robot (if a redstone signal is active) to wake up and execute the first and second logic statements. This logic statement will be executed even if no free farmland exists. The Robot will not work but will continue to use up energy. 
Once seeds are planted on each Farmland block in the work zone, the Robot automatically returns to the control station but will remain active. If a Farmland block is freed up it will resume work. The Robot can be stopped anytime by switching the lever (in front of the gate) off. 
BuildCraft_Planter_working.png|Fig. 8: Lever switched on and Robot starts working.
== Recharging ==
If the robot is low on energy, it will seek out a kinesis pipe with a Docking Station to charge itself. If none are available it will continue working until its battery dies. The player can also stop the robot with attacks to prematurely drain its battery, causing the to Robot to drop as an item on the ground. Stronger attacks will drain its battery faster. The player can pick up the Robot and place it in the Charging Table to recharge it. The Robot can then be placed on the Docking Station and ready to resume work.
== Notes ==
* After programming the frame created with the Land Marks isn't needed anymore. The coordinates of the working area are saved in the Emerald Gate.
Category:BuildCraftCategory:MachinesCategory:Farming