ComputerCraft Wiki - User contributions [en]

Turtle Upgrade IDs

2014-11-08T13:17:33Z

TheOriginalBIT: added new upcoming MoarP upgrades

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.

ComputerCraft 1.53 increased the maximum turtle upgrade ID from 255 to 32767.

'''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"|'''Author'''
!style="background:#EEE" width="200px"|'''Download Link'''
|-
|0
|Turtle
|No Item
|dan200
|n/a
|-
|1
|Wireless Turtle
|Wireless Modem
|dan200
|n/a
|-
|2
|Crafty Turtle
|Crafting Table
|dan200
|n/a
|-
|3
|Melee Turtle
|Diamond Sword
|dan200
|n/a
|-
|4
|Digging Turtle
|Diamond Shovel
|dan200
|n/a
|-
|5
|Mining Turtle
|Diamond Pickaxe
|dan200
|n/a
|-
|6
|Felling Turtle
|Diamond Axe
|dan200
|n/a
|-
|7
|Farming Turtle
|Diamond Hoe
|dan200
|n/a
|-
|8-63
|Reserved by ComputerCraft
|n/a
|n/a
|n/a
|-
|64-99
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|100
|Internet Turtle
|Webinterface
|Kilobyte/Stiepen
|[http://www.computercraft.info/forums2/index.php?/topic/3624-mc-146cc-1481-kilobytes-peripherals-formerly-known-as-ccsockets-a-shtton-of-new-stuff/ Forum Page]
|-
|101-149
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|150
|IDetecting Turtle
|Book
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|151
|Solar Turtle
|Solar Panel
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|152
|Sonar Turtle
|Jukebox
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|153
|Batch turtle
|Batch pearl
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|154
|Database turtle
|Database
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|155
|Silk Touch Mining turtle
|Silk Touch Diamond Pickaxe
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|156
|Ender Turtle
|Eye of ender
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|157
|Speaking Turtle
|Note Block
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|158
|Chunk Loading Turtle
|Chunk Loader
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|159
|??? Turtle
|???
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|160
|Fishing Turtle
|Fishing rod
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|161
|Advanced Solar Turtle
|Advanced solar panel
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|162
|Furnace Turtle
|Furnace
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|163
|Self-Destructing Turtle
|TNT
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|164
|Creative Turtle
|Bedrock
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|165
|Face Detection Turtle
|Advanced Human Face Detector
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|166
|Iron Detecting Turtle
|Iron Detector
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|167
|Poisonous Turtle
|Poison
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|168
|Robot-Arm Turtle
|Robot Arm
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|168
|Thaum Turtle
|Vis Shard
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|170
|Alchemical Turtle
|Transmutation Tablet
|Absorr
|[http://www.computercraft.info/forums2/index.php?/topic/4221-cc-13-141mc-125wip-alchemical-turtles Forum Page]
|-
|171-179
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|180
|Sensor Turtle
|Sensor Peripheral
|Cloudy
|n/a
|-
|181-199
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|200
|ARP Turtle
|Inventory Interface
|Xfel
|[http://www.computercraft.info/forums2/index.php?/topic/738-cc-13314-mc-125-smp-advanced-resource-processing-v171-peripheral-cable-v02 Forum Page]
|-
|201
|Wrench Turtle
|Wrench Tool
|ZeldoKavira/King_Lemming
|[http://thermalexpansion.wikispaces.com/ ThermalExpansion Wiki]
|-
|202-204
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|205
|Fireworks Turtle
|Electrical Fireworks Lighter
|heldplayer
|[http://www.computercraft.info/forums2/index.php?/topic/4882-mc-147-cc-1481-helds-peripherals-now-with-fireworks-turtles/ Forum Page]
|-
|206
|Hardware Accelerated Turtle
|Hardware Accelerator
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|207
|???
|???
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|208
|Scoop Turtle
|Scoop
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|209
|Grafter Turtle
|Grafter
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|210
|Speaker Turtle
|Speaker
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|211
|Ore Scanner Turtle
|OD Scanner
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|212
|Advanced Ore Scanner Turtle
|OV Scanner
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|213
|Peripheral Turtle
|Peripheral Holder
|ChickenBones
|[http://www.minecraftforum.net/topic/909223-145146-smp-chickenbones-mods/ MC Forums]
|-
|214
|MFFS Turtle
|MFFS MultiTool <Wrench>
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|215
|RTG Turtle
|RTG Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|216
|Thaum Scanner Turtle
|Goggles of Revealing
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|217
|Tank Turtle
|Tank
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|218
|Inventory Turtle
|Inventory Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|219
|REther Turtle
|REther Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|220
|Alchemist Turtle
|Minium Stone
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|221
|Wrench Turtle
|Wrench
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|222
|Treetap Turtle
|Treetap
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|223
|Gate Reader Turtle
|Gate Reader
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|224
|Note Turtle
|Iron Note Block
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|225
|Chunk Loader Turtle
|Chunk Loader
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|226
|Laser Turtle
|Mining Laser
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|227
|Feeder Turtle
|Feeding Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|228
|Resupply Turtle
|Resupply Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|229
|Solar Turtle
|Solar Panel
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|230
|Shearing Turtle
|Shears
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|231
|Compass Turtle
|Compass
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|232
|LV Solar Turtle
|LV Solar Array
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|233
|MV Solar Turtle
|MV Solar Array
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|234
|HV Solar Turtle
|HV Solar Array
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|235
|Sign Reader Turtle
|Sign
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|236
|Advanced Solar Turtle
|Advanced Solar Panel
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|237
|Hybrid Solar Turtle
|Hybrid Solar Panel
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|238
|Ultimate Hybrid Solar Turtle
|Ultimate Hybrid Solar Panel
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|239
|XP Turtle
|Enchantment Table
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|240
|Image Reading Turtle
|Painting
|coranos
|[http://www.computercraft.info/forums2/index.php?/topic/7556-cc-148-ccreadimage/ Forum Page]
|-
|241
|Chemistry Turtle
|Chemistry Upgrade
|ljdp
|[http://www.minecraftforum.net/topic/1611745-minechem-2-pr6-now-with-chemistry-turtles-7th-jan-mon/ MC Forums]
|-
|242
|Anvil Turtle
|Anvil
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|243-244
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|245
|Paintbrush Turtle
|Paintbrush
|ee_man
|[http://www.minecraftforum.net/topic/1715756-147-151forgepanicle-craft-create-play-or-draw-and-clean-up-after/ MC Forums]
|-
|246
|SignEdit Turtle
|Sign Edit Tool
|ee_man
|[http://www.minecraftforum.net/topic/1715756-147-151forgepanicle-craft-create-play-or-draw-and-clean-up-after/ MC Forums]
|-
|247-252
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|253
|Camera Turtle
|Camera (Peripheral)
|Sangar
|[http://www.computercraft.info/forums2/index.php?/topic/14428-mc-152cc-153-camera-peripheral/ Forum Page]
|-
|254
|NBT Editor Turtle
|Bottle o' Enchanting
|xuma202
|[http://www.computercraft.info/forums2/index.php?/topic/10324-cc-1481mc-147-turtle-nbt-editor-10/ Forum Page]
|-
|255
|Analytical Turtle
|Magnifying Glass
|someone9999
|[http://www.computercraft.info/forums2/index.php?/topic/5875-cc-146mc-142turtle-item-analyzer/ Forum Page]
|-
|256-259
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|260
|Chunky Turtle
|n/a
|_CR_
|[http://www.computercraft.info/forums2/index.php?/topic/18156-mc-16-cc-158-163-turtle-chunkloaders-crmod/ Forum Page]
|-
|261
|Miny Chunky Turtle
|n/a
|_CR_
|[http://www.computercraft.info/forums2/index.php?/topic/18156-mc-16-cc-158-163-turtle-chunkloaders-crmod/ Forum Page]
|-
|260-16383
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|16384
|Chatty Turtle
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=ChatBox ChatBox]
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16385
|Noisy Turtle
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Iron_Note_Block Iron Note]
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16386
|Informed Turtle
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Item_Dictionary Item Dictionary]
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16387
|Dizzy Turtle
|Compass
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16388
|Shearing Turtle
|Shears
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16389
|Fiery Turtle
|Furnace
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16390
|Outdoorsy Turtle
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Solar Panel]
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16391
|Pyromaniac Turtle
|Flint and Steel
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16392-26709
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|26710
|Tool Builder Turtle
|Tool Station
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|26711
|Fireworks Turtle
|Firework Launcher
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|26712
|Energy Meter Turtle
|Energy Meter
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|26713
|Chest Turtle
|Chest
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|26714-32767
| style="color: green" |Available
|n/a
|n/a
|n/a
|}

[[Category:Lists]]

Turtle Upgrade IDs

2014-10-12T14:59:06Z

TheOriginalBIT: added IDs used by MoarPeripherals

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.

ComputerCraft 1.53 increased the maximum turtle upgrade ID from 255 to 32767.

'''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"|'''Author'''
!style="background:#EEE" width="200px"|'''Download Link'''
|-
|0
|Turtle
|No Item
|dan200
|n/a
|-
|1
|Wireless Turtle
|Wireless Modem
|dan200
|n/a
|-
|2
|Crafty Turtle
|Crafting Table
|dan200
|n/a
|-
|3
|Melee Turtle
|Diamond Sword
|dan200
|n/a
|-
|4
|Digging Turtle
|Diamond Shovel
|dan200
|n/a
|-
|5
|Mining Turtle
|Diamond Pickaxe
|dan200
|n/a
|-
|6
|Felling Turtle
|Diamond Axe
|dan200
|n/a
|-
|7
|Farming Turtle
|Diamond Hoe
|dan200
|n/a
|-
|8-63
|Reserved by ComputerCraft
|n/a
|n/a
|n/a
|-
|64-99
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|100
|Internet Turtle
|Webinterface
|Kilobyte/Stiepen
|[http://www.computercraft.info/forums2/index.php?/topic/3624-mc-146cc-1481-kilobytes-peripherals-formerly-known-as-ccsockets-a-shtton-of-new-stuff/ Forum Page]
|-
|101-149
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|150
|IDetecting Turtle
|Book
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|151
|Solar Turtle
|Solar Panel
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|152
|Sonar Turtle
|Jukebox
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|153
|Batch turtle
|Batch pearl
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|154
|Database turtle
|Database
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|155
|Silk Touch Mining turtle
|Silk Touch Diamond Pickaxe
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|156
|Ender Turtle
|Eye of ender
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|157
|Speaking Turtle
|Note Block
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|158
|Chunk Loading Turtle
|Chunk Loader
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|159
|??? Turtle
|???
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|160
|Fishing Turtle
|Fishing rod
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|161
|Advanced Solar Turtle
|Advanced solar panel
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|162
|Furnace Turtle
|Furnace
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|163
|Self-Destructing Turtle
|TNT
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|164
|Creative Turtle
|Bedrock
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|165
|Face Detection Turtle
|Advanced Human Face Detector
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|166
|Iron Detecting Turtle
|Iron Detector
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|167
|Poisonous Turtle
|Poison
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|168
|Robot-Arm Turtle
|Robot Arm
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|168
|Thaum Turtle
|Vis Shard
|Hackingroelz
|[http://www.computercraft.info/forums2/index.php?/topic/2942-cc-14-mc-125-idetector-know-what-your-mining Forum Page]
|-
|170
|Alchemical Turtle
|Transmutation Tablet
|Absorr
|[http://www.computercraft.info/forums2/index.php?/topic/4221-cc-13-141mc-125wip-alchemical-turtles Forum Page]
|-
|171-179
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|180
|Sensor Turtle
|Sensor Peripheral
|Cloudy
|n/a
|-
|181-199
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|200
|ARP Turtle
|Inventory Interface
|Xfel
|[http://www.computercraft.info/forums2/index.php?/topic/738-cc-13314-mc-125-smp-advanced-resource-processing-v171-peripheral-cable-v02 Forum Page]
|-
|201
|Wrench Turtle
|Wrench Tool
|ZeldoKavira/King_Lemming
|[http://thermalexpansion.wikispaces.com/ ThermalExpansion Wiki]
|-
|202-204
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|205
|Fireworks Turtle
|Electrical Fireworks Lighter
|heldplayer
|[http://www.computercraft.info/forums2/index.php?/topic/4882-mc-147-cc-1481-helds-peripherals-now-with-fireworks-turtles/ Forum Page]
|-
|206
|Hardware Accelerated Turtle
|Hardware Accelerator
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|207
|???
|???
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|208
|Scoop Turtle
|Scoop
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|209
|Grafter Turtle
|Grafter
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|210
|Speaker Turtle
|Speaker
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|211
|Ore Scanner Turtle
|OD Scanner
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|212
|Advanced Ore Scanner Turtle
|OV Scanner
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|213
|Peripheral Turtle
|Peripheral Holder
|ChickenBones
|[http://www.minecraftforum.net/topic/909223-145146-smp-chickenbones-mods/ MC Forums]
|-
|214
|MFFS Turtle
|MFFS MultiTool <Wrench>
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|215
|RTG Turtle
|RTG Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|216
|Thaum Scanner Turtle
|Goggles of Revealing
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|217
|Tank Turtle
|Tank
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|218
|Inventory Turtle
|Inventory Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|219
|REther Turtle
|REther Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|220
|Alchemist Turtle
|Minium Stone
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|221
|Wrench Turtle
|Wrench
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|222
|Treetap Turtle
|Treetap
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|223
|Gate Reader Turtle
|Gate Reader
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|224
|Note Turtle
|Iron Note Block
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|225
|Chunk Loader Turtle
|Chunk Loader
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|226
|Laser Turtle
|Mining Laser
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|227
|Feeder Turtle
|Feeding Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|228
|Resupply Turtle
|Resupply Module
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|229
|Solar Turtle
|Solar Panel
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|230
|Shearing Turtle
|Shears
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|231
|Compass Turtle
|Compass
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|232
|LV Solar Turtle
|LV Solar Array
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|233
|MV Solar Turtle
|MV Solar Array
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|234
|HV Solar Turtle
|HV Solar Array
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|235
|Sign Reader Turtle
|Sign
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|236
|Advanced Solar Turtle
|Advanced Solar Panel
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|237
|Hybrid Solar Turtle
|Hybrid Solar Panel
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|238
|Ultimate Hybrid Solar Turtle
|Ultimate Hybrid Solar Panel
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|239
|XP Turtle
|Enchantment Table
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|240
|Image Reading Turtle
|Painting
|coranos
|[http://www.computercraft.info/forums2/index.php?/topic/7556-cc-148-ccreadimage/ Forum Page]
|-
|241
|Chemistry Turtle
|Chemistry Upgrade
|ljdp
|[http://www.minecraftforum.net/topic/1611745-minechem-2-pr6-now-with-chemistry-turtles-7th-jan-mon/ MC Forums]
|-
|242
|Anvil Turtle
|Anvil
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|243-244
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|245
|Paintbrush Turtle
|Paintbrush
|ee_man
|[http://www.minecraftforum.net/topic/1715756-147-151forgepanicle-craft-create-play-or-draw-and-clean-up-after/ MC Forums]
|-
|246
|SignEdit Turtle
|Sign Edit Tool
|ee_man
|[http://www.minecraftforum.net/topic/1715756-147-151forgepanicle-craft-create-play-or-draw-and-clean-up-after/ MC Forums]
|-
|247-252
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|253
|Camera Turtle
|Camera (Peripheral)
|Sangar
|[http://www.computercraft.info/forums2/index.php?/topic/14428-mc-152cc-153-camera-peripheral/ Forum Page]
|-
|254
|NBT Editor Turtle
|Bottle o' Enchanting
|xuma202
|[http://www.computercraft.info/forums2/index.php?/topic/10324-cc-1481mc-147-turtle-nbt-editor-10/ Forum Page]
|-
|255
|Analytical Turtle
|Magnifying Glass
|someone9999
|[http://www.computercraft.info/forums2/index.php?/topic/5875-cc-146mc-142turtle-item-analyzer/ Forum Page]
|-
|256-259
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|260
|Chunky Turtle
|n/a
|_CR_
|[http://www.computercraft.info/forums2/index.php?/topic/18156-mc-16-cc-158-163-turtle-chunkloaders-crmod/ Forum Page]
|-
|261
|Miny Chunky Turtle
|n/a
|_CR_
|[http://www.computercraft.info/forums2/index.php?/topic/18156-mc-16-cc-158-163-turtle-chunkloaders-crmod/ Forum Page]
|-
|260-16383
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|16384
|Chatty Turtle
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=ChatBox ChatBox]
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16385
|Noisy Turtle
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Iron_Note_Block Iron Note]
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16386
|Informed Turtle
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Item_Dictionary Item Dictionary]
|theoriginalbit
|[http://wiki.theoriginalbit.com/moarperipherals/index.php?title=Main_Page Wiki]
|-
|16387-26709
| style="color: green" |Available
|n/a
|n/a
|n/a
|-
|26710
|Tool Builder Turtle
|Tool Station
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|26711
|Fireworks Turtle
|Firework Launcher
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|26712
|Energy Meter Turtle
|Energy Meter
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|26713
|Chest Turtle
|Chest
|RichardG867
|[http://www.computercraft.info/forums2/index.php?/topic/4587-cc142mc132-miscperipherals-10/ Forum Page]
|-
|26714-32767
| style="color: green" |Available
|n/a
|n/a
|n/a
|}

[[Category:Lists]]

Peripheral (event)

2014-03-25T11:19:53Z

TheOriginalBIT: slight wording tweak

{{Event
|name=peripheral
|desc=Fired when a peripheral is connected to the computer locally or remotely (over Network Cables).
|return1=A [[String_(type)|string]] of the side/name of the connected peripheral.
}}
{{Example
|desc=Prints the type of peripheral and the side of the peripheral when attached
|code=
while true do
local event, side = os.pullEvent("peripheral")
print("A "..peripheral.getType(side).." has been attached on the "..side)
end
}}
{{Example
|desc=Prints if a modem is attached to the computer.
|code=
while true do
local event, side = os.pullEvent("peripheral")
if peripheral.getType(side) == "modem" then
print("A modem has been attached!")
end
end
}}

Peripheral detach (event)

2014-03-25T11:18:51Z

TheOriginalBIT: updated to match peripheral event page

{{Event
|name=peripheral_detach
|desc=Fired when a peripheral is disconnected from the computer locally or remotely (over Network Cables).
|return1=The [[String_(type)|string]] of the side/name of the now disconnected peripheral.
}}

{{Example
|desc=Prints the side/name of a peripheral when it's disconnected
|code=
while true do
local event, side = os.pullEvent("peripheral_detach")
print("The peripheral ", side, " has been disconnected")
end
}}

Colors (API)

2014-03-25T06:59:09Z

TheOriginalBIT: Colors section cleanup

The Colors API allows you to manipulate sets of colors. This is useful in conjunction with Bundled Cables from the RedPower mod, RedNet Cables from the MineFactory Reloaded mod, and colors on [[Advanced Computer|Advanced Computers]] and [[Advanced Monitor|Advanced Monitors]].

For the non-American English version just replace 'colors' with 'colours' and it will use the other API, colours—which is exactly the same, except in non-American English (e.g. gray is spelt grey and lightGray is spelt lightGrey).

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

{{API table/row|[[colors.combine]]({{Type|number}} color1, {{Type|number}} color2, ...)|{{type|number}} value|
Combines one or more colors (or sets of colors) into a larger set.
|odd}}

{{API table/row|[[colors.subtract]]({{Type|number}} colors, {{Type|number}} color1, {{Type|number}} color2, ...)|{{type|number}} value|
Removes one or more colors (or sets of colors) from an initial set.
|}}

{{API table/row|[[colors.test]]({{type|number}} colors, {{type|number}} color)|{{type|boolean}} contained|
Tests whether ''color'' is contained within '''colors'''.
|odd}}

}}

'''Note:''' The standard addition (+) and subtraction (-) operators while able to be used on colors instead of colors.combine and colors.subtract should be avoided due to the nature of the colour format. For example<pre>print(colors.white + colors.white)</pre>will output 2 which is orange as opposed to<pre>print(colors.combine(colors.white, colors.white))</pre>will output 1 which is white.

Furthermore, the [[Bit (API)]] may be used on sets of colors. For example,
<pre>
bCableLeft = rs.getBundledInput("left")
bCableRight = rs.getBundledInput("right")

-- Get a number representing colors on in both right and left bundled cables
commonColors = bit.band(bCableLeft, bCableRight)

-- Get all the colors active on either right or left
totalColors = bit.bor(bCableLeft, bCableRight)

-- Get the colors which are active on right, or left, but not both at the same time
exclusiveColors = bit.bxor(bCableLeft, bCableRight)

-- Get the colors that are not active on the left
offColorsA = bit.bnot(bCableLeft)
</pre>

==Colors==
The following table includes; the variable name to use in ComputerCraft programs, the decimal, hexadecimal, and binary values of the color, the number used in the 'paint' programs save files, and the actual color used to display in the ComputerCraft mod (provided in web hexadecimal format).

{| class="wikitable" style="text-align:right;"
! Color
! Decimal
! Hexadecimal
! Binary
! Paint
! Display
|-
| colors.white
| 1
| 0x1
| 0000000000000001
| 0
| #F0F0F0
|-
| colors.orange
| 2
| 0x2
| 0000000000000010
| 1
| #F2B233
|-
| colors.magenta
| 4
| 0x4
| 0000000000000100
| 2
| #E57FD8
|-
| colors.lightBlue
| 8
| 0x8
| 0000000000001000
| 3
| #99B2F2
|-
| colors.yellow
| 16
| 0x10
| 0000000000010000
| 4
| #DEDE6C
|-
| colors.lime
| 32
| 0x20
| 0000000000100000
| 5
| #7FCC19
|-
| colors.pink
| 64
| 0x40
| 0000000001000000
| 6
| #F2B2CC
|-
| colors.gray
| 128
| 0x80
| 0000000010000000
| 7
| #4C4C4C
|-
| colors.lightGray
| 256
| 0x100
| 0000000100000000
| 8
| #999999
|-
| colors.cyan
| 512
| 0x200
| 0000001000000000
| 9
| #4C9962
|-
| colors.purple
| 1024
| 0x400
| 0000010000000000
| a
| #B266E5
|-
| colors.blue
| 2048
| 0x800
| 0000100000000000
| b
| #253192
|-
| colors.brown
| 4096
| 0x1000
| 0001000000000000
| c
| #7F664C
|-
| colors.green
| 8192
| 0x2000
| 0010000000000000
| d
| #57A64
|-
| colors.red
| 16384
| 0x4000
| 0100000000000000
| e
| #CC4C4C
|-
| colors.black
| 32768
| 0x8000
| 1000000000000000
| f
| #191919 (text)<br/>#000000 (background)
|}
[[Category:APIs]]

Term.isColor

2013-12-02T18:30:19Z

TheOriginalBIT: whoops, no one saw this :P

{{lowercase}}
{{Function
|name=term.isColor
|returns=[[boolean_(type)|boolean]] returns true if it's an advanced computer.
|api=term
|addon=ComputerCraft
|desc=Returns true if it's an advanced computer.
|examples=
{{Example
|desc=This program verifies if the computer can display colors.<br />Outputting information in each possible case
|code=
-- first check if the term.isColor function exists
if not term.isColor then
print("This is a pre ComputerCraft 1.45 computer, there are only normal computers! Text is always white and the background is always black")

-- next check if the computer is an advanced computer
elseif term.isColor() then
print("This is an advanced computer, go crazy with the colours!")

-- all checks failed, meaning that it is a normal computer
else
print("This is a normal computer. The text and background colour can be changed between black and white, but no colours!")
end
}}
}}

[[Category:API_Functions]]

Term.isColor

2013-12-02T18:29:42Z

TheOriginalBIT: much, much, MUCH, better code example!

Mouse click (event)

2013-11-20T01:50:08Z

TheOriginalBIT: better code example, also better coding habits

{{Event
|name=mouse_click
|desc=Fired when the terminal is clicked.
|return1=The mouse button that was clicked.
|return2=The X-coordinate of the click (in screen-characters).
|return3=The Y-coordinate of the click (in screen-characters).
|examples=
{{Example
|desc=Print the button and the co-ordinates of every mouse click we receive a ''mouse_click'' event.
|code=
while true do
local event, button, xPos, yPos = [[os.pullEvent]]("[[mouse_click_(event)|mouse_click]]")
[[print]]("Mouse button clicked: ", button, " => Click Position X: ", xPos, " => Click Position Y: ", yPos)
end
|output=The button that was pressed, followed by the X and Y position of the event.
}}
}}

Bit (API)

2013-11-20T01:46:28Z

TheOriginalBIT: what?! when did that get changed?!

The Bit API is for manipulating numbers using bitwise binary operations.

All of these functions treat the numbers as 32-bit integers, and will raise an error if an input number is greater than 4,294,967,295.

{{API table|Bit|image=Grid disk.png|2=

{{API table/row
|[[bit.blshift]]({{type|number}} n, {{type|number}} bits)|{{type|number}} value
|Shifts a number left by a specified number of bits.
|odd}}

{{API table/row
|[[bit.brshift]]({{type|number}} n, {{type|number}} bits)|{{type|number}} value
|Shifts a number right arithmetically by a specified number of bits.
|}}

{{API table/row
|[[bit.blogic_rshift]]({{type|number}} n, {{type|number}} bits)|{{type|number}} value
|Shifts a number right logically by a specified number of bits.
|odd}}

{{API table/row
|[[bit.bxor]]({{type|number}} m, {{type|number}} n)|{{type|number}} value
|Computes the bitwise exclusive OR of two numbers.
|}}

{{API table/row
|[[bit.bor]]({{type|number}} m, {{type|number}} n)|{{type|number}} value
|Computes the bitwise inclusive OR of two numbers.
|odd}}

{{API table/row
|[[bit.band]]({{type|number}} m, {{type|number}} n)|{{type|number}} value
|Computes the bitwise AND of two numbers.
|}}

{{API table/row
|[[bit.bnot]]({{type|number}} n)|{{type|number}} value
|Computes the bitwise NOT of a numbers.
|odd}}

}}

= Deprecated Functions =
{{Deprecated
|plural=yes
|type=These functions
}}

{{API table|Bit|image=Grid disk.png|2=

{{API table/row
|[[bit.tobits]]({{type|number}} n)|{{type|table}} bit_tbl
|Converts a number to an array (numerically-indexed table) containing the corresponding binary bit values.
|odd}}

{{API table/row
|[[bit.tonumb]]({{type|table}} bit_tbl)|{{type|number}} value
|Converts an array (numerically-indexed table) of 0 and 1 values representing a number in binary into that number.
|odd}}

}}

[[Category:APIs]]

Colors (API)

2013-11-06T20:30:13Z

TheOriginalBIT: Fixing incorrect information telling people to use +/- instead of combine/subtract

The Colors API allows you to manipulate sets of colors. This is useful in conjunction with Bundled Cables from the RedPower mod, RedNet Cables from the MineFactory Reloaded mod, and colors on [[Advanced Computer|Advanced Computers]] and [[Advanced Monitor|Advanced Monitors]].

For the non-American English version just replace 'colors' with 'colours' and it will use the other API, colours—which is exactly the same, except in non-American English (e.g. gray is spelt grey and lightGray is spelt lightGrey).

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

{{API table/row|[[colors.combine]]({{Type|number}} color1, {{Type|number}} color2, ...)|{{type|number}} value|
Combines a one or more colors (or sets of colors) into a larger set.
|odd}}

{{API table/row|[[colors.subtract]]({{Type|number}} colors, {{Type|number}} color1, {{Type|number}} color2, ...)|{{type|number}} value|
Removes one or more colors (or sets of colors) from an initial set.
|}}

{{API table/row|[[colors.test]]({{type|number}} colors, {{type|number}} color)|{{type|boolean}} contained|
Tests whether ''color'' is contained within '''colors'''.
|odd}}

}}

'''Note:''' The standard addition (+) and subtraction (-) operators while able to be used on colors instead of colors.combine and colors.subtract should be avoided due to the nature of the colour format. For example<pre>print(colors.white + colors.white)</pre>will output 2 which is orange as opposed to<pre>print(colors.combine(colors.white, colors.white))</pre>will output 1 which is white.

Furthermore, the [[Bit (API)]] may be used on sets of colors. For example,
<pre>
bCableLeft = rs.getBundledInput("left")
bCableRight = rs.getBundledInput("right")

-- Get a number representing colors on in both right and left bundled cables
commonColors = bit.band(bCableLeft, bCableRight)

-- Get all the colors active on either right or left
totalColors = bit.bor(bCableLeft, bCableRight)

-- Get the colors which are active on right, or left, but not both at the same time
exclusiveColors = bit.bxor(bCableLeft, bCableRight)

-- Get the colors that are not active on the left
offColorsA = bit.bnot(bCableLeft)
</pre>

==Colors==
Color constants include, in ascending bit order:

{| class="wikitable" width="200px"
! Color
! Decimal
! Hexadecimal
! Binary
|-
| colors.white
| align="right" | 1
| align="right" | 0x1
| align="right" | 0000000000000001
|-
| colors.orange
| align="right" | 2
| align="right" | 0x2
| align="right" | 0000000000000010
|-
| colors.magenta
| align="right" | 4
| align="right" | 0x4
| align="right" | 0000000000000100
|-
| colors.lightBlue
| align="right" | 8
| align="right" | 0x8
| align="right" | 0000000000001000
|-
| colors.yellow
| align="right" | 16
| align="right" | 0x10
| align="right" | 0000000000010000
|-
| colors.lime
| align="right" | 32
| align="right" | 0x20
| align="right" | 0000000000100000
|-
| colors.pink
| align="right" | 64
| align="right" | 0x40
| align="right" | 0000000001000000
|-
| colors.gray
| align="right" | 128
| align="right" | 0x80
| align="right" | 0000000010000000
|-
| colors.lightGray
| align="right" | 256
| align="right" | 0x100
| align="right" | 0000000100000000
|-
| colors.cyan
| align="right" | 512
| align="right" | 0x200
| align="right" | 0000001000000000
|-
| colors.purple
| align="right" | 1024
| align="right" | 0x400
| align="right" | 0000010000000000
|-
| colors.blue
| align="right" | 2048
| align="right" | 0x800
| align="right" | 0000100000000000
|-
| colors.brown
| align="right" | 4096
| align="right" | 0x1000
| align="right" | 0001000000000000
|-
| colors.green
| align="right" | 8192
| align="right" | 0x2000
| align="right" | 0010000000000000
|-
| colors.red
| align="right" | 16384
| align="right" | 0x4000
| align="right" | 0100000000000000
|-
| colors.black
| align="right" | 32768
| align="right" | 0x8000
| align="right" | 1000000000000000
|}
[[Category:APIs]]

Turtle.refuel

2013-11-06T19:04:02Z

TheOriginalBIT: better code examples

{{lowercase}}
{{Function
|name=turtle.refuel
|args={{type|number}} fuel item consume quantity
|api=turtle
|returns={{type|boolean}} true if fuel, else false.
|addon=ComputerCraft
|desc=If the current selected slot contains a fuel item, it will consume it to give the turtle the ability to move. If the current slot doesn't contain a fuel item, it returns false. If a quantity is specified, it will refuel only up to that many items (if 32 is specified and 16 is present only 16 will be consumed), otherwise, it will consume all the items in the slot.
|examples=
{{Example
|desc=Checks if the item in the current slot can be used as fuel without consuming it
|code=local valid = turtle.refuel(0)
print(valid)
|output=If the current slot is valid fuel
}}
{{Example
|desc=Consumes only 4 items in the current slot if the item is a valid fuel
|code=local success = turtle.refuel(4)
print(success)
|output=whether it successfully refuelled
}}
{{Example
|desc=Loops through the turtle's inventory checking if the item is valid fuel and then consuming half of the stack when it is
|code=for i = 1, 16 do -- loop through the slots
turtle.select(i) -- change to the slot
if turtle.refuel(0) then -- if it's valid fuel
local halfStack = math.ceil(turtle.getItemCount(i)/2) -- work out half of the amount of fuel in the slot
turtle.refuel(halfStack) -- consume half the stack as fuel
end
end
}}
}}

== Fuel Values ==
Fuel values for different items.

{| class="wikitable sortable"
! Item
! Movement gained
! Added by
|-
| Biofuel Can
| 520
| IndustrialCraft
|-
| Scrap
| 15
| IndustrialCraft
|-
| Coalfuel Can
| 1520
| IndustrialCraft
|-
| Wooden Scaffolding
| 15
| IndustrialCraft
|-
| Peat
| 80
| Forestry
|-
| Sugar Cane
| 0
| Vanilla
|-
| Wooden Tools
| 10
| Vanilla
|-
| Lava
| 1000
| Vanilla
|-
| Blaze Rod
| 120
| Vanilla
|-
| Wood Blocks
| 15
| Vanilla
|-
| Sticks
| 5
| Vanilla
|-
| Coal/Charcoal
| 80
| Vanilla
|-
| Mushroom Blocks
| 15
| Vanilla
|-
| Coal Coke
| 320
| Railcraft
|}

1.41:

The formula for calculating the movement gain from a fuel is "((fuel / 100) * 6)".
Where fuel is the items burn time in ticks in a regular furnace and "/" is integer division.

1.42+:

Formula changed to ((fuel * 6) / 100).
This will give more accurate movement values.

1.48:

Formula changed to ((fuel * 5) / 100)
== Trivia ==

[[Category:Lua_Core_Functions]]

Os.clock

2013-11-06T08:31:36Z

TheOriginalBIT: Better coding habits and better example

{{lowercase}}
{{Function
|name=os.clock
|returns={{type|number}}, amount of time the computercraft computer has been running, in seconds.
|api=OS
|addon=ComputerCraft
|desc=Returns the amount of time the Computer has been running, note that this may not be the amount of time the program has been running. the function os.clock() is useful for debugging, see the example.
|examples=
{{Example
|desc=Measure how long a task takes to complete
|code=local function consumeTime()
sleep(4)
end

local startTime = os.clock() -- before we do anything
consumeTime() -- perform the action you wish to time
local endTime = os.clock() -- we now get the time again
local difference = endTime - startTime -- the time it took is the end minus the start
print("Took "..difference)
|output=Time it took to run the tasks, in this case 4 seconds
}}
}}

[[Category:Lua_Core_Functions]]

Turtle.forward

2013-11-04T06:38:14Z

TheOriginalBIT: That code example hurt my eyes.... its now fixed, also made sure better coding habits promoted as well as removing code that was taking attention away from the function at hand

{{Function
|name=turtle.forward
|api=turtle
|returns=[[boolean_(type)|boolean]] whether the turtle succeeded in moving forward
|addon=ComputerCraft
|desc=Attempts to move the turtle forward.
|examples=
{{Example
|desc=Tries to move the turtle forward and outputs whether it worked or not.
|code=if turtle.forward() then
[[print]] ("Turtle moved forward.")
else
[[print]] ("Turtle didn't move forward.")
end
|output= Turtle moved forward. or Turtle didn't move forward.
}}
{{Example
|desc=Tries to move the turtle forward a number of times. The times to move forward is specified by the user.
|code=local distance = ... -- gets the first argument from the user
if distance ~= nil then
distance = [[tonumber]] (distance) -- make it a number
for i = 1, distance do
turtle.forward()
end
else
[[print]] ("Did not specify distance.")
end
|output= Either the turtle moving the specified amount of times or missing parameter.
}}
{{Example
|desc=Digs until the turtle can move forward.
|code=while not turtle.forward() do
[[turtle.dig]]()
end
|output= The turtle moves forward.
}}
}}

[[Category:Lua_Core_Functions]]

Peripheral (event)

2013-10-28T10:08:55Z

TheOriginalBIT: better coding habits

{{Event
|name=peripheral
|desc=Fired when a peripheral is connected to the computer locally or remotely (over Network Cables).
|return1=The [[String_(type)|string]] value of the side of the connected peripheral.
}}
{{Example
|desc=Prints the type of peripheral and the side of the peripheral when attached
|code=
while true do
local event, side = os.pullEvent("peripheral")
print("A "..peripheral.getType(side).." has been attached on the "..side)
end
}}
{{Example
|desc=Prints if a modem is attached to the computer.
|code=
while true do
local event, side = os.pullEvent("peripheral")
if peripheral.getType(side) == "modem" then
print("A modem has been attached!")
end
end
}}

Disk eject (event)

2013-10-28T10:06:32Z

TheOriginalBIT: links, cleanup and better coding habits

{{Event
|name=disk_eject
|desc=Fired when a [[Floppy Disk]] is removed into any [[Disk Drive]] connected to the computer locally or remotely (over Network Cables).
|return1=The [[String_(type)|String]] value of the side/name of the [[Disk Drive]].
}}
{{Example
|desc=Notifies the user when a disk is removed from a connected disk drive
|code=while true do
local event, side = os.pullEvent()
if event == "disk_eject" then
print("Disk was removed from: "..side)
end
end
}}

Disk (event)

2013-10-28T10:06:20Z

TheOriginalBIT: added links and some cleanup

{{Event
|name=disk
|desc=Fired when a [[Floppy Disk]] is inserted into any [[Disk Drive]] connected to the computer locally or remotely (over Network Cables).
|return1=The [[String_(type)|String]] value of the side/name of the [[Disk Drive]].
}}
{{Example
|desc=Print a message when a disk is inserted into a connected disk drive.
|code=
while true do
local event, side = os.pullEvent()
if event == "disk" then
print("Disk was inserted: "..side)
end
end
}}

Disk (event)

2013-10-28T09:59:01Z

TheOriginalBIT: Slightly better description updated for network cables, also better coding habits

{{Event
|name=disk
|desc=Fired when a disk is inserted into any disk drive connected to the computer locally or remotely (over peripheral cables).
|return1=The [[String_(type)|String]] value of the side/name of the disk drive.
}}
{{Example
|desc=Print a message when a disk is inserted into a connected disk drive.
|code=
while true do
local event, side = os.pullEvent("disk")
if event == "disk" then
print("Disk has been inserted")
end
end
|output=Notification once the disk has been inserted.
}}

Terminate (event)

2013-10-28T09:48:24Z

TheOriginalBIT: Less confusing example for newbies. Also removed the comment that was implying to override os.pullEvent if you wish to capture this event

{{Event
|name=terminate
|desc=Fired when CTRL+T is held for at least 1 second. '''NOTE:''' This event cannot be captured with an unmodified [[os.pullEvent]], [[os.pullEventRaw]] or [[coroutine.yield]] should be used whenever possible instead of overriding os.pullEvent
}}
{{Example
|desc=This loop listens for the terminate event and exits the program when found, cleaning the screen first
|code=while true do
local event = os.pullEventRaw()
if event == "terminate" then
term.clear()
term.setCursorPos(1,1)
return
else
print("Still running!")
end
end
}}

Redstone (event)

2013-10-28T09:41:47Z

TheOriginalBIT: better coding habits

{{NeedsWork|A demonstration on the use and handling of this event would be beneficial. ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:13, 30 November 2012 (MSK)''}}

{{Event
|name=redstone
|desc=Fired when any Redstone inputs change on any of the sides of the computer.
}}=== Basic Usage ===
{{Example
|desc=Alerts via console output when a redstone input changes.
|code=
while true do
local event = os.pullEvent("redstone")
print("Redstone input changed.")
end
|output=This will tell one when the redstone event is triggered. Note that this doesn't tell you the side of the event.
}}=== Application ===
{{Example
|desc=This program will store the values of each redstone signal on load, and on each state change. It will further display on the screen which state was changed.
|code=
-- Set up a list which contains the sides as keys, and the current redstone state of each side as a boolean value
local statelist = {
["top"] = rs.getInput("top"),
["front"] = rs.getInput("front"),
["left"] = rs.getInput("left"),
["right"] = rs.getInput("right"),
["back"] = rs.getInput("back"),
["bottom"] = rs.getInput("bottom"),
}

-- Ready the terminal for printing to
term.clear()
term.setCursorPos(1,1)

while true do -- Start an endless loop
os.pullEvent("redstone") -- Yield the computer until some redstone changes
-- We don't care what the event returns, since the first variable will be "redstone" and the rest will be nil.

-- Now we check each side to see if it's changed.
for side, state in pairs(statelist) do -- Run the lines of code in this loop for each key/value pair in statelist
if rs.getInput(side) ~= state then -- If the side we're checking doesn't match what it was last time we checked then
print(side.." is now "..tostring(rs.getInput(side))) -- Print the new state of the side.
statelist[side] = rs.getInput(side) -- Update the statelist with the new change
end
end
end
}}

Alarm (event)

2013-10-28T09:40:21Z

TheOriginalBIT: better coding habits

{{Event
|name=alarm
|desc=Fired when an alarm has expired.
|return1=The alarm's numerical representation value (returned when [[os.setAlarm|os.setAlarm()]] is initially called).
|examples=
{{Example
|desc=Sets the alarm for 1 (in-game) hour, then waits for the event to fire
|code=local alarm = os.setAlarm(os.time()+01.00) -- Sets the Alarm for 1 hour after the current time
while true do
local event, id = os.pullEvent("alarm") -- Waits for the alarm event
if id == alarm then -- Checks to see if it's the alarm we created
print("The alarm has gone off!")
break -- Get out of the loop
end
end
}}
}}

Timer (event)

2013-10-28T09:38:33Z

TheOriginalBIT: Better explanation and coding practices for first code example. Added second example to deal with multiple timers.

{{NeedsWork|A demonstration on the use and handling of this event would be beneficial. ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:11, 30 November 2012 (MSK)''}}

{{Event
|name=timer
|desc=Fired when a timer completes.
|return1=The timer's unique ID value (returned when [[os.startTimer|os.startTimer()]] is called).
}}
{{Example
|desc=This code will loop and refresh every 1 second. If the event that occurred was a not a timer the loop will complete
|code=while true do
os.startTimer(1)
local event = os.pullEvent()
if event == "timer" then
print("Too slow!")
else
print("You've beaten me!")
end
end
}}
{{Example
|desc=This code will output different text depending on which timer has completed
|code=local timerA = os.startTimer(1)
local timerB = os.startTimer(2)

while true do
local event, completed = os.pullEvent()
if event == "timer" then
if completed == timerA then
print("TimerA has finished, restarting it now")
timerA = os.startTimer(1)
elseif completed == timerB then
print("TimerB has finished, restarting it now")
timerB = os.startTimer(2)
else
print("A timer finished, but it wasn't one of the ones I care about")
end
end
end
}}

Key (event)

2013-10-28T09:31:15Z

TheOriginalBIT: better coding habits

{{Event
|name=key
|desc=Fired when any key except Escape is pressed while the terminal is focused.
|return1=The numerical key value of the key pressed
}}
{{Example
|desc=Print each key pressed on the keyboard whenever a ''key'' event is fired. Use Ctrl+T (Windows) to terminate the loop.
|code=
while true do
local event, scancode = os.pullEvent("key")
print(tostring(scancode).." was pressed.")
end
|output=Any key that is pressed.
}}

==Key scan codes ==
[[File:CC-Keyboard-Charcodes.png|center|frame|250x250px|Click for a larger copy of this image - contains keys and their event numbers.]]

These scan codes are also available as constants in the [[Keys (API)|keys API]], and can be translated from numerical codes to strings using [[keys.getName]].

Char (event)

2013-10-28T09:30:41Z

TheOriginalBIT: better coding habits

{{Event
|name=char
|desc=Fired when a alphanumeric key is pressed on the keyboard.
|return1=The [[String_(type)|String]] representing the character that was pressed.
}}
{{Example
|desc=Prints out the character that was pressed.
|code=
while true do
local event, character = os.pullEvent("char")
print(character.." was pressed.")
end
|output=The key that was pressed. Note this doesn't trigger for Tab, Shift, the up arrow, etc. Use the [[key_(event)|key]] event if you wish to trap those keys.
}}

Term.scroll

2013-10-28T09:27:44Z

TheOriginalBIT: Added some code examples

{{Function
|name=term.scroll
|args={{type|number}} n
|returns=None
|api=term
|addon=ComputerCraft
|desc=Scrolls the content on terminal window by the supplied number of lines.
|examples=
{{Example
|desc=Scrolls the text up two lines
|code=[[term.clear]]()
[[term.setCursorPos]](1,10)
print("Hello world!")
-- text exists on the 10th line
term.scroll(2)
-- text is now on the 8th line
}}
{{Example
|desc=Scrolls the text down three lines
|code=[[term.clear]]()
[[term.setCursorPos]](1,3)
print("Hello world!")
-- text exists on the 3rd line
term.scroll(-3)
-- text is now on the 6th line
}}
}}
[[Category:API_Functions]]

Monitor.setTextScale

2013-10-08T21:52:56Z

TheOriginalBIT: Fixed code to remove the implication that there is a "monitor" API

{{lowercase}}
{{Function
|name=monitor.setTextScale
|args={{type|number}} scale
|api=Term
|addon=ComputerCraft
|desc=Sets the size of all text on the monitor. scale can be any multiple of 0.5, starting at 0.5 and ending at 5.
|examples=
{{Example
|desc=Sets the monitor's text scale to 2.
|code=local monitor = [[peripheral.wrap]]("left")
monitor.setTextScale(2)
}}
}}

[[Category:API_Functions]]

Paintutils.drawPixel

2013-08-20T01:05:28Z

TheOriginalBIT: Removed code implying it had a return value

{{lowercase}}
{{Function
|name=paintutils.drawPixel
|args={{type|number}} x, {{type|number}} y, {{type|number}} [[color (API)|color]]
|api=paintutils
|returns=nil
|addon=ComputerCraft
|desc=Draw a pixel on the screen
|examples=
{{Example
|desc=This code will draw a red pixel at the position (10, 8)
|code=[[paintutils.drawPixel]](10, 8, [[color (API)|colors]].red)
}}
}}

[[Category:API_Functions]]

Redstone (API)

2013-05-09T01:35:58Z

TheOriginalBIT: Added a note for the functions that were added in CC1.51 stating that it can only be used in CC1.51 and above

The Redstone API contains methods to control attached RedPower cables/bundled cables and regular redstone. All methods from the redstone API can also be called using "rs", which points to the same library. For example, instead of redstone.getSides(), rs.getSides() can be used. Refer to the [[Colors]] API for more information on interacting with RedPower's bundled cables.

<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
Redstone (API)
</td></tr>

<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Method Name</td><td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.getSides]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns a table of possible sides.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.getInput]]({{type|string}} side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the current redstone input signal state on ''side''.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.setOutput]]({{type|string}} side, {{type|boolean}} value)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sets or resets a redstone signal on ''side''.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.getOutput]]({{type|string}} side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the current redstone output signal on ''side''.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.getAnalogInput]]({{type|string}} side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">'''(Requires CC1.51 and above)''' Returns the current redstone input signal strength on ''side''. If no input is present, returns 0. If a redstone source (such as a redstone torch or block) is directly adjacent to the computer, returns 15.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.setAnalogOutput]]({{type|string}} side, {{type|number}} strength)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">'''(Requires CC1.51 and above)''' Sets or resets a redstone signal on ''side'' to ''strength'' (where ''strength'' is a positive integer).</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.getAnalogOutput]]({{type|string}} side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">'''(Requires CC1.51 and above)''' Returns the current redstone output signal strength on ''side''.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.getBundledInput]]({{type|string}} side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the state (as a number) of a RedPower bundled cable connected to ''side''.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.getBundledOutput]]({{type|string}} side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns the set of RedPower wires in the RedPower bundled cable which are being activated by the terminal on ''side''.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.setBundledOutput]]({{type|string}} side, {{type|number}} colors)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sets one or multiple colored signals in a RedPower bundled cable attached to ''side''. ''colors'' will determine which signals are activated. In order to set multiple signals, add the color values of the colors you want to activate. To turn off all of the colors, use 0.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[redstone.testBundledInput]]({{type|string}} side, {{type|number}} color)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns true if ''color'' is active in a RedPower bundled cable attached to ''side''. Else, returns false.</td></tr>

</table>

[[Category:APIs]]

IO (API)

2013-01-20T12:08:44Z

TheOriginalBIT: added some new non-working features

IO is a reimplementation of the default Lua input / output API defined [http://www.lua.org/manual/5.1/manual.html#5.7 here], with some features trimmed. Most features should work. If you find a non-working feature, please list it here.

List of non-working features from IO:

* file:seek(...) - Doesn't exist.
* io.lines(...) - Doesn't exist either.
* io.read("*all") - read() does not work with "*all" argument; use "*a" instead.
* io.open("FILE_NAME", "a+") - Append+ mode is unsupported.
* io.open("FILE_NAME", "w+") - Write+ mode is unsupported.
* io.open("FILE_NAME", "r+") - Read+ mode is unsupported.
* file:read(...) - Doesn't seem to exist in 1.43.
* file:read(number) - Doesn't exist as of 1.46.

If any functions don't exist try the [[Fs (API)|Fs]] API instead.
[[Category:APIs]]

Fs.open

2013-01-20T11:58:18Z

TheOriginalBIT: Fixed up some parts that weren't clear. fixed links to nil

{{lowercase}}
{{Function
|name=fs.open
|args=[[string (type)|string]] path, [[string (type)|string]] mode
|api=fs
|returns=[[Table_(type)|Table]] the file handle, or [[Nil|nil]] if the mode was read-only and the file did not exist
|desc=
'''Supported File Modes'''
Opens a file; <var>mode</var> consists of a first character which is one of the following
"r" to open the file read-only,

"w" to open it for writing and remove any existing data on file open, or

"a" to open for writing but keep existing data and append any writes to the end of the file, plus optionally the second character

"b" to open the file for binary access instead of text access
(text mode will perform end-of-line conversions necessary to move text files between Windows, Linux, and Mac OS systems; binary files should not have these conversions applied as they will be corrupted)

When you have opened a file you must always close the file handle, or else data will not be saved.
|examples=
{{Example
|desc=Creates the file "abcd" for writing, and holds a file handle to it
|code=h = fs.open("abcd", "w")
}}
}}

== File Handles ==

A file handle allows access to a file. A file handle is a table; the functions within the table are accessed with the dot operator (<em>not</em> the colon operator, as may be more intuitive!). The examples below assume a file has already been opened and the handle stored in the variable <var>h</var>.

=== Closing a file handle ===

When you open a file you must remember to then close the handle! With the write modes supported by ComputerCraft all the data that you are writing to a file will not be written into the file until you close the file. A file opened in any mode exposes the following close function.
{{Function
|name=<var>h</var>.close
|api=fs
|desc=Closes the file handle, after which it can no longer be used
}}

=== Files opened in text read mode ===

A file opened in mode "r" (text read mode) exposes the following functions.

{{Function
|name=<var>h</var>.readLine
|api=fs
|returns=[[string]] the next line read from the file, with the end-of-line character stripped; or nil if there are no more lines in the file
|desc=Reads the next line from the file
}}
{{Function
|name=<var>h</var>.readAll
|api=fs
|returns=[[string]] the entire rest of the file, with the end-of-line character on the very last line (if present) stripped
|desc=Reads the all the text in the file
}}

=== Files opened in text write/append mode ===

A file opened in mode "w" (text write mode) or "a" (text append mode) exposes the following functions:

{{Function
|name=<var>h</var>.write
|args=[[string (type)|string]] data
|api=fs
|desc=Writes a string of characters to the file exactly as they appear in the string <var>data</var>
}}
{{Function
|name=<var>h</var>.writeLine
|args=[[string (type)|string]] data
|api=fs
|desc=Writes a string of characters to the file, then appends an end-of-line character
}}

=== Files opened in binary read mode ===

A file opened in mode "rb" (binary read mode) exposes the following functions:

{{Function
|name=<var>h</var>.read
|api=fs
|returns=[[int (type)|int]] the byte read from the file, or [[Nil|nil]] if there are no more bytes
|desc=Reads a single byte from the file and returns it
}}

=== Files opened in binary write/append mode ===

A file opened in mode "wb" (binary write mode) or "ab" (binary append mode) exposes the following functions:

{{Function
|name=<var>h</var>.write
|args=[[int (type)|int]] byte
|api=fs
|desc=Writes a single byte into the file
}}

[[Category:Lua_Core_Functions]]

Textutils.urlEncode

2013-01-18T18:44:39Z

TheOriginalBIT: added outputs

{{lowercase}}
{{Function
|name=textutils.urlEncode
|args= [[String (type)|string]]
|returns=A string safe for use on the internet
|api=textutils
|addon=ComputerCraft
|desc=Replaces certain characters in a string to make it safe for use on the internet. Note that it is a string function and will even replace characters that are allowed in URLs. Use this only for text to be inserted in an URL, not the URL itself.
|examples=
{{Example
|desc=Create a safe string from another string full of invalid characters. '''This is incorrect usage!'''
|code=<pre>sUnsafe = "http://example.com/?view=€ @!! 3-g_dvv[gf"
sSafe = textutils.urlEncode(sUnsafe)
print(sSafe)</pre>
|output=http%3A%2F%2Fexample%2Ecom%2F%3Fview%3D?0%9AŒ87´A8+%40%21%21+3%2Dg%5Fdvv%5Bgf
}}
{{Example
|desc=Create a safe URL from a base URL and a string to be inserted.
|code=<pre>sUnsafe = "€ @!! 3-g_dvv[gf"
sBaseURL = "http://example.com/?view="
sSafe = textutils.urlEncode(sUnsafe)
sURL = sBaseURL .. sSafe
print(sURL)</pre>
|output=http://example.com/?view=Œ84+%40%21%21+3%2Dg%5Fdvv%5Bgf
}}
}}

[[Category:API_Functions]]

Peripheral (event)

2013-01-18T18:39:06Z

TheOriginalBIT: Added a code example

{{NeedsWork|A demonstration on the use and handling of this event would be beneficial. ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:13, 30 November 2012 (MSK)''}}

{{Event
|name=peripheral
|desc=Fired when a peripheral is connected (directly adjacent) to the computer.
|return1=The [[String_(type)|string]] value of the side of the connected peripheral.
}}
{{Example
|desc=Prints the type of peripheral and side when peripheral is attached
|code=
while true do
event, side = os.pullEvent("peripheral")
print("A "..peripheral.getType(side).." has been attached on the "..side)
end
}}
{{Example
|desc=Prints if it found the peripheral it was looking for ( in this example modem, more peripheral type here [[peripheral.getType]]
|code=
while true do
event, side = os.pullEvent("peripheral")
if peripheral.getType(side) == "modem" then
print("A modem has been attached!")
break
end
end
}}

Rednet message (event)

2013-01-18T18:30:57Z

TheOriginalBIT: Added code examples

{{NeedsWork|A demonstration on the use and handling of this event would be beneficial. ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:02, 30 November 2012 (MSK)''}}

{{Event
|name=rednet_message
|desc=Fired when any Rednet message arrives through an open modem.
|return1=The computer ID of the sender (see [[os.computerID|os.getComputerID()]]).
|return2=The message as a [[string (type) | string]]. If message was previously a table see [[textutils.unserialize]]
|return3=The distance between the modems.
}}
{{Example
|desc=Prints a message
|code=
while true do
event, senderId, message, distance = os.pullEvent("rednet_message")
print( "Computer: "..senderId.." sent a message: "..message.." from "..distance.." blocks away!" )
end
}}
{{Example
|desc=Ignores messages from any computer other than the one with id 5
|code=
while true do
event, senderId, message, distance = os.pullEvent("rednet_message")
if senderId == 5 then
print("Got a message from the boss saying: "..message)
end
end
}}

Rednet (API)

2013-01-18T18:23:39Z

TheOriginalBIT: Updating some information in rednet.send

The Rednet API allows computers to communicate between themselves without using redstone wires. In order to send and receive data, a [[modem]] is required. The data is received immediately after sending it, but only by computers within a certain range. That range depends on the altitude of the sending computer increasing with higher altitudes to a max of 384.

<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="2" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">
[[File:Grid_disk.png|24px]]  
Rednet (API)
</td></tr>

<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Method Name</td><td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.open]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tells the computer that the side can be used for networking.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.close]](side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Tells the computer that the side can no longer be used for networking.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.announce]]()</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Broadcasts an empty rednet message.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.send]](receiverID, message)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sends a message to the computer using the opened sides. The receiver ID is the ID (number, not string) of the computer you're sending the message to. ID as nil will do the same as a broadcast. The message must be a string to send across rednet, if you are wanting to send a table see [[textutils.serialize]]</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.broadcast]](message)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Sends the message to ALL connected and open computers.</td></tr>

