diff --git a/QUICKSTART.md b/QUICKSTART.md new file mode 100644 index 0000000..8cd9e0a --- /dev/null +++ b/QUICKSTART.md @@ -0,0 +1,77 @@ +# πŸš€ 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) + +## 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 diff --git a/start.sh b/start.sh old mode 100644 new mode 100755