474 lines
18 KiB
Plaintext
474 lines
18 KiB
Plaintext
# textdomain: signs_bot
|
|
|
|
|
|
|
|
### basis.lua ###
|
|
|
|
running=
|
|
stopped=
|
|
Off=
|
|
On=
|
|
Signs=
|
|
Other items=
|
|
Config=
|
|
Preassign slots items=
|
|
Back=
|
|
Robot Box=
|
|
Signs Bot Box=
|
|
The Box is the housing of the bot.=
|
|
Place the box and start the bot by means of the 'On' button.=
|
|
If the mod techage is installed, the bot needs electrical power.=
|
|
The bot leaves the box on the right side.=
|
|
It will not start, if this position is blocked.=
|
|
To stop and remove the bot, press the 'Off' button.=
|
|
The box inventory simulates the inventory of the bot.=
|
|
You will not be able to access the inventory, if the bot is running.=
|
|
The bot can carry up to 8 stacks and 6 signs with it.=
|
|
|
|
### bot_flap.lua ###
|
|
|
|
Exit=
|
|
Bot Flap=
|
|
The flap is a simple block used as door for the bot.=
|
|
Place the flap in any wall, and the bot will automatically open=
|
|
and close the flap as it passes through it.=
|
|
|
|
### bot_sensor.lua ###
|
|
|
|
Bot Sensor: Connected with=
|
|
Bot Sensor=
|
|
Bot Sensor: Not connected=
|
|
The Bot Sensor detects any bot and sends a signal, if a bot is nearby.=
|
|
The sensor direction does not care.=
|
|
|
|
### bot_sensor.lua ###
|
|
### cart_sensor.lua ###
|
|
|
|
the sensor range is one node/meter.=
|
|
|
|
### cart_sensor.lua ###
|
|
|
|
Cart Sensor: Connected with=
|
|
Cart Sensor=
|
|
Cart Sensor: Not connected=
|
|
The Cart Sensor detects and sends a signal, if a cart (Minecart) is nearby.=
|
|
The sensor has an active side (red) that must point to the rail/cart.=
|
|
|
|
### changer.lua ###
|
|
|
|
Signs:=
|
|
Bot Control Unit=
|
|
The Bot Control Unit is used to lead the bot by means of signs.=
|
|
The unit can be loaded with up to 4 different signs and can be programmed by means of sensors.=
|
|
To load the unit, place a sign on the red side of the unit and click on the unit.=
|
|
The sign disappears / is moved to the inventory of the unit.=
|
|
This can be repeated 3 times.=
|
|
Use the connection tool to connect up to 4 sensors with the Bot Control Unit.=
|
|
|
|
### chest.lua ###
|
|
|
|
Bot Chest: Sends signal to=
|
|
Signs Bot Chest=
|
|
Bot Chest: Not connected=
|
|
The Signs Bot Chest is a special chest with sensor function.=
|
|
It sends a signal depending on the chest state.=
|
|
Possible states are 'empty', 'not empty', 'almost full'=
|
|
A typical use case is to turn off the bot, when the chest is almost full or empty.=
|
|
|
|
### cmd_farming.lua ###
|
|
|
|
Sow farming seeds@nin front of the robot=
|
|
Harvest farming products@nin front of the robot@non a 3x3 field.=
|
|
Plant a sapling@nin front of the robot=
|
|
Sign "farming"=
|
|
Sign 'farming'=
|
|
Used to harvest and seed a 3x3 field.=
|
|
The seed to be placed has to be in the first inventory slot of the bot.=
|
|
|
|
### cmd_flowers.lua ###
|
|
|
|
Cutting flowers, leaves and tree blocks@nin front of the robot@non a 3x3 field.=
|
|
Sign "flowers"=
|
|
Sign 'flowers'=
|
|
Used to cut flowers on a 3x3 field.=
|
|
|
|
### cmd_flowers.lua ###
|
|
### cmd_farming.lua ###
|
|
|
|
Place the sign in front of the field.=
|
|
When finished, the bot turns.=
|
|
|
|
### cmd_item.lua ###
|
|
|
|
Take <num> items from a chest like node@nand put it into the item inventory.@n<slot> is the inventory slot (1..8) or 0 for any one=
|
|
Add <num> items to a chest like node@ntaken from the item inventory.@n<slot> is the inventory slot (1..8) or 0 for any one=
|
|
Add <num> fuel to a furnace like node@ntaken from the item inventory.@n<slot> is the inventory slot (1..8) or 0 for any one=
|
|
deprecated, use bot inventory configuration instead=
|
|
Pick up all objects@nin a 3x3 field.@n<slot> is the inventory slot (1..8) or 0 for any one=
|
|
Drop items in front of the bot.@n<slot> is the inventory slot (1..8) or 0 for any one=
|
|
Punch a rail cart to start it=
|
|
|
|
### cmd_move.lua ###
|
|
|
|
Move the robot one step back=
|
|
Turn the robot to the left=
|
|
Turn the robot to the right=
|
|
Turn the robot around=
|
|
Move the robot upwards=
|
|
Move the robot down=
|
|
Stop the robot for <sec> seconds@n(1..9999)=
|
|
Stop the robot.=
|
|
Turn the robot off@nand put it back in the box.=
|
|
|
|
### cmd_pattern.lua ###
|
|
|
|
Store pattern to be cloned.=
|
|
Copy the nodes from@nthe stored pattern position@n<size> is: 3x1, 3x2, 3x3,@n5x1, 5x2, 5x3 (wide x deep)@n<lvl> pattern level offset (0..4)=
|
|
Sign "pattern"=
|
|
Sign "copy 3x3x3"=
|
|
Sign 'pattern'=
|
|
Used to make a copy of a 3x3x3 cube.=
|
|
Place the sign in front of the pattern to be copied.=
|
|
Use the copy sign to make the copy of this pattern on a different location.=
|
|
The bot must first reach the pattern sign, then the copy sign.=
|
|
Sign 'copy3x3x3'=
|
|
Place the sign in front of the location, where the copy should be made.=
|
|
Use the pattern sign to mark the pattern.=
|
|
|
|
### cmd_place.lua ###
|
|
|
|
Place a block in front of the robot@n<slot> is the inventory slot (1..8)@n<lvl> is one of: -1 0 +1=
|
|
Place a block on the left side@n<slot> is the inventory slot (1..8)@n<lvl> is one of: -1 0 +1=
|
|
Place a block on the right side@n<slot> is the inventory slot (1..8)@n<lvl> is one of: -1 0 +1=
|
|
Place a block under the robot.@nHint: use 'move_up' first.@n<slot> is the inventory slot (1..8)=
|
|
Place a block above the robot.@n<slot> is the inventory slot (1..8)=
|
|
Error: No free inventory space=
|
|
Dig the block in front of the robot@n<slot> is the inventory slot (1..8)@n<lvl> is one of: -1 0 +1=
|
|
Dig the block on the left side@n<slot> is the inventory slot (1..8)@n<lvl> is one of: -1 0 +1=
|
|
Dig the block on the right side@n<slot> is the inventory slot (1..8)@n<lvl> is one of: -1 0 +1=
|
|
Dig the block under the robot.@n<slot> is the inventory slot (1..8)=
|
|
Dig the block above the robot.@n<slot> is the inventory slot (1..8)=
|
|
Rotate the block in front of the robot@n<lvl> is one of: -1 0 +1@n<steps> is one of: 1 2 3=
|
|
Bot torch=
|
|
|
|
### cmd_sign.lua ###
|
|
|
|
Commands,Help=
|
|
Sign name:=
|
|
Cancel=
|
|
Check=
|
|
Help=
|
|
Copy Cmnd=
|
|
please check the added line(s)=
|
|
Sign "command"=
|
|
-- enter or copy commands from help page=
|
|
Error: Signs inventory empty=
|
|
Error: Position protected or occupied=
|
|
Place a sign in front of the robot@ntaken from the signs inventory@n<slot> is the inventory slot (1..6)=
|
|
Place a sign behind the robot@ntaken from the signs inventory@n<slot> is the inventory slot (1..6)=
|
|
Error: No sign available=
|
|
Error: Signs inventory slot is occupied=
|
|
Error: Position is protected=
|
|
Dig the sign in front of the robot@nand add it to the signs inventory.@n<slot> is the inventory slot (1..6)=
|
|
Dig the sign in front of the robot@nand add the cleared sign to@nthe item iventory.@n<slot> is the inventory slot (1..8)=
|
|
Sign 'command'=
|
|
The 'command' sign can be programmed by the player.=
|
|
Place the sign in front of you and use the node menu to program your sequence of bot commands.=
|
|
The menu has an edit field for your commands and a help page with all available commands.=
|
|
|
|
### cmd_soup.lua ###
|
|
|
|
Take water into empty bucket when standing on a shore@n(use specified slot number or 0 for auto selection)=
|
|
Error: No still water around=
|
|
Error: No empty bucket in inventory=
|
|
Error: No empty bucket in inventory slot =
|
|
Error: No inventory space for full bucket=
|
|
Pour water from bucket to empty cauldron in front of a robot@n(use specified slot number or 0 for auto selection)=
|
|
Error: No empty cauldron in front of a robot=
|
|
Error: No full bucket in inventory=
|
|
Error: No full bucket in inventory slot =
|
|
Error: No inventory space for empty bucket=
|
|
Set fire under cauldron (requires flammable material)@n(command is ignored when fire is already burning)=
|
|
Error: No cauldron in front of a robot=
|
|
Error: No space for fire under cauldron=
|
|
Error: No flammable material under cauldron=
|
|
Put out (extinguish) fire under cauldron@n(command is ignored when there is no fire)=
|
|
Take boiling soup into empty bowl from cauldron@nin front of a robot@n(use specified slot number or 0 for auto selection)=
|
|
Error: No cauldron with a soup in front of a robot=
|
|
Error: No empty bowl in inventory=
|
|
Error: No empty bowl in inventory slot =
|
|
Error: No inventory space for full bowl=
|
|
Sign "take water"=
|
|
Sign "cook soup"=
|
|
Sign 'take water'=
|
|
Used to take water into bucket.=
|
|
Place the sign on a shore, in front of the still water pool.=
|
|
Items in slots:=
|
|
1 - empty bucket=
|
|
The result is one bucket with water in selected inventory slot.=
|
|
When finished, the bot turns around.=
|
|
Sign 'cook soup'=
|
|
Used to cook a vegetable soup in cauldron.=
|
|
Cauldon should be empty and located above flammable material.=
|
|
Place the sign in front of the cauldron with one field space,=
|
|
to prevent wooden sign from catching fire.=
|
|
1 - water bucket=
|
|
2 - vegetable #1 (i.e. tomato)=
|
|
3 - vegetable #2 (i.e. carrot)=
|
|
4 - empty bowl (from farming or xdecor mods)=
|
|
The result is one bowl with vegetable soup in selected inventory slot.=
|
|
|
|
### cmd_soup.lua ###
|
|
### cmd_place.lua ###
|
|
|
|
Error: Position protected=
|
|
|
|
### cmd_trees.lua ###
|
|
|
|
Used to harvest an aspen or pine tree trunk=
|
|
- Place the sign in front of the tree.=
|
|
- Place a chest to the right of the sign.=
|
|
- Put a dirt stack (10 items min.) into the chest.=
|
|
- Preconfigure slot 1 of the bot inventory with dirt=
|
|
- Preconfigure slot 2 of the bot inventory with saplings=
|
|
Sign "aspen"=
|
|
Sign 'aspen'=
|
|
|
|
### commands.lua ###
|
|
|
|
commands:=
|
|
unknown command=
|
|
start of a 'repeat..end' block=
|
|
end command of a 'repeat..end' block=
|
|
call a subroutine (with 'return' statement)=
|
|
return from a subroutine=
|
|
jump to a label=
|
|
Move the robot 1..999 steps forward@nwithout paying attention to any signs.@nUp and down movements also become@ncounted as steps.=
|
|
Walk until a sign or obstacle is@nreached. Then continue with the next command.@nWhen a sign has been reached, @nthe current program is ended@nand the bot executes the@nnew program from the sign=
|
|
Print given text as chat message.@nFor two or more words, use the '*' character @ninstead of spaces, like "Hello*world"=
|
|
|
|
### compost.lua ###
|
|
|
|
Put 2 leaves into the compost barrel@n<slot> is the bot inventory slot (1..8)@nwith the leaves.=
|
|
Take a compost item from the barrel.@n<slot> (1..8 or 0 for the first free slot) is the bot@nslot for the compost item.=
|
|
|
|
### crop_sensor.lua ###
|
|
|
|
Crop Sensor: Connected with=
|
|
Crop Sensor=
|
|
Crop Sensor: Not connected=
|
|
The Crop Sensor sends cyclical signals when, for example, wheat is fully grown.=
|
|
The sensor range is one node/meter.=
|
|
The sensor has an active side (red) that must point to the crop/field.=
|
|
|
|
### delayer.lua ###
|
|
|
|
Signal Delayer: Connected with=
|
|
Delay time [sec]:=
|
|
Signal Delayer=
|
|
Signals are forwarded delayed. Subsequent signals are queued.=
|
|
The delay time can be configured.=
|
|
|
|
### doc.lua ###
|
|
|
|
After you have placed the Signs Bot Box, you can start the bot by means of the 'On' button in the box menu.=
|
|
If the bot returns to its box right away, you will likely need to charge it with electrical energy (techage) first.=
|
|
The bot then runs straight up until it reaches an obstacle (a step with two or more blocks up or down or a sign.)=
|
|
If the bot first reaches a sign it will execute the commands on the sign.=
|
|
If the command(s) on the sign is e.g. 'turn_around', the bot turns and goes back.=
|
|
In this case, the bot reaches his box again and turns off.=
|
|
The Signs Bot Box has an inventory with 6 stacks for signs and 8 stacks for other items (to be placed/dug by the bot).=
|
|
This inventory simulates the bot internal inventory.=
|
|
That means you will only have access to the inventory if the bot is turned off ('sitting' in his box).=
|
|
You simply control the direction of the bot by means of the 'turn left' and 'turn right' signs (signs with the arrow).=
|
|
The bot can run over steps (one block up/down). But there are also commands to move the bot up and down.=
|
|
It is not necessary to mark a way back to the box.=
|
|
With the command 'turn_off' the bot will turn off and be back in his box from every position.=
|
|
The same applies if you turn off the bot by the box menu.=
|
|
If the bot reaches a sign from the wrong direction (from back or sides) the sign will be ignored.=
|
|
The bot will walk over.=
|
|
All predefined signs have a menu with a list of the bot commands.=
|
|
These signs can't be changed, but you can craft and program your own signs.=
|
|
For this you have to use the 'command' sign.=
|
|
This sign has an edit field for your commands and a help page with all available commands.=
|
|
Also for your own signs it is important to know:=
|
|
After the execution of the last command of the sign, the bot falls back into its default behaviour and runs in its taken direction.=
|
|
A standard job for the bot is to move items from one chest to another=
|
|
(chest or node with a chest like inventory).=
|
|
This can be done by means of the two signs 'take item' and 'add item'.=
|
|
These signs have to be placed on top of chest nodes.=
|
|
In addition to the signs the bot can be controlled by means of sensors.=
|
|
Sensors like the Bot Sensor have two states: on and off.=
|
|
If the Bot Sensor detects a bot it will switch to the state 'on' and=
|
|
sends a signal to a connected block, called an actuator.=
|
|
Sensors are:=
|
|
- Bot Sensor: Sends a signal when the robot passes by=
|
|
- Node Sensor: Sends a signal when it detects any node=
|
|
- Crop Sensor: Sends a signal when, for example wheat is fully grown=
|
|
- Bot Chest: Sends a signal depending on the chest state (empty, full)=
|
|
Actuators are:=
|
|
- Signs Bot Box: Can turn the bot off and on=
|
|
- Control Unit: Can be used to exchange the sign to lead the bot=
|
|
Additional sensors and actuator can be added by other mods.=
|
|
To send a signal from a sensor to an actuator, the sensor has to be connected (paired) with actuator.=
|
|
To connect sensor and actuator, the Sensor Connection Tool has to be used.=
|
|
Simply click with the tool on both blocks and the sensor will be connected with the actuator.=
|
|
A successful connection is indicated by a ping/pong noise.=
|
|
Before you connect sensor with actuator, take care that the actuator is in the requested state.=
|
|
For example: If you want to start the Bot with a sensor, connect the sensor with the Bot Box,=
|
|
when the Bot is in the state 'on'. Otherwise the sensor signal will stop the Bot,=
|
|
instead of starting it.=
|
|
The following applies to all commands that are used to place items in the bot inventory, like:=
|
|
- take_item <num> <slot>=
|
|
- pickup_items <slot>=
|
|
- trash_sign <slot>=
|
|
- harvest <slot>=
|
|
- dig_front <slot> <lvl>=
|
|
- dig_left <slot> <lvl>=
|
|
- dig_right <slot> <lvl>=
|
|
- dig_below <slot> <lvl>=
|
|
- dig_above <slot> <lvl>=
|
|
If no slot or slot 0 was specified with the command (case A), all 8 slots of the bot inventory =
|
|
are checked one after the other. If a slot was specified (case B), only this slot is checked.=
|
|
In both cases the following applies: If the slot is preconfigured and fits the item, =
|
|
or if the slot is not configured and empty, or is only partially filled with the item type =
|
|
(which should be added), then the items are added.=
|
|
If not all items can be added, the remaining slots will be tried out in case A.=
|
|
Anything that could not be added to your own inventory goes back.=
|
|
The following applies to all commands that are used to take items from the bot inventory, like:=
|
|
- add_item <num> <slot>=
|
|
It doesn't matter whether a slot is configured or not. The bot takes the first stack that =
|
|
it can find from its own inventory and tries to use it.=
|
|
If a slot is specified, it only takes this, if no slot has been specified, it checks all of =
|
|
them one after the other, starting from slot 1 until it finds something.=
|
|
If the number found is smaller than requested, he tries to take the rest out of any slot.=
|
|
Signs Bot=
|
|
A robot controlled by signs, used for automated work=
|
|
Start the Bot=
|
|
Control the Bot=
|
|
Sensors and Actuators=
|
|
Connecting sensors and actuator=
|
|
Bot inventory behavior=
|
|
|
|
### doc.lua ###
|
|
### cmd_sign.lua ###
|
|
|
|
The help page has a copy button to simplify the programming.=
|
|
|
|
### duplicator.lua ###
|
|
|
|
Template:=
|
|
Input:=
|
|
Output:=
|
|
1. Place one 'cmnd' sign=
|
|
2. Add 'blank signs'=
|
|
3. Take the copies=
|
|
Signs Duplicator=
|
|
Sign "user"=
|
|
Sign "blank"=
|
|
The Duplicator can be used to make copies of signs.=
|
|
1. Put one 'cmnd' sign to be used as template into the 'Template' inventory=
|
|
2. Add one or several 'blank signs' to the 'Input' inventory.=
|
|
3. Take the copies from the 'Output' inventory.=
|
|
Written books [default:book_written] can alternatively be used as template=
|
|
Already written signs can be used as input, too.=
|
|
Needed as input for the Duplicator.=
|
|
|
|
### extender.lua ###
|
|
|
|
Sensor Extender: Connected with=
|
|
Sensor Extender=
|
|
Sensor Extender: Not connected=
|
|
With the Sensor Extender, sensor signals can be sent to more than one actuator.=
|
|
Place one or more extender nearby the sensor and connect each extender=
|
|
with one further actuator by means of the Connection Tool.=
|
|
|
|
### interpreter.lua ###
|
|
|
|
Maximum programm size exceeded=
|
|
Too many parameters=
|
|
Parameter error=
|
|
Command error=
|
|
'repeat' missing=
|
|
'end' missing=
|
|
Checked and approved=
|
|
|
|
### logic_and.lua ###
|
|
|
|
Signal AND with=
|
|
inputs=
|
|
Signal AND=
|
|
Signal is sent, if all input signals are received.=
|
|
|
|
### logic_and.lua ###
|
|
### timer.lua ###
|
|
|
|
Connected with=
|
|
|
|
### node_sensor.lua ###
|
|
|
|
Node Sensor: Connected with =
|
|
added=
|
|
removed=
|
|
added or removed=
|
|
Send signal if nodes have been:=
|
|
accept=
|
|
Node Sensor=
|
|
Node Sensor: Not connected=
|
|
The node sensor sends cyclical signals when it detects that nodes have appeared or disappeared,=
|
|
but has to be configured accordingly.=
|
|
Valid nodes are all kind of blocks and plants.=
|
|
The sensor range is 3 nodes/meters in one direction.=
|
|
The sensor has an active side (red) that must point to the observed area.=
|
|
|
|
### signs.lua ###
|
|
|
|
Instructions:=
|
|
Code=
|
|
Sign "turn right"=
|
|
Sign "turn left"=
|
|
Sign "take item"=
|
|
Sign "add item"=
|
|
Sign "stop"=
|
|
Sign "add to cart"=
|
|
Sign "take from cart"=
|
|
The Bot turns right when it detects this sign in front of it.=
|
|
The Bot turns left when it detects this sign in front of it.=
|
|
The Bot takes items out of a chest in front of it and then turns around.=
|
|
This sign has to be placed on top of the chest.=
|
|
The Bot puts items into a chest in front of it and then turns around.=
|
|
The Bot will stop in front of this sign until the sign is removed or the bot is turned off.=
|
|
The Bot puts items into a minecart in front of it, pushes the cart and then turns around.=
|
|
This sign has to be placed on top of the rail at the cart end position.=
|
|
The Bot takes items out of a minecart in front of it, pushes the cart and then turns around.=
|
|
|
|
### techage.lua ###
|
|
|
|
no power=
|
|
Ignite the techage charcoal lighter=
|
|
Turns the bot off if the@nbattery power is below the@ngiven value in percent (1..99)=
|
|
fully charged=
|
|
Sends a techage command@nto a given node. @nReceiver is addressed by@nthe techage node number.@nFor commands with two or more @nwords, use the '*' character @ninstead of spaces, e.g.: @nsend_cmnd 3465 pull*default:dirt*2=
|
|
|
|
### techage.lua ###
|
|
### basis.lua ###
|
|
|
|
charging=
|
|
|
|
### timer.lua ###
|
|
|
|
Bot Timer=
|
|
Cycle time [min]:=
|
|
Bot Timer: Not connected=
|
|
Special kind of sensor.=
|
|
Can be programmed with a time in seconds, e.g. to start the bot cyclically.=
|
|
|
|
### timer.lua ###
|
|
### delayer.lua ###
|
|
|
|
Start=
|
|
|
|
### tool.lua ###
|
|
|
|
Sensor Connection Tool=
|