ComputerCraft Wiki - User contributions [en]

Turtle.transferTo

2012-11-13T04:32:38Z

Dadmob18: Forgot to login on the last three changes-- they were mine, too

{{lowercase}}
{{Function
|name=turtle.transferTo
|args=slot, quantity
|returns=bool "success"
|api=turtle
|addon=ComputerCraft
|desc=Transfers items from the selected slot to the specified slot in the quantity given. If the [quantity] argument is omitted, tries to transfer all the items from the selected slot. If the destination slot already has items of a different type, returns false (does not try to fill the next slot, like suck() would). If there are fewer than [quantity] items in the selected slot or only room for fewer items in the destination slot, transfers as many as possible and returns true. If none can be transferred, returns false.
|examples=
{{Example
|desc=Transfers 32 items from the selected slot to slot 6.
|code=turtle.transferTo(6, 32)
}}
}}
This function came available in version 1.45

Turtle.placeDown

2012-10-11T13:41:34Z

Dadmob18: returns bool

{{lowercase}}
{{Function
|name=turtle.placeDown
|args=
|api=turtle
|addon=ComputerCraft
|desc=Places a Block of the selected Slot below
|returns=[[boolean]] whether the turtle succeeded in placing the block. False if selected slot is empty, or if there is already a block below.
|examples=
{{Example
|desc=Places a Block of the selected Slot below
|code=turtle.placeDown()
}}
}}

Turtle.placeUp

2012-10-11T13:41:02Z

Dadmob18: returns bool

{{lowercase}}
{{Function
|name=turtle.placeUp
|args=
|api=turtle
|addon=ComputerCraft
|desc=Places a Block of the selected Slot above
|returns=[[boolean]] whether the turtle succeeded in placing the block. False if selected slot is empty, or if there is already a block above.
|examples=
{{Example
|desc=Places a Block of the selected Slot above
|code=turtle.placeUp()
}}
}}

Turtle.place

2012-10-11T13:40:10Z

Dadmob18:

{{lowercase}}
{{Function
|name=turtle.place
|args=
|api=turtle
|addon=ComputerCraft
|returns=[[boolean]] whether the turtle succeeded in placing the block. False if selected slot is empty, or if there is already a block in front.
|desc=Places the selected block in front of the Turtle. Add [signText] to sign if given.
|examples=
{{Example
|desc=Places the selected block in front of the Turtle.
|code=turtle.place()
}}
}}

Turtle.place

2012-10-11T13:39:34Z

Dadmob18: returns bool

{{lowercase}}
{{Function
|name=turtle.place
|args=
|api=turtle
|addon=ComputerCraft
|returns=[[boolean]] whether the turtle succeeded in placing the block. False if empty inventory, or if already a block in front.
|desc=Places the selected block in front of the Turtle. Add [signText] to sign if given.
|examples=
{{Example
|desc=Places the selected block in front of the Turtle.
|code=turtle.place()
}}
}}

Turtle (API)

2012-10-11T13:36:15Z

Dadmob18: Place does return a bool result, not nil

The Turtle API is used to work with your Turtles.

{| border="1" cellpadding="2" cellspacing="0|"
| colspan="2" | <center>KEY</center>
|-
! Color
! Turtles that can perform this
|-
|White
|All
|-{{row-lightgreen}}
|Green
|Crafty
|-{{row-lightyellow}}
|Yellow
|Mining, Felling, Digging, Farming
|-{{row-lightred}}
|Red
|Any tool
|}


{| border="1" cellpadding="2" cellspacing="0|"
!style="background:#EEE" width="100px"|Return
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
!style="background:#EEE" width="*"|Min version
|-{{row-lightgreen}}
|bool "success"
|[[turtle.craft]]()
|Craft items using ingredients anywhere in the Turtle's inventory and place results in the active slot
|
|-
|bool "success"
|[[turtle.forward]]()
|Let the Turtle move forward
|
|-
|bool "success"
|[[turtle.back]]()
|Let the Turtle move back
|
|-
|bool "success"
|[[turtle.up]]()
|Let the Turtle move up
|
|-
|bool "success"
|[[turtle.down]]()
|Let the Turtle move down
|
|-
|bool "true"
|[[turtle.turnLeft]]()
|The Turtle turns left
|
|-
|bool "true"
|[[turtle.turnRight]]()
|The Turtle turns right
|
|-
|bool "slot > 16"
|[[turtle.select]]( slotNum )
|The Turtle selects the given Slot (1 is top left, 16 (9 in 1.33 and earlier) is bottom right)
|
|-
|int "result"
|[[turtle.getItemCount]]( slotNum )
|Counts how many items are in the given Slot
|
|-
|int "result"
|[[turtle.getItemSpace]]( slotNum )
|Counts how many remaining items you need to fill the stack in the given Slot
|
|-{{row-lightred}}
|bool "success"
|[[turtle.attack]]()
|Attacks in front of the turtle.
| 1.4
|-{{row-lightred}}
|bool "success"
|[[turtle.attackUp]]()
|Attacks over the turtle.
| 1.4
|-{{row-lightred}}
|bool "success"
|[[turtle.attackDown]]()
|Attacks under the turtle.
| 1.4
|-{{row-lightyellow}}
|bool "success"
|[[turtle.dig]]()
|Breaks the Block in front. With hoe: tills the dirt in front of it.
|
|-{{row-lightyellow}}
|bool "success"
|[[turtle.digUp]]()
|Breaks the Block above. With hoe: tills the dirt above it.
|
|-{{row-lightyellow}}
|bool "success"
|[[turtle.digDown]]()
|Breaks the Block below. With hoe: tills the dirt below it.
|
|-
|bool "success"
|[[turtle.place]]( [signText] )
|Places a Block of the selected slot in front. Engrave [signText] on signs if provided.
| 1.4
|-
|bool "success"
|[[turtle.placeUp]]()
|Places a Block of the selected slot above
|
|-
|bool "success"
|[[turtle.placeDown]]()
|Places a Block of the selected slot below
|
|-
|bool "result"
|[[turtle.detect]]()
|Detects if there is a Block in front. Does not detect mobs.
|
|-
|bool "result"
|[[turtle.detectUp]]()
|Detects if there is a Block above
|
|-
|bool "result"
|[[turtle.detectDown]]()
|Detects if there is a Block below
|
|-
|bool "result"
|[[turtle.compare]]()
|Detects if the block in front is the same as the one in the currently selected slot
|
|-
|bool "result"
|[[turtle.compareUp]]()
|Detects if the block above is the same as the one in the currently selected slot
|
|-
|bool "result"
|[[turtle.compareDown]]()
|Detects if the block below is the same as the one in the currently selected slot
|
|-
|bool "result"
|[[turtle.compareTo]]( [slot] )
|Compare the current selected slot and the given slot to see if the items are the same, yields true if they are the same, and false if not.
| 1.4
|-
|bool "success"
|[[turtle.drop]]( [count] )
|Drops all items in the selected slot, or if [count] is specified, drops that many items. [>= 1.4 only:] If there is a inventory on the side (i.e in front of the turtle) it will try to place into the inventory, returning false if the inventory is full.
|
|-
|bool "success"
|[[turtle.drop|turtle.dropUp]]( [count] )
|Drops all items in the selected slot, or if [count] is specified, drops that many items. [>= 1.4 only:] If there is a inventory on the side (i.e above the turtle) it will try to place into the inventory, returning false if the inventory is full. If below a furnace, will place item in the bottom slot.
|
|-
|bool "success"
|[[turtle.drop|turtle.dropDown]]( [count] )
|Drops all items in the selected slot, or if [count] is specified, drops that many items. [>= 1.4 only:] If there is a inventory on the side (i.e below the turtle) it will try to place into the inventory, returning false if the inventory is full. If above a furnace, will place item in the top slot.
|
|-
|bool "success"
|[[turtle.suck]]()
|Picks up an item stack of any number, from the ground or an inventory in front of the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|bool "success"
|[[turtle.suckUp]]()
|Picks up an item stack of any number, from the ground or an inventory above the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|bool "success"
|[[turtle.suckDown]]()
|Picks up an item stack of any number, from the ground or an inventory below the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|bool "success"
|[[turtle.refuel]]([quantity])
|If the current selected slot contains a fuel item, it will consume it to give the turtle the ability to move. Added in 1.4 and is only needed in needfuel mode. If the current slot doesn't contain a fuel item, it yields false. Fuel values for different items can be found at [[Turtle.refuel#Fuel_Values]]. If a quantity is specified, it will refuel only up to that many items, otherwise, it will consume all the items in the slot.
| 1.4
|-
|int "fuel"
|[[turtle.getFuelLevel]]()
|Returns the current fuel level of the turtle, this is the number of blocks the turtle can move. If turtleNeedFuel = 0 then it yields "unlimited".
| 1.4
|}

