CC: Tweaked · Setup guide · Intermediate

Rednet & Wireless GPS Setup Guide: Remote Control & 3D Turtle Navigation

Tired of your mining turtles losing their way after a server restart or getting stuck across your base? In this guide, you will learn how to build a 4-computer wireless GPS satellite constellation at maximum build height, configure Rednet for wireless networking, and use a Pocket Computer with an Ender Modem to remotely command turtles from anywhere—even across dimensions.

What you need

  • 4x Computer or Advanced Computer (for the GPS satellite cluster)
  • 4x Wireless Modem or Ender Modem (for the GPS hosts)
  • 1x Turtle or Advanced Turtle equipped with a Wireless or Ender Modem
  • 1x Pocket Computer or Advanced Pocket Computer equipped with an Ender Modem
  • Building blocks or scaffolding to reach maximum build height
  • Coal, Charcoal, or Lava Buckets (to fuel the Turtle)

Step by step

  1. 1Plan the 3D Constellation Geometry

    To calculate a position in 3D space, a wireless GPS cluster requires exactly four computers arranged in a non-coplanar shape—meaning they cannot all sit on the same flat horizontal or vertical plane. Pillar up near maximum build height above your base where standard Wireless Modems get their maximum broadcast range bonus. Build a small framework that places two computers at one Y-level (for example, North and South) and the other two computers three blocks lower (East and West).

    Tip: If you use Ender Modems instead of standard Wireless Modems for your GPS hosts, altitude does not affect range, though keeping the cluster high in the sky prevents accidental demolition.

  2. 2Install Computers and Modems

    Place your four Computers onto the framework nodes you just built. Hold shift and right-click to attach a Wireless Modem (or Ender Modem) directly to the side or back of each computer. Before configuring them, stand directly on top of each computer or look directly at the block using the F3 debug screen to write down the exact X, Y, and Z block coordinates for all four machines.

    Tip: Make sure you record the block coordinates of the computer itself, not your player's eye level or the attached modem's block space.

  3. 3Configure Persistent GPS Startup Scripts

    Right-click the first computer to open its terminal and type 'edit startup.lua' to create a script that runs automatically whenever the chunk loads. Inside the editor, type: shell.run("gps", "host", X, Y, Z) replacing X, Y, and Z with that specific computer's exact coordinates. Press Ctrl to open the menu, select Save, then Exit, and finally type 'reboot' to start broadcasting. Repeat this exact process for the remaining three computers using their respective coordinates.

    Tip: Always test one host manually by typing 'gps host X Y Z' first to ensure the modem lights up before committing it to the startup file.

  4. 4Test Signal with a Pocket Computer

    Craft a Pocket Computer mixed with a Wireless or Ender Modem in your crafting grid (or check JEI for the exact upgrade recipe in your version). Right-click the Pocket Computer in your hand and type 'gps locate' into the console. If your four satellites are properly configured, the terminal will immediately query the constellation and print your exact current coordinates.

    Tip: If it returns only a partial match or times out, double-check that all four computers are on at least two different Y-levels.

  5. 5Equip and Label Your Wireless Turtle

    Place your Turtle down and attach a Wireless Modem or Ender Modem to it (either via crafting grid or using the 'equip' command, depending on your setup). Open the turtle's terminal and immediately run 'label set <name>' so it keeps its fuel and programs when broken. Next, run 'id' and write down the numerical Computer ID of the turtle, as you will need this address to send it direct remote commands. Finally, place some coal in its selected inventory slot and run 'refuel all'.

    Tip: An Ender Modem on a Turtle allows it to receive commands from your Pocket Computer even if you are in the Nether and the turtle is in the Overworld.

  6. 6Write the Turtle Receiver & Navigation Script

    On the Turtle, type 'edit receiver.lua' to write a program that listens for Rednet commands and uses GPS to verify its location. Enter the following logic: first, call 'peripheral.find("modem", rednet.open)' to open the wireless connection. Next, create a 'while true do' loop that waits for messages using 'local id, msg = rednet.receive("turtle_cmd")'. Inside the loop, add conditions like 'if msg == "pos" then local x,y,z = gps.locate() rednet.send(id, x..":"..y..":"..z, "turtle_reply") elseif msg == "forward" then turtle.forward() end'. Save and run the program.

    Tip: Using protocol strings like 'turtle_cmd' inside rednet.receive filters out random background wireless chatter from other computers.

  7. 7Build the Pocket Computer Remote Controller

    Open your Pocket Computer and type 'edit remote.lua'. Start the script with 'peripheral.find("modem", rednet.open)' so the handheld device initializes its Ender Modem. Add a simple loop that reads user input with 'local input = read()', sends it to your turtle's ID using 'rednet.send(TURTLE_ID, input, "turtle_cmd")' (replace TURTLE_ID with the number from Step 5), and waits for a coordinate reply using 'local id, reply = rednet.receive("turtle_reply", 3)'. Save and run 'remote', then type 'pos' or 'forward' to watch your turtle respond wirelessly!

    Tip: You can expand the turtle's receiver script with a simple 3D pathfinding loop that compares gps.locate() against target coordinates sent from your remote.

