CC: Tweaked Guide

What is CC: Tweaked?

CC: Tweaked is the maintained continuation of ComputerCraft, developed by SquidDev for Fabric, Forge, and NeoForge. It adds programmable Computers and robotic Turtles that run real Lua code in-game, plus peripherals — monitors, modems, speakers, printers, and disk drives — for building genuine computer systems inside Minecraft.

People have written everything from automatic strip-mining scripts to base-wide monitoring dashboards to working operating systems on top of it. The API documentation lives at tweaked.cc and is excellent.

Getting Started with Computers and Turtles

1. Craft a Computer (stone, redstone, glass pane) and right-click to open the terminal. The lua command starts an interactive prompt; edit startup.lua writes a program that runs on boot.
2. Craft a Turtle — a computer in a chassis with an inventory. Upgrade it with tools: a Mining Turtle carries a pickaxe, and other upgrades add swords, axes, hoes, or crafting tables.
3. Move it with code. turtle.forward(), turtle.dig(), turtle.place(), and friends drive the robot; a dozen lines of Lua makes a tunnel bore.
4. Fuel your turtles. Movement costs fuel; turtle.refuel() consumes coal or other burnables from the inventory.
5. Add peripherals. Wireless Modems enable rednet messaging between machines, Monitors build wall displays, and wired networks tie whole systems together.

The built-in excavate program ships with the mod: give a mining turtle fuel, type excavate 16, and it digs a 16x16 quarry to bedrock and returns to unload.

What People Build With It

• Mining fleets – coordinated turtles quarrying regions and reporting over rednet.
• Base dashboards – monitors showing power buffers, tank levels, and machine states, polling other mods' blocks through peripheral APIs.
• Farm controllers – turtles harvesting and replanting on schedules.
• Door locks and security – password terminals, keycard systems, and player detectors.
• Pure software – games, text editors, and network protocols written entirely in-game.

With the HTTP API enabled (server config), programs can even call external web services, which powers everything from live price boards to chat bridges.