CC: Tweaked · Getting started · Beginner

CC: Tweaked Getting Started Guide: First Computer, CraftOS & Pastebin

CC: Tweaked brings fully programmable computers into your Minecraft world, allowing you to automate almost any task using the Lua programming language. In this guide, you will learn how to craft your first computer, navigate the CraftOS terminal, write a simple script, and download community-made programs straight into your game. Mastering these foundational skills is the essential first step before moving on to autonomous mining turtles and complex base networks.

What you need

  • Stone (smelted from Cobblestone)
  • Redstone Dust
  • Glass Panes
  • Paper and any Dye (for a Floppy Disk)
  • Gold Ingots (optional, if you want to craft an Advanced Computer right away)
  • An active internet connection (required only if you plan to download external scripts)

Step by step

  1. 1Craft Your First Computer

    Open a Crafting Table and surround a piece of Redstone Dust with seven Stone blocks, leaving the bottom-center slot for a Glass Pane. This yields a standard grey Computer. If you have Gold Ingots to spare, you can replace the Stone with Gold to craft an Advanced Computer, which unlocks a color display and mouse-click support inside the terminal. Place the Computer block anywhere in your base and right-click it to boot up CraftOS.

    Tip: Always double-check your in-game recipe viewer (like JEI) as some modpacks slightly tweak the crafting ingredients.

  2. 2Label Your Computer Immediately

    When you break an unlabeled computer, its internal hard drive is completely wiped, meaning all your saved programs will vanish. To prevent this, type 'label set MyFirstPC' into the blinking CraftOS prompt and press Enter. Naming the computer assigns it a persistent internal ID, allowing it to keep its files even when you pick it up with a pickaxe and move it elsewhere.

    Tip: You can check a computer's current name and ID at any time by typing 'label get' or 'id'.

  3. 3Learn Basic CraftOS Navigation

    CraftOS works much like a real-world command line interface. Type 'ls' or 'dir' and press Enter to list all files and folders currently in your directory. You can create a new folder by typing 'mkdir programs', move into it with 'cd programs', and return to the previous folder with 'cd ..'. If the screen gets too cluttered, simply type 'clear' to wipe the terminal text.

    Tip: Type 'help' followed by any command name (for example, 'help cd') to read a built-in manual page explaining how it works.

  4. 4Write a Script Using the Edit Program

    To create your own Lua program, type 'edit hello.lua' and press Enter to open the built-in text editor. Type a simple line of code like: print("Hello Minecraft!"). When you are done typing, press the Ctrl key on your keyboard to open the bottom menu, use the arrow keys to select 'Save', press Enter, and then press Ctrl again to select 'Exit'. Back in the main shell, type 'hello' and press Enter to watch your computer execute the code.

    Tip: On an Advanced Computer, you can simply click the 'Save' and 'Exit' buttons at the bottom of the screen with your mouse cursor.

  5. 5Set Up a Disk Drive and Floppy Disk

    To transfer files between different computers or make backups, craft a Disk Drive using Stone and Redstone, and a Floppy Disk using Redstone, Paper, and any dye. Place the Disk Drive directly adjacent to your Computer (Wait for them to visually connect) and right-click the drive to insert the Floppy Disk. In the computer terminal, a new directory called 'disk' will automatically appear. You can now copy your script onto the floppy by typing 'cp hello.lua disk/hello.lua'.

    Tip: You can dye Floppy Disks different colors and label them using 'label set' while they are in the drive to keep your script library organized.

  6. 6Download Community Scripts with Pastebin and Wget

    You do not have to write every complex program from scratch; CC: Tweaked can pull scripts directly from the real-world internet into your virtual hard drive. To grab a script hosted on Pastebin, find its unique short alphanumeric code and type 'pastebin get <code> <filename>' (for example, 'pastebin get abc12345 myprogram'). If a community creator provides a direct raw text file link instead, use the 'wget <full_address> <filename>' command to download and save it locally.

    Tip: If 'pastebin' or 'wget' fails to run, ask your server administrator if the HTTP API is enabled in the mod's configuration file, or check if the specific domain is whitelisted.

  7. 7Create an Automatic Startup Script

    By default, computers turn off whenever their chunk unloads or the server restarts, requiring you to manually run your programs again. To automate this, CraftOS is programmed to automatically look for and run a file named 'startup.lua' the exact moment the block receives power or loads into the world. You can rename any downloaded or custom script to 'startup.lua' using the move command ('mv myprogram.lua startup.lua') so your base automation never stops running.

    Tip: If you ever write a buggy startup script that traps you in an infinite loop, hold down Ctrl + T for two seconds to force-terminate the running program.

How it works

Every CC: Tweaked Computer runs a lightweight, sandboxed virtual machine inside your Minecraft world. When you create files or folders inside CraftOS, the mod assigns a unique numeric ID to that specific computer block and saves your Lua scripts as actual text files inside a dedicated subfolder within your Minecraft world's save directory. This is why labeling the block is so critical: without a label, breaking the block breaks the link to that specific ID folder, and placing it back down generates a brand-new, blank ID.

