README.md

137 lines · 3.2 KB

Open raw

Copy & run

wget https://perlytiara.github.io/turtles.tips/raw/programs/perlytiara/eHydra_wip/README.md
1# eHydra - Advanced Turtle Management System
2
3eHydra is a comprehensive turtle management system for CC:Tweaked that provides auto-updating, deployment, and initialization capabilities for advanced mining turtles.
4
5## Features
6
7- **Auto-Updater**: Download and install programs directly from GitHub
8- **Turtle Deployment**: Deploy and configure advanced mining turtles from inventory
9- **Batch Operations**: Update multiple programs at once
10- **Wireless Management**: Configure and control turtles via rednet
11- **GPS Integration**: Automatic positioning and coordinate management
12
13## Programs
14
15### autoupdater.lua
16Downloads and installs individual programs from GitHub raw links.
17
18```bash
19autoupdater <github_raw_url> <local_filename>
20```
21
22Example:
23```bash
24autoupdater https://raw.githubusercontent.com/perlytiara/CC-Tweaked-TurtsAndComputers/refs/heads/main/programs/perlytiara/stairs/multi.lua stairs-multi
25```
26
27### batch_updater.lua
28Updates multiple predefined programs from the GitHub repository.
29
30```bash
31batch_updater
32```
33
34### init.lua
35Main initialization system for turtle deployment and setup.
36
37```bash
38init
39```
40
41Options:
421. Deploy Advanced Mining Turtle
432. Deploy Advanced Wireless Chunky Turtle
443. Initialize existing turtle
454. Setup GPS system
465. Full deployment sequence
47
48### turtle_deployer.lua
49Advanced turtle placement and fleet management system.
50
51```bash
52turtle_deployer
53```
54
55Options:
561. Deploy single Advanced Mining Turtle
572. Setup Advanced Wireless Chunky Turtle
583. Deploy Mining Fleet
594. List inventory turtles
60
61### self_update.lua
62Self-updating system for all eHydra programs.
63
64```bash
65self_update
66```
67
68Automatically downloads and updates all eHydra programs from the GitHub repository with backup and restore capabilities.
69
70### restore_backups.lua
71Backup restoration system.
72
73```bash
74restore_backups
75```
76
77Restores eHydra programs from backup files created during updates.
78
79## Quick Start
80
811. **Install the system**:
82 ```bash
83 mkdir eHydra
84 cd eHydra
85 # Copy all .lua files to this directory
86 ```
87
882. **Update programs**:
89 ```bash
90 batch_updater
91 ```
92
933. **Deploy a mining turtle**:
94 ```bash
95 init
96 # Select option 1 or 2
97 ```
98
994. **Deploy a mining fleet**:
100 ```bash
101 turtle_deployer
102 # Select option 3
103 ```
104
105## Requirements
106
107- CC:Tweaked computer/turtle
108- Internet access for auto-updater
109- Wireless modem for remote turtle management
110- Advanced turtles in inventory for deployment
111
112## Supported Turtle Types
113
114- `computercraft:turtle_advanced` - Standard advanced turtle
115- `advancedperipherals:chunky_turtle` - Chunky loading turtle
116- `computercraft:turtle_normal` - Basic turtle (limited features)
117
118## Network Protocol
119
120eHydra uses rednet for turtle communication with the following commands:
121
122- `{command = "INIT", program = "quarry", autostart = true}`
123- `{command = "CONFIG", fuelLevel = 1000, program = "quarry"}`
124- `{command = "START"}` - Start mining operation
125- `{command = "STOP"}` - Stop current operation
126- `{command = "STATUS"}` - Get turtle status
127
128## Integration
129
130eHydra integrates with existing turtle programs and can deploy:
131- Quarry turtles
132- Stairs builders
133- tClear systems
134- Custom mining programs
135
136Works with GPS systems for automatic positioning and coordinate management.
137