SKS OCDoc
OpenComputers
Computronics
Minitel

Getting Started

Also know as "how to build your first computer". To get your first computer to run, you will need to first set it up correctly. There are many different types of computers in OpenComputers, but let's start with the basic one: the standard computer.

Disclaimer: this will be step-by-step, and also provide some information on how to look for issues yourself later on, so this is quite long. If you have never built a computer in real life, and/or are completely new to the mod, it is highly recommended you read through it all.

First off, you will need a computer case. This is the block which will contain all of the components, defining the behavior of the computer you are building.

A tier two computer case.

For example, you will need to choose what tier of graphics card you wish to use, if you need a network card, a redstone card or, if you're just playing around in creative mode, maybe even a debug card.

When you open the computer case's GUI, you will see a few slots to the right. The number of slots, and what tier of component can be placed into them (indicated by the small roman numeral in the slot) depends on the tier of the case itself. GUI of a tier two computer case. In their empty state, computer cases are pretty useless. You can try to power up your computer now, but it'll immediately print an error message to your chat log, and make its dissatisfaction heard by beeping at you. Good thing the error message is telling you what you can do to fix this situation: it requires energy. Connect your computer to some power, either directly or via a power converter.

When you try to start it now, it will tell you that you need a CPU. These come in different tiers - a trend you will notice is present throughout OpenComputers. For CPUs, higher tiers mean more components at a time, as well as faster execution. So pick a tier, and put it in your computer case.

Next up you will be asked to insert some memory (RAM). Notice that the beep code is different now: long-short. Higher tiers of memory (RAM) mean more memory available to the programs running on your computer. To run OpenOS, which is the goal of this introduction, you will want to use at least two tier 1 memory (RAM) sticks.

We're making good progress here. By now your computer case will look somewhat like this: Partially configured computer. And behold, turning it on now does not print any more error messages! But alas, it still doesn't do much. At least it beeps twice now. That means the actual execution of the computer failed. In other words: it technically runs! This is where a very useful tool comes into play: the analyzer. This tool allows inspecting many of OpenComputers' blocks, as well as some blocks from other mods. To use it on the computer, use the analyzer on the case while sneaking.

You should now see the error that caused the computer to crash: no bios found; install configured EEPROM

The emphasis here is on configured. Crafting an EEPROM is pretty simple. To configure it, you will usually use a computer - but that's a little difficult right now, so we're going to use a recipe to craft a configured "Lua BIOS" EEPROM. The standard recipe is an EEPROM plus a manual. Put the configured EEPROM into your computer, aaaand.

Nope. Still nothing. But we know what to do: player uses analyzer, it's super effective! Now we have a different error message: no bootable medium found; file not found

Well then. That means the BIOS is working. It's just not finding a file system to boot from, such as a floppy or hard drive. The Lua BIOS in particular expects such a file system to furthermore contain a file named init.lua at root level. As with the EEPROM, you usually write to file systems using a computer. You probably guessed it: we now need to craft our operating system disk. Take a blank floppy disk and a manual, craft them together, and you'll get an OpenOS disk.

Now, if you used a tier 2 computer case as in the screenshots above, you'll have nowhere to place that floppy. If you have a tier 3 or creative computer case, you can place the floppy right into the case. Otherwise you'll need to place a disk drive next to your case (or connect it via cables). Once your disk is in place, you know what to do. Press the power button.

It lives! Or should, anyway. If it doesn't something went wrong, and you'll want to investigate using the analyzer. But assuming it's running now, you're pretty much done. The hardest part is over. All that's left is to make it take input and show some output.

To allow the computer to show some output, you'll want to grab a screen and a graphics card. No, it's not a flatscreen.

Place the screen adjacent to your computer case, or, again, connect it using some cable. Then place a graphics card of your choice into the computer case. You should now see a blinking cursor on the screen. Finally, place a keyboard either on the screen itself, or in a way so that it faces the screen, to enable keyboard input.

And with that, you're done. The computer is up and running and ready for action. Try using it now! Type lua in the shell and press enter, and you'll be greeted with a bit of information on how to use the Lua interpreter. Here you can test basic Lua commands. For more information this topic see the Lua page.

It lives!

Have fun building more complex computers, messing with servers and assembling robots, drones, microcontrollers and tablets in the assembler.

Happy coding!

© ShadowKat Studios
The software used to generate this page is licensed under the Mozilla Public License version 2 and can be found here