CraftOS

2017-06-22T21:47:02Z

Wojbie: Change link for shell to point to official CC github repo.

{{Selfref|This is the article for ComputerCraft's primary shell, CraftOS. If you are looking for the API, see [[shell (API)]].}}

[[File:CraftOS1.7.png|thumb|right|300px|The CraftOS interface.]]CraftOS is the default shell used by [[ComputerCraft]]'s systems. It offers a command line interface, making use of a [[CraftOS Shell|selection of Unix-style commands]] for navigation.

It is launched automatically when a given [[Computer]], [[Turtle]] or [[Pocket Computer]] starts up, from the file [https://github.com/dan200/ComputerCraft/blob/master/src/main/resources/assets/computercraft/lua/rom/programs/shell.lua /rom/programs/shell] (for a time, it labelled itself as "TurtleOS" when executed on turtles - currently it calls itself "CraftOS" on all systems). It then initialises the [[shell (API)|shell API]] which other scripts can use to interface with it. If the first instance of CraftOS running on a system is exited, the system will shut down.

As of ComputerCraft 1.6, advanced systems launch CraftOS via the [[Multishell]] script, which enables easy multitasking (allowing the one device to run multiple programs at the same time, in different tabs). ComputerCraft 1.74 furthermore added tab-completion to the interface.

Alternate "operating systems" can either run "on top of" CraftOS, or, using a [http://www.computercraft.info/forums2/index.php?/topic/14049-how-to-make-and-install-lua-resource-packs/ resource pack], they can replace it altogether. Many user-defined OSes can be found in [http://www.computercraft.info/forums2/index.php?/forum/32-operating-systems/ the ComputerCraft forums], but note that not all are fully-functional and/or compatible with all versions of ComputerCraft.

==Quick Guide==

When first starting a system, it is recommended to label it - an unlabelled [[computer]]'s file system will be discarded if it is pickaxe'd and re-placed (in the case of [[turtle]]s, their [[refuel|fuel reserves]] will ''also'' be lost). To check the current label of a system, enter:

label get

To set a new label, enter:

label set <newLabel>

From there, use is similar to a standard Unix-style prompt - [[CraftOS Shell|see here for the command list]], and try the [[help]] script to get details on commands you're unclear about.

For example, to view a list of files on the system, enter:

ls

You can change to a different folder by entering:

cd <folderName>

To go back a directory, enter:

cd ..

To run a script file, simply enter its name. If you wish to edit a script file, use the edit command:

edit <scriptName>

Note that you cannot edit the contents of the rom (Read-Only Memory) directory, nor that of [[Treasure Disks]].

Also try the included [[lua]] script, which gives you immediate access to a Lua interpreter.

==See Also==
* [http://www.computercraft.info/forums2/index.php?/forum/13-tutorials/ ComputerCraft Tutorials on the ComputerCraft Forum]
* [http://www.computercraft.info/forums2/index.php?/topic/15033-computer-basics-i/ Computer Basics I]
* [http://www.computercraft.info/forums2/index.php?/topic/15041-computer-basics-ii/ Computer Basics II]
* [http://www.computercraft.info/forums2/index.php?/topic/20905-computer-basics-iii/ Computer Basics III]

[[Category:OSes]]

ComputerCraft Wiki - User contributions [en]

CraftOS