How it works

The GPS system in CC: Tweaked works through mathematical trilateration, closely mirroring real-world satellites. When a turtle or pocket computer runs gps.locate(), its modem broadcasts a ping on a dedicated GPS channel. Every computer currently running the 'gps host' program hears this ping and replies with its own hardcoded X, Y, Z coordinates. The mod's internal engine automatically measures the exact Euclidean distance between the sender and each host based on signal travel.

Why do you need four computers on different Y-levels? One host gives you a hollow sphere of possible locations; two hosts narrow that down to a flat circle where the spheres intersect; three hosts narrow it down to two distinct points (one above the plane of the hosts, one below). The fourth host—placed at a different elevation—breaks the tie between those final two points, locking in an exact 3D coordinate.

Rednet is a high-level networking API built on top of standard modem channels. While standard Wireless Modems have a limited block range that scales up with altitude (peaking at max build height) and decreases during thunderstorms, Ender Modems bypass range limits entirely. By pairing Rednet protocols with Ender Modems, your devices can exchange structured Lua tables and strings across thousands of blocks or across different dimensions.

Common mistakes

  • Placing all four GPS hosts on a flat floor: If all four computers share the same Y coordinate (coplanar), the math cannot distinguish whether you are above or below the cluster, causing gps.locate() to fail.
  • Typoing a single coordinate in startup.lua: Even a one-block error on a single GPS host will warp the trilateration math for your entire base, making turtles think they are dozens of blocks away from reality.
  • Letting the GPS chunk unload: If you move far away and the chunk containing your sky constellation unloads, the computers shut off. Always build the GPS cluster inside a force-loaded or spawn chunk.
  • Forgetting to open Rednet before sending: Calling rednet.send() without first executing rednet.open(side) or peripheral.find("modem", rednet.open) will silently fail or throw an error.
  • Ignoring Turtle directional facing: GPS only gives you X, Y, and Z coordinates, not which cardinal direction (North, South, East, West) the turtle is facing. Have the turtle move forward one block and run gps.locate() a second time to deduce its orientation from which coordinate changed.

FAQ

How does my Turtle know which direction it is facing using GPS?

A single GPS check only returns X, Y, Z coordinates. To find its facing direction, program the turtle to check its GPS position, move forward one block, and check GPS again. If X increased, it is facing East; if X decreased, West; if Z increased, South; if Z decreased, North.

Do Ender Modems work across dimensions for GPS hosting too?

No. While Ender Modems allow Rednet messages to cross dimensions between a Pocket Computer and a Turtle, the built-in GPS API requires the hosts and the receiver to be in the same dimension to calculate physical block distances. You need a separate 4-computer GPS cluster for the Nether or the End.

Why did my GPS satellites stop broadcasting after a server restart?

If you started the GPS hosts by typing the command directly into the terminal instead of saving it inside a 'startup.lua' file, the computers will reboot to a blank prompt whenever the server restarts or the chunk reloads.

What is the exact range of a standard Wireless Modem?

Range depends on altitude, weather, and your modpack's configuration files. Standard modems reach furthest at maximum build height in clear weather, though you should check your mod config or use Ender Modems if you need guaranteed infinite range.

By combining a non-coplanar 4-computer GPS sky constellation with Ender Modems and Rednet protocols, you unlock reliable 3D turtle pathfinding and cross-dimensional remote control across your entire Minecraft world.

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