Redstone-overhaul

# 🔴 Redstone Overhaul

A complete redesign of Minecraft redstone with deterministic logic, AI optimization, and GPU-accelerated rendering.

---

## ✨ Features

### 🔌 Redstone System
- Fully deterministic signal behavior  
- Tick-based simulation (no instant chaos)  
- 30+ components (logic gates, memory, I/O)  
- Efficient signal caching  

### 🧠 AI Optimization
- Finds optimal circuit paths (A* algorithm)  
- Detects performance bottlenecks  
- Auto-improves circuits over time  
- Remembers optimizations  

### 🎨 Rendering
- GPU-accelerated rendering  
- Smooth visualization of signal flow  
- Debug overlays (paths, heatmaps, nodes)  
- Color-coded signal strength  

### ⚡ Performance
- Multi-threaded simulation  
- Handles 10,000+ components  
- Chunk-based processing  
- Minimal TPS impact  

---

## 📥 Installation

### Requirements
- Minecraft 1.21 – 1.21.11  
- Fabric Loader 0.18.1+  
- Fabric API  
- Java 21+  

### Steps
1. Install Fabric Loader  
2. Download the mod `.jar` file  
3. Place it in `.minecraft/mods/`  
4. Launch Minecraft  

---

## 💻 Commands

- `/redstone status` → system info  
- `/redstone profile` → performance stats  
- `/redstone debug ` → visualization tools  
- `/redstone optimize` → run AI optimization  

### Debug Modes
- `paths` → signal routes  
- `nodes` → component states  
- `heatmap` → activity intensity  
- `performance` → bottlenecks  

---

## 🧱 Components

### Basic
Wire · Repeater · Comparator · Torch  

### Logic
AND · OR · XOR · NAND · NOR · NOT  

### Memory
RS Latch · D Flip-Flop · T Flip-Flop · JK Flip-Flop  

### Advanced
Counter · Timer · Encoder · Decoder · Multiplexer  

### Devices
Lever · Button · Piston · Door · Hopper · Lamp  

---

## 📊 Performance

- < 1,000 components → negligible impact  
- 1,000–5,000 → light overhead  
- 5,000–10,000 → AI optimization helps  
- 10,000+ → graph splitting enabled  

---

## 🐛 Bug Fixes (v0.0.2)

- Fixed signal update ordering issue  
- Fixed thread safety problems  
- Fixed logic gate errors  
- Fixed missing cache detection  
- Fixed AI controller compile error  
- Improved caching system  
- Fixed typo in optimization method  
- Added cache size limit  

---

## ⚙️ Notes

- Auto-detects CPU threads  
- Runs optimization every 5 seconds  
- No config required  

---

## 💬 Community

Discord: https://discord.gg/9q7HTGUeQF  
Issues: https://github.com/Ahaduzzamankhan/redstone-overhaul/issues  

---

## 📄 License

MIT License © Fluxenite