108 lines
2.5 KiB
Markdown
108 lines
2.5 KiB
Markdown
# 🚀 Quick Setup Guide
|
|
|
|
## Step 1: Install Dependencies
|
|
|
|
### Linux/Mac:
|
|
```bash
|
|
./start.sh
|
|
```
|
|
|
|
### Windows:
|
|
```cmd
|
|
start.bat
|
|
```
|
|
|
|
The script will automatically:
|
|
- Check for Node.js
|
|
- Install all dependencies
|
|
- Start both servers
|
|
|
|
## Step 2: Configure Minecraft Bridge
|
|
|
|
1. In Minecraft, place a computer with wireless modem
|
|
2. Copy `webbridge.lua` to the computer
|
|
3. Edit line 5 to match your setup:
|
|
```lua
|
|
local SERVER_URL = "http://localhost:3001" -- Change if needed
|
|
```
|
|
4. Run the script:
|
|
```
|
|
webbridge
|
|
```
|
|
|
|
## Step 3: Deploy Turtles
|
|
|
|
1. Place mining turtles with wireless modems
|
|
2. Copy `turtle.lua` to each turtle
|
|
3. Run on each turtle:
|
|
```
|
|
turtle
|
|
```
|
|
4. 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:
|
|
|
|
```lua
|
|
-- 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
|
|
|
|
1. Select a turtle in the web interface
|
|
2. Use "Set Home" button
|
|
3. Try "Explore" command
|
|
4. Watch the 3D map update in real-time!
|
|
|
|
---
|
|
|
|
Need more help? Check the full README.md
|