<tr style="background-color: #E8E8E8;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[rednet.receive]](timeout)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Waits until it received a rednet message or <var>timeout</var> has passed. Leave args empty to wait for a message forever.</td></tr>

<tr style="background-color: #FFFFFF;"><td style="border-top: solid #C9C9C9 1px; padding: .4em;">rednet.isOpen(side)</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Returns true if the wireless modem is open or nil if not. Returns 1 always.</td></tr>
</table>

==Events==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Event name
!style="background:#EEE" width="*"|Description
!style="background:#EEE" width="*"|Parameters
|-
|rednet_message
|Fired when a rednet message is received (can be used as alternative for rednet.receive())
|senderId, message, distance
|}

==History==
Before the creation of the in-game wireless networking API, the term "Rednet" referred to a system created by one of the ComputerCraft users based on bundled cables from a popular Minecraft mod - RedPower. It also allowed communication between computers, but the data was transferred slowly - every bit was converted to redstone signal, that lasted about 0,1 seconds. On the release of ComputerCraft 1.3, the system became useless, as the wireless networking was officially implemented to the mod.

[[Category:APIs]]

Http success (event)

2013-01-18T18:13:39Z

TheOriginalBIT: Added some example code

{{NeedsWork|A demonstration on the use and handling of this event would be beneficial. ''[[User:AfterLifeLochie|AfterLifeLochie]] 15:52, 30 November 2012 (MSK)''}}