Trivia:
During the 1.4 beta, turtle.getFuelLevel() in softcore(that is now turtleneedsfuel = 0) returned 9000.
[[Category:APIs]]

Rednet.send

2012-10-08T20:43:36Z

Dadmob18:

{{lowercase}}
{{Function
|name=rednet.send
|args=[[int]] receiverID, [[string]] message, [[boolean]] WaitUntilPortOpen
|returns=[[boolean]] success code. True if a message has been sent, false if not. "true" does not guarantee, that the destination was reachable!
|api=rednet
|addon=ComputerCraft
|desc=Sends a message to a specific Computer or Turtle. (see [[rednet.broadcast( message )]] and [[rednet.receive( timeout )]]. To get the id from a computer see [[os.computerID()]]. Setting WaitUntilPortOpen to True can help when the server is not receiving a response from the responding client.
|examples=
{{Example
|desc=Sends a Message to the Computer with the ID 22 (assuming a modem is attached and open), and will wait until the port is available to use.
|code=rednet.send(22,"ComputerCraft", true)
}}
}}

Turtle.dig

2012-10-07T20:46:17Z

Dadmob18:

{{lowercase}}
{{Function
|name=turtle.dig
|args=
|api=turtle
|returns=[[boolean]] whether the turtle succeeded in digging.
|addon=ComputerCraft
|desc=Attempts to dig the block in front of the turtle. If successful, [[Turtle.suck|suck()]] is automatically called, placing the item in turtle inventory in the selected slot if possible (block type matches and the slot is not a full stack yet), or in the next available slot.
|examples=
{{Example
|desc=Digs the block in front of the turtle.
|code=[[print]](turtle.dig())
|output=true if the turtle could dig the block, false if it could not or no block present.
}}
{{Example
|desc=Digs the block in front of the turtle, but only if there is a block to dig (saves time).
|code=if [[turtle.detect]]() then
turtle.dig()
end
|output=the turtle digs if there is a block in front.
}}
}}

Turtle.dig

2012-10-07T20:44:39Z

Dadmob18:

{{lowercase}}
{{Function
|name=turtle.dig
|args=
|api=turtle
|returns=[[boolean]] whether the turtle succeeded in digging.
|addon=ComputerCraft
|desc=Attempts to dig the block in front of the turtle. If successful, [[Turtle.suck|suck()]] is automatically called, placing the item in turtle inventory in the selected slot if possible, or in the next available slot.
|examples=
{{Example
|desc=Digs the block in front of the turtle.
|code=[[print]](turtle.dig())
|output=true if the turtle could dig the block, false if it could not or no block present.
}}
{{Example
|desc=Digs the block in front of the turtle, but only if there is a block to dig (saves time).
|code=if [[turtle.detect]]() then
turtle.dig()
end
|output=the turtle digs if there is a block in front.
}}
}}

Turtle.detect

2012-10-06T16:57:51Z

Dadmob18:

{{lowercase}}
{{Function
|name=turtle.detect
|args=
|api=turtle
|returns=[[boolean]] If turtle has Detected a Block in front.
|addon=ComputerCraft
|desc=Detects if there is a Block in front. Does not detect mobs or liquids or floating items.
|examples=
{{Example
|desc=Detects if there is a Block in front and digs it out.
|code= if turtle.detect() then turtle.dig() end
}}
}}

Turtle.detect

2012-10-06T16:57:22Z

Dadmob18:

{{lowercase}}
{{Function
|name=turtle.detect
|args=
|api=turtle
|returns=[[boolean]] If turtle has Detected a Block in front.
|addon=ComputerCraft
|desc=Detects if there is a Block in front. Does not detect mobs or liquids.
|examples=
{{Example
|desc=Detects if there is a Block in front and digs it out.
|code= if turtle.detect() then turtle.dig() end
}}
}}

Turtle (API)

2012-10-06T16:55:55Z

Dadmob18:

The Turtle API is used to work with your Turtles.

{| border="1" cellpadding="2" cellspacing="0|"
| colspan="2" | <center>KEY</center>
|-
! Color
! Turtles that can perform this
|-
|White
|All
|-{{row-lightgreen}}
|Green
|Crafty
|-{{row-lightyellow}}
|Yellow
|Mining, Felling, Digging, Farming
|-{{row-lightred}}
|Red
|Any tool
|}


{| border="1" cellpadding="2" cellspacing="0|"
!style="background:#EEE" width="100px"|Return
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
!style="background:#EEE" width="*"|Min version
|-{{row-lightgreen}}
|bool "success"
|[[turtle.craft]]()
|Craft items using ingredients in the nine upper left slots
|
|-
|bool "success"
|[[turtle.forward]]()
|Let the Turtle move forward
|
|-
|bool "success"
|[[turtle.back]]()
|Let the Turtle move back
|
|-
|bool "success"
|[[turtle.up]]()
|Let the Turtle move up
|
|-
|bool "success"
|[[turtle.down]]()
|Let the Turtle move down
|
|-
|bool "true"
|[[turtle.turnLeft]]()
|The Turtle turns left
|
|-
|bool "true"
|[[turtle.turnRight]]()
|The Turtle turns right
|
|-
|bool "slot > 16"
|[[turtle.select]]( slotNum )
|The Turtle selects the given Slot (1 is top left, 16 (9 in 1.33 and earlier) is bottom right)
|
|-
|int "result"
|[[turtle.getItemCount]]( slotNum )
|Counts how many items are in the given Slot
|
|-
|int "result"
|[[turtle.getItemSpace]]( slotNum )
|Counts how many remaining items you need to fill the stack in the given Slot
|
|-{{row-lightred}}
|bool "success"
|[[turtle.attack]]()
|Attacks in front of the turtle.
| 1.4
|-{{row-lightred}}
|bool "success"
|[[turtle.attackUp]]()
|Attacks over the turtle.
| 1.4
|-{{row-lightred}}
|bool "success"
|[[turtle.attackDown]]()
|Attacks under the turtle.
| 1.4
|-{{row-lightyellow}}
|bool "success"
|[[turtle.dig]]()
|Breaks the Block in front. With hoe: tills the dirt in front of it.
|
|-{{row-lightyellow}}
|bool "success"
|[[turtle.digUp]]()
|Breaks the Block above. With hoe: tills the dirt above it.
|
|-{{row-lightyellow}}
|bool "success"
|[[turtle.digDown]]()
|Breaks the Block below. With hoe: tills the dirt below it.
|
|-
|nil
|[[turtle.place]]( [signText] )
|Places a Block of the selected slot in front. Engrave [signText] on signs if provided.
| 1.4
|-
|nil
|[[turtle.placeUp]]()
|Places a Block of the selected slot above
|
|-
|nil
|[[turtle.placeDown]]()
|Places a Block of the selected slot below
|
|-
|bool "result"
|[[turtle.detect]]()
|Detects if there is a Block in front. Does not detect mobs.
|
|-
|bool "result"
|[[turtle.detectUp]]()
|Detects if there is a Block above
|
|-
|bool "result"
|[[turtle.detectDown]]()
|Detects if there is a Block below
|
|-
|bool "result"
|[[turtle.compare]]()
|Detects if the block in front is the same as the one in the currently selected slot
|
|-
|bool "result"
|[[turtle.compareUp]]()
|Detects if the block above is the same as the one in the currently selected slot
|
|-
|bool "result"
|[[turtle.compareDown]]()
|Detects if the block below is the same as the one in the currently selected slot
|
|-
|bool "result"
|[[turtle.compareTo]]( [slot] )
|Compare the current selected slot and the given slot to see if the items are the same, yields true if they are the same, and false if not.
| 1.4
|-
|bool "success"
|[[turtle.drop]]( [count] )
|Drops all items in the selected slot, or if [count] is specified, drops that many items. [>= 1.4 only:] If there is a inventory on the side (i.e in front of the turtle) it will try to place into the inventory, returning false if the inventory is full.
|
|-
|bool "success"
|[[turtle.drop|turtle.dropUp]]( [count] )
|Drops all items in the selected slot, or if [count] is specified, drops that many items. [>= 1.4 only:] If there is a inventory on the side (i.e above the turtle) it will try to place into the inventory, returning false if the inventory is full. If below a furnace, will place item in the bottom slot.
|
|-
|bool "success"
|[[turtle.drop|turtle.dropDown]]( [count] )
|Drops all items in the selected slot, or if [count] is specified, drops that many items. [>= 1.4 only:] If there is a inventory on the side (i.e below the turtle) it will try to place into the inventory, returning false if the inventory is full. If above a furnace, will place item in the top slot.
|
|-
|bool "success"
|[[turtle.suck]]()
|Picks up an item stack of any number, from the ground or an inventory in front of the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|bool "success"
|[[turtle.suckUp]]()
|Picks up an item stack of any number, from the ground or an inventory above the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|bool "success"
|[[turtle.suckDown]]()
|Picks up an item stack of any number, from the ground or an inventory below the turtle. If the turtle can't pick up the item, the function yields false.
| 1.4
|-
|bool "success"
|[[turtle.refuel]]([quantity])
|If the current selected slot contains a fuel item, it will consume it to give the turtle the ability to move. Added in 1.4 and is only needed in needfuel mode. If the current slot doesn't contain a fuel item, it yields false. Fuel values for different items can be found at [[Turtle.refuel#Fuel_Values]]. If a quantity is specified, it will refuel only up to that many items, otherwise, it will consume all the items in the slot.
| 1.4
|-
|int "fuel"
|[[turtle.getFuelLevel]]()
|Returns the current fuel level of the turtle, this is the number of blocks the turtle can move. If turtleNeedFuel = 0 then it yields "unlimited".
| 1.4
|}

Trivia:
During the 1.4 beta, turtle.getFuelLevel() in softcore(that is now turtleneedsfuel = 0) returned 9000.
[[Category:APIs]]

Textutils.serialize

2012-10-04T16:19:06Z

Dadmob18:

{{lowercase}}
{{Function
|name=textutils.serialize
|args= [[Table (type)|anything]]
|returns=a string representing the object
|api=textutils
|addon=ComputerCraft
|desc=Converts the object to a string that can be saved in a file or sent over rednet and then converted back into a copy of the object later, using [[textutils.unserialize|unserialize]]. Nested structures are supported, but tables with circular graphs will be detected and raise an error.
|examples=
{{Example
|desc=Sends a table over rednet, demonstrates object recovery
|code=myThing={name="Test", n=2}
sThing=textutils.serialize(myThing)
[[rednet.send]](receiverID, sThing) -- assuming you have rednet open and receiverID has a useful value
myCopy=[[textutils.unserialize]](sThing)
print(myCopy.name)
|output=Test
}}
}}

Textutils.unserialize

2012-10-04T16:17:33Z

Dadmob18: Created page with "{{lowercase}} {{Function |name=textutils.unserialize |args= serialized |returns=a copy of the original object that was serialized |api=textutils |addon=Compu..."

{{lowercase}}
{{Function
|name=textutils.unserialize
|args= [[string (type)|serialized]]
|returns=a copy of the original object that was serialized
|api=textutils
|addon=ComputerCraft
|desc=Converts the serialized string back into an object. The string shoudl have been created using [[textutils.serialize()|serialize]]. Note, the representation used by textutils actually creates Lua syntax, so that [loadstring] will also work to deserialize.
}}

Textutils.serialize

2012-10-04T16:14:19Z

Dadmob18:

{{lowercase}}
{{Function
|name=textutils.serialize
|args= [[Table (type)|anything]]
|returns=a string representing the object
|api=textutils
|addon=ComputerCraft
|desc=Converts the object to a string that can be saved in a file or sent over rednet and then converted back into a copy of the object later, using [[textutils.unserialize()|unserialize]]. Nested structures are supported, but tables with circular graphs will be detected and raise an error.
|examples=
{{Example
|desc=Sends a table over rednet, demonstrates object recovery
|code=myThing={name="Test", n=2}
sThing=textutils.serialize(myThing)
[[rednet.send]](receiverID, sThing) -- assuming you have rednet open and receiverID has a useful value
myCopy=[[textutils.unserialize]](sThing)
print(myCopy.name)
|output=Test
}}
}}

Textutils.serialize

2012-10-04T16:11:49Z

Dadmob18:

{{lowercase}}
{{Function
|name=textutils.serialize
|args= [[Table (type)|anything]]
|returns=a string representing the object
|api=textutils
|addon=ComputerCraft
|desc=Converts the object to a string that can be saved in a file or sent over rednet and then converted back into a copy of the object later, using [[textutils.unserialize()|unserialize]]. Nested structures are supported, but tables with circular graphs will be detected and raise an error.
|examples=
{{Example
|desc=Sends a table over rednet, demonstrates object recovery
|code=myThing={name="Test", n=2}
sThing=textutils.serialize(myThing)
[[rednet.send]](receiverID, sThing)
myCopy=[[textutils.unserialize]](sThing)
print(myCopy.name)
|output=Test
}}
}}

Table (type)

2012-10-04T16:09:31Z

Dadmob18: Created page with "A table is a basic Lua type that is an associative array, or map, that associates keys with values. It can be indexed either with numbers, like a plain array, or with any kin..."

A table is a basic Lua type that is an associative array, or map, that associates keys with values. It can be indexed either with numbers, like a plain array, or with any kind of value (except nil), such as a string.

See [[Tables]]

Textutils.serialize

2012-10-04T16:05:50Z

Dadmob18:

{{lowercase}}
{{Function
|name=textutils.serialize
|args= [[Table (type)|anything]]
|returns=a string representing the object
|api=textutils
|addon=ComputerCraft
|desc=Converts the object to a string that can be saved or sent and then converted back into a copy of the object later, using [[textutils.unserialize()|unserialize]]. Nested structures are supported, but tables with circular graphs will be detected and raise an error.
|examples=
{{Example
|desc=Sends a table over rednet, demonstrates object recovery
|code=myThing={name="Test", n=2}
sThing=textutils.serialize(myThing)
[[rednet.send]](receiverID, sThing)
myCopy=[[textutils.unserialize]](sThing)
print(myCopy.name)
|output=Test
}}
}}

Textutils.serialize

2012-10-04T16:02:15Z

Dadmob18:

{{lowercase}}
{{Function
|name=textutils.serialize
|args= [[Table|anything]]
|returns=a string representing the object
|api=textutils
|addon=ComputerCraft
|desc=Converts the object to a string that can be saved or sent and then converted back into a copy of the object later, using [[textutils.unserialize()|unserialize]]. Nested structures are supported, but tables with circular graphs will be detected and raise an error.
|examples=
{{Example
|desc=Sends a table over rednet, demonstrates object recovery
|code=myThing={name="Test", n=2}
sThing=textutils.serialize(myThing)
[[rednet.send]](receiverID, sThing)
myCopy=[[textutils.unserialize]](sThing)
print(myCopy.name)
|output=Test
}}
}}

Textutils.serialize

2012-10-04T15:59:35Z

Dadmob18:

{{lowercase}}
{{Function
|name=textutils.serialize
|args= [[table (type)|anything]]
|returns=a string representing the object
|api=textutils
|addon=ComputerCraft
|desc=Converts the object to a string that can be saved or sent and then converted back into a copy of the object later, using [[textutils.unserialize()|unserialize]]. Nested structures are supported, but tables with circular graphs will be detected and raise an error.
|examples=
{{Example
|desc=Sends a table over rednet, demonstrates object recovery
|code=myThing={name="Test", n=2}
sThing=textutils.serialize(myThing)
[[rednet.send]](receiverID, sThing)
myCopy=[[textutils.unserialize]](sThing)
print(myCopy.name)
|output=Test
}}
}}

Textutils.serialize

2012-10-04T15:55:18Z

Dadmob18:

{{lowercase}}
{{Function
|name=textutils.serialize
|args= [[table (type)|anything]]
|returns=a string representing the object
|api=textutils
|addon=ComputerCraft
|desc=Converts the object to a string that can be saved or sent and then converted back into a copy of the object later, using [[textutils.unserialize()|unserialize]]. Nested structures are supported, but tables with circular graphs will be detected and raise an error.
|examples=
{{Example
|desc=Sends a table over rednet
|code=myThing={name="Test", n=2} sThing=textutils.serialize(myThing) rednet.send(receiverID, sThing) myCopy=textutils.unserialize(sThing) print(myCopy.name)
|output=Test
}}
}}

Textutils.serialize

2012-10-04T15:54:06Z

Dadmob18: Created page with "{{lowercase}} {{Function |name=textutils.serialize |args= anything |returns=a string representing the object |api=textutils |addon=ComputerCraft |desc=Convert..."

{{lowercase}}
{{Function
|name=textutils.serialize
|args= [[table (type)|anything]]
|returns=a string representing the object
|api=textutils
|addon=ComputerCraft
|desc=Converts the object to a string that can be saved or sent and then converted back into a copy of the object later, using [[textutils.unserialize()|unserialize]]. Nested structures are supported, but tables with circular graphs will be detected an raise an error.
|examples=
{{Example
|desc=Sends a table over rednet
|code=myThing={name="Test", n=2} sThing=textutils.serialize(myThing) rednet.send(receiverID, sThing) myCopy=textutils.unserialize(sThing) print(myCopy.name)
|output=Test
}}
}}

Recipes

2012-10-04T00:05:23Z

Dadmob18:

{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Item
!style="background:#EEE" width="*"|Crafting ingredients
|-
|[[Computer]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_dust |C2=stone
|A3=stone |B3=glass_pane |C3=stone
|Output=console
}}
|-
|[[Modem]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_torch |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=modem
}}
|-
|[[Disk Drive]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_dust |C2=stone
|A3=stone |B3=redstone_dust |C3=stone
|Output=disk_drive
}}
|-
|[[Floppy Disk]]
|{{Crafting grid
|B1=redstone_dust
|B2=paper
|Output=disk
}}
|-
|[[Turtle]] (and see [[Turtle#Recipes|Turtle recipes]])
|{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=console |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle
}}
|-
|Mining [[Turtle]]
|{{Crafting grid
|A2=turtle |B2=diamond_pickaxe
|Output=mining_turtle
}}
|-
|Wireless [[Turtle]]
|{{Crafting grid
|A2=turtle |B2=modem
|Output=wireless_turtle
}}
|-
|Wireless Mining [[Turtle]]
|{{Crafting grid
|A2=diamond_pickaxe |B2=turtle |C2=modem
|Output=wireless_mining_turtle
}}
|-
|[[Monitor]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=glass_pane |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=screen
}}
|-
|[[Printer]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_dust |C2=stone
|A3=stone |B3=Ink_Sac |C3=stone
|Output=printer
}}
|}

Recipes

2012-10-04T00:04:52Z

Dadmob18:

{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Item
!style="background:#EEE" width="*"|Crafting ingredients
|-
|[[Computer]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_dust |C2=stone
|A3=stone |B3=glass_pane |C3=stone
|Output=console
}}
|-
|[[Modem]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_torch |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=modem
}}
|-
|[[Disk Drive]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_dust |C2=stone
|A3=stone |B3=redstone_dust |C3=stone
|Output=disk_drive
}}
|-
|[[Floppy Disk]]
|{{Crafting grid
|B1=redstone_dust
|B2=paper
|Output=disk
}}
|-
|[[Turtle]] (and see [[Turtle#recipes|Turtle recipes]])
|{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=console |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle
}}
|-
|Mining [[Turtle]]
|{{Crafting grid
|A2=turtle |B2=diamond_pickaxe
|Output=mining_turtle
}}
|-
|Wireless [[Turtle]]
|{{Crafting grid
|A2=turtle |B2=modem
|Output=wireless_turtle
}}
|-
|Wireless Mining [[Turtle]]
|{{Crafting grid
|A2=diamond_pickaxe |B2=turtle |C2=modem
|Output=wireless_mining_turtle
}}
|-
|[[Monitor]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=glass_pane |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=screen
}}
|-
|[[Printer]]
|{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_dust |C2=stone
|A3=stone |B3=Ink_Sac |C3=stone
|Output=printer
}}
|}

Rednet.receive

2012-10-03T01:48:37Z

Dadmob18:

{{lowercase}}
{{Function
|name=rednet.receive
|args=[[float (type)|float]] timeoutSeconds
|returns=senderId, message, distance-to-sender (or <code>nil</code> if using redpower bundled cable instead of a modem)
|api=rednet
|addon=ComputerCraft
|desc=Waits for <var>timeoutSeconds</var> or until another computer sends a message to this computer. (see [[rednet.broadcast( message )]] and [[rednet.send( receiverID, message )]]. If a Timeout occurs the return id and message are set to nil. If timeout is nil, waits forever. To get the id from a computer see [[os.computerID()]], or the [[id]] command. You must be calling this function at the moment a message is sent, or you will miss it. If you need to watch for messages while doing something else at the same time, see [[Parallel.waitForAny]]
|examples=
{{Example
|desc=Waits forever until someone sends a message to this computer and displays it.
|code=senderId, message, distance = rednet.receive() term.write(message)
|output=The received message.
}}
}}

Category:APIs

2012-10-02T02:01:05Z

Dadmob18:

[[File:Apis.png|thumb|350px|API's being listed with the "apis" command run in a computer.]]An API (Application Programming Interface) is a collection of code that, rather than being run directly by the user as a program, is meant to be used by other programs. This is different from a function in that an API may contain many functions that perform related tasks; the API groups them together. It is a library of functions.
There are two reasons why one might want to use an API:
* The API may provide a function that you could write yourself if you had to, but using the one from the API means you don't have to do that work.

* The API may provide something it's impossible to do yourself because it has to be done in Java rather than Lua.

ComputerCraft itself ships with a collection of APIs of both types. For example:

* The [[color (API)|color API]] provides names for the various numbers used in RedPower bundled cable, and functions that manipulate those numbers. The names for the numbers are just variables, and the functions are written in Lua (you can find this in "rom/apis/colors"). You could write the same variables and functions in your own code if you wanted, but using the API saves you from doing that.

* The [[fs (API)|fs API]] provides functions to work with files. You couldn't write the functions from this API in Lua because they have to access the corresponding files in your real computer (the one running Minecraft), and the only way to do that from Lua is… through the fs API (or the [[IO (API)|io API]], but that's just a wrapper around fs).

All the stock APIs of the first kind, those that are implemented in Lua, can be found in your "mods/ComputerCraft/lua/rom/apis" directory. Inside Minecraft, on a ComputerCraft computer, these appear in the directory "rom/apis". All the built-in APIs of both kinds (Lua and Java) are automatically loaded, so you don't have to use "[[OS (API)|os]].loadAPI" on them.

ComputerCraft mods, for example mods that add custom peripherals, might also add APIs that help you work with those peripherals.

Finally, you might find APIs written by other people that you can download, or you might write APIs yourself if you'll be using a function in many different programs and don't want to keep rewriting it. If you're playing single-player or you're running the multiplayer server, you can add those APIs to "rom/apis" and they will automatically be loaded on every computer in the world. Normally, though, you would leave the APIs somewhere else and use "os.loadAPI" to make them available to your program.

You can see a list of APIs built-in to ComputerCraft by typing "apis" in the terminal.

[[Category:Lists]]

Rednet.receive

2012-10-02T01:52:04Z

Dadmob18:

{{lowercase}}
{{Function
|name=rednet.receive
|args=[[float (type)|float]] timeoutSeconds
|returns=senderId, message, distance-to-sender (or <code>nil</code> if using redpower bundled cable instead of a modem)
|api=rednet
|addon=ComputerCraft
|desc=Waits for <var>timeoutSeconds</var> or until another computer sends a message to this computer. (see [[rednet.broadcast( message )]] and [[rednet.send( receiverID, message )]]. If a Timeout occurs the return id and message are set to nil. To get the id from a computer see [[os.computerID()]], or the [[id]] command. You must be calling this function at the moment a message is sent, or you will miss it. If you need to watch for messages while doing something else at the same time, see [[Parallel.waitForAny]]
|examples=
{{Example
|desc=Waits forever until someone sends a message to this computer and displays it.
|code=senderId, message, distance = rednet.receive() term.write(message)
|output=The received message.
}}
}}

Rednet.receive

2012-10-02T01:50:31Z

Dadmob18:

{{lowercase}}
{{Function
|name=rednet.receive
|args=[[float (type)|float]] timeoutSeconds
|returns=senderId, message, distance-to-sender (or <code>nil</code> if using redpower bundled cable instead of a modem)
|api=rednet
|addon=ComputerCraft
|desc=Waits for <var>timeoutSeconds</var> or until another computer sends a message to this computer. (see [[rednet.broadcast( message )]] and [[rednet.send( receiverID, message )]]. To get the id from a computer see [[os.computerID()]], or the [[id]] command. If a Timeout occurs the return id and message are set to nil. You must be calling this function at the moment a message is sent, or you will miss it. If you need to watch for messages while doing something else at the same time, see [[Parallel.waitForAny]]
|examples=
{{Example
|desc=Waits forever until someone sends a message to this computer and displays it.
|code=senderId, message, distance = rednet.receive() term.write(message)
|output=The received message.
}}
}}

Rednet.receive

2012-10-02T01:49:21Z

Dadmob18:

{{lowercase}}
{{Function
|name=rednet.receive
|args=[[float (type)|float]] timeoutSeconds
|returns=senderId, message, distance-to-sender (or <code>nil</code> if using redpower bundled cable instead of a modem)
|api=rednet
|addon=ComputerCraft
|desc=Waits for <var>timeoutSeconds</var> or until another computer sends a message to this computer. (see [[rednet.broadcast( message )]] and [[rednet.send( receiverID, message )]]. To get the id from a computer see [[os.computerID()]], or the [[id]] command. If a Timeout occurs the return id and message are set to nil. You must be calling this function at the moment a message is sent, or you will miss it. If you need to watch for messages while doing something else at the same time, use [[Parallel.waitForAny]]
|examples=
{{Example
|desc=Waits forever until someone sends a message to this computer and displays it.
|code=senderId, message, distance = rednet.receive() term.write(message)
|output=The received message.
}}
}}

Talk:APIs

2012-10-02T01:39:16Z

Dadmob18: Created page with "So sorry-- this page is the result of trying to fix a link elsewhere back to Category:APIs, and now I can't delete it."

So sorry-- this page is the result of trying to fix a link elsewhere back to Category:APIs, and now I can't delete it.

OS (API)

2012-10-02T01:35:41Z

Dadmob18: /* API */

''You may be looking for alternative OS's for ComputerCraft. If so, go to the [[list of oses|list of OSes]].''

The Operating System API allows for interfacing with the Lua based Operating System itself.
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[os.version]]()
|Returns the version of the OS the computer is running.
|-
|[[os.computerID]]()
|Returns the unique ID of this computer.
|-
|[[os.getComputerLabel]]()
|Returns the label of this computer.
|-
|[[os.setComputerLabel]]( label )
|Set the label of this computer.
|-
|[[os.run]]( environment, programpath, arguments )
|An advanced way of starting programs. A started program will have a given
Environment table which determines what functions it has available, as well as
any variables it will be able to access by default. You may prefer to use the
[[Shell (API)]] unless you need to do something special.
|-
|[[#api|os.loadAPI]]( name )
|Loads a lua script as an API in it's own namespace (see example). It will be available to *all* programs.
-- "apiTest" file
function foo(bar)
print(bar)
end

-- "program" file
apiTest.foo("this is a test")
|-
|[[#api|os.unloadAPI]]( name )
|Unloads a previously loaded API.
|-
|[[Os.pullEvent|os.pullEvent]]( only-event-to-accept )
|Blocks until the computer has detected an event, then returns the event.
|-
|[[#pullEvent|os.pullEventRaw]]()
|Advanced version of pullEvent().
|-
|[[os.queueEvent]]( event, param1, param2, ... )
|Adds an event to the event queue with the name <var>event</var> and the given parameters
|-
|[[os.clock]]()
|Returns CPU time.
|-
|[[os.startTimer]]( timeout )
|Queues an event to be triggered after a number of seconds.
The ID of the timer is returned from this function to differentiate multiple
timers. Timers are one-shot, once they have fired an event you will need to
start another one if you need a recurring timer.
|-
|[[os.sleep]]( timeout )
|Makes the system wait a number of seconds before continuing in the program.
May also be used as simply "sleep( timeout )".
|-
|[[os.time]]()
|Returns the current Minecraft world time.
|-
|[[os.setAlarm]]( time )
|Queues an event to be triggered at the specific Minecraft world time.
|-
|[[os.shutdown]]()
|Turns off the computer.
|-
|[[os.reboot]]()
|Reboots the computer.
|}

== <div id="api">API</div> ==

API are programs which are loaded in to the OS itself, and expose functions
which other programs may use. The stock [[APIs]] that ship with
ComputerCraft are loaded in this way, and may be replaced by a computer's
user or programs.

== <div id="pullEvent">os.pullEvent()</div> ==

os.pullEvent() causes the current program to pause, retrieving the next event
from the computer's queue of events. If there is no event to read, then the
program will stall until such an event becomes available. Note that if a
program has not attempted to pull an event in the past ten seconds, it will
be forcefully terminated to prevent CPU waste in SMP environments.

pullEvent returns the name of the event that was read, as well as up to
five parameters:

<code>
local event, p1, p2, p3, p4, p5 = os.pullEvent()
</code>

os.pullEvent() is usually run inside a 'while true do' loop.

An advanced version of this method <code>os.pullEventRaw</code> bypasses the
normal handling of events from the OS. You may use this to act on the
"Terminate" event (triggered when holding Ctrl-T) for custom termination logic.


[[Category:APIs]]

OS (API)

2012-10-02T01:32:49Z

Dadmob18: /* API */

''You may be looking for alternative OS's for ComputerCraft. If so, go to the [[list of oses|list of OSes]].''

The Operating System API allows for interfacing with the Lua based Operating System itself.
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[os.version]]()
|Returns the version of the OS the computer is running.
|-
|[[os.computerID]]()
|Returns the unique ID of this computer.
|-
|[[os.getComputerLabel]]()
|Returns the label of this computer.
|-
|[[os.setComputerLabel]]( label )
|Set the label of this computer.
|-
|[[os.run]]( environment, programpath, arguments )
|An advanced way of starting programs. A started program will have a given
Environment table which determines what functions it has available, as well as
any variables it will be able to access by default. You may prefer to use the
[[Shell (API)]] unless you need to do something special.
|-
|[[#api|os.loadAPI]]( name )
|Loads a lua script as an API in it's own namespace (see example). It will be available to *all* programs.
-- "apiTest" file
function foo(bar)
print(bar)
end

-- "program" file
apiTest.foo("this is a test")
|-
|[[#api|os.unloadAPI]]( name )
|Unloads a previously loaded API.
|-
|[[Os.pullEvent|os.pullEvent]]( only-event-to-accept )
|Blocks until the computer has detected an event, then returns the event.
|-
|[[#pullEvent|os.pullEventRaw]]()
|Advanced version of pullEvent().
|-
|[[os.queueEvent]]( event, param1, param2, ... )
|Adds an event to the event queue with the name <var>event</var> and the given parameters
|-
|[[os.clock]]()
|Returns CPU time.
|-
|[[os.startTimer]]( timeout )
|Queues an event to be triggered after a number of seconds.
The ID of the timer is returned from this function to differentiate multiple
timers. Timers are one-shot, once they have fired an event you will need to
start another one if you need a recurring timer.
|-
|[[os.sleep]]( timeout )
|Makes the system wait a number of seconds before continuing in the program.
May also be used as simply "sleep( timeout )".
|-
|[[os.time]]()
|Returns the current Minecraft world time.
|-
|[[os.setAlarm]]( time )
|Queues an event to be triggered at the specific Minecraft world time.
|-
|[[os.shutdown]]()
|Turns off the computer.
|-
|[[os.reboot]]()
|Reboots the computer.
|}

== <div id="api">API</div> ==

API are programs which are loaded in to the OS itself, and expose functions
which other programs may use. The stock [[APIs|APIs that ship with
ComputerCraft]] are loaded in this way, and may be replaced by a computer's
user or programs.

== <div id="pullEvent">os.pullEvent()</div> ==

os.pullEvent() causes the current program to pause, retrieving the next event
from the computer's queue of events. If there is no event to read, then the
program will stall until such an event becomes available. Note that if a
program has not attempted to pull an event in the past ten seconds, it will
be forcefully terminated to prevent CPU waste in SMP environments.

pullEvent returns the name of the event that was read, as well as up to
five parameters:

<code>
local event, p1, p2, p3, p4, p5 = os.pullEvent()
</code>

os.pullEvent() is usually run inside a 'while true do' loop.

An advanced version of this method <code>os.pullEventRaw</code> bypasses the
normal handling of events from the OS. You may use this to act on the
"Terminate" event (triggered when holding Ctrl-T) for custom termination logic.


[[Category:APIs]]

User:Dadmob18

2012-09-27T12:53:20Z

Dadmob18: Created page with "I'm a developer by day and a father of two boys by night, and we all enjoy playing Minecraft. My ultimate goal for turtles is to build a self-replicating set of them... but I..."

I'm a developer by day and a father of two boys by night, and we all enjoy playing Minecraft. My ultimate goal for turtles is to build a self-replicating set of them... but I only get one hour of playing each night.

Talk:Turtle (API)

2012-09-27T12:50:02Z

Dadmob18: /* turtle collect ? */

Is there a way to detect a block's type? Preferably without picking it up; it would be nice to be able to write a function to check the block about to be broken against a list of "Do not break" blocks, such as Industrial craft's MFSU, which loses all held power when picked up.

Also I request a way to set server-wide list of blocks immune to the turtle.dig() functions, such as say personal safes (Industrial Craft again).— Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:50.131.199.48|50.131.199.48]] ([[User talk:50.131.199.48|talk]] • [[Special:Contributions/50.131.199.48|contribs]]) 
:As far as I know, there's no way to check the block type with the current API. Could be a feature in the future though, never know. {{User:Scarfacial/Signature|22:17 - 8 March 2012}}
::Would be interesting to see if one could write a function for that. {{User:Banane9/Signature|22:43 - 9 March 2012}}
:::i would see it too please. But i dont think that you can make that in a function
:::[[User:Dude|Dude]] 22:13, 9 March 2012 (UTC)
::::You can determine if the block matches the one in its inventory using turtle.select(slot) and then turtle.compare() or turtle.compareUp() or turtle.compareDown()

== turtle collect ? ==

i understand that the turtle can drop items from its inventory with turtle.drop( [amount] )
but is there a way to make the turtle collect items (like a player would do) around and store it in inventory ?
(from what i understand right now the turtle collects items taken from a digged block ?
thanks
:Nope they don't collect items that are already dropped --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
:Now in 1.4 there is the [[turtle.suck|turtle.suck()]] function --[[User:Dadmob18|Dadmob18]] 12:22, 27 Sep 2012 (UTC)

== treefarm ==

i have write a big programm (120 lines) that destory the tree full (with the leaves) when the tree is grown. so the turtle can plant an new tree an beginn at the start. My problem: the programm dont work and i cant find the faults... — Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:Dude|Dude]] ([[User talk:Dude|talk]] • [[Special:Contributions/Dude|contribs]]) 
:Maybe because the leaves of the tree decay and that f*cks up the code? We cant help you without seeing your code ;) --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
::On a similar note, I have written a disassembler script which (mostly) disassembles arbitrary things from the top down, but it really gets messed up by doors and other turtles and pistons, it is basically because interacting with blocks only works well if the blocks don't change while you are trying to deal with them/use them for navigating.

== Turtle API to detect block/item ID? ==

I have a suggestion, what if you have a function like: turtle.getBlockID() which would return ID, damage value, or simmilar
:Dan doesn't want Block IDs as they'd break the 4th wall. --[[User:Pinkishu|Pinkishu]] 13:12, 16 August 2012 (CEST)

== More than 1 mover per turtle.up() ==

is there a way to make a turtle go up more than once for each turtle.up() ? like maybe turtle.up(36) (i tried that but it said attempt to call nil)

You could use:
<pre>
turtleold = turtle.up
function turtlenew(times)
for i=1,times do
turtle.up()
end
end
turtle.up = turtlenew
</pre>
Then just use turtle.up(5) and stuff, because it overrides the function.

Can you tell the turtle to drop/not pick up unwanted items like dirt, cobble, sand and gravel?

Talk:Turtle (API)

2012-09-27T12:49:02Z

Dadmob18: /* turtle collect ? */

Is there a way to detect a block's type? Preferably without picking it up; it would be nice to be able to write a function to check the block about to be broken against a list of "Do not break" blocks, such as Industrial craft's MFSU, which loses all held power when picked up.

Also I request a way to set server-wide list of blocks immune to the turtle.dig() functions, such as say personal safes (Industrial Craft again).— Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:50.131.199.48|50.131.199.48]] ([[User talk:50.131.199.48|talk]] • [[Special:Contributions/50.131.199.48|contribs]]) 
:As far as I know, there's no way to check the block type with the current API. Could be a feature in the future though, never know. {{User:Scarfacial/Signature|22:17 - 8 March 2012}}
::Would be interesting to see if one could write a function for that. {{User:Banane9/Signature|22:43 - 9 March 2012}}
:::i would see it too please. But i dont think that you can make that in a function
:::[[User:Dude|Dude]] 22:13, 9 March 2012 (UTC)
::::You can determine if the block matches the one in its inventory using turtle.select(slot) and then turtle.compare() or turtle.compareUp() or turtle.compareDown()

== turtle collect ? ==

i understand that the turtle can drop items from its inventory with turtle.drop( [amount] )
but is there a way to make the turtle collect items (like a player would do) around and store it in inventory ?
(from what i understand right now the turtle collects items taken from a digged block ?
thanks
:Nope they don't collect items that are already dropped --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
:Now in 1.4 there is the [[turtle.suck()|Turtle.suck]] function --[[User:Dadmob18|Dadmob18]] 12:22, 27 Sep 2012 (UTC)

== treefarm ==

i have write a big programm (120 lines) that destory the tree full (with the leaves) when the tree is grown. so the turtle can plant an new tree an beginn at the start. My problem: the programm dont work and i cant find the faults... — Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:Dude|Dude]] ([[User talk:Dude|talk]] • [[Special:Contributions/Dude|contribs]]) 
:Maybe because the leaves of the tree decay and that f*cks up the code? We cant help you without seeing your code ;) --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
::On a similar note, I have written a disassembler script which (mostly) disassembles arbitrary things from the top down, but it really gets messed up by doors and other turtles and pistons, it is basically because interacting with blocks only works well if the blocks don't change while you are trying to deal with them/use them for navigating.

== Turtle API to detect block/item ID? ==

I have a suggestion, what if you have a function like: turtle.getBlockID() which would return ID, damage value, or simmilar
:Dan doesn't want Block IDs as they'd break the 4th wall. --[[User:Pinkishu|Pinkishu]] 13:12, 16 August 2012 (CEST)

== More than 1 mover per turtle.up() ==

is there a way to make a turtle go up more than once for each turtle.up() ? like maybe turtle.up(36) (i tried that but it said attempt to call nil)

You could use:
<pre>
turtleold = turtle.up
function turtlenew(times)
for i=1,times do
turtle.up()
end
end
turtle.up = turtlenew
</pre>
Then just use turtle.up(5) and stuff, because it overrides the function.

Can you tell the turtle to drop/not pick up unwanted items like dirt, cobble, sand and gravel?

Talk:Turtle (API)

2012-09-27T12:46:41Z

Dadmob18: /* turtle collect ? */

Is there a way to detect a block's type? Preferably without picking it up; it would be nice to be able to write a function to check the block about to be broken against a list of "Do not break" blocks, such as Industrial craft's MFSU, which loses all held power when picked up.

Also I request a way to set server-wide list of blocks immune to the turtle.dig() functions, such as say personal safes (Industrial Craft again).— Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:50.131.199.48|50.131.199.48]] ([[User talk:50.131.199.48|talk]] • [[Special:Contributions/50.131.199.48|contribs]]) 
:As far as I know, there's no way to check the block type with the current API. Could be a feature in the future though, never know. {{User:Scarfacial/Signature|22:17 - 8 March 2012}}
::Would be interesting to see if one could write a function for that. {{User:Banane9/Signature|22:43 - 9 March 2012}}
:::i would see it too please. But i dont think that you can make that in a function
:::[[User:Dude|Dude]] 22:13, 9 March 2012 (UTC)
::::You can determine if the block matches the one in its inventory using turtle.select(slot) and then turtle.compare() or turtle.compareUp() or turtle.compareDown()

== turtle collect ? ==

i understand that the turtle can drop items from its inventory with turtle.drop( [amount] )
but is there a way to make the turtle collect items (like a player would do) around and store it in inventory ?
(from what i understand right now the turtle collects items taken from a digged block ?
thanks
:Nope they don't collect items that are already dropped --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
:Now in 1.4 there is the turtle.suck() function --[[User:Dadmob18|Dadmob18]] 12:22, 27 Sep 2012 (UTC)

== treefarm ==

i have write a big programm (120 lines) that destory the tree full (with the leaves) when the tree is grown. so the turtle can plant an new tree an beginn at the start. My problem: the programm dont work and i cant find the faults... — Preceding [[Wikipedia:Signatures|unsigned]] comment added by [[User:Dude|Dude]] ([[User talk:Dude|talk]] • [[Special:Contributions/Dude|contribs]]) 
:Maybe because the leaves of the tree decay and that f*cks up the code? We cant help you without seeing your code ;) --[[User:Banane9|Banane9]] 12:22, 11 July 2012 (UTC)
::On a similar note, I have written a disassembler script which (mostly) disassembles arbitrary things from the top down, but it really gets messed up by doors and other turtles and pistons, it is basically because interacting with blocks only works well if the blocks don't change while you are trying to deal with them/use them for navigating.

== Turtle API to detect block/item ID? ==

I have a suggestion, what if you have a function like: turtle.getBlockID() which would return ID, damage value, or simmilar
:Dan doesn't want Block IDs as they'd break the 4th wall. --[[User:Pinkishu|Pinkishu]] 13:12, 16 August 2012 (CEST)

== More than 1 mover per turtle.up() ==

is there a way to make a turtle go up more than once for each turtle.up() ? like maybe turtle.up(36) (i tried that but it said attempt to call nil)

You could use:
<pre>
turtleold = turtle.up
function turtlenew(times)
for i=1,times do
turtle.up()
end
end
turtle.up = turtlenew
</pre>
Then just use turtle.up(5) and stuff, because it overrides the function.

Can you tell the turtle to drop/not pick up unwanted items like dirt, cobble, sand and gravel?

Rednet.receive

2012-09-25T21:07:20Z

Dadmob18:

{{lowercase}}
{{Function
|name=rednet.receive
|args=[[float (type)|float]] timeoutSeconds
|returns=senderId, message, distance-to-sender (or <code>nil</code> if using redpower bundled cable instead of a modem)
|api=rednet
|addon=ComputerCraft
|desc=Waits for <var>timeoutSeconds</var> or until another computer sends a message to this computer. (see [[rednet.broadcast( message )]] and [[rednet.send( receiverID, message )]]. To get the id from a computer see [[os.computerID()]], or the [[id]] command. If a Timeout occurs the return id and message are set to nil
|examples=
{{Example
|desc=waits unlimited till someone sends a message to this computer and displays it
|code=senderId, message, distance = rednet.receive() term.write(message)
|output=The received message.
}}
}}

Rednet.receive

2012-09-25T21:06:51Z

Dadmob18:

{{lowercase}}
{{Function
|name=rednet.receive
|args=[[float (type)|float]] timeoutSeconds
|returns=senderId, message, distance-to-sender (or <code>nil</code> if using redpower bundled cable instead of a modem)
|api=rednet
|addon=ComputerCraft
|desc=Waits for <var>timeoutSeconds</var> or until another computer sends a message to this computer. (see [[rednet.broadcast( message )]] and [[rednet.send( receiverID, message )]]. To get the id from a computer see [[os.computerID()]]. If a Timeout occurs the return id and message are set to nil
|examples=
{{Example
|desc=waits unlimited till someone sends a message to this computer and displays it
|code=senderId, message, distance = rednet.receive() term.write(message)
|output=The received message.
}}
}}

Login with Roaming Profiles

2012-09-25T02:07:58Z

Dadmob18: /* Setting Up */

This tutorial covers how to make a password server and a password client. The server will host a Lua table of usernames and passwords and the client will remotely connect each start up, ask the user for their username and password and compare it to that on the password server.

__TOC__

== Setting Up ==
As I'm sure you're aware, writing code directly into the computer terminal can be difficult, slow, and therefore annoying. I highly recommend writing/copying the following code into a Lua editor and then using FTP to transfer the documents across to the computer or disk. Please ensure you do not add the .lua extension. Programs are saved in your minecraft world under the "computer" directory, with one folder for each computer plus the folder "disk" which contains a directory for each disk.

First craft two or more computers. One will act as your password server, any others will be connecting to that computer. Find the computer ID of your password server. This is important as we don't want to broadcast password requests and replies. In the following code I have also locked the requests to certain computers to ensure security but it is not a needed component of the code. If you decide to take the security as well, make a note of all of the ID's of the client computers. I found it useful to give each computer a label and then search for labels.txt on the server to map it out easily.

Each computer you craft needs a [[modem|rednet modem]].

== The Code ==

=== Server Code ===

os.pullEvent = os.pullEventRaw
term.clear()
term.setCursorPos(1,1)
print("This is a password server. There is no user interaction here.")
print("Please find a computer and login there.")
local firstCycle = true
local validSender = false
local modemSide = "left" -- change to the side of the computer your modem is on
local valid = false
users = { username1, username2 } --make sure users and passwords line up
passwords = { password1, password2 }
senders = { 13, 14, 15, 17 } -- computer ID's of the computers you want to accept requests from
function bootUp()
rednet.open(modemSide)
end
while true do
validSender = false
if firstCycle then
bootUp()
firstCycle = false
end
senderId, message, distance = rednet.receive()
for i,v in ipairs(senders) do
if v == senderId then
validSender = true
break
end
end
if validSender then
for i,v in ipairs(users) do
if message == v then
valid = true
password = passwords[i]
else
valid = false
end
end
if valid then
rednet.send(senderId, password)
else
rednet.send(senderId, "Not Valid")
end
end
end

=== Client Code ===

os.pullEvent = os.pullEventRaw
local locker = true
local failed = true
local attempted_login = true
local password_server = 17 -- change to the ID of your password server computer
rednet.open("left") -- change to the side your rednet modem is on
while locker do
attempted_login = false
term.clear()
term.setCursorPos(1,1)
print("Welcome to a USERS PC : Roaming Profile Enabled")
print("What would you like to do?")
print("[1] Login (*)")
print("[2] Shutdown")
write("> ")
local input = read()
if input == "2" then
os.shutdown()
elseif input == "1" then
attempted_login = true
print("Please login...")
write("Username: ")
local username = read()
write("Password: ")
local password = read("*")
rednet.send(password_server, username)
senderId, message, distance = rednet.receive(5)
if password == message then
failed = false
locker = false
term.clear()
term.setCursorPos(1,1)
print("Welcome ", username)
else
print("Not authorised.")
sleep(1)
end
else
print("Command not recognised...")
sleep(2)
end
end

== Thoughts and Notes ==
If you change the client code, to "startup" and put it in the root directory, it works very well as a login system.
You may also want to put in the line
os.pullEvent = os.pullEventRaw -- disables Ctrl+T
as if it doesn't work first time it can be difficult to get out of the program.

If you have either Railcraft or Additional Pipes, find the 'World Anchor' or 'Teleport Tether' block. If your server can afford the resources, place the block within a 3x3 grid of your password server. It will ensure that even if you leave the chunk, the password server still is operational. Otherwise you may find that you cannot login because you've left the chunk and the password server is no longer dealing with requests.

This is a minor security flaw but it is only if someone has access to a computer that is 'whitelisted' to access the password server. The security flaw is that if they use the password Not Valid on that computer they are allowed access;

if valid then
--send client password
else
--send client Not Valid
end

to fix remove the else statement

[[Category:User Management]]