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