CC: Tweaked is a mod for Minecraft which adds programmable computers, turtles and more to the game. A fork of the much-beloved ComputerCraft, it continues its legacy with better performance, stability, and a wealth of new features.
CC: Tweaked can be installed from CurseForge or Modrinth. It requires the Minecraft Forge mod loader, but versions are available for Fabric.
Features
Controlled using the Lua programming language, CC: Tweaked's computers provides all the tools you need to start writing code and automating your Minecraft world.
While computers are incredibly powerful, they're rather limited by their inability to move about. Turtles are the solution here. They can move about the world, placing and breaking blocks, swinging a sword to protect you from zombies, or whatever else you program them to!
Not all problems can be solved with a pickaxe though, and so CC: Tweaked also provides a bunch of additional peripherals for your computers. You can play a tune with speakers, display text or images on a monitor, connect all your computers together with modems, and much more.
Computers can now also interact with inventories such as chests, allowing you to build complex inventory and item management systems.
Getting Started
While ComputerCraft is lovely for both experienced programmers and for people who have never coded before, it can be a little daunting getting started. Thankfully, there's several fantastic tutorials out there:
Once you're a little more familiar with the mod, the sidebar and links below provide more detailed documentation on the various APIs and peripherals provided by the mod.
If you get stuck, do pop in to the Minecraft Computer Mod Discord guild or ComputerCraft's IRC channel.
Get Involved
CC: Tweaked lives on GitHub. If you've got any ideas, feedback or bugs please do create an issue.
Globals
| _G | Functions in the global environment, defined in bios.lua. |
|---|---|
| colors | The Colors API allows you to manipulate sets of colors. |
| colours | Colours for lovers of British spelling. |
| commands | The commands API allows your system to directly execute Minecraftcommands and gather data from the results. |
| disk | The Disk API allows you to interact with disk drives. |
| fs | The FS API allows you to manipulate files and the filesystem. |
| gps | The GPS API provides a method for turtles and computers to retrieve theirown locations. |
| help | Provides an API to read help files. |
| http | The http library allows communicating with web servers, sending andreceiving data from them. |
| io | Emulates Lua's standard io library. |
| keys | The Keys API provides a table of numerical codes corresponding to keyboardkeys, suitable for decoding key events. |
| multishell | Multishell allows multiple programs to be run at the same time. |
| os | The os API allows interacting with the current computer. |
| paintutils | An API for advanced systems which can draw pixels and lines, load and drawimage files. |
| parallel | Provides a simple implementation of multitasking. |
| peripheral | Peripherals are blocks (or turtle and pocket computer upgrades) which canbe controlled by a computer. |
| Control the current pocket computer, adding or removing upgrades. | |
| rednet | The Rednet API allows computers to communicate between each other by usingmodems. |
| redstone | Interact with redstone attached to this computer. |
| settings | The settings API allows to store values and save them to a file forpersistent configurations for CraftOS and your programs. |
| shell | The shell API provides access to CraftOS's command line interface. |
| term | The Terminal API provides functions for writing text to the terminal and monitors, and drawing ASCII graphics. |
| textutils | The textutils API provides helpful utilities for formatting andmanipulating strings. |
| turtle | Turtles are a robotic device, which can break and place blocks, attack mobs, and move about the world. |
| vector | The vector API provides methods to create and manipulate vectors. |
| window | The Window API allows easy definition of spaces within the display that canbe written/drawn to, then later redrawn/repositioned/etc as need be. |
Modules
| cc.audio.dfpwm | Provides utilities for converting between streams of DFPWM audio data and a list of amplitudes. |
|---|---|
| cc.completion | A collection of helper methods for working with input completion, suchas that require by _G.read. |
| cc.expect | The cc.expect library provides helper functions for verifying thatfunction arguments are well-formed and of the correct type. |
| cc.image.nft | Provides utilities for working with "nft" images. |
| cc.pretty | Provides a "pretty printer", for rendering data structures in anaesthetically pleasing manner. |
| cc.require | This provides a pure Lua implementation of the builtin require functionand package library. |
| cc.shell.completion | A collection of helper methods for working with shell completion. |
| cc.strings | Various utilities for working with strings and text. |
Peripherals
| command | This peripheral allows you to interact with command blocks. |
|---|---|
| computer | A computer or turtle wrapped as a peripheral. |
| drive | Disk drives are a peripheral which allow you to read and write to floppy disks and other "mountable media" (such ascomputers or turtles). |
| modem | Modems allow you to send messages between computers over long distances. |
| monitor | Monitors are a block which act as a terminal, displaying information on one side. |
| printer | The printer peripheral allows pages and books to be printed. |
| speaker | The speaker peirpheral allow your computer to play notes and other sounds. |
Generic Peripherals
| energy_storage | Methods for interacting with blocks using Forge's energy storage system. |
|---|---|
| fluid_storage | Methods for interacting with tanks and other fluid storage blocks. |
| inventory | Methods for interacting with inventories. |
Events
| alarm | The timer event is fired when an alarm started with os.setAlarm completes. |
|---|---|
| char | The char event is fired when a character is typed on the keyboard. |
| computer_command | The computer_command event is fired when the /computercraft queue command is run for the current computer. |
| disk | The disk event is fired when a disk is inserted into an adjacent or networked disk drive. |
| disk_eject | The disk_eject event is fired when a disk is removed from an adjacent or networked disk drive. |
| http_check | The http_check event is fired when a URL check finishes. |
| http_failure | The http_failure event is fired when an HTTP request fails. |
| http_success | The http_success event is fired when an HTTP request returns successfully. |
| key | This event is fired when any key is pressed while the terminal is focused. |
| key_up | Fired whenever a key is released (or the terminal is closed while a key was being pressed). |
| modem_message | The modem_message event is fired when a message is received on an open channel on any modem. |
| monitor_resize | The monitor_resize event is fired when an adjacent or networked monitor's size is changed. |
| monitor_touch | The monitor_touch event is fired when an adjacent or networked Advanced Monitor is right-clicked. |
| mouse_click | This event is fired when the terminal is clicked with a mouse. |
| mouse_drag | This event is fired every time the mouse is moved while a mouse button is being held. |
| mouse_scroll | This event is fired when a mouse wheel is scrolled in the terminal. |
| mouse_up | This event is fired when a mouse button is released or a held mouse leaves the computer's terminal. |
| paste | The paste event is fired when text is pasted into the computer through Ctrl-V (or ⌘V on Mac). |
| peripheral | The peripheral event is fired when a peripheral is attached on a side or to a modem. |
| peripheral_detach | The peripheral_detach event is fired when a peripheral is detached from a side or from a modem. |
| rednet_message | The rednet_message event is fired when a message is sent over Rednet. |
| redstone | The redstone event is fired whenever any redstone inputs on the computer change. |
| speaker_audio_empty | Return Values |
| task_complete | The task_complete event is fired when an asynchronous task completes. |
| term_resize | The term_resize event is fired when the main terminal is resized. |
| terminate | The terminate event is fired when Ctrl-T is held down. |
| timer | The timer event is fired when a timer started with os.startTimer completes. |
| turtle_inventory | The turtle_inventory event is fired when a turtle's inventory is changed. |
| websocket_closed | The websocket_closed event is fired when an open WebSocket connection is closed. |
| websocket_failure | The websocket_failure event is fired when a WebSocket connection request fails. |
| websocket_message | The websocket_message event is fired when a message is received on an open WebSocket connection. |
| websocket_success | The websocket_success event is fired when a WebSocket connection request returns successfully. |
Guides
| Playing audio with speakers | CC: Tweaked's speaker peripheral provides a powerful way to play any audio you like with the speaker.playAudiomethod. |
|---|---|
| Reusing code with require | A library is a collection of useful functions and other definitions which is stored separately to your main program. |