# 🔴 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
The Redstone-overhaul Team
