CC: Tweaked

Overview

CC: Tweaked is a maintained fork of the legendary ComputerCraft mod, bringing programmable Computers and robotic Turtles into Minecraft. Every device runs the Lua programming language, giving you full control over automation, Redstone logic, networking, and display output. The mod adds three families of computing devices (Normal, Advanced, and Command), a full suite of peripherals including Monitors, Modems, Speakers, Printers, and Disk Drives, plus a networking system built on wired and wireless Modems.

You can browse all 41 items and 50 recipes this mod adds using the tabs at the top of this page. This guide focuses on understanding the systems, progression, and practical usage rather than listing every recipe.

Computers

The mod adds three tiers of Computer, each with different capabilities. All Computers share a terminal size of 51 columns by 19 rows and run CraftOS, a built-in operating system with a file manager, text editor, and Lua interpreter.

Normal Computer

The baseline device, crafted from Stone, Redstone Dust, and a Glass Pane. Normal Computers have a grayscale display limited to black, white, and shades of gray. They provide 1,000,000 bytes of storage, can interact with any peripheral placed adjacent to them, and emit Redstone signals on any side. These are cheap to mass-produce and perfect for dedicated controllers like door locks, farm managers, or Redstone clocks.

Advanced Computer

The Advanced Computer unlocks a full 16-color palette, mouse click events, and scroll events. You can either craft one directly using Gold Ingots, Redstone Dust, and a Glass Pane, or upgrade a Normal Computer by surrounding it with Gold Ingots. The color display makes Advanced Computers essential for graphical interfaces, menus, and any program that needs user-friendly interaction.

Command Computer

Available only in Creative mode, the Command Computer is crafted with Gold Ingots, a Command Block, and a Glass Pane. It has an unbreakable blast resistance of 6,000,000 and can execute server commands programmatically, making it a powerful tool for map makers and server administrators. The block hardness is set to -1.0, meaning it cannot be broken in Survival.

Turtles

Turtles are the crown jewel of CC: Tweaked. These programmable robots can move in all six directions, mine blocks, place blocks, attack mobs, and interact with inventories. Every Turtle is also a full Computer with its own terminal, file system, and peripheral slots.

Fuel System

Turtles consume one unit of fuel per block moved. They do not use fuel for turning, mining, or placing blocks. Normal Turtles can store up to 20,000 fuel, while Advanced Turtles hold up to 100,000 fuel. Feed them any burnable item: a piece of Coal provides 80 fuel, a Blaze Rod provides 120, and a Block of Coal provides 800. The fuel system can be disabled entirely in the server config.

Turtle Upgrades

Turtles have two upgrade slots (left and right) that determine their capabilities. Place a tool or peripheral item next to a Turtle in the crafting grid to attach it. Upgrades include Diamond Pickaxe (mining), Diamond Sword (attacking), Diamond Axe (tree felling), Diamond Shovel (digging), Diamond Hoe (farming), Crafting Table (in-turtle crafting), Wireless Modem (networking), and Speaker (audio playback). You can combine two different upgrades on one Turtle for maximum versatility.

Advanced Turtle

Like Advanced Computers, Advanced Turtles have full color displays and mouse event support. They also have the higher 100,000 fuel limit. Craft them directly with Gold Ingots and an Advanced Computer, or upgrade a Normal Turtle by surrounding it with Gold Ingots and a Block of Gold. Advanced Turtles can be dyed to any color, making it easy to visually distinguish robots in a fleet.

Pocket Computers

Pocket Computers are handheld devices you carry in your inventory. They have a smaller terminal (26 columns by 20 rows) but run the same CraftOS and Lua programs as full-sized Computers. Craft a Normal Pocket Computer with Stone, a Golden Apple, and a Glass Pane. The Advanced version uses Gold Ingots instead of Stone and supports color output plus touch events.

Pocket Computers accept a single peripheral upgrade placed above them in the crafting grid. Available upgrades include Wireless Modems (normal and advanced), Speakers, and any tool peripheral. This makes them perfect as wireless remotes, triggering door locks, activating farm systems, or monitoring your Turtle fleet while you explore.

Peripherals

Monitors

Monitors are display blocks that form multi-block screens when placed adjacent to each other. A single Monitor is tiny, but you can build screens up to 8 blocks wide by 6 blocks tall. Normal Monitors display text in grayscale, while Advanced Monitors support all 16 colors and allow mouse click interaction. Connect a Monitor to a Computer by placing them next to each other, then use the peripheral API or the built-in "monitor" program to direct output to the screen.

Disk Drive

The Disk Drive reads and writes Floppy Disks, which are portable storage media with 125,000 bytes of space each. Craft a Floppy Disk from Paper, Redstone Dust, and any Dye (the Dye determines the disk color). Disk Drives are essential for transferring programs between Computers, distributing software, and playing music discs. Place a Disk Drive next to a Computer, insert a disk, and access it through the "disk" mount point.

Printer

The Printer outputs text to Printed Pages using Paper and Dye as ink. You can bind multiple Printed Pages together with String to create Printed Page bundles, or combine them with Leather and String to create Printed Books. Printers are useful for creating in-game documentation, signs, and manuals.

Speaker

The Speaker block plays sounds and musical notes. It can play up to 8 notes per tick and supports all vanilla noteblock instruments. Attach it as a peripheral to a Computer or as a Turtle/Pocket Computer upgrade. The Speaker API lets you play individual notes, custom audio, or use it as part of an alarm or notification system.

Networking

CC: Tweaked provides both wired and wireless networking, letting you build anything from a simple two-Computer link to a complex server infrastructure spanning your entire base.

Wireless Modems

Normal Wireless Modems are crafted from Stone and an Ender Pearl. They transmit on numbered channels (0 to 65535) with a default range of 64 blocks at ground level. At high altitude (above sea level), range increases dramatically to 384 blocks. During thunderstorms, range is reduced. Advanced Wireless Modems use Gold Ingots and an Eye of Ender, offering the same range but also supporting GPS positioning when four or more are set up as satellite hosts.

Wired Networking

For reliable, unlimited-range connections, use Networking Cable and Wired Modems. Cable is crafted from Stone and Redstone Dust, yielding 6 per craft. Wired Modems are made from Stone and Redstone Dust in the same pattern as Wireless Modems. Place Cable between two Wired Modems to create a physical network. Right-click a Wired Modem to connect the adjacent block as a peripheral. Any Computer on the same wired network can access that peripheral remotely, enabling centralized control of Disk Drives, Monitors, Printers, and even other Computers.

Programming with Lua

Every CC: Tweaked device runs Lua 5.1 (with some 5.2 and 5.3 features available unless disabled in config). Lua is a lightweight, beginner-friendly scripting language used in many real-world applications. Programs are plain text files stored on the Computer's virtual file system.

Essential APIs

CraftOS comes loaded with powerful APIs. The turtle API controls Turtle movement and actions (turtle.forward(), turtle.dig(), turtle.place()). The redstone API reads and outputs Redstone signals. The peripheral API interacts with adjacent peripherals. The http API (enabled by default) lets Computers make real HTTP requests, download programs from Pastebin, or interact with web services. The fs API manages the file system, while os handles timers, events, and system functions.

The Built-in Editor

Type "edit filename" in the terminal to open the built-in text editor. It supports basic editing with arrow key navigation, Ctrl+S to save, and Ctrl+E to close. For larger projects, many players prefer writing code in an external editor like Visual Studio Code and transferring files via the HTTP API or Floppy Disks.

Your First Turtle Program

A simple mining Turtle program demonstrates the core concepts. Open a Turtle terminal, type "edit miner", and enter this code: turtle.refuel() followed by a for loop that calls turtle.dig() and turtle.forward(). This basic script digs a straight tunnel. From here, you can add torch placement, ore detection, and inventory management to build a fully automated branch miner.

Automation Ideas

The real power of CC: Tweaked emerges when you combine its components into automated systems. Here are the most popular applications that players build.

Automated Mining

A mining Turtle equipped with a Diamond Pickaxe can strip-mine a chunk automatically. Advanced programs detect ores using turtle.inspect(), skip Stone and Dirt, and return home to deposit valuables when the inventory is full. With GPS navigation, Turtles can resume mining after a server restart exactly where they left off.

Farm Automation

Turtles with a Diamond Hoe upgrade can plant and harvest crops. A typical setup uses a Turtle that patrols rows of farmland, breaking mature crops and replanting seeds. Combined with a Chest at the end of the row, this creates a fully automatic food farm.

Redstone Control Systems

Computers can read and output Redstone signals on all six sides, making them programmable Redstone controllers. Build automated door locks with passwords, lighting systems that respond to time of day, or complex contraptions that would require hundreds of Redstone components done manually. The bundled cable API supports 16 independent Redstone channels per side.

Information Displays

Multi-block Monitor walls connected to Computers create dynamic displays. Build a base dashboard that shows Turtle fuel levels, storage inventory counts, or server status information. Advanced Monitors support 16 colors and mouse click events, enabling interactive touch-screen interfaces.

Configuration

CC: Tweaked offers extensive server-side configuration. The most important settings to know about:

Computer storage defaults to 1,000,000 bytes per Computer and 125,000 bytes per Floppy Disk. Both values are configurable. The maximum simultaneous open files is 128. The Computer terminal size defaults to 51x19 characters, while Pocket Computer terminals are 26x20. Monitor walls can be built up to 8 blocks wide and 6 blocks tall.

Wireless Modem range is 64 blocks at low altitude and 384 blocks at high altitude by default, with separate storm-range settings. Turtle fuel can be disabled entirely by setting turtlesNeedFuel to false, and fuel limits (20,000 normal, 100,000 advanced) can be adjusted. The turtlesObeyBlockProtection setting controls whether Turtles respect claimed/protected areas. HTTP access, websocket support, and domain whitelisting are all independently configurable.