Modular Computers the manual GitHub

Modular Computers

Modular Computers is a Minecraft mod for Fabric and NeoForge that adds computers you assemble from parts and program in Lua. Put a CPU, memory and an EEPROM on a motherboard in a case, add a disk and a screen, and boot mcos, a Linux-like operating system that comes on a disk you craft. Then automate your world: read and drive redstone, sense players and sounds, move pistons, talk to other computers, or just learn how a computer really works.

A computer's case view: a motherboard with CPU, RAM, ROM and SATA and expansion sockets, and its bus order beside it Every computer has a real motherboard. This is the case view: its sockets, and the bus order.

New here? Start with Installing, then build your first computer.

What makes it different

A Lua that can be frozen and saved

The Lua runs on a Java port of Lua 5.5 with no native code. A computer is budgeted and preempted, and a running program is saved with the world and resumes mid-run when it comes back.

Real parts

A case, a CPU, memory, an EEPROM, disks, cards in slots, and cables to everything else.

An operating system

mcos has a shell, a filesystem, processes, sockets, services and 53 programs, with man pages for each. Its files are real files in your world save.

Devices on a bus

Everything a program can touch is a device on one bus, found by several names and woken by interrupts.

Computers that talk

Wired and wireless network cards, sockets in mcos, and remote shells between computers. A card never silently drops a frame.

Real terminals

Screens are VT102 and xterm terminals: color, resizing, scrollback and, on the best tier, sixel graphics.

The manual

Tutorials

From an empty case to two computers talking.

Hardware

Every block and item, how to craft it and what it does.

Devices

Each device’s methods, events and faces.

mcos

The operating system, and its sys API.

Programs

The man page of every program.

Concepts

The ideas behind the mod: the bus, faces, power.

Modular Computers is MIT licensed, and its source is on GitHub. It builds on the ideas OpenComputers proved, and owes it a great deal.