QUICK_START.md

93 lines · 2.0 KB

Open raw

Copy & run

wget https://perlytiara.github.io/turtles.tips/raw/programs/perlytiara/tClear/QUICK_START.md
1# tClear with Chunky Pairing - Quick Start
2
3## 🚀 Quick Setup (5 minutes)
4
5### 1. Place Turtles
6```
7[Chunky] [Mining] ← Your starting position
8```
9**Note:** Chunky turtle goes to the LEFT of the mining turtle at SAME HEIGHT
10
11### 2. Get IDs
12On each turtle: `print(os.getComputerID())`
13
14### 3. Start Operation
15**Option A: Direct (Recommended)**
16```lua
17# Terminal 1 (Chunky Turtle):
18tClearChunky
19
20# Terminal 2 (Mining Turtle):
21tClear 5 3 2
22```
23
24**Option B: Remote Control**
25```lua
26# On mining turtle:
27tClear_listener
28
29# On chunky turtle:
30tClear_listener
31
32# On any computer:
33tClear_multi
34```
35
36## 📋 Common Commands
37
38### Basic Mining
39```lua
40tClear 10 5 3 # 10 deep, 5 wide, 3 high
41tClear 5 3 2 layerbylayer # Safer, one layer at a time
42tClear 8 4 2 startwithin # Start inside the area
43```
44
45### Multi-Turtle Mining
46```lua
47tClear_multi # Follow prompts for 2-turtle setup
48```
49
50## ⚙️ Parameters
51- **Depth**: Forward distance (≥1)
52- **Width**: Side distance (not -1,0,1)
53- **Height**: Up/down distance (not 0)
54
55## 🛠️ Options
56- `layerbylayer` - Safer mining
57- `startwithin` - Start inside area
58- `stripmine` - Strip mining mode
59
60## 🔧 Troubleshooting
61
62### "No chunky turtle found"
631. Start chunky turtle first: `tClearChunky`
642. Check wireless modems
653. Verify network connectivity
66
67### "No modem found"
68- Attach wireless modem to turtle
69
70### Turtle breaks during mining
71- This should not happen with chunky pairing
72- Check chunky turtle is following
73- Restart both turtles if needed
74
75## 📍 Placement Rules
76- Chunky turtle goes to the **LEFT** of mining turtle
77- **SAME HEIGHT** as mining turtle
78- **SAME FACING DIRECTION** as mining turtle
79- Clear path for chunky turtle to follow
80- Avoid lava and dangerous areas
81
82## ⛽ Fuel Tips
83- Keep both turtles fueled
84- Monitor fuel levels during operation
85- Have backup fuel ready
86
87## 🆘 Emergency Stop
88- Press `Ctrl+T` on any turtle to stop
89- Both turtles will stop safely
90
91---
92**Need help?** See `USAGE_GUIDE.md` for detailed instructions.
93