{{Event
|name=http_success
|desc=Fired when a call to [[http.request|http.request()]], [[http.get|http.get()]] or [[http.post|http.post()]] completes successfully.
|return1=The URL to the website.
|return2=A table containing functions of operations to perform on the requests reply
}}
{{Example
|desc=Prints the response code from the server and the text returned from the server
|code=
http.request( "http://www.example.com" )
event, url, handle = os.pullEvent( "http_success" )
print( "Got a response with the status code: "..handle.getResponseCode() )
print( "With the text: "..handle.readAll() )
handle:close()
}}
{{Example
|desc=Prints all the available functions to call on the response from the server
|code=
http.request( "http://www.example.com" )
while true do
event, url, handle = os.pullEvent( "http_success" )
for k, v in pairs( handle ) do
print( k )
end
end
}}

Http failure (event)

2013-01-18T17:33:55Z

TheOriginalBIT: Added code example.

{{NeedsWork|A demonstration on the use and handling of this event would be beneficial. ''[[User:AfterLifeLochie|AfterLifeLochie]] 15:53, 30 November 2012 (MSK)''}}

{{Event
|name=http_failure
|return1=The URL to the website.
|desc=Fired when a call to [[http.request|http.request()]], [[http.get|http.get()]] or [[http.post|http.post()]] fails.
}}
{{Example
|desc=Prints a message and quits when the requested URL could not be contacted.
|code=
http.request( "http://www.example-failure.com" )
while true do
event, url = os.pullEvent()
if event == "http_failure" then
print( "Cannot contact the server: "..url )
break
end
end
}}

Mouse drag (event)

2013-01-18T17:23:20Z

TheOriginalBIT: Added a graphical code example

{{NeedsWork|A demonstration on the use and handling of this event would be beneficial. ''[[User:AfterLifeLochie|AfterLifeLochie]] 16:00, 30 November 2012 (MSK)''}}

{{Event
|name=mouse_drag
|desc=Fired when the mouse is dragged (implies that a [[mouse_click_(event)|mouse_click]] event has already occurred).
|return1=The mouse button that was clicked.
|return2=The X-coordinate of the mouse (in screen-characters).
|return3=The Y-coordinate of the mouse (in screen-characters).
|examples=
{{Example
|desc=Print the new co-ordinates of the mouse every time a ''mouse_drag'' event occurs.
|code=
while true do
_, button, xPos, yPos = os.pullEvent("[[mouse_drag_(event)|mouse_drag]]")
[[print]]("mouse_drag => " .. [[tostring]](button) .. ": " ..
"X: " .. [[tostring]](xPos) .. ", " ..
"Y: " .. [[tostring]](yPos))
end
|output=The X and Y position of the mouse during the drag.
}}
{{Example
|desc=Draws a single pixel on the screen, which is moved to the mouse position when mouse is clicked and dragged on the screen
|code=
x = 5
y = 5
while true do
[[term.clear]]()
[[term.setBackgroundColor]]( colors.black )
[[paintutils.drawPixel]]( x, y, colors.red )

event, button, xPos, yPos = os.pullEvent("[[mouse_drag_(event)|mouse_drag]]")

if button == 1 then -- left button was clicked
x = xPos
y = yPos
end
end
|output=
}}

Category:OSes

2013-01-18T16:35:36Z

TheOriginalBIT: Removed NDF-OS as it no longer exists in an OS capacity

This is a list of all OSes, or OS supplements which have enough change to make it seem like a new OS, for ComputerCraft.






<table style="width: 100%; border: solid 1px black; margin: 2px; border-spacing: 0px;">
<tr><td colspan="3" style="font-weight: bold; font-size: large; padding-bottom: .3em; border-bottom: solid #C9C9C9 1px; background: #D3FFC2; line-height:28px;">[[File:Grid_disk.png|24px]]  Operating Systems</td></tr>

<tr><td style="width: 350px; background: #E0E0E0; padding: .4em; font-weight:bold;">Name</td>
<td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Requirements</td>
<td style="background: #E0E0E0; padding: .4em; font-weight:bold;">Description</td></tr>

<tr style="background-color: #FFFFFF;">
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">[[Redworks]]</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">HTTP</td>
<td style="border-top: solid #C9C9C9 1px; padding: .4em;">Lots of programs & APIs, login system</td>
</tr>
</table>

[[Category:Lists]]

Turtle.craft

2013-01-18T16:10:46Z

TheOriginalBIT: added code examples

{{lowercase}}
{{Function
|name=turtle.craft
|args=[[int (type)|number]] quantity ( if not supplied will craft as many as possible )
|returns=[[boolean (type)|boolean]] if an item was crafted
|api=turtle
|addon=ComputerCraft
|desc=Requires a [[Crafty Turtle]].
Crafts an item if items in the turtle's inventory matches a valid recipe. The items can be placed anywhere as long as they are oriented properly with respect to one another.
Can craft a maximum of one stack of items at a time; for example, if you put three stacks of 64 reed in a line and craft them, only 63 paper will be crafted, and three piles of 43 reed will remain in the turtle.
Will not craft if there are any items in the turtle's inventory that are not part of the recipe, including in the slots not used for crafting.
The produced items will appear in the selected slot, if that slot is free. If not, it will try the next available slot.
A parameter can also be supplied to specify the quantity of items to craft.
|examples=
{{Example
|desc=Crafts as many items as possible
|code=print( turtle.craft() )
|output=prints a [[boolean (type)|boolean]] representing if an item was crafted
}}
{{Example
|desc=Crafts 5 items
|code=print(turtle.craft(5))
|output=prints a [[boolean (type)|boolean]] representing if items were crafted
}}
}}

[[Category:Lua_Core_Functions]]

Turtle.select

2013-01-18T15:59:07Z

TheOriginalBIT: Fixed typo, stated 1-6, should have been 1-9

{{lowercase}}
{{Function
|name=turtle.select
|args=[[int (type)|int]] slotNumber (1-16 in ComputerCraft 1.4+, otherwise 1-9)
|api=turtle
|returns=[[boolean_(type)|boolean]] whether the slot number specified is greater than nine or not.
|addon=ComputerCraft
|desc=Attempts to select the specified slot.
|examples=
{{Example
|desc=Selects the specified slot
|code=print(turtle.select(5))
|output=true
}}
}}

[[Category:Lua_Core_Functions]]

Turtle.craft

2013-01-18T15:58:38Z

TheOriginalBIT: added parameter description

{{lowercase}}
{{Function
|name=turtle.craft
|args=[[int (type)|number]] quantity ( if not supplied will craft as many as possible )
|returns=[[boolean (type)|boolean]] if an item was crafted
|api=turtle
|addon=ComputerCraft
|desc=Requires a [[Crafty Turtle]].
Crafts an item if items in the turtle's inventory matches a valid recipe. The items can be placed anywhere as long as they are oriented properly with respect to one another.
Can craft a maximum of one stack of items at a time; for example, if you put three stacks of 64 reed in a line and craft them, only 63 paper will be crafted, and three piles of 43 reed will remain in the turtle.
Will not craft if there are any items in the turtle's inventory that are not part of the recipe, including in the slots not used for crafting.
The produced items will appear in the selected slot, if that slot is free. If not, it will try the next available slot.
A parameter can also be supplied to specify the quantity of items to craft.
}}


[[Category:Lua_Core_Functions]]

Turtle (API)

2013-01-18T15:51:00Z

TheOriginalBIT: Added missing 'quantity' parameter and description to turtle craft

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

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


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

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