Subscribe to download
Lua Bots

Lua Bots are programmable robots utilizing the
Lua programming language. All the usual features
of the language (if statements, variables,
for loops) can be used to program your robots.

All programs must contain a function named "main".
This function will serve as the main coroutine for
the program.


After the Lua Bot crafting recipe has been researched,
the robots can be crafted in the manufacturing plant

Look at the robot and press E to open the robot's GUI.

The code editing text area appears on the left.
The robot's inventory, which is text based, appears on the right.

Below the code editing window is a text field for entering file names.
Enter a file name here and click the 'save' button to save the file to disk.
Enter a file name and click the 'load' button to load a program.

All files should use the .lua file extension or the mod will not recognize them.

Some example programs are included with the mod:

help.lua - displays information about the mod.
quarry.lua - the robot digs a 10x10x10 hole in the ground.
tunnel.lua - the robot digs a 50x2x2 tunnel.
wall.lua - the robot builds a 10x1x10 wall.
floor.lua - builds a square platform, default size is 20x20.
room.lua - builds a 16x24 room with a 3x3 entryway for airlocks.

Once a program has been entered in the code editor, click the run button to start the program.

Click the close button to close the GUI.

Lua bots can dig, build, interact with hoppers and harvest plants from hydroponics bays.

All available lua bot commands are listed below.

--------------------------
Robot Commands
--------------------------
Move(x,y,z)
-Moves the robot 1 meter in any direction.
-For example, use Move(0,1,0) to move up.
-X,Y,Z values above 1 will be reduced to 1.

Dig(x,y,z)
-Digs the cube at (x,y,z) relative to the robot.
-For example, use Dig(0,-1,0) to dig down.
-X,Y,Z values above 1 will be reduced to 1.

Mine(x,y,z)
-Mines ore from the cube at (x,y,z) relative to the robot.
-For example, use Mine(0,-1,0) to dig down.
-X,Y,Z values above 1 will be reduced to 1.

Build(x,y,z, name)
-Places a cube at (x,y,z) relative to the robot.
-Cube name parameter is optional.
-X,Y,Z values above 1 will be reduced to 1.

Harvest(x,y,z)
-Harvests plants from a hydroponics bay
at (x,y,z) relative to the robot and adds
them to the robot's inventory.
-X,Y,Z values above 1 will be reduced to 1.

IsPassable(x,y,z)
-Returns true if the cube at (x,y,z) relative
to the robot is considered passable. This
means the robot can pass through the
cube and will not collide with it.
-X,Y,Z values above 1 will be reduced to 1.

IsOre(x,y,z)
-Returns true if the cube at (x,y,z) relative
to the robot is part of an ore vein.
-X,Y,Z values above 1 will be reduced to 1.

TakeFromHopper(x,y,z)
-Removes all items from a hopper
at (x,y,z) relative to the robot and
adds them to the robot's inventory.
-X,Y,Z values above 1 will be reduced to 1.

EmptyToHopper(x,y,z)
-The robot will attempt to place the
items it is carrying into a hopper
at (x,y,z) relative to the robot.
-X,Y,Z values above 1 will be reduced to 1.

GetInventory(name)
-Searches the robot's inventory for items
with the given name and returns the amount
of that item stored in the inventory.

GetPower(x,y,z)
-Returns the power stored in a power
storage cube, laser energy transmitter
or other power interface at (x,y,z) relative
to the robot.
-X,Y,Z values above 1 will be reduced to 1.

GetExtractorState(x,y,z)
-Returns the state of an ore extractor
at (x,y,z) relative to the robot.
-X,Y,Z values above 1 will be reduced to 1.

Transmit(id, string)
-Sends data to another lua bot with the
given ID. The data should always be a string.

Receive()
-Retruns received data if any is available.
The data type is always a string.

GetID()
-Returns the robot's id number.

GetScripts()
-Prints a list of all available scripts.

Print(string)
-Prints the string to the output window.

Chat(string)
-Sends a chat message.
-Only works in multiplayer games.

Delay(seconds)
-Pauses execution.

[Source Code]
https://github.com/Droog71/FCE_Lua_Robots