🚀 Quick Setup Guide

Step 1: Install Dependencies

Linux/Mac:

./start.sh

Windows:

start.bat

The script will automatically:

Check for Node.js
Install all dependencies
Start both servers

Step 2: Configure Minecraft Bridge

In Minecraft, place a computer with wireless modem
Copy webbridge.lua to the computer

Edit line 5 to match your setup:

local SERVER_URL = "http://localhost:3001"  -- Change if needed

Run the script:
```
webbridge
```

Step 3: Deploy Turtles

Place mining turtles with wireless modems
Copy turtle.lua to each turtle
Run on each turtle:
```
turtle
```
First command for each turtle: setHome (via pocket or web)

Step 4: Access Web Interface

Open your browser to: http://localhost:3000

You should see:

✅ Connection status (top right)
🐢 Turtle list (left panel)
🗺️ 3D map (center)

Troubleshooting

Turtles not showing up?

Check webbridge.lua is running
Verify SERVER_URL matches your server
Ensure turtles have wireless modems equipped

Can't connect from web?

Verify both servers are running (check terminal output)
Try accessing http://localhost:3001/api/turtles directly
Check browser console for errors

GPS not working?

Set up 4 GPS host computers at high altitude
Run gps host X Y Z on each (with their coordinates)
Alternative: If running Opus OS, use its gpsServer package — a single turtle can self-build a complete GPS constellation (replaces 4 host computers)

Pathfinding

The turtle now includes a built-in pathfinding module exposed as _G._pathfind. You can trigger it from the web UI via eval commands:

-- Navigate to coordinates (avoids obstacles)
_pathfind.goto(100, 65, -200)

-- Navigate with block digging enabled
_pathfind.goto(100, 65, -200, { dig = true })

-- Go home
_pathfind.goHome()

-- Face a specific heading (0=south, 1=west, 2=north, 3=east)
_pathfind.face(3)

-- Get current heading name
_pathfind.headingName()  -- "east"

The pathfinder:

Uses GPS for initial position, then tracks movement locally
Auto-detects heading on startup via GPS triangulation
Handles obstacles by trying to go over/around them
Supports optional block digging for clearing paths

Next Steps

Select a turtle in the web interface
Use "Set Home" button
Try "Explore" command
Watch the 3D map update in real-time!

Need more help? Check the full README.md

2.5 KiB Raw Blame History