# 🔴 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

Redstone-overhaul