solutions_season_unearthed/README.md

# 🤖 65266 Lego Dynamics - UNEARTHED Season

<div align="center">

**⚡ Competitive Robotics Code for FLL SUBMERGED℠ Season ⚡**

![Team](https://img.shields.io/badge/Team-65266%20Lego%20Dynamics-blue?style=for-the-badge)
![Season](https://img.shields.io/badge/Season-UNEARTHED-green?style=for-the-badge)
![License](https://img.shields.io/badge/License-GPL-red?style=for-the-badge)

</div>

---

## 📋 Project Overview

Welcome to the official code repository for **Team 65266 Lego Dynamics**! This repository contains all the Pybricks code powering our robot through the UNEARTHED season missions. Our modular approach allows for flexible mission execution and quick color-sensor-based run selection.

---

## 🦾 Robot Hardware

### 🎯 Meet Optimus Prime III

| Component | Specification |
|-----------|--------------|
| 🤖 **Robot Name** | Optimus Prime III |
| 💾 **Firmware** | Pybricks |
| 🔧 **Attachment Motors** | 2× Large Motors (Ports C & D) |
| 🚗 **Drive Motors** | 2× Small Motors (Ports A & B) |
| 👁️ **Sensors** | Up-facing Color Sensor (Quick Start) |
| 🛠️ **Attachments** | Multiple mission-specific tools |

### ⚙️ Motor Configuration
- **Port A**: Left Drive Motor (Small)
- **Port B**: Right Drive Motor (Small)
- **Port C**: Left Attachment Motor (Large)
- **Port D**: Right Attachment Motor (Large)

---

## 📂 Code Structure

Our codebase is organized for maximum efficiency and modularity:

```
📦 Repository
 ┣ 📜 run_1.py          # Individual mission runs
 ┣ 📜 run_2.py          # Each file = 1+ mission completions
 ┣ 📜 run_3.py
 ┣ 📜 ...
 ┗ 📜 master.py         # 🎯 Combined master file with color-start logic
```

### 🔄 Workflow
1. **Individual Run Files** → Contain specific mission sequences
2. **Script Combination** → Merges runs into master file
3. **Color Sensor Logic** → Adds intelligent run selection based on color detection

---

## 🚀 How to Use

### 📥 Installation & Deployment

1. **Load the Code**
   ```bash
   # Open the master.py file in Pybricks IDE
   ```

2. **🔌 Connect to Robot**
   - Pair your robot via Bluetooth in Pybricks

3. **📤 Upload to Robot**
   - Click "Download and Run" or send the program to the robot

4. **🎨 Start Your Run**
   - Hold a colored LEGO brick up to the color sensor
   - Different colors trigger different mission runs!

### 🎮 Color Start System

| 🟥 Red | 🟦 Blue | 🟩 Green | 🟨 Yellow |
|--------|---------|----------|-----------|
| Run 1  | Run 2   | Run 3    | Run 4     |

> **💡 Pro Tip**: Organize your colored bricks before the match for quick run selection!

---

## 🏆 Competition Notes

- ⏱️ **Quick Start**: Color sensor enables rapid run switching without reprogramming
- 🎯 **Modular Design**: Easy to test and modify individual missions
- 🔧 **Flexible Attachments**: Multiple tools optimized for different challenges

---

## 🤝 Contributing

Team members can contribute by:
- 🐛 Reporting bugs via Issues
- 💡 Suggesting mission optimizations
- 🧪 Testing new attachment designs
- 📝 Documenting successful strategies

---

## 📄 License

**GNU General Public License v3.0**

```
🔒 You can take inspiration from our code, but you can't take our exact code.
```

This project is licensed under GPL-3.0 - see the [LICENSE](LICENSE) file for complete details.

### 📖 What This Means:
- ✅ Learn from our approaches and strategies
- ✅ Understand our logic and algorithms
- ❌ Don't copy-paste our exact code
- ✅ Create your own unique implementations

---

## 📞 Contact & Support

**Team 65266 Lego Dynamics**

Questions about our approach? Interested in collaboration? Reach out!

---

<div align="center">

**🔧 Built with Passion | 🤖 Powered by Pybricks | 🏆 Competing for Excellence**

⭐ Star this repo if you found it helpful! ⭐

</div>