CC: Tweaked · Power · Beginner

Turtle Fuel & Progression Guide: From Basic Turtles to Infinite Lava Refueling

Turtles 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.

What you need

  • 1 Turtle or Advanced Turtle
  • 1 Diamond Pickaxe (un-enchanted and undamaged, to craft a Mining Turtle)
  • 1 Anvil and 1 Name Tag (or use the built-in label command)
  • 1 Empty Bucket
  • Early-game fuel items (Coal, Charcoal, or Planks)
  • Access to a Nether Lava ocean (or a large Overworld lava pool)

Step by step

  1. 1Label Your Turtle Immediately

    Place your Turtle down and right-click it to open the CraftOS terminal. Type 'label set MyMiner' (replace MyMiner with any name you like) and press Enter. Labeling a Turtle assigns it a permanent unique ID, which ensures that when you break it to move it elsewhere, it retains both its stored programs and its internal fuel pool.

    Tip: You can also rename a Turtle in a standard vanilla Anvil before placing it to achieve the exact same persistence.

  2. 2Perform Your First Manual Refuel

    Look at the 4x4 inventory grid in the lower right of the Turtle GUI and click the top-left slot to highlight it (this is Slot 1). Place a stack of Coal or Charcoal into Slot 1. In the terminal, type 'refuel all' and press Enter to consume the entire stack, then type 'refuel' to check your new total.

    Tip: If you are inside a Lua script rather than the command prompt, use the function turtle.refuel() instead.

  3. 3Choose Efficient Early-to-Mid Game Fuels

    While wooden items work in an emergency, they yield very few movement points per item. For early mining runs, craft your Coal or Charcoal into Blocks of Coal, which provide nine times the fuel of a single piece and let you carry much more energy in a single inventory slot. As soon as you have spare iron, transition to Lava Buckets, which offer the highest single-item fuel boost in vanilla Minecraft ( typically 1,000 movements per bucket).

    Tip: Blaze Rods are also a decent mid-game alternative if you have a Blaze farm running.

  4. 4Upgrade to an Advanced Turtle

    Basic gray Turtles have a standard fuel limit (usually 20,000 movements under default config settings). By crafting an Advanced Computer with Gold Ingots and upgrading it into an Advanced Turtle, you unlock a full-color touch screen interface and multiply the maximum fuel capacity to 100,000 movements. Check JEI for the exact gold recipe in your modpack, as upgrading an existing Turtle directly in a crafting grid may clear an unlabeled Turtle's data.

    Tip: Always transfer your scripts onto a Floppy Disk using a Disk Drive before upgrading hardware bodies, or just build a fresh Advanced Turtle and copy the files over.

  5. 5Equip the Turtle for Lava Skimming

    To build an infinite refueling script, head to the Nether and place your labeled Advanced Turtle directly one block above the edge of a large Lava ocean. Put a single Empty Bucket into Slot 1 of the Turtle's inventory. Make sure no other items are in the Turtle's inventory so the bucket always returns to the active slot.

    Tip: Turtles are completely immune to lava and fire damage when placed as a block, so do not worry about it burning up.

  6. 6Write the Lava Skimmer Lua Script

    Open the code editor by typing 'edit lavafuel' in the terminal. Type a loop that checks 'while turtle.getFuelLevel() < turtle.getFuelLimit() do', and inside that loop, sequence 'turtle.placeDown()', 'turtle.refuel()', and 'turtle.forward()'. Close the block with 'end', press Ctrl to open the menu, save the file, and exit back to the prompt.

    Tip: Using turtle.placeDown() with an empty bucket selected automatically scoops up the liquid source block directly beneath the Turtle.

  7. 7Run the Automated Nether Refueler

    Ensure Slot 1 with the Empty Bucket is selected, then type 'lavafuel' and press Enter. The Turtle will scoop the lava beneath it, consume the lava internally (leaving the empty bucket back in Slot 1), and step forward one block to the next lava source. Within a couple of minutes, your Advanced Turtle will reach its 100,000 fuel cap and stop automatically, giving you enough power to mine tens of thousands of blocks without touching Coal again.

    Tip: Keep chunk loading in mind; walk alongside your Turtle as it skims across the Nether lava lake so it does not wander into an unloaded chunk and halt.

How it works

In CC: Tweaked, fuel is only consumed when a Turtle physically changes its block coordinates—meaning forward, back, up, and down movements cost exactly 1 fuel point each. Turning left or right, digging blocks with a pickaxe, attacking mobs, placing blocks, and running complex calculations in the CPU cost zero fuel.

The Turtle fuel system directly reads Minecraft's standard furnace burn time registry. Any solid or liquid item that can smelt items in a vanilla Furnace can be digested by a Turtle using the refuel command. The mod converts the item's tick burn time into movement points via a standard formula (typically burn ticks multiplied by 5, divided by 100), meaning 1 Coal (1,600 ticks) yields 80 movements, and 1 Lava Bucket (20,000 ticks) yields 1,000 movements.

When a Turtle consumes a Lava Bucket via turtle.refuel(), the mod's inventory logic replicates furnace behavior: it extracts the fuel value from the lava and leaves the Empty Bucket behind in the exact same inventory slot. This is why a single bucket can be reused infinitely in a loop to scoop, drink, and repeat across a lava lake.

Common mistakes

  • Breaking an unlabeled Turtle: If you mine a Turtle that has no label, it reverts to a fresh factory state item and permanently deletes all stored Lua scripts and all accumulated fuel.
  • Forgetting to select the fuel slot: Both the 'refuel' shell program and 'turtle.refuel()' only inspect the currently highlighted inventory slot. Always call 'turtle.select(1)' in your scripts before attempting to refuel.
  • Scooping flowing lava instead of source blocks: Buckets only pick up stationary lava source blocks. If your Turtle tries to use 'turtle.placeDown()' on flowing lava, the function returns false and no fuel is gained.
  • Overfilling past the fuel cap: If a Turtle is at 99,950/100,000 fuel and drinks a Lava Bucket (+1,000), the extra 950 points are wasted. Add a check in your script so it only drinks lava when 'turtle.getFuelLimit() - turtle.getFuelLevel() >= 1000'.

FAQ

Can Turtles run on Forge Energy (FE) or RF from tech mods?

Out of the box, CC: Tweaked only accepts burnable furnace items in its inventory. However, many modpacks include companion add-ons (like Advanced Peripherals or Plethora) or altered configs that allow charging Turtles with FE—check JEI or your modpack documentation to see if an electric upgrade exists.

Why does my Turtle say its fuel level is 'unlimited'?

Server administrators or modpack authors can disable fuel requirements in the CC: Tweaked configuration file. If 'turtle.getFuelLevel()' returns 'unlimited', your Turtle can move freely without ever needing fuel.

Does digging hard blocks like Obsidian cost extra fuel?

No. Breaking Obsidian, digging dirt, or swinging a sword at a Zombie all cost 0 fuel. Only shifting the Turtle's chassis from one block space to another drains the fuel gauge.

By labeling your Advanced Turtle and running a simple three-line Lua loop with an empty bucket over a Nether lava lake, you can easily max out its 100,000-movement fuel pool for long-term automated mining.

More CC: Tweaked guides

CC: Tweaked · Getting startedCC: Tweaked Getting Started Guide: First Computer, CraftOS & PastebinCC: 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.Beginner7 steps
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 · 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