ComputerCraft Wiki - User contributions [en]

Template:Changelog

2016-11-27T12:02:22Z

Dan200: Removed a confusing april fools joke from the changelog

{| class="wikitable sortable" style="width: 100%"
! style="width: 15%" | Version
! class="unsortable" | New Features or Changes
! style="width: 15%" | Minecraft Version
|-
|align=center|[http://www.computercraft.info/2016/04/01/computercraft-and-computercraftedu-1-79/ ComputerCraft 1.79]
|
*Ported ComputerCraftEdu to Minecraft 1.8.9.
*Fixed a handful of bugs in ComputerCraft.
|align=center|1.8.9
|-
|align=center|[http://www.computercraft.info/2016/01/15/computercraft-1-78/ ComputerCraft 1.77 - 1.78]
|
*Ported to Minecraft 1.8.9.
*Added [[Settings_(API)|“settings” API]].
*Added [[set|“set”]] and [[wget|“wget”]] programs.
*Added [[Settings_(API)|settings]] to disable [[multishell]], startup scripts, and tab completion on a per-computer basis. The default values for these settings can be customised in [[ComputerCraft.cfg]].
*All [[Computer]] and [[Turtle]] items except [[Command Computer]]s can now be mounted in [[Disk Drive]]s.
|align=center|1.8.9
|-
|align=center|[http://www.computercraft.info/2015/12/24/computercraft-1-76/ ComputerCraft 1.76]
|
*Ported to Minecraft 1.8.
*Added [[Ender Modem]]s for cross-dimensional communication.
*Fixed handling of 8-bit characters. All the characters in the [https://en.wikipedia.org/wiki/ISO/IEC_8859-1 ISO 8859-1 codepage] can now be displayed.
*Added some extra graphical characters in the unused character positions, including a suite of characters for [http://teletextart.tumblr.com/ Teletext-style drawing].
*Added support for the new commands in Minecraft 1.8 to the [[Command Computer]].
*The return values of [[turtle.inspect]]() and [[commands.getBlockInfo]]() now include blockstate information.
*Added [[commands.getBlockInfos]]() function for Command Computers.
*Added new "[[Peripherals (program)|peripherals]]" program.
*Replaced the "_CC_VERSION" and "_MC_VERSION" constants with a new "_HOST" constant.
*Shortened the length of time that "Ctrl+T", "Ctrl+S" and "Ctrl+R" must be held down to terminate, shutdown or reboot the computer.
*[[textutils.serializeJSON]]() now takes an optional parameter allowing it to produce JSON text with unquoted object keys. This is used by all autogenerated methods in the [[commands (API)|commands API]] except for "title" and "tellraw".
*Fixed many bugs.
|align=center|1.8
|-
|align=center|[http://www.computercraft.info/2015/12/04/computercraft-1-75/ ComputerCraft 1.75]
|
*Fixed monitors sometimes rendering without part of their text.
*Fixed a regression in the [[Bit_(API)|“bit” API]].
|align=center|1.7.10
|-
|align=center|[http://www.computercraft.info/2015/06/27/computercraft-1-74/ ComputerCraft 1.74]
|
*Added tab completion to [[Edit|“edit”]], [[Lua|“lua”]] and the [[shell]].
*Added [[textutils.complete]](), [[fs.complete]](), [[shell.complete]](), [[shell.completeProgram]](), [[shell.setCompletionFunction]](), [[shell.getCompletionInfo]](), and [[help.completeTopic]]().
*Added tab completion options to [[read]]().
*Added [[key_up_(event)|“key_up”]] and [[mouse_up_(event)|“mouse_up”]] events.
*Non-advanced terminals now accept both grey [[Color_(API)|colour]]s.
*Added [[term.getTextColor]](), [[term.getBackgroundColor]]() and [[term.blit]]().
*Improved the performance of text rendering on [[Advanced Computer]]s.
*Added a “Run” button to the [[edit|“edit”]] program on [[Advanced Computer]]s.
*[[Turtle]]s can now push players and entities ([[ComputerCraft.cfg|configurable]]).
*[[Turtle]]s now respect server spawn protection ([[ComputerCraft.cfg|configurable]]).
*Added a turtle permissions API for mod authors.
*Implemented a subset of the Lua 5.2 API so programs can be written against it now, ahead of a future Lua version upgrade.
*Added a [[ComputerCraft.cfg|config option]] to disable parts of the Lua 5.1 API which will be removed when a future Lua version upgrade happens.
*[[Command Computer]]s can no longer be broken by survival players.
*Fixed the “pick block” key not working on ComputerCraft items in creative mode.
*Fixed the [[edit|“edit”]] program being hard to use on certain European keyboards.
*Added “_CC_VERSION” and “_MC_VERSION” constants.
|align=center|1.7.10
|-
|align=center|[http://www.computercraft.info/2015/02/22/computercraft-1-73/ ComputerCraft 1.71 - 1.73]
|
*[CC 1.71] The [[exec|“exec”]] program, [[commands.exec]]() and all related [[Command Computer]] functions now return the console output of the command.
*[CC 1.72 - 1.73] Fixed two multiplayer-only crash bugs when placing certain blocks.
|align=center|1.7.10
|-
|align=center|[http://www.computercraft.info/2015/02/15/computercraft-1-7/ ComputerCraft 1.7]
|
*Added [[Command Computer]]s.
*Added new API: [[commands_(API)|commands]].
*Added new programs: [[commands]], [[exec]].
*Added [[textutils.serializeJSON]]().
*Added ILuaContext.executeMainThreadTask() for peripheral developers.
*[[Disk Drive]]s and [[Printer]]s can now be renamed with Anvils.
*Fixed problems with HD texture packs.
*Fixed various bugs and crashes.
*Documented all the new features in the in-game help system.
|align=center|1.7.10
|-
|align=center|[http://www.computercraft.info/2014/10/09/computercraft-1-65/ ComputerCraft 1.65]
|
*Fixed a multiplayer-only crash with [[turtle.place]]().
*Fixed some problems with [[http.post]]().
*Fixed [[fs.getDrive]]() returning incorrect results on remote peripherals.
|align=center|1.7.10
|-
|align=center|[http://www.computercraft.info/2014/09/27/computercraft-1-64/ ComputerCraft 1.64]
|
*Ported to Minecraft 1.7.10.
*New [[turtle_(API)|turtle API]] functions: [[turtle.inspect]](), [[turtle.inspectUp]](), [[turtle.inspectDown]](), [[turtle.getItemDetail]]().
*Lots of bug fixes and crash fixes, a huge stability improvement over previous versions.
*New [[paintutils_(API)|paintutils API]] functions: [[paintutils.drawBox]]( startX, startY, endX, endY [, color] ), [[paintutils.drawFilledBox]]( startX, startY, endX, endY [, color] ).
|align=center|1.7.10
|-
|align=center|[http://www.computercraft.info/2014/04/16/computercraft-1-63/ ComputerCraft 1.63]
|
*[[Turtle]]s can now be painted with dyes, and cleaned with water buckets.
*Added a new game: [[Redirection]] – ComputerCraft Edition by [http://www.computercraft.info/forums2/index.php?/user/16414-ramilego4game/ RamiLego] (type “redirection” on an Advanced Computer to play).
*[[Turtle]] label nameplates now only show when the [[Turtle]] is moused-over.
*The HTTP API is now enabled by default, and can be configured with a whitelist of permitted domains.
*[[http.get]]() and [[http.post]]() now accept parameters to control the request headers.
*New [[Fs_(API)|fs API]] function: [[fs.getDir]]( path ).
*Fixed some bugs.
|align=center|1.6.4
|-
|align=center|[http://www.computercraft.info/2014/04/04/computercraft-1-62/ ComputerCraft 1.62]
|
*Fixed some bugs which were crashing the game.
*[[Chat]] now supports IRC commands.
|align=center|1.6.4
|-
|align=center|[http://www.computercraft.info/2014/04/01/computercraft-1-61-bug-fix-update/ ComputerCraft 1.61]
|
*Fixed a bug where newly placed [[Computer]]s would share their folder structure until game restart.
*Fixed a bug where running [[Computer]]s might not automatically restart as the game did so.
|align=center|1.6.4
|-
|align=center|[http://www.computercraft.info/2014/03/27/computercraft-1-6-is-here/ ComputerCraft 1.6]
|
*Added [[Pocket Computer]]s.
*Added a [[Multishell|multi-tasking system]] for [[Advanced Computer]]s and [[Turtle]]s.
*[[Turtle]]s can now [[Equip|swap out their tools and peripherals]] at runtime.
*[[Turtle]]s can now carry two tools or peripherals at once in any combination.
*[[Turtle]]s and [[Computer]]s can now be labelled using Name Tags and Anvils.
*Added a [[ComputerCraft.cfg|configurable fuel limit]] for [[Turtle]]s.
*Added hostnames, protocols and long distance routing to the [[Rednet (API)|rednet API]].
*Added a peer-to-peer [[chat]] program to demonstrate new rednet capabilities.
*Added a new game, only on [[Pocket Computer]]s: “[[falling]]” by [http://www.computercraft.info/forums2/index.php?/user/3545-gopheratl/ GopherATL].
*File system commands in the shell now accept wildcard arguments.
*The shell now accepts long arguments in quotes.
*[[term.redirect|Terminal redirection]] now no longer uses a stack-based system. Instead: [[term.current]]() gets the current terminal object and [[term.redirect]]() replaces it. [[term.restore]]() has been removed.
*Added a new [[Window (API)|Windowing API]] for addressing sub-areas of the terminal.
*New programs: [[fg]], [[bg]], [[multishell]], [[chat]], [[repeat]], [[Redstone (program)|redstone]], [[equip]], [[unequip]].
*Improved programs: [[copy]], [[move]], [[delete]], [[rename]], [[paint]], [[CraftOS|shell]].
*Removed programs: redset, redprobe, redpulse.
*New [[:Category:APIs|APIs]]: [[Window (API)|window]], [[Multishell (API)|multishell]].
*New [[Turtle (API)|turtle API]] functions: [[turtle.equipLeft]](), [[turtle.equipRight]](), [[turtle.getFuelLimit]](), [[turtle.getSelectedSlot]]().
*New [[Peripheral (API)|peripheral API]] functions: [[peripheral.find]]( [type] ).
*New [[Rednet (API)|rednet API]] functions: [[rednet.host]]( protocol, hostname ), [[rednet.unhost]]( protocol ), [[rednet.lookup]]( protocol, [hostname] ).
*Improved [[Rednet (API)|rednet API]] functions: [[rednet.send]](), [[rednet.broadcast]]() and [[rednet.receive]]() now take optional protocol parameters.
*New [[fs (API)|fs API]] function: [[fs.find]]( wildcard ).
*New [[Shell (API)|shell API]] functions: [[shell.openTab]]( command ), [[shell.switchTab]]( number ).
*New event “[[Term_resize_(event)|term_resize]]” fired when the size of a terminal changes.
*[[turtle.craft]](0) and [[turtle.refuel]](0) now return true if there is a valid recipe or fuel item, but do not craft or refuel anything.
*[[turtle.suck]]( [limit] ) can now be used to limit the number of items picked up.
*Users of [[turtle.dig]]() and [[turtle.attack]]() can now specify which side of the turtle to look for a tool to use (by default, both will be considered).
*[[textutils.serialize]]() now produces human-readable output.
*Refactored most of the codebase and fixed many old bugs and instabilities, [[Turtle]]s should never ever lose their content now.
*Fixed the “[[turtle_inventory_(event)|turtle_inventory]]” event firing when it shouldn’t have.
*Added error messages to many more [[Turtle_(API)|turtle API]] functions after they return false.
*Documented all new programs and API changes in the “[[help]]” system.
|align=center|1.6.4
|-
|align=center|[http://www.computercraft.info/2013/12/09/computercraft-1-58/ ComputerCraft 1.58]
|
*Fixed a long standing bug where [[Turtle]]s could lose their identity.
*Fixed use of deprecated code, ensuring mod compatibility with the latest versions of Minecraft Forge and world compatibility with future versions of Minecraft.
|align=center|1.6.4
|-
|align=center|[http://www.computercraft.info/2013/10/14/new-versions/ ComputerCraft 1.57]
|
*Ported to Minecraft 1.6.4.
*Added two new [[Treasure Disks]]: Conway’s Game of Life by [http://www.computercraft.info/forums2/index.php?/user/1823-vilsol/ vilsol] and Protector by [http://www.computercraft.info/forums2/index.php?/user/6929-fredthead/ fredthead].
*Fixed a very nasty item duplication bug.
|align=center|1.6.4
|-
|align=center|[http://www.computercraft.info/2013/08/04/computercraft-1-56/ ComputerCraft 1.56]
|
*Added [[Treasure Disks]]: Rare [[Floppy Disk]]s found only in dungeons, which contain fun programs made by the community. Find them all!
*All [[Turtle_(API)|turtle API]] functions now return additional error messages when they fail.
*Resource Packs with Lua Programs can now be loaded when extracted to a folder, for easier editing.
|align=center|1.6.2
|-
|align=center|[http://www.computercraft.info/2013/07/11/computercraft-1-55/ Computercraft 1.55]
|
*Ported to Minecraft 1.6.2.
*Added [[Advanced Turtle]]s.
*Added [[turtle_inventory_(event)|“turtle_inventory”]] event. Fires when any change is made to the inventory of a [[Turtle]].
*Added missing [[IO_(API)|io API]] functions: io.close, io.flush, io.input, io.lines, io.output.
*Tweaked the screen colours used by [[Advanced Computer]]s, [[Advanced Monitor]]s and [[Advanced Turtle]]s.
*Added several new features for Peripheral authors.
*Lua programs can now be included in Resource Packs.
|align=center|1.6.2
|-
|align=center|[http://www.computercraft.info/2013/05/23/computercraft-1-53/ ComputerCraft 1.53]
|
*Ported to Minecraft 1.5.2.
*[[redstone.setBundledOutput]]() and [[redstone.getBundledOutput]]() now work with cables from Minefactory Reloaded, as well as RedPower.
*[[Monitor]]s and [[Advanced Monitor]]s can now be placed on floors and ceilings.
|align=center|1.5.2
|-
|align=center|[http://www.computercraft.info/2013/03/26/computercraft-1-52/ Computercraft 1.52]
|
*Ported to Minecraft 1.5.1.
|align=center|1.5.1
|-
|align=center|[http://www.computercraft.info/2013/03/15/computercraft-1-51/ Computercraft 1.51]
|
*Ported to Minecraft 1.5.
*Added [[Wired Modem]]s.
*Added [[Networking Cable]]s.
*Made [[Wireless Modem]]s more expensive to craft.
*New [[redstone_(API)|redstone API]] functions: [[redstone.getAnalogInput]](), [[redstone.setAnalogOutput]](), [[redstone.getAnalogOutput]]().
*Peripherals can now be controlled remotely over wired networks.
*New [[peripheral_(API)|peripheral API]] function: [[peripheral.getNames]]().
*New event: [[monitor_resize_(event)|“monitor_resize”]]is fired when the size of a monitor changes.
*Except for labelled [[Computer]]s and [[Turtle]]s, ComputerCraft blocks no longer drop items in creative mode.
*The pick block function works in creative mode now works for all ComputerCraft blocks.
*All blocks and items now use the IDs numbers assigned by FTB by default.
*Fixed [[Turtle]]s sometimes placing blocks with incorrect orientations.
*Fixed [[Wireless Modem]]s being able to send messages to themselves.
*Fixed [[turtle.attack]]() having a very short range.
*Various bugfixes.
|align=center|1.5
|-
|align=center|[http://www.computercraft.info/2013/02/11/computercraft-1-5/ Computercraft 1.5]
|
*Redesigned [[Wireless Modem]]s; they can now send and receive on multiple channels, independent of the computer ID. To use these features, interface with modem peripherals [[Modem_(API)|directly]]. The [[Rednet_(API)|rednet API]] still functions as before.
*[[Floppy Disk]]s can now be dyed with multiple dyes, just like armour.
*The [[Excavate|“excavate”]] program now retains fuel in it’s inventory, so can run unattended.
*[[turtle.place]]() now tries all possible block orientations before failing.
*[[turtle.refuel]](0) returns true if a fuel item is selected.
*[[turtle.craft]](0) returns true if the inventory is a valid recipe.
*The in-game help system now has documentation for all the peripherals and their methods, including the new [[Modem]] functionality.
*A romantic surprise.
|align=center|1.4.7
|-
|align=center|[http://www.computercraft.info/2012/12/27/computercraft-1-481-miscperipherals-fix/ Computercraft 1.481]
|
*Fixed compatibility bug with MiscPeripherals.
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/12/23/computercraft-1-48/ Computercraft 1.48]
|
*Ported to Minecraft 1.4.6.
*[[Advanced Monitor]]s can now be used as touchscreens.
*[[Advanced Monitor]]s are now easier to craft.
*[[Turtle]]s now get slightly less movement from fuel.
*[[Turtle]]s can now push items.
*[[Computer]]s can now [[Command_Block_(API)|control Command Blocks]], if enabled in the [[ComputerCraft.cfg|config]].
*New [[OS_(API)|os API]] function: [[os.day]]().
*A Christmas surprise.
|align=center|1.4.6
|-
|align=center|[http://www.computercraft.info/2012/11/15/computercraft-1-47-and-minecon-news/ ComputerCraft 1.47]
|
*Ported to Minecraft 1.4.4.
*Fixed label tooltips not showing up in SMP.
|align=center|1.4.4
|-
|align=center|[http://www.computercraft.info/2012/10/25/computercraft-1-46-minecraft-update/ ComputerCraft 1.46]
|
*Ported to Minecraft 1.4.2.
*ComputerCraft items now have their own tab in Creative Mode.
|align=center|1.4.2
|-
|align=center|[http://www.computercraft.info/2012/10/22/computercraft-1-45-now-with-colors/ ComputerCraft 1.45]
|
*Added [[Advanced Computer]]s.
*Added [[Advanced Monitor]]s.
*New program: [[paint]] (by [http://www.computercraft.info/forums2/index.php?/user/643-nitrogenfingers/ nitrogenfingers]).
*New API: [[paintutils_(API)|paintutils]].
*New term functions: [[term.setBackgroundColor]]( color ), [[term.setTextColor]]( color ), [[term.isColor]]().
*New [[Turtle|Turtle API]] function: [[turtle.transferTo]]().
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/10/04/computercraft-1-43-books/ ComputerCraft 1.43]
|
*Added [[Printed Page]]s (bind several [[Printed Page]] items into one with a string).
*Added [[Printed_book|Printed Books]] (add a leather cover to the above).
*Labelled [[Turtle]]s now keep their fuel when broken.
*Fixed incompatibility with Forge 275 and above.
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/09/22/computercraft-1-42-is-released/ ComputerCraft 1.42]
|
*Ported to Minecraft 1.3.2 and the Forge mod system.
*Added [[Printer]]s.
*[[Floppy Disk]]s can now be dyed different colours.
*[[Turtle|Wireless Crafty Turtles]] can now be crafted.
*All new textures.
*New Forge [[ComputerCraft.cfg|config file]].
*Various tweaks and bug fixes.
|align=center|1.3.2
|-
|align=center|[http://www.computercraft.info/2012/07/29/computercraft-1-41-bugfix-update/ ComputerCraft 1.41]
|
*Fixed labelled [[Computer]]s not keeping their data when destroyed.
*Fixed the [[Excavate|“excavate”]] program outputting lots of spam.
*File system size limits now take into account empty files and directories.
*Some small changes to the Turtle Upgrade API ahead of it’s impending release. (Update: The API has now been released).
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/07/27/computercraft-1-4-is-released/ ComputerCraft 1.4]
|
*Ported to Forge Mod Loader: ComputerCraft can now be ran directly from the .zip without extraction.
*Added Farming [[Turtle]]s, Felling [[Turtle]]s, Digging [[Turtle]]s, Melee [[Turtle]]s and Crafty [[Turtle]]s.
*Added 14 new [[Turtle]] combinations accessible by combining the turtle upgrades above.
*Labelled [[Computer]]s and [[Turtle]]s can now be crafted into [[Turtle]]s or other [[Turtle]] types without losing their ID, label and data.
*Added a “[[Turtle]] Upgrade API” for mod developers to create their own tools and peripherals for [[Turtle]]s.
*[[Turtle]]s can now attack entities with [[turtle.attack]]() and collect their dropped items.
*[[Turtle]]s can now use [[turtle.place]]() with any item the player can and can interact with entities.
*[[Turtle]]s can now craft items with [[turtle.craft]]().
*[[Turtle]]s can now place items into inventories with [[turtle.drop]]().
*Changed the behaviour of [[turtle.place]]() and [[turtle.drop]]() to only consider the currently selected slot.
*[[Turtle]]s can now pick up items from the ground or from inventories with [[turtle.suck]]().
*[[Turtle]]s can now compare items in their inventories.
*[[Turtle]]s can place signs with text on them with [[turtle.place]]( [signText] ).
*[[Turtle]]s now optionally require fuel items to move, and can [[turtle.refuel|refuel]] themselves.
*The size of the the [[Turtle]] inventory has been increased to 16 slots.
*The size of the [[Turtle]] screen has been increased.
*New [[Turtle_(API)|turtle API]] functions: [[turtle.compareTo]]( [slotNum] ), [[turtle.craft]](), [[turtle.attack]](), [[turtle.attackUp]](), [[turtle.attackDown]](), [[turtle.dropUp]](), [[turtle.dropDown]](), [[turtle.getFuelLevel]](), [[turtle.refuel]]().
*New [[Disk_(API)|disk API]] function: [[disk.getID]]().
*New [[Turtle]] programs: [[craft]], [[refuel]].
*[[Excavate|“excavate”]] program is now much smarter: will return items to a chest when full, attack mobs, and refuel itself automatically.
*New API: [[Keys_(API)|keys]].
*Added optional [[Floppy Disk]] and Hard Drive space limits for [[Computer]]s and [[Turtle]]s.
*New [[Fs_(API)|fs API]] function: [[fs.getFreeSpace]]( path ). Also [[fs.getDrive]]() works again.
*The send and receive range of wireless modems now increases with altitude, allowing long range networking from high-altitude [[Computer]]s (great for GPS networks).
*[[http.request]]() now supports <code>https://</code> URLs.
*Right clicking a [[Disk Drive]] with a [[Floppy Disk]] or a Record when sneaking will insert the item into the [[Disk Drive]] automatically.
*The default size of the [[Computer]] screen has been increased.
*Several stability and security fixes: LuaJ can now no longer leave dangling threads when a [[Computer]] is unloaded, [[Turtle]]s can no longer be destroyed by tree leaves or walking off the edge of the loaded map. [[Computer]]s no longer crash when used with RedPower frames.
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/04/23/computercraft-updated-to-1-2-5/ ComputerCraft 1.33]
|
*Ported to Minecraft 1.2.5.
|align=center|1.2.5
|-
|align=center|[http://www.computercraft.info/2012/03/30/computercraft-1-32-out-now/ ComputerCraft 1.32]
|
*Ported to Minecraft 1.2.4.
*Fixed a big memory leak in LuaJ that caused extra threads to stay around forever when [[Computer]]s were shut down.
|align=center|1.2.4
|-
|align=center|[http://www.computercraft.info/2012/03/13/computercraft-1-31-is-released/ ComputerCraft 1.31]
|
*Ported to Minecraft 1.2.3.
*Added [[Monitor]]s (thanks to Cloudy). Build huge external displays for your [[Computer]]s!
*New positioning capabilities for [[Computer]]s and [[Turtle]]s. Build GPS networks and triangulate the positions of your [[Turtle]]'s position so they never get lost!
*New [[turtle.compare]]() function for [[Turtle]]s for more intelligent mining.
*New programs and APIs: [[Gps_(program)|gps]], [[Monitor_(program)|monitor]], [[Vector_(API)|vector API]].
*New program: [[Pastebin_(program)|pastebin]] (requires <code>enableAPI_HTTP=1</code> in [[ComputerCraft.cfg]]), upload and download programs made by other users ingame!
*Added a new top secret program designed for use with [[Monitor]]s, see if you can find it.
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for full details.
|align=center|1.2.3
|-
|align=center|[http://www.computercraft.info/2012/02/23/computercraft-1-3-trailer/ ComputerCraft 1.3]
|
*Ported to Minecraft Forge.
*Added [[Turtle]]s, Mining [[Turtle]]s, Wireless [[Turtle]]s and Wireless Mining [[Turtle]]s (Block ID 209).
*Added a Peripheral API to allow mod developers to create custom peripherals for ComputerCraft. Details on this will be posted in the next few days.
*Added [[Wireless Modem]]s. Use the [[Rednet_(API)|rednet API]] to send data wirelessly between [[Computer]]s and [[Turtle]]s!
*[[Computer]]s and [[Disk Drive]]s no longer get destroyed by water.
*[[Computer]]s and [[Turtle]]s can now be labelled, destroyed, and moved around, keeping their state.
*[[Computer]]s and [[Turtle]]s can connect to adjacent devices and turn them on or off.
*User programs now give line numbers in their error messages, for easier debugging.
*New APIs and programs for [[Turtle]]s: [[Turtle_(API)|turtle]], [[excavate]], [[tunnel]], [[go]], [[turn]] and [[dance]].
*Lots of additions to existing APIs and programs. Type "help whatsnew" in game for the full details.
|align=center|1.1
|-
|align=center|ComputerCraft 1.21
|
*Added shortcut key to shutdown the computer (CTRL + S).
*Added a [[Help_(API)|help API]] add-on pack.
*Various bug fixes.
|align=center|1.1
|-
|align=center|ComputerCraft 1.2
|
*Added [[Disk Drive]]s.
*Added shortcut keys to terminate the current program (CTRL + T) and reboot the computer (CTRL + R).
*Added [[os.loadAPI|a new system]] for user created APIs.
*Added [[Rednet_(API)|RedNet]].
*Added [[shell.setPath]]() and [[shell.setAlias]]().
*Added a new ROM startup script.
*Added [[os.clock]](), [[os.time]]() and [[os.setAlarm]]().
*Added game: [[Worm|"Worm!"]].
*Added programs: [[alias]], [[apis]], [[copy]], [[delete]], [[dj]], [[drive]], [[eject]], [[id]], [[label]], [[list]], [[move]], [[reboot]], [[redset]], [[rename]], [[time]].
*Added APIs: [[Bit_(API)|bit]], [[Colours_(API)|colours]], [[Disk_(API)|disk]], [[Help_(API)|help]], [[Rednet_(API)|rednet]], [[Parallel_(API)|parallel]], [[Textutils_(API)|textutils]].
*Text can be edited with left and right arrow keys.
*Many bug fixes.
|align=center|1.0
|-
|align=center|ComputerCraft 1.11
|
*Fixed bug where [[Computer]]s could not read input from RedPower cables which had a bend in the immediately adjacent square.
|align=center|1.0
|-
|align=center|ComputerCraft 1.1
|
*Changed the default block ID for the [[Computer]] to 207.
*Added multiplayer support.
*Added connectivity with RedPower bundled cables.
*Added [[HTTP_(API)|HTTP API]].
*Fixed support for HD textures on the front of [[Computer]]s.
*Added command history to the [[Computer]].
*Added [[ComputerCraft.cfg|config]] options to change the size of the [[Computer]] GUI and the text color.
*Programs with infinite loops that don't yield will no longer freeze Minecraft and will terminate after 10 seconds.
*Extended Help and fixed typos/small errors in various programs.
|align=center|1.0
|-
|align=center|ComputerCraft 1.02
|
*Fixed the MCPatcher HD textures incompatibility that was causing the computer texture to replace cobblestone blocks.
|align=center|1.0
|-
|align=center|ComputerCraft 1.01
|
*Added a ModLoader configuration file, so the computers block ID can be changed.
*Made the error message that displays when Lua files are not correctly installed much more clear, no more "Assertion failed."
|align=center|1.0
|-
|align=center|ComputerCraft 1.0
|
*First Release.
|align=center|1.0
|}

Turtle.dig

2016-06-09T19:37:06Z

Dan200: Reverted edits by Bomb Bloke (talk) to last revision by MisterSanderson

{{lowercase}}
{{Function
|name=turtle.dig
|args=
|api=turtle
|returns={{Type|boolean}} whether the turtle succeeded in digging, {{type|string}} error message
|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.
}}
}}

==See also==
*[[turtle.digUp]]
*[[turtle.digDown]]

[[Category:Lua_Core_Functions]]

Parallel.waitForAny

2016-01-27T21:54:49Z

Dan200: Removed very misleading incorrect note

{{Function
|name=parallel.waitForAny
|args={{type|function}} function1, {{type|function}} function2, ...
|returns = {{type|number}} indicating which function has completed based on argument order
|api=parallel
|addon=ComputerCraft
|desc=Lets you run multiple functions at the same time, alternating between them until any happen to finish.
|examples=
{{Example
|desc=Tells the computer to run <var>receive</var >and <var>send</var> the same time. Will broadcast what the user enters or prints what it receives over rednet, depending on what happens first.
|code= local function receive () -- Define function1.
[[print]]([[rednet.receive]]())
end

local function send () -- Define function2.
[[rednet.broadcast]]([[read]]())
end

'''parallel.waitForAny(receive, send)''' -- Run both functions in parallel until one finishes.
|output=Either it prints what it received via rednet, or it broadcasts the message the user typed.
}}
}}

[[Category:API_Functions]]

Settings (API)

2016-01-18T19:41:58Z

Dan200:

{{lowercase}}
The '''settings API''' allows to store values and save them to a file for persistent configurations for your and CraftOS programs. The default file for saving settings is <var>.settings</var> sitting in the root of the computer. Settings can also be changed and added to all computers through [[ComputerCraft.cfg]]'s <var>S:default_computer_settings</var> value.

{{API table|settings|image=Grid_disk.png|2=

{{API table/row
|[[settings.set]]({{type|string}} name, {{type|any}} value)
|{{type|nil}}
|Sets the setting <var>name</var> to <var>value</var>.
|odd}}

{{API table/row
|[[settings.get]]({{type|string}} name [, {{type|any}} default])
|{{type|any}} value
|Returns the setting's <var>name</var> value, or <var>default</var> if the setting does not exist.}}

{{API table/row
|[[settings.unset]]({{type|string}} name)
|{{type|nil}}
|Removes the setting <var>name</var>.
|odd}}

{{API table/row
|[[settings.clear]]()
|{{type|nil}}
|Removes all settings.}}

{{API table/row
|[[settings.getNames]]()
|{{type|table}} settingNames
|Returns a numerically-indexed table of all the setting's names.
|odd}}

{{API table/row
|[[settings.load]]({{type|string}} path)
|{{type|boolean}} loaded
|Loads settings from a file.}}

{{API table/row
|[[settings.save]]({{type|string}} path)
|{{type|boolean}} saved
|Saves current settings to a file.
|odd}}

}}

[[Category:APIs]]

==Notes==
* Settings are '''not''' automatically saved to a file, you have to do this [[settings.save|manually]].
* Setting's names can only be of type {{type|string}}.
* Setting's values can only be [[textutils.serialize|serializable]] types: {{type|string}}, {{type|number}}, {{type|boolean}} or {{type|table}}.

==Default Settings==
These are the default settings of a computer (as seen in CC 1.77)

<pre>
{
[ "bios.use_multishell" ] = true,
[ "shell.autocomplete" ] = true,
[ "shell.allow_disk_startup" ] = true (for all Computer types except Command Computers),
[ "shell.allow_startup" ] = true,
[ "lua.autocomplete" ] = true,
[ "list.show_hidden" ] = false,
[ "edit.autocomplete" ] = true,
}
</pre>

*'''<var>shell.autocomplete</var>''' - enables auto-completion in the [[Shell]].
*'''<var>lua.autocomplete</var>''' - enables auto-completion in the [[Lua]] program.
*'''<var>edit.autocomplete</var>''' - enables auto-completion in the [[Edit]] program.
*'''<var>bios.use_multishell</var>''' - enables [[Multishell]] on [[Advanced Computer]]s, [[Advanced Turtle|Turtles]], [[Advanced Pocket Computer|Pocket Computers]] and [[Command Computer]]s.
*'''<var>shell.allow_disk_startup</var>''' - if a [[Disk Drive]] with a [[Disk]] inside that has a 'startup' script is attached to a computer, this setting allows to automatically run that script when the computer starts.
*'''<var>shell.allow_startup</var>''' - if there is a 'startup' script in a computer's root, this setting allow to automatically run that script when the computer runs.
*'''<var>list.show_hidden</var>''' - determines, whether the [[List]] program will list hidden files or not.

==ComputerCraft.cfg==
You can change or add default settings for all computers through [[ComputerCraft.cfg]]. The format is as follows:
* each setting is separated by a comma (<var>,</var>)
* setting's name and value is separated by an equals sign (<var>=</var>)

This example will disable auto-completion features in the default programs.
<pre>
S:default_computer_settings=shell.autocomplete=false,lua.autocomplete=false,edit.autocomplete=false
</pre>

Turtle

2015-12-26T23:32:35Z

Dan200: /* Recipes */ Added some ender modem info

{{Block
|name=Turtle
|image=Grid turtle.png
|id=
|damage-value=
|is-peripheral=
}}

{{Selfref|This is for the turtle block/item. For the API, visit [[Turtle (API)]].}}

[[File:Turtles.png|thumb|Normal Turtle (left) and Advanced Turtle (right).]]

'''Turtles''' and '''Advanced Turtles''' are essentially robots, and were added in the 1.3 update. They run an OS named [[TurtleOS]], similar to [[CraftOS]] for [[Computer]]s. They have the ability to place, break and detect blocks, move around and drop items in their inventory via their access to the [[Turtle_(API)|Turtle API]]. The programs they run are stored in their internal memory, or on [[Floppy Disk|floppy disks]].

The 1.4 update was focused on turtles, and expanded their ability to use tools. Turtles are capable of using pickaxes, hoes, axes, shovels and swords. The update added "Crafty Turtles", which have the ability to craft using their inventory - and part of this upgrade saw the number of inventory slots in the Turtle raised to 16 from the previous 9 slot inventory. The 1.4 update also included a new [[fuel]] system for the turtles.

The 1.55 update added Advanced Turtles - made of gold, are able to display color, and have mouse input available through their display. Their exterior appearance is also of gold. They're just like [[Advanced Computer|Advanced Computers]], but with a smaller screen.

Prior to 1.6, turtles had to have tools manually attached via crafting. As of that update, they are now also able to swap tools in and out of their inventory at will. That build also brought in caps to the arbitrarily large fuel values turtles could previously store - by default, they are now 20,000 units for regular turtles and 100,000 for advanced.

Turtles are submersible and lavaproof. As such, they are extremely useful for mining near bedrock, where heavy [[lava]] flows can prevent access to diamonds and other rare finds.

If you would like to know more about how to program them, have a look at the [[Turtle (API)|Turtle API]].

Keep in mind that when turtles are 'mined', picked up, and placed somewhere else, they will not keep their programs unless they have been given a label. To do so, you simply need to type in "label set ''<labelName>''" at the [[TurtleOS]] prompt.

==Floppy Disks and Peripherals==
Turtles do not have a built-in [[Disk Drive]]. As such, they need a [[Disk Drive]] placed beside them to access [[Floppy Disk|Floppy Disks]]. However, if the Turtle is of the Wireless family, the [[Disk Drive]] (and other peripherals) must be placed on a side other than the side the [[Wireless Modem|wireless modem]] is on. Any other peripherals, such as [[Monitor|Monitors]] and [[Printer|Printers]] can be interacted using the peripheral API.

==Power source==
Turtles require [[fuel]] to operate - this means Turtles must be powered from any item that works in a regular furnace, like coal and lava. The turtle gains 0.6 "movement" per half second the fuel would have burnt in a furnace. The Turtle can move 1 block for each fuel count it has, for example, coal yields 80 block movements.

=== Optional Non-fuel mode ===
In this mode, Turtles use their internal Redstone Engine, and as such, they do not need to be re-charged, or receive any other form of external power. This is because Redstone continuously emits low levels of energy, and the Turtle's engine is very efficient. This mode can be turned on by editing [[ComputerCraft.cfg]] and setting <var>turtleNeedsFuel</var> to <var>false</var>.

==Dyeing==
As of ComputerCraft 1.63 Turtles can be dyed using Dyes. It supports all 16 different colors, so you can have a green Farming Turtle harvesting some melons and a gray Mining Turtle gathering materials and mining ores.

==Farming==
Turtles equipped with a [[diamond hoe]] can till dirt so it can later be used for Farming. An example of a use for this would be using it to till, plant, and harvest your wheat farm and dropping any product in a chest for you.

==Mining==
Turtles crafted with a [[diamond pickaxe]], [[diamond axe]], or [[diamond shovel]], can break blocks, chop wood, mine stone and ores, and even break dirt and gravel (depending on the tool you used on it). The tools equipped on the Turtle have no durability, and so can be used indefinitely without the need for any additional materials. When a Turtle breaks the block, the Turtle receives the item directly into it's inventory. Different tools yield different drops - for example, an axe can break anything, but it won't drop ores.

==Crafting==
Turtles with a [http://www.minecraftwiki.net/wiki/Crafting_Table Crafting Table] can craft items if they have the correct materials to do so, and all other slots outside the crafting-zone are empty.

==Melee==
Turtles equipped with a [[diamond sword]] can attack players and mobs. When a Turtle kills a mob it will leave the experience orbs on the ground, but add the loot to its inventory. Turtles can also attack with any tool, where the [[diamond axe]] is the second best after the [[diamond sword]].

==Inventory Interaction==
Turtles can interact with blocks that have inventories. This includes chests, furnaces, [[Printer]]s and even blocks with inventories in other mods. (This means a turtle cannot interact with a player's inventory, unless you use a third party peripheral). Turtles can interact with such inventories by using [[Turtle.suck|turtle.suck, turtle.suckDown, turtle.suckUp]] (To retrieve the first item in the inventory. The turtle finds the first item by scanning the first row from left to right, then the second row from left to right, etc). Turtles can also place items inside inventories, by using [[Turtle.drop|turtle.drop, turtle.dropUp, turtle.dropDown]], which places items on the first item slot available (Using the same system as the one described for retrieving items).

In special inventories, with just a few slots on the top or bottom - for example furnaces - you can specify which slot to place an item in by positioning the turtle in the corresponding location to the front face of the inventory. For example in a furnace, you would use a turtle at the bottom of the furnace for it to place fuel in the furnace, a turtle at the top to place objects to smelt, and a turtle to the right to retrieve the smelted objects (Note that you can do this with just 1 turtle moving around).

==Peripheral functions==

Just like a [[Computer]], a Turtle can be [[peripheral.wrap|used]] as a peripheral. You can find all Turtle peripheral functions [[Computer_(API)|here]].

==Recipes==

{|
|+'''Crafting ingredients'''
|-
|Turtle
|{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle |Output-link=turtle
}}
|Advanced Turtle
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Advanced_Computer |C2=Gold_Ingot
|A3=Gold_Ingot |B3=chest |C3=Gold_Ingot
|Output=Advanced_Turtle |Output-link=turtle
}}
|}

'''Note:''' NEI has been known to present the recipe for an advanced turtle as requiring a normal computer, somehow ignoring the actual recipe.

Turtles can be equipped with different peripherals and tools. A turtle can be crafted with any combination of tools and peripherals. Turtles may later use [[Turtle.equipLeft|turtle.equipLeft()]] / [[Turtle.equipRight|turtle.equipRight()]] to add, remove or exchange tools in any combination.
 The following tools can be equipped to a turtles: [[diamond pickaxe]], [[diamond axe]], [[diamond shovel]], [[diamond hoe]] and [[diamond sword]]
 The following peripherals can be equipped to a turtles: [[Wireless Modem|wireless modems]], [[Ender_Modem|ender modems]] and [[Crafting Table|crafting tables]].
 Diamond tools must be unused (i.e. not have a durability bar showing) an unenchanted to combine with a turtle.
 '''Turtle recipe and examples for equipping a turtle with tools and peripherals (Note that any variants of the turtle can also be crafted with the Advanced Turtle):'''
{| class="wikitable"
! !! None !! Crafty !! Wireless
|-
! scope="row"| None
|{{Crafting grid
|B2=turtle
|Output=turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=workbench
|Output=Crafty_Turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=Modem
|Output=wireless_turtle |Output-link=turtle
}}
|-
! scope="row"| Mining
|{{Crafting grid
|B2=turtle |C2=diamond_pickaxe
|Output=mining_turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_pickaxe
|Output=Crafty_Mining_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_pickaxe
|Output=wireless_mining_turtle |Output-link=turtle
}}
|-
! scope="row"| Farming
|{{Crafting grid
|B2=turtle |C2=diamond_hoe
|Output=Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_hoe
|Output=Crafty_Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_hoe
|Output=Wireless_Farming_Turtle |Output-link=turtle
}}
|-
! scope="row"| Melee
|{{Crafting grid
|B2=turtle |C2=diamond_sword
|Output=Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_sword
|Output=Crafty_Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_sword
|Output=Wireless_Melee_Turtle |Output-link=turtle
}}
|-
! scope="row"| Felling
|{{Crafting grid
|B2=turtle |C2=diamond_axe
|Output=Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_axe
|Output=Crafty_Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_axe
|Output=Wireless_Felling_Turtle |Output-link=turtle
}}
|-
! scope="row"| Digging
|{{Crafting grid
|B2=turtle |C2=diamond_shovel
|Output=Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_shovel
|Output=Crafty_Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_shovel
|Output=Wireless_Digging_Turtle |Output-link=turtle
}}
|-
! scope="row"| Crafty
|See Above
|N/A
|{{Crafting grid
|A2=Modem |B2=turtle |C2=workbench
|Output=Wireless_Crafty_Turtle |Output-link=turtle
}}
|}

{{BlocksItemsList}}
[[Category:Blocks]]

Turtle

2015-12-26T23:31:22Z

Dan200: /* Recipes */ Corrected falsehoods about recipe limiations

{{Block
|name=Turtle
|image=Grid turtle.png
|id=
|damage-value=
|is-peripheral=
}}

{{Selfref|This is for the turtle block/item. For the API, visit [[Turtle (API)]].}}

[[File:Turtles.png|thumb|Normal Turtle (left) and Advanced Turtle (right).]]

'''Turtles''' and '''Advanced Turtles''' are essentially robots, and were added in the 1.3 update. They run an OS named [[TurtleOS]], similar to [[CraftOS]] for [[Computer]]s. They have the ability to place, break and detect blocks, move around and drop items in their inventory via their access to the [[Turtle_(API)|Turtle API]]. The programs they run are stored in their internal memory, or on [[Floppy Disk|floppy disks]].

The 1.4 update was focused on turtles, and expanded their ability to use tools. Turtles are capable of using pickaxes, hoes, axes, shovels and swords. The update added "Crafty Turtles", which have the ability to craft using their inventory - and part of this upgrade saw the number of inventory slots in the Turtle raised to 16 from the previous 9 slot inventory. The 1.4 update also included a new [[fuel]] system for the turtles.

The 1.55 update added Advanced Turtles - made of gold, are able to display color, and have mouse input available through their display. Their exterior appearance is also of gold. They're just like [[Advanced Computer|Advanced Computers]], but with a smaller screen.

Prior to 1.6, turtles had to have tools manually attached via crafting. As of that update, they are now also able to swap tools in and out of their inventory at will. That build also brought in caps to the arbitrarily large fuel values turtles could previously store - by default, they are now 20,000 units for regular turtles and 100,000 for advanced.

Turtles are submersible and lavaproof. As such, they are extremely useful for mining near bedrock, where heavy [[lava]] flows can prevent access to diamonds and other rare finds.

If you would like to know more about how to program them, have a look at the [[Turtle (API)|Turtle API]].

Keep in mind that when turtles are 'mined', picked up, and placed somewhere else, they will not keep their programs unless they have been given a label. To do so, you simply need to type in "label set ''<labelName>''" at the [[TurtleOS]] prompt.

==Floppy Disks and Peripherals==
Turtles do not have a built-in [[Disk Drive]]. As such, they need a [[Disk Drive]] placed beside them to access [[Floppy Disk|Floppy Disks]]. However, if the Turtle is of the Wireless family, the [[Disk Drive]] (and other peripherals) must be placed on a side other than the side the [[Wireless Modem|wireless modem]] is on. Any other peripherals, such as [[Monitor|Monitors]] and [[Printer|Printers]] can be interacted using the peripheral API.

==Power source==
Turtles require [[fuel]] to operate - this means Turtles must be powered from any item that works in a regular furnace, like coal and lava. The turtle gains 0.6 "movement" per half second the fuel would have burnt in a furnace. The Turtle can move 1 block for each fuel count it has, for example, coal yields 80 block movements.

=== Optional Non-fuel mode ===
In this mode, Turtles use their internal Redstone Engine, and as such, they do not need to be re-charged, or receive any other form of external power. This is because Redstone continuously emits low levels of energy, and the Turtle's engine is very efficient. This mode can be turned on by editing [[ComputerCraft.cfg]] and setting <var>turtleNeedsFuel</var> to <var>false</var>.

==Dyeing==
As of ComputerCraft 1.63 Turtles can be dyed using Dyes. It supports all 16 different colors, so you can have a green Farming Turtle harvesting some melons and a gray Mining Turtle gathering materials and mining ores.

==Farming==
Turtles equipped with a [[diamond hoe]] can till dirt so it can later be used for Farming. An example of a use for this would be using it to till, plant, and harvest your wheat farm and dropping any product in a chest for you.

==Mining==
Turtles crafted with a [[diamond pickaxe]], [[diamond axe]], or [[diamond shovel]], can break blocks, chop wood, mine stone and ores, and even break dirt and gravel (depending on the tool you used on it). The tools equipped on the Turtle have no durability, and so can be used indefinitely without the need for any additional materials. When a Turtle breaks the block, the Turtle receives the item directly into it's inventory. Different tools yield different drops - for example, an axe can break anything, but it won't drop ores.

==Crafting==
Turtles with a [http://www.minecraftwiki.net/wiki/Crafting_Table Crafting Table] can craft items if they have the correct materials to do so, and all other slots outside the crafting-zone are empty.

==Melee==
Turtles equipped with a [[diamond sword]] can attack players and mobs. When a Turtle kills a mob it will leave the experience orbs on the ground, but add the loot to its inventory. Turtles can also attack with any tool, where the [[diamond axe]] is the second best after the [[diamond sword]].

==Inventory Interaction==
Turtles can interact with blocks that have inventories. This includes chests, furnaces, [[Printer]]s and even blocks with inventories in other mods. (This means a turtle cannot interact with a player's inventory, unless you use a third party peripheral). Turtles can interact with such inventories by using [[Turtle.suck|turtle.suck, turtle.suckDown, turtle.suckUp]] (To retrieve the first item in the inventory. The turtle finds the first item by scanning the first row from left to right, then the second row from left to right, etc). Turtles can also place items inside inventories, by using [[Turtle.drop|turtle.drop, turtle.dropUp, turtle.dropDown]], which places items on the first item slot available (Using the same system as the one described for retrieving items).

In special inventories, with just a few slots on the top or bottom - for example furnaces - you can specify which slot to place an item in by positioning the turtle in the corresponding location to the front face of the inventory. For example in a furnace, you would use a turtle at the bottom of the furnace for it to place fuel in the furnace, a turtle at the top to place objects to smelt, and a turtle to the right to retrieve the smelted objects (Note that you can do this with just 1 turtle moving around).

==Peripheral functions==

Just like a [[Computer]], a Turtle can be [[peripheral.wrap|used]] as a peripheral. You can find all Turtle peripheral functions [[Computer_(API)|here]].

==Recipes==

{|
|+'''Crafting ingredients'''
|-
|Turtle
|{{Crafting grid
|A1=iron_ingot |B1=iron_ingot |C1=iron_ingot
|A2=iron_ingot |B2=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle |Output-link=turtle
}}
|Advanced Turtle
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Advanced_Computer |C2=Gold_Ingot
|A3=Gold_Ingot |B3=chest |C3=Gold_Ingot
|Output=Advanced_Turtle |Output-link=turtle
}}
|}

'''Note:''' NEI has been known to present the recipe for an advanced turtle as requiring a normal computer, somehow ignoring the actual recipe.

Turtles can be equipped with different peripherals and tools. A turtle can be crafted with any combination of tools and peripherals. Turtles may later use [[Turtle.equipLeft|turtle.equipLeft()]] / [[Turtle.equipRight|turtle.equipRight()]] to add, remove or exchange tools in any combination.
 The following tools can be equipped to a turtles: [[diamond pickaxe]], [[diamond axe]], [[diamond shovel]], [[diamond hoe]] and [[diamond sword]]
 The following peripherals can be equipped to a turtles: [[Wireless Modem|wireless modem]] and [[Crafting Table|crafting tables]].
 Diamond tools must be unused (i.e. not have a durability bar showing) an unenchanted to combine with a turtle.
 '''Turtle recipe and examples for equipping a turtle with tools and peripherals (Note that any variants of the turtle can also be crafted with the Advanced Turtle):'''
{| class="wikitable"
! !! None !! Crafty !! Wireless
|-
! scope="row"| None
|{{Crafting grid
|B2=turtle
|Output=turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=workbench
|Output=Crafty_Turtle |Output-link=turtle
}}
|{{Crafting grid
|B2=turtle |A2=Modem
|Output=wireless_turtle |Output-link=turtle
}}
|-
! scope="row"| Mining
|{{Crafting grid
|B2=turtle |C2=diamond_pickaxe
|Output=mining_turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_pickaxe
|Output=Crafty_Mining_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_pickaxe
|Output=wireless_mining_turtle |Output-link=turtle
}}
|-
! scope="row"| Farming
|{{Crafting grid
|B2=turtle |C2=diamond_hoe
|Output=Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_hoe
|Output=Crafty_Farming_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_hoe
|Output=Wireless_Farming_Turtle |Output-link=turtle
}}
|-
! scope="row"| Melee
|{{Crafting grid
|B2=turtle |C2=diamond_sword
|Output=Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_sword
|Output=Crafty_Melee_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_sword
|Output=Wireless_Melee_Turtle |Output-link=turtle
}}
|-
! scope="row"| Felling
|{{Crafting grid
|B2=turtle |C2=diamond_axe
|Output=Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_axe
|Output=Crafty_Felling_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_axe
|Output=Wireless_Felling_Turtle |Output-link=turtle
}}
|-
! scope="row"| Digging
|{{Crafting grid
|B2=turtle |C2=diamond_shovel
|Output=Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=workbench |B2=turtle |C2=diamond_shovel
|Output=Crafty_Digging_Turtle |Output-link=turtle
}}
|{{Crafting grid
|A2=Modem |B2=turtle |C2=diamond_shovel
|Output=Wireless_Digging_Turtle |Output-link=turtle
}}
|-
! scope="row"| Crafty
|See Above
|N/A
|{{Crafting grid
|A2=Modem |B2=turtle |C2=workbench
|Output=Wireless_Crafty_Turtle |Output-link=turtle
}}
|}

{{BlocksItemsList}}
[[Category:Blocks]]

Commands.getBlockInfo

2015-12-26T23:28:07Z

Dan200:

{{lowercase}}
{{Function
|name=commands.getBlockInfo
|args={{type|number}} x, {{type|number}} y, {{type|number}} z
|returns={{type|table}} block info
|api=commands
|addon=ComputerCraft
|desc=Available only to [[Command Computer]]s, returns a table containing information on the block at the specified world co-ordinate, formatted as follows:

{
state = {{type|table}} state information
name = {{type|string}} block's name,
metadata = {{type|number}} block's metadata
}

The block inspected will be in the same dimension as the computer. This function yields until the data is available to be returned. If the queried block exists in an ungenerated chunk, this function will cause that chunk to be generated.

The "state" sub-table is only present in Minecraft 1.8+, and contains the [http://minecraft.gamepedia.com/Block_states block state] info for the block being observed. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation).

See also: [[commands.getBlockInfos]](), [http://minecraft.gamepedia.com/Data_values Data Values @ Minecraft wiki]

|examples=
{{Example
|desc=Prints the [[Command Computer]]'s internal name and metadata value.
|code=local blockInfo = '''commands.getBlockInfo( [[commands.getBlockPosition]]() )'''

[[print]]( "Computer block's name: ", blockInfo.name )
[[print]]( "Computer block's metadata: ", blockInfo.metadata )
}}
{{Example
|desc=Prints the facing of the [[Command Computer]] running the script by inspecting its own metadata.
|code=local blockInfo = '''commands.getBlockInfo( [[commands.getBlockPosition]]() )'''

[[print]]( "My facing is " .. blockInfo.state.facing )
}}
}}

{{CommandsAPIFunctions}}

[[Category:API_Functions]]

Commands.getBlockInfo

2015-12-26T23:27:54Z

Dan200:

{{lowercase}}
{{Function
|name=commands.getBlockInfo
|args={{type|number}} x, {{type|number}} y, {{type|number}} z
|returns={{type|table}} block info
|api=commands
|addon=ComputerCraft
|desc=Available only to [[Command Computer]]s, returns a table containing information on the block at the specified world co-ordinate, formatted as follows:

{
state = {{type|table}} state information
name = {{type|string}} block's name,
metadata = {{type|number}} block's metadata
}

The block inspected will be in the same dimension as the computer. This function yields until the data is available to be returned. If the queried block exists in an ungenerated chunk, this function will cause that chunk to be generated.

The "state" sub-table is only present in Minecraft 1.8+, and contains the [http://minecraft.gamepedia.com/Block_states block state] info for the block being observed. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation).

See also: [[commands.getBlockInfos]](), [http://minecraft.gamepedia.com/Data_values Data Values @ Minecraft wiki]

|examples=
{{Example
|desc=Prints the [[Command Computer]]'s internal name and metadata value.
|code=local blockInfo = '''commands.getBlockInfo( [[commands.getBlockPosition]]() )'''

[[print]]( "Computer block's name: ", blockInfo.name )
[[print]]( "Computer block's metadata: ", blockInfo.metadata )
}}
{{Example
|desc=Prints the facing of the [[Command Computer]] running the script by inspecting its own metadata.
|code=local blockInfo = '''commands.getBlockInfo( [[commands.getBlockPosition]]() )'''

[[print]]( "My facing is " .. blockInfo.metadata.facing )
}}
}}

{{CommandsAPIFunctions}}

[[Category:API_Functions]]

Commands.getBlockInfo

2015-12-26T23:27:35Z

Dan200:

{{lowercase}}
{{Function
|name=commands.getBlockInfo
|args={{type|number}} x, {{type|number}} y, {{type|number}} z
|returns={{type|table}} block info
|api=commands
|addon=ComputerCraft
|desc=Available only to [[Command Computer]]s, returns a table containing information on the block at the specified world co-ordinate, formatted as follows:

{
state = {{type|table}} state information
name = {{type|string}} block's name,
metadata = {{type|number}} block's metadata
}

The block inspected will be in the same dimension as the computer. This function yields until the data is available to be returned. If the queried block exists in an ungenerated chunk, this function will cause that chunk to be generated.

The "state" sub-table is only present in Minecraft 1.8+, and contains the [http://minecraft.gamepedia.com/Block_states block state] info for the block being observed. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation).

See also: [[commands.getBlockInfos]](), [http://minecraft.gamepedia.com/Data_values Data Values @ Minecraft wiki]

|examples=
{{Example
|desc=Prints the [[Command Computer]]'s internal name and metadata value.
|code=local blockInfo = '''commands.getBlockInfo( [[commands.getBlockPosition]]() )'''

[[print]]( "Computer block's name: ", blockInfo.name )
[[print]]( "Computer block's metadata: ", blockInfo.metadata )
}}
{{Example
|desc=Prints the facing of the [[Command Computer]] running the script by inspecting its own metadata.
|local blockInfo = '''commands.getBlockInfo( [[commands.getBlockPosition]]() )'''

[[print]]( "My facing is ", blockInfo.metadata.facing )
}}
}}

{{CommandsAPIFunctions}}

[[Category:API_Functions]]

Commands.getBlockInfo

2015-12-26T23:27:00Z

Dan200: Clarified state

{{lowercase}}
{{Function
|name=commands.getBlockInfo
|args={{type|number}} x, {{type|number}} y, {{type|number}} z
|returns={{type|table}} block info
|api=commands
|addon=ComputerCraft
|desc=Available only to [[Command Computer]]s, returns a table containing information on the block at the specified world co-ordinate, formatted as follows:

{
state = {{type|table}} state information
name = {{type|string}} block's name,
metadata = {{type|number}} block's metadata
}

The block inspected will be in the same dimension as the computer. This function yields until the data is available to be returned. If the queried block exists in an ungenerated chunk, this function will cause that chunk to be generated.

The "state" sub-table is only present in Minecraft 1.8+, and contains the [http://minecraft.gamepedia.com/Block_states block state] info for the block being observed. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation).

See also: [[commands.getBlockInfos]](), [http://minecraft.gamepedia.com/Data_values Data Values @ Minecraft wiki]

|examples=
{{Example
|desc=Prints the [[Command Computer]]'s internal name and metadata value.
|code=local blockInfo = '''commands.getBlockInfo( [[commands.getBlockPosition]]() )'''

[[print]]( "Computer block's name: ", blockInfo.name )
[[print]]( "Computer block's metadata: ", blockInfo.metadata )
}}
{{Example
|desc=Prints the facing of the [[Command Computer]] running the script by inspecting its own metadata.
|local blockInfo = '''commands.getBlockInfo( [[commands.getBlockPosition]]() )'''

[[print]]( "My facing is " .. blockInfo.metadata.facing .. "." )
}}
}}

{{CommandsAPIFunctions}}

[[Category:API_Functions]]

Commands.getBlockInfos

2015-12-26T23:25:28Z

Dan200: Clarified state

{{lowercase}}
{{Function
|name=commands.getBlockInfos
|args={{type|number}} x1, {{type|number}} y1, {{type|number}} z1, {{type|number}} x2, {{type|number}} y2, {{type|number}} z2
|returns={{type|table}} blocks info
|api=commands
|addon=ComputerCraft
|desc=Available only to [[Command Computer]]s as of ComputerCraft version 1.76, returns a numerically-indexed table containing information on the blocks within the specified world co-ordinates. Each sub-table is formatted per the output of [[commands.getBlockInfo]]():

{
state = {{type|table}} state information
name = {{type|string}} block's name,
metadata = {{type|number}} block's metadata
}

A maximum of 4096 (2^12) blocks may be inspected at a time (for example, a 16x16x16 cube); the function will error if the block count exceeds this.

The blocks are returned in the order of lowest x-co-ord to highest x-co-ord, then lowest z-co-ord to highest z-co-ord, then lowest y-co-ord to highest y-co-ord; that is to say, west to east, then north to south, then lowest altitude to highest altitude.

See also: [[commands.getBlockInfo]](), [http://minecraft.gamepedia.com/Block_states Block States @ Minecraft wiki]

|examples=
{{Example
|desc=Reports on a 2x2x2 area, with the Command Computer being at the lowest north-west point.
|code=local x, y, z = commands.getBlockPosition()

local blocks = commands.getBlockInfos(x, y, z, x + 1, y + 1, z + 1)

print("North-west low block:"..blocks[1].name)
print("North-east low block:"..blocks[2].name)
print("South-west low block:"..blocks[3].name)
print("South-east low block:"..blocks[4].name)
print("North-west high block:"..blocks[5].name)
print("North-east high block:"..blocks[6].name)
print("South-west high block:"..blocks[7].name)
print("South-east high block:"..blocks[8].name)
}}
}}

{{CommandsAPIFunctions}}

[[Category:API_Functions]]

Turtle.inspect

2015-12-26T23:24:20Z

Dan200:

{{lowercase}}
{{Function
|name=turtle.inspect
|args=
|api=turtle
|returns={{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|addon=ComputerCraft
|desc=Returns the ID string and metadata of the block in front of the Turtle in a table format: <var>{ name = "modname:blockname", metadata = 0, state = {} }</var>. 

The "state" sub-table is only present in Minecraft 1.8+, and contains [http://minecraft.gamepedia.com/Block_states block state] info for the block being inspected. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation).
|examples={{Example
|desc=If there is a block in front of the turtle, prints it's name and metadata.
|code= local success, data = '''turtle.inspect()'''

if success then
[[print]]("Block name: ", data.name)
[[print]]("Block metadata: ", data.metadata)
end
}}
|notes=
* Returns false when there is nothing (air) in front of the Turtle.
}}

==See also==
*[[turtle.inspectDown]]
*[[turtle.inspectUp]]

Turtle.inspect

2015-12-26T23:24:06Z

Dan200:

{{lowercase}}
{{Function
|name=turtle.inspect
|args=
|api=turtle
|returns={{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|addon=ComputerCraft
|desc=Returns the ID string and metadata of the block in front of the Turtle in a table format: <var>{ name = "modname:blockname", metadata = 0, state = {} }</var>. 

The "state" sub-table is only present in Minecraft 1.8+, and contains [http://minecraft.gamepedia.com/Block_states blockstate] info for the block being inspected. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation).
|examples={{Example
|desc=If there is a block in front of the turtle, prints it's name and metadata.
|code= local success, data = '''turtle.inspect()'''

if success then
[[print]]("Block name: ", data.name)
[[print]]("Block metadata: ", data.metadata)
end
}}
|notes=
* Returns false when there is nothing (air) in front of the Turtle.
}}

==See also==
*[[turtle.inspectDown]]
*[[turtle.inspectUp]]

Turtle.inspect

2015-12-26T23:23:56Z

Dan200:

{{lowercase}}
{{Function
|name=turtle.inspect
|args=
|api=turtle
|returns={{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|addon=ComputerCraft
|desc=Returns the ID string and metadata of the block in front of the Turtle in a table format: <var>{ name = "modname:blockname", metadata = 0, state = {} }</var>. 

The "state" sub-table is only present in Minecraft 1.8+, and contains [http://minecraft.gamepedia.com/Block_states blockstate]]info for the block being inspected. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation).
|examples={{Example
|desc=If there is a block in front of the turtle, prints it's name and metadata.
|code= local success, data = '''turtle.inspect()'''

if success then
[[print]]("Block name: ", data.name)
[[print]]("Block metadata: ", data.metadata)
end
}}
|notes=
* Returns false when there is nothing (air) in front of the Turtle.
}}

==See also==
*[[turtle.inspectDown]]
*[[turtle.inspectUp]]

Turtle.inspect

2015-12-26T23:23:35Z

Dan200: Clarified state

{{lowercase}}
{{Function
|name=turtle.inspect
|args=
|api=turtle
|returns={{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|addon=ComputerCraft
|desc=Returns the ID string and metadata of the block in front of the Turtle in a table format: <var>{ name = "modname:blockname", metadata = 0, state = {} }</var>. 

The "state" sub-table is only present in Minecraft 1.8+, and contains [[http://minecraft.gamepedia.com/Block_states blockstate]] info for the block being inspected. For example, a log of wood's state table contains the keys "variant" (which may be set to eg "oak"), and "axis" (which may be set to eg "y", indicating an upright orientation).
|examples={{Example
|desc=If there is a block in front of the turtle, prints it's name and metadata.
|code= local success, data = '''turtle.inspect()'''

if success then
[[print]]("Block name: ", data.name)
[[print]]("Block metadata: ", data.metadata)
end
}}
|notes=
* Returns false when there is nothing (air) in front of the Turtle.
}}

==See also==
*[[turtle.inspectDown]]
*[[turtle.inspectUp]]

Command Computer

2015-02-18T14:30:02Z

Dan200:

{{Block
|name=Command Computer
|image=Iso_Command_Computer.png
|id=ComputerCraft:command_computer
|damage-value=0
|is-peripheral=[[#Peripheral_Functions|Yes]]
}}
Introduced by ComputerCraft 1.7 (and therefore requiring MineCraft 1.7.10 or later), the Command Computer is a more powerful version of the [[Advanced Computer]], having direct access to [http://minecraft.gamepedia.com/Commands MineCraft commands]. They are therefore uncraftable, only available to op-status players via the creative inventory, and can only be directly interacted with by the same such players. For example, unlike other computers, they will not boot from an external [[Disk Drive]].

==Exclusive APIs==
*[[Commands (API)]]

==Exclusive Programs==
*[[commands]]
*[[exec]]

== Peripheral Functions ==
Supports all the methods available to a [[Computer]] or [[Turtle]].
*[[Computer (API)]]
 

{{BlocksItemsList}}
[[Category:Blocks]][[Category:Consoles]]

Commands (API)

2015-02-18T03:03:46Z

Dan200: I'd prefer the "native" table remain undocumented

Only available to the fabled [[Command Computer]] (itself only available to ops in creative mode, running CC 1.7 or later), the '''commands API''' allows your system to directly execute [http://minecraft.gamepedia.com/Commands MineCraft commands] and gather data from the results.

==API==
{{API table|commands|image=Grid_disk.png|2=

{{API table/row
|[[commands.exec]]({{type|string}} command)
|{{type|boolean}} success
|Executes the specified command, yields until the result is determined, then returns it.
|odd}}

{{API table/row
|[[commands.execAsync]]({{type|string}} command)
|{{type|number}} taskID
|Executes the specified command, but doesn't yield. Queues a [[task_complete_(event)|"task_complete"]] event after the command is executed.
|}}

{{API table/row
|[[commands.list]]()
|{{type|table}} commands
|Returns a numerically indexed table filled with strings representing acceptable commands for [[commands.exec]]() / [[commands.execAsync]]().
|odd}}

{{API table/row
|[[commands.getBlockPosition]]()
|{{type|number}} x, {{type|number}} y, {{type|number}} z
|Returns the MineCraft world co-ordinates of the computer running the command.
|}}

{{API table/row
|[[commands.getBlockInfo]]({{type|number}} x, {{type|number}} y, {{type|number}} z)
|{{type|table}} block info
|Returns a table containing info about the block at the specified world location. Keys are "name" (a string) and "metadata" (a number).
|odd}}

}}

__TOC__

==commands.<command>()/commands.async.<command>()==
Every command returned by [[commands.list]]() is available as commands.''command'' and commands.async.''command''. For example, instead of writing this:

[[commands.exec]]("say Hi")

...you can write:

commands.say("Hi")

Same with async:

[[commands.execAsync]]("say Hi")
''-- same as:''
commands.async.say("Hi")

On top of that you can pass to them multiple parameters including strings, numbers, booleans and tables. All those parameters are [[textutils.serializeJSON|serialized]] if necessary (such as tables) and concatenated into one string. All these functions will run the same command with the same parameters:

[[commands.exec]]("tellraw @p {text:'Hello!',bold:true}")

commands.tellraw("@p {text:'Hello!',bold:true}") ''-- one or more parameters may be put into one string''

commands.tellraw("@p", "{text:'Hello!',bold:true}") ''-- or you can separate them to different parameters''

commands.tellraw("@p", {text="Hello!", bold=true}) ''-- you can also pass a {{type|table}} directly to it''

The same applies for commands.async.<command>().

All the commands inside commands.<command>()/commands.async.<command>() are also case insensitive. Running commands.TellRAW( ... ) is the same as running commands.tellraw( ... ).

==Notes==
*ComputerCraft enforces a limit of 1000 commands per server tick on Command Computers. Consider [[os.pullEvent|yielding]] manually every so often (eg, sleeping for a second) when making large amounts of [[commands.execAsync]] calls.

[[Category:APIs]]

Turtle (API)

2014-09-28T16:50:47Z

Dan200:

The Turtle API is used to work with your [[Turtle|Turtles]].

===Key===
{| class="wikitable"
! Color !! Turtles that can perform this
|-
| White ||All
|-{{row-lightgreen}}
|Green || Crafty
|-{{row-lightyellow}}
| Yellow || Mining, Felling, Digging, Farming
|-{{row-lightred}}
| Red || Any tool
|}


===API===
{| class="wikitable"
! width="100px" | Return
! width="200px" | Method name
! Description
! Min version
|-{{row-lightgreen}}
|{{type|boolean}} success
|[[turtle.craft]]({{type|number}} quantity)
|Craft items using ingredients anywhere in the turtle's inventory and place results in the active slot. If a quantity is specified, it will craft only up to that many items, otherwise, it will craft as many of the items as possible.
|
|-
|{{type|boolean}} success
|[[turtle.forward]]()
|Try to move the turtle forward
|
|-
|{{type|boolean}} success
|[[turtle.back]]()
|Try to move the turtle backward
|
|-
|{{type|boolean}} success
|[[turtle.up]]()
|Try to move the turtle up
|
|-
|{{type|boolean}} success
|[[turtle.down]]()
|Try to move the turtle down
|
|-
|{{type|boolean}} success
|[[turtle.turnLeft]]()
|Turn the turtle left
|
|-
|{{type|boolean}} success
|[[turtle.turnRight]]()
|Turn the turtle right
|
|-
|{{type|boolean}} success
|[[turtle.select]]({{type|number}} slotNum)
|Make the turtle select slot <var>slotNum</var> (1 is top left, 16 (9 in 1.33 and earlier) is bottom right)
|
|-
|{{type|number}} slot
|[[turtle.getSelectedSlot]]()
|Indicates the currently selected inventory slot
| 1.6
|-
|{{type|number}} count
|[[turtle.getItemCount]]([<nowiki/>{{type|number}} slotNum])
|Counts how many items are in the currently selected slot or, if specified, <var>slotNum</var> slot
|
|-
|{{type|number}} count
|[[turtle.getItemSpace]]([<nowiki/>{{type|number}} slotNum])
|Counts how many remaining items you need to fill the stack in the currently selected slot or, if specified, <var>slotNum</var> slot
|
|-
|{{type|table}} data
|[[turtle.getItemDetail]]([<nowiki/>{{type|number}} slotNum])
|Returns the ID string, count and damage values of currently selected slot or, if specified, <var>slotNum</var> slot
|1.64
|-
|{{type|boolean}} success
|[[turtle.equipLeft]]()
|Attempts to equip an item in the current slot to the turtle's left side, switching the previously equipped item back into the inventory
|1.6
|-
|{{type|boolean}} success
|[[turtle.equipRight]]()
|Attempts to equip an item in the current slot to the turtle's right side, switching the previously equipped item back into the inventory
|1.6
|-{{row-lightred}}
|{{type|boolean}} success
|[[turtle.attack]]()
|Attacks in front of the turtle.
| 1.4
|-{{row-lightred}}
|{{type|boolean}} success
|[[turtle.attackUp]]()
|Attacks above the turtle.
| 1.4
|-{{row-lightred}}
|{{type|boolean}} success
|[[turtle.attackDown]]()
|Attacks under the turtle.
| 1.4
|-{{row-lightyellow}}
|{{type|boolean}} success
|[[turtle.dig]]()
|Breaks the block in front. With hoe: tills the dirt in front of it.
|
|-{{row-lightyellow}}
|{{type|boolean}} success
|[[turtle.digUp]]()
|Breaks the block above. With hoe: tills the dirt above it.
|
|-{{row-lightyellow}}
|{{type|boolean}} success
|[[turtle.digDown]]()
|Breaks the block below. With hoe: tills the dirt below it.
|
|-
|{{type|boolean}} success
|[[turtle.place]]([<nowiki></nowiki>{{type|string}} signText])
|Places a block of the selected slot in front. Engrave <var>signText</var> on signs if provided. Collects [[water]] or [[lava]] if the currently selected slot is an empty bucket.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.placeUp]]()
|Places a block of the selected slot above. Collects water or lava if the currently selected slot is an empty bucket.
|
|-
|{{type|boolean}} success
|[[turtle.placeDown]]()
|Places a block of the selected slot below. Collects water or lava if the currently selected slot is an empty bucket.
|
|-
|{{type|boolean}} result
|[[turtle.detect]]()
|Detects if there is a block in front. Does not detect mobs.
|
|-
|{{type|boolean}} result
|[[turtle.detectUp]]()
|Detects if there is a block above
|
|-
|{{type|boolean}} result
|[[turtle.detectDown]]()
|Detects if there is a block below
|
|-
|{{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|[[turtle.inspect]]()
|Returns the ID string and metadata of the block in front of the Turtle
|1.64
|-
|{{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|[[turtle.inspectUp]]()
|Returns the ID string and metadata of the block above the Turtle
|1.64
|-
|{{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|[[turtle.inspectDown]]()
|Returns the ID string and metadata of the block below the Turtle
|1.64
|-
|{{type|boolean}} result
|[[turtle.compare]]()
|Detects if the block in front is the same as the one in the currently selected slot
|
|-
|{{type|boolean}} result
|[[turtle.compareUp]]()
|Detects if the block above is the same as the one in the currently selected slot
|
|-
|{{type|boolean}} result
|[[turtle.compareDown]]()
|Detects if the block below is the same as the one in the currently selected slot
|
|-
|{{type|boolean}} result
|[[turtle.compareTo]]({{type|number}} slot)
|Compare the current selected slot and the given slot to see if the items are the same. Returns true if they are the same, false if not.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.drop]]([<nowiki></nowiki>{{type|number}} count])
|Drops all items in the selected slot, or specified, drops <var>count</var> 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.
|
|-
|{{type|boolean}} success
|[[turtle.drop|turtle.dropUp]]([<nowiki></nowiki>{{type|number}} count])
|Drops all items in the selected slot, or specified, drops <var>count</var> 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.
|
|-
|{{type|boolean}} success
|[[turtle.drop|turtle.dropDown]]([<nowiki></nowiki>{{type|number}} count])
|Drops all items in the selected slot, or specified, drops <var>count</var> 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.
|
|-
|{{type|boolean}} success
|[[turtle.suck]]([<nowiki></nowiki>{{type|number}} amount])
|Picks up an item stack of any number, from the ground or an inventory in front of the turtle, then places it in the selected slot. If the turtle can't pick up the item, the function returns false. <var>amount</var> parameter requires ComputerCraft 1.6 or later.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.suck|turtle.suckUp]]([<nowiki></nowiki>{{type|number}} amount])
|Picks up an item stack of any number, from the ground or an inventory above the turtle, then places it in the selected slot. If the turtle can't pick up the item, the function returns false. <var>amount</var> parameter requires ComputerCraft 1.6 or later.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.suck|turtle.suckDown]]([<nowiki></nowiki>{{type|number}} amount])
|Picks up an item stack of any number, from the ground or an inventory below the turtle, then places it in the selected slot. If the turtle can't pick up the item, the function returns false. <var>amount</var> parameter requires ComputerCraft 1.6 or later.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.refuel]]([<nowiki></nowiki>{{type|number}} 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 returns 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
|-
|{{type|number}} fuel
|[[turtle.getFuelLevel]]()
|Returns the current fuel level of the turtle, this is the number of blocks the turtle can move. If <var>turtleNeedFuel = 0</var> then it returns <var>"unlimited"</var>.
| 1.4
|-
|{{type|number}} fuel
|[[turtle.getFuelLimit]]()
|Returns the maximum amount of fuel a turtle can store - by default, 20,000 for regular turtles, 100,000 for advanced. If <var>turtleNeedFuel = 0</var> then it returns <var>"unlimited"</var>.
| 1.6
|-
|{{type|boolean}} success
|[[turtle.transferTo]]({{type|number}} slot [, {{type|number}} quantity])
|Transfers <var>quantity</var> items from the selected slot to <var>slot</var>. If <var>quantity</var> isn't specified, will attempt to transfer everything in the selected slot to <var>slot</var>.
| 1.45
|}

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

Turtle (API)

2014-09-28T16:49:57Z

Dan200:

The Turtle API is used to work with your [[Turtle|Turtles]].

===Key===
{| class="wikitable"
! Color !! Turtles that can perform this
|-
| White ||All
|-{{row-lightgreen}}
|Green || Crafty
|-{{row-lightyellow}}
| Yellow || Mining, Felling, Digging, Farming
|-{{row-lightred}}
| Red || Any tool
|}


===API===
{| class="wikitable"
! width="100px" | Return
! width="200px" | Method name
! Description
! Min version
|-{{row-lightgreen}}
|{{type|boolean}} success
|[[turtle.craft]]({{type|number}} quantity)
|Craft items using ingredients anywhere in the turtle's inventory and place results in the active slot. If a quantity is specified, it will craft only up to that many items, otherwise, it will craft as many of the items as possible.
|
|-
|{{type|boolean}} success
|[[turtle.forward]]()
|Try to move the turtle forward
|
|-
|{{type|boolean}} success
|[[turtle.back]]()
|Try to move the turtle backward
|
|-
|{{type|boolean}} success
|[[turtle.up]]()
|Try to move the turtle up
|
|-
|{{type|boolean}} success
|[[turtle.down]]()
|Try to move the turtle down
|
|-
|{{type|boolean}} success
|[[turtle.turnLeft]]()
|Turn the turtle left
|
|-
|{{type|boolean}} success
|[[turtle.turnRight]]()
|Turn the turtle right
|
|-
|{{type|boolean}} success
|[[turtle.select]]({{type|number}} slotNum)
|Make the turtle select slot <var>slotNum</var> (1 is top left, 16 (9 in 1.33 and earlier) is bottom right)
|
|-
|{{type|number}} slot
|[[turtle.getSelectedSlot]]()
|Indicates the currently selected inventory slot
| 1.6
|-
|{{type|number}} count
|[[turtle.getItemCount]]({{type|number}} slotNum)
|Counts how many items are in the currently selected slot or, if specified, <var>slotNum</var> slot
|
|-
|{{type|number}} count
|[[turtle.getItemSpace]]({{type|number}} slotNum)
|Counts how many remaining items you need to fill the stack in the currently selected slot or, if specified, <var>slotNum</var> slot
|
|-
|{{type|table}} data
|[[turtle.getItemDetail]]([<nowiki/>{{type|number}} slotNum])
|Returns the ID string, count and damage values of currently selected slot or, if specified, <var>slotNum</var> slot
|1.64
|-
|{{type|boolean}} success
|[[turtle.equipLeft]]()
|Attempts to equip an item in the current slot to the turtle's left side, switching the previously equipped item back into the inventory
|1.6
|-
|{{type|boolean}} success
|[[turtle.equipRight]]()
|Attempts to equip an item in the current slot to the turtle's right side, switching the previously equipped item back into the inventory
|1.6
|-{{row-lightred}}
|{{type|boolean}} success
|[[turtle.attack]]()
|Attacks in front of the turtle.
| 1.4
|-{{row-lightred}}
|{{type|boolean}} success
|[[turtle.attackUp]]()
|Attacks above the turtle.
| 1.4
|-{{row-lightred}}
|{{type|boolean}} success
|[[turtle.attackDown]]()
|Attacks under the turtle.
| 1.4
|-{{row-lightyellow}}
|{{type|boolean}} success
|[[turtle.dig]]()
|Breaks the block in front. With hoe: tills the dirt in front of it.
|
|-{{row-lightyellow}}
|{{type|boolean}} success
|[[turtle.digUp]]()
|Breaks the block above. With hoe: tills the dirt above it.
|
|-{{row-lightyellow}}
|{{type|boolean}} success
|[[turtle.digDown]]()
|Breaks the block below. With hoe: tills the dirt below it.
|
|-
|{{type|boolean}} success
|[[turtle.place]]([<nowiki></nowiki>{{type|string}} signText])
|Places a block of the selected slot in front. Engrave <var>signText</var> on signs if provided. Collects [[water]] or [[lava]] if the currently selected slot is an empty bucket.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.placeUp]]()
|Places a block of the selected slot above. Collects water or lava if the currently selected slot is an empty bucket.
|
|-
|{{type|boolean}} success
|[[turtle.placeDown]]()
|Places a block of the selected slot below. Collects water or lava if the currently selected slot is an empty bucket.
|
|-
|{{type|boolean}} result
|[[turtle.detect]]()
|Detects if there is a block in front. Does not detect mobs.
|
|-
|{{type|boolean}} result
|[[turtle.detectUp]]()
|Detects if there is a block above
|
|-
|{{type|boolean}} result
|[[turtle.detectDown]]()
|Detects if there is a block below
|
|-
|{{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|[[turtle.inspect]]()
|Returns the ID string and metadata of the block in front of the Turtle
|1.64
|-
|{{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|[[turtle.inspectUp]]()
|Returns the ID string and metadata of the block above the Turtle
|1.64
|-
|{{type|boolean}} success, {{type|table}} data/{{type|string}} error message
|[[turtle.inspectDown]]()
|Returns the ID string and metadata of the block below the Turtle
|1.64
|-
|{{type|boolean}} result
|[[turtle.compare]]()
|Detects if the block in front is the same as the one in the currently selected slot
|
|-
|{{type|boolean}} result
|[[turtle.compareUp]]()
|Detects if the block above is the same as the one in the currently selected slot
|
|-
|{{type|boolean}} result
|[[turtle.compareDown]]()
|Detects if the block below is the same as the one in the currently selected slot
|
|-
|{{type|boolean}} result
|[[turtle.compareTo]]({{type|number}} slot)
|Compare the current selected slot and the given slot to see if the items are the same. Returns true if they are the same, false if not.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.drop]]([<nowiki></nowiki>{{type|number}} count])
|Drops all items in the selected slot, or specified, drops <var>count</var> 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.
|
|-
|{{type|boolean}} success
|[[turtle.drop|turtle.dropUp]]([<nowiki></nowiki>{{type|number}} count])
|Drops all items in the selected slot, or specified, drops <var>count</var> 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.
|
|-
|{{type|boolean}} success
|[[turtle.drop|turtle.dropDown]]([<nowiki></nowiki>{{type|number}} count])
|Drops all items in the selected slot, or specified, drops <var>count</var> 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.
|
|-
|{{type|boolean}} success
|[[turtle.suck]]([<nowiki></nowiki>{{type|number}} amount])
|Picks up an item stack of any number, from the ground or an inventory in front of the turtle, then places it in the selected slot. If the turtle can't pick up the item, the function returns false. <var>amount</var> parameter requires ComputerCraft 1.6 or later.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.suck|turtle.suckUp]]([<nowiki></nowiki>{{type|number}} amount])
|Picks up an item stack of any number, from the ground or an inventory above the turtle, then places it in the selected slot. If the turtle can't pick up the item, the function returns false. <var>amount</var> parameter requires ComputerCraft 1.6 or later.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.suck|turtle.suckDown]]([<nowiki></nowiki>{{type|number}} amount])
|Picks up an item stack of any number, from the ground or an inventory below the turtle, then places it in the selected slot. If the turtle can't pick up the item, the function returns false. <var>amount</var> parameter requires ComputerCraft 1.6 or later.
| 1.4
|-
|{{type|boolean}} success
|[[turtle.refuel]]([<nowiki></nowiki>{{type|number}} 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 returns 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
|-
|{{type|number}} fuel
|[[turtle.getFuelLevel]]()
|Returns the current fuel level of the turtle, this is the number of blocks the turtle can move. If <var>turtleNeedFuel = 0</var> then it returns <var>"unlimited"</var>.
| 1.4
|-
|{{type|number}} fuel
|[[turtle.getFuelLimit]]()
|Returns the maximum amount of fuel a turtle can store - by default, 20,000 for regular turtles, 100,000 for advanced. If <var>turtleNeedFuel = 0</var> then it returns <var>"unlimited"</var>.
| 1.6
|-
|{{type|boolean}} success
|[[turtle.transferTo]]({{type|number}} slot [, {{type|number}} quantity])
|Transfers <var>quantity</var> items from the selected slot to <var>slot</var>. If <var>quantity</var> isn't specified, will attempt to transfer everything in the selected slot to <var>slot</var>.
| 1.45
|}

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

Paintutils.drawLine

2014-04-25T13:11:06Z

Dan200:

{{lowercase}}
{{Function
|name=paintutils.drawLine
|args={{type|number}} startX, {{type|number}} startY, {{type|number}} endX, {{type|number}} endY, {{type|number}} [[color (API)|color]]
|api=paintutils
|returns=None
|addon=ComputerCraft
|desc=Draws a line on the screen starting from ''startX'' and ''startY'' and ending at ''endX'' and ''endY'', with color ''color''. Note that the cursor will be moved and background color will be changed by this function.
|examples=
{{Example
|desc=Draws a red line from the position (1, 2) to the position (9, 10).
|code='''paintutils.drawLine(1, 2, 9, 10, [[color (API)|colors]].red)'''
}}
}}

[[Category:API_Functions]]

Paintutils.drawPixel

2014-04-25T13:10:33Z

Dan200:

{{lowercase}}
{{Function
|name=paintutils.drawPixel
|args={{type|number}} x, {{type|number}} y, {{type|number}} [[color (API)|color]]
|api=paintutils
|returns=None
|addon=ComputerCraft
|desc=Draw a pixel on the screen at ''x'' and ''y'', with color ''color''. Note that the cursor will be moved and background color will be changed by this function.
|examples=
{{Example
|desc=Draws a red pixel at the position (10, 8).
|code='''paintutils.drawPixel(10, 8, [[color (API)|colors]].red)'''
}}
}}

[[Category:API_Functions]]

Paintutils.drawPixel

2014-04-25T13:09:03Z

Dan200:

{{lowercase}}
{{Function
|name=paintutils.drawPixel
|args={{type|number}} x, {{type|number}} y, {{type|number}} [[color (API)|color]]
|api=paintutils
|returns=None
|addon=ComputerCraft
|desc=Draw a pixel on the screen at ''x'' and ''y''. If ''color'' is specified then draws the pixel using that color, otherwise uses last color set by [[term.setBackgroundColor]]. Note that it doesn't reset the background color.
|examples=
{{Example
|desc=Draws a red pixel at the position (10, 8).
|code='''paintutils.drawPixel(10, 8, [[color (API)|colors]].red)'''
}}
}}

[[Category:API_Functions]]

Paintutils.drawLine

2014-04-25T13:04:17Z

Dan200:

{{lowercase}}
{{Function
|name=paintutils.drawLine
|args={{type|number}} startX, {{type|number}} startY, {{type|number}} endX, {{type|number}} endY, {{type|number}} [[color (API)|color]]
|api=paintutils
|returns=None
|addon=ComputerCraft
|desc=Draws a line on the screen starting from ''startX'' and ''startY'' and ending at ''endX'' and ''endY''. If ''color'' is specified then uses that color, otherwise uses last color set by [[term.setBackgroundColor]].
|examples=
{{Example
|desc=Draws a red line from the position (1, 2) to the position (9, 10).
|code='''paintutils.drawLine(1, 2, 9, 10, [[color (API)|colors]].red)'''
}}
}}

[[Category:API_Functions]]

Recipes

2013-07-11T19:44:10Z

Dan200:

{| 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 |C2=Stone
|A3=Stone |B3=glass_pane |C3=Stone
|Output=Computer
}}
|-
|[[Wired Modem]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Wired_Modem
}}
|-
|[[Networking Cable]]
|{{Crafting grid
| B1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|B3=Stone
|Output=Networking_Cable
|OA=6
}}
|-
|[[Wireless Modem|Wireless Modem]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=ender_pearl |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Modem
}}
|-
|[[Wireless Modem|Wireless Modem (old recipe, changed in 1.51)]]
|{{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 |C2=Stone
|A3=Stone |B3=Redstone |C3=Stone
|Output=Disk_Drive
}}
|-
|[[Floppy Disk]]
|{{Crafting grid
|B1=Redstone
|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=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle
}}
|-
|[[Monitor]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=glass_pane |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Monitor
}}
|-
|[[Printer]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|A3=Stone |B3=Ink_Sac |C3=Stone
|Output=printer
}}
|-
|[[Advanced Computer]]
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Redstone |C2=Gold_Ingot
|A3=Gold_Ingot |B3=glass_pane |C3=Gold_Ingot
|Output=Advanced_Computer
}}
|-
|[[Advanced Monitor]]
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=glass_pane |C2=Gold_Ingot
|A3=Gold_Ingot |B3=Gold_Ingot |C3=Gold_Ingot
|Output=Advanced_Monitor |OA=4
}}
|-
|[[Advanced Turtle]] (and see [[Turtle#Recipes|Turtle recipes]])
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Advanced_Computer |C2=Gold_Ingot
|A3=Gold_Ingot |B3=chest |C3=Gold_Ingot
|Output=Advanced_Turtle
}}
|}
[[Category:Lists]]

Recipes

2013-07-11T19:43:46Z

Dan200:

{| 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 |C2=Stone
|A3=Stone |B3=glass_pane |C3=Stone
|Output=Computer
}}
|-
|[[Wired Modem]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Wired_Modem
}}
|-
|[[Networking Cable]]
|{{Crafting grid
| B1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|B3=Stone
|Output=Networking_Cable
|OA=6
}}
|-
|[[Wireless Modem|Wireless Modem]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=ender_pearl |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Modem
}}
|-
|[[Wireless Modem|Wireless Modem (old recipe, changed in 1.51)]]
|{{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 |C2=Stone
|A3=Stone |B3=Redstone |C3=Stone
|Output=Disk_Drive
}}
|-
|[[Floppy Disk]]
|{{Crafting grid
|B1=Redstone
|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=Computer |C2=iron_ingot
|A3=iron_ingot |B3=chest |C3=iron_ingot
|Output=turtle
}}
|-
|[[Monitor]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=glass_pane |C2=Stone
|A3=Stone |B3=Stone |C3=Stone
|Output=Monitor
}}
|-
|[[Printer]]
|{{Crafting grid
|A1=Stone |B1=Stone |C1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|A3=Stone |B3=Ink_Sac |C3=Stone
|Output=printer
}}
|-
|[[Advanced Computer]]
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Redstone |C2=Gold_Ingot
|A3=Gold_Ingot |B3=glass_pane |C3=Gold_Ingot
|Output=Advanced_Computer
}}
|-
|[[Advanced Monitor]]
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=glass_pane |C2=Gold_Ingot
|A3=Gold_Ingot |B3=Gold_Ingot |C3=Gold_Ingot
|Output=Advanced_Monitor |OA=4
}}
|[[Advanced Turtle]] (and see [[Turtle#Recipes|Turtle recipes]])
|{{Crafting grid
|A1=Gold_Ingot |B1=Gold_Ingot |C1=Gold_Ingot
|A2=Gold_Ingot |B2=Advanced_Computer |C2=Gold_Ingot
|A3=Gold_Ingot |B3=chest |C3=Gold_Ingot
|Output=Advanced_Turtle
}}
|}
[[Category:Lists]]

Wired Modem

2013-07-03T04:28:04Z

Dan200:

{{NeedsWork|Needs correction and more examples -alekso56)}}
:''This page is for the Modem blocks. For the modem API, see [[Modem_(API)|Modem (API)]]''
{{Block
|name=Wired Modem
|image=
|id=???
|damage-value= ???
|is-peripheral=Yes
|peripheral-api=Modem (API)
}}
Modems are blocks which can be used to transfer data between [[Computer|computers]], using the [[Rednet_(API)|Rednet API]] or the [[Modem_(API)|Modem API]].
To place a modem on a side of a computer, right-click to place the modem while sneaking.
To use the modems, you need to connect the modems to each other by placing cables.
==Recipes==

{{Crafting grid
| B1=Stone
|A2=Stone |B2=Redstone |C2=Stone
|B3=Stone
|Output=Networking_Cable
|OA=6}}
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=Redstone |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=Wired_Modem
}}

== Example (Rednet API)==
* Place 2 computers and add modems to them by clicking the right mouse button while sneaking.
* Access them, and start Lua.
* Once Lua has started, type "[[rednet_(API)|rednet]].[[rednet.open|open]] ("<relative location to modem, e.g. left, right>")" on both computers.
* Check if there exists a connection: a dim, red ring should be found around the modem, closest to the computer/peripheral it is connected to.
* Type on one computer "[[rednet_(API)|rednet]].[[rednet.receive|receive]] (60)". This will make the computer freeze for 60 seconds, or until it has received a signal from the other computer(s).
* Now, type "[[rednet_(API)|rednet]].[[rednet.broadcast|broadcast]] ('<your message>')" on the other computer. This should send your message to all computers connected.
* Opening the first computer should show the message written on the second computer.

== Example 2 (Modem and peripheral) ==
* If you want to use a modem to communicate with a peripheral you might want to take a look at the [[Peripheral_(API)#Remote_Peripherals_using_Networking_Cables|Peripheral API]]

==Modem as a Peripheral==
To use a Modem as a peripheral, you need to either call a method directly using [[peripheral.call]](), or wrap the modem using the [[Peripheral_(API)|Peripheral API]]. Wrapped modems provide all functions listed in the [[Rednet_(API)|Rednet API]].

For this example, we have a Modem connected to the top of our [[Computer]]:

-- Immediately invoke a method without wrapping
peripheral.call("top", "open")

-- You can also "wrap" the peripheral side to a variable:
local modem = peripheral.wrap("top")
modem.open("top")

{{BlocksItemsList}}

Turtle Upgrade IDs

2012-07-30T08:02:07Z

Dan200: Created page with "The following table is used to assign IDs for new types of Turtle Upgrade. When releasing a peripheral, choose an unused ID from this list, then claim it as yours by editing t..."

The following table is used to assign IDs for new types of Turtle Upgrade. When releasing a peripheral, choose an unused ID from this list, then claim it as yours by editing this page.
'''This is for about-to-be-released Turtle Upgrades only. Please don't reserve IDs for upgrades while they're still in development.'''

{| border="1" cellpadding="2" cellspacing="0|"
|-
!style="background:#EEE" width="50px"|'''ID'''
!style="background:#EEE" width="200px"|'''Turtle name'''
!style="background:#EEE" width="200px"|'''Crafting Item'''
!style="background:#EEE" width="200px"|'''Download Link'''
|-
|0
|Turtle
|No Item
|n/a
|-
|1
|Wireless Turtle
|Wireless Modem
|n/a
|-
|2
|Crafty Turtle
|Crafting Table
|n/a
|-
|3
|Melee Turtle
|Diamond Sword
|n/a
|-
|4
|Digging Turtle
|Diamond Shovel
|n/a
|-
|5
|Mining Turtle
|Diamond Pickaxe
|n/a
|-
|6
|Felling Turtle
|Diamond Axe
|n/a
|-
|7
|Farming Turtle
|Diamond Hoe
|n/a
|-
|8-63
|Reserved by ComputerCraft
|n/a
|n/a
|-
|64-255
|Available
|n/a
|n/a
|}