When you connect a peripheral like a Disk Drive next to a Computer, the computer's operating system automatically detects the hardware on its adjacent block face and mounts its storage into the virtual file tree (as '/disk'). Similarly, the HTTP API acts as a safe bridge between your Minecraft client or server and the real-world internet. Commands like 'pastebin' and 'wget' are actually pre-installed Lua programs located in the computer's read-only memory ('/rom') that fetch plain text data from external servers and write it straight into your virtual computer's storage.

Common mistakes

  • Breaking an unlabeled computer: Players frequently spend hours writing code, break the computer to move it one block over, and lose everything. Always run 'label set <name>' before doing any serious work.
  • Getting stuck in an infinite loop: Writing a 'while true do' loop in Lua without adding a delay (like 'sleep(1)') will freeze your computer or error out with a 'Too long without yielding' message. Always include a sleep pause in continuous loops, and use Ctrl + R to reboot or Ctrl + T to terminate a stuck program.
  • Placing peripherals a block away without cables: A Disk Drive, Monitor, or Modem must physically touch one of the six faces of the Computer block to be recognized, unless you specifically network them together using Wired Modems and Networking Cable.
  • Forgetting file extensions or capitalization: CraftOS file paths are case-sensitive. Naming a file 'MyScript.lua' and trying to copy it as 'myscript.lua' will result in a file-not-found error.

FAQ

Why can I not use my mouse to click inside the text editor?

Standard grey Computers only support keyboard navigation. To click cursor positions, menus, and buttons with your mouse, you must craft an Advanced Computer (the golden variant).

How do I stop a program that is running forever?

Open the computer terminal and hold down the Ctrl and T keys together for a couple of seconds to terminate the active program. If the program prevents termination, hold Ctrl and R to force the entire computer to reboot, or Ctrl and S to shut it down.

Can I copy and paste code from my real computer into Minecraft?

Yes! You can paste a single line of text from your system clipboard directly into the CraftOS terminal or the 'edit' program by pressing Ctrl + V (or Shift + Insert). For long multi-line scripts, however, using the 'pastebin' or 'wget' command is much faster and cleaner.

Where is the built-in software stored if my new computer looks empty?

When you type 'ls' on a fresh computer, it looks empty because you are viewing the user drive. All built-in commands like 'edit', 'ls', and 'pastebin' live inside a hidden read-only directory called 'rom', which you can explore by typing 'cd /rom'.

By crafting a labeled computer, learning basic CraftOS file navigation, and utilizing Pastebin or the built-in editor, you now have the essential foundation to automate your Minecraft world with CC: Tweaked.

More CC: Tweaked guides

CC: Tweaked · ExplainedLua for CC: Tweaked Explained: Variables, Functions & The os.pullEvent LoopWriting your own scripts in CC: Tweaked unlocks total control over your Minecraft world, allowing you to automate everything from simple redstone doors to complex Turtle mining arrays. This guide breaks down the essentials of the Lua language—specifically variables, functions, and the critical event-pulling loop—so you can build reliable programs that never freeze or crash.Beginner6 steps
CC: Tweaked · PowerTurtle Fuel & Progression Guide: From Basic Turtles to Infinite Lava RefuelingTurtles in CC: Tweaked are powerful mobile robots, but they cannot move a single block without fuel. In this guide, you will learn how the internal Turtle fuel economy operates, how to upgrade from basic gray models to high-capacity Advanced Turtles, and how to program a self-sustaining Nether lava refueling loop.Beginner7 steps
CC: Tweaked · AutomationHow to Automate Strip Mining & Quarries with Mining TurtlesManual mining is one of the most time-consuming tasks in survival Minecraft, often taking hours away from complex base building and automation. With CC: Tweaked, you can deploy programmable Mining Turtles to carve out massive quarries and strip mines completely hands-free. This guide will walk you through crafting a Mining Turtle, setting up an automated fueling and chest-dumping station, and running both built-in and custom Lua mining scripts.Intermediate8 steps
CC: Tweaked · ExplainedPeripherals & Wired Networks Explained: Wrapping, Modems & Networking CablesIn CC: Tweaked, a standalone Computer can only do so much on its own; its real power comes from controlling external blocks known as peripherals. This guide will teach you how to connect your Computer to adjacent and distant machines—like Monitors, Speakers, and Chests—using Wired Modems, Networking Cables, and the Lua peripheral API. Mastering wired networks allows you to manage an entire base's inventory and automation from one central terminal.Intermediate8 steps
CC: Tweaked · Setup guideHow to Build a CC: Tweaked Storage Network & Auto-Crafting SystemIn this advanced guide, you will build a centralized item storage network and an on-demand auto-crafting system using CC: Tweaked's Wired Modems, Advanced Computers, and Crafty Turtles. By leveraging the native inventory peripheral methods in Lua, you can create a zero-RF digital storage solution that rivals dedicated logistics mods while giving you total programmable control over every item slot.Advanced8 steps
CC: Tweaked · Setup guideHow to Build an Interactive Touchscreen Monitor Dashboard for Base ControlIn this guide, you will build a dynamic touchscreen dashboard using CC: Tweaked to monitor your base's energy and fluid storage while toggling generators with a single tap. Centralizing your base controls onto an interactive graphical screen eliminates messy redstone wiring and prevents catastrophic power outages by giving you real-time data at a glance.Intermediate7 steps