diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6dc4fac
--- /dev/null
+++ b/README.md
@@ -0,0 +1,239 @@
+````markdown
+
+
+# RS-Auger
+
+### Vertical Item Transport for Modern Minecraft Servers
+
+
+
+
+
+
+
+
+
+
+---
+
+## Overview
+
+**RS-Auger** is a lightweight vertical item transport plugin designed for Minecraft servers that need fast, reliable movement of items between containers without the complexity of pipes, networks, or large hopper systems.
+
+Players place and configure Augers to automatically move item stacks between containers using Lightning Rods while maintaining full control through filters, machine states, diagnostics, and administrative tools.
+
+Built from the ground up with performance, scalability, and long-term server operation in mind.
+
+---
+
+## Why RS-Auger?
+
+Traditional item transport systems often create:
+
+* Excessive hopper usage
+* Server lag
+* Complicated redstone contraptions
+* Large storage bottlenecks
+* Difficult maintenance and troubleshooting
+
+RS-Auger replaces those systems with a clean, configurable, database-backed solution that is easy for players to use and easy for administrators to manage.
+
+---
+
+# Features
+
+### Whole Stack Transfers
+
+Moves entire item stacks instead of individual items.
+
+### Vertical Item Transport
+
+Built specifically for moving items upward between containers.
+
+### Dynamic GUI Menus
+
+Simple and intuitive inventory-based interfaces.
+
+### Advanced Item Filtering
+
+Control exactly which items are transferred.
+
+### SQLite Storage
+
+Reliable persistent machine storage.
+
+### Machine States
+
+BUILDING, RUNNING, PAUSED, and ERROR states.
+
+### Error Diagnostics
+
+Visual error indicators using Angry Villager particles.
+
+### Pause & Resume
+
+Pause machines safely and resume after validation.
+
+### Automatic Validation
+
+Continuously validates source and destination containers.
+
+### Performance Focused
+
+Designed to minimize server impact while maximizing functionality.
+
+### Administrative Tools
+
+Powerful management tools for staff and server operators.
+
+---
+
+# How It Works
+
+The Lightning Rod orientation determines transfer direction.
+
+### Small End
+
+Source container
+
+### Large End
+
+Destination container
+
+Example:
+
+```text
+Chest
+ ↑
+RS-Auger
+ ↑
+Barrel
+````
+
+Items move from the chest to the barrel.
+
+---
+
+# Supported Containers
+
+* Chest
+* Trapped Chest
+* Barrel
+* Hopper
+
+---
+
+# Configuration
+
+### Maximum Machine Length
+
+```yaml
+max-machine-length: 16
+```
+
+Defines the maximum number of Lightning Rod segments allowed between source and destination containers.
+
+Server owners may lower this value.
+
+The hard maximum machine length is capped at **16 segments** regardless of configuration.
+
+---
+
+# RS Ecosystem
+
+RS-Auger is the transport component of the growing **RS Ecosystem**.
+
+```text
+┌─────────────┐
+│ RS-MobStand │
+└──────┬──────┘
+ │ Generate
+ ▼
+┌──────────────┐
+│ RS-ItemMagnet│
+└──────┬───────┘
+ │ Collect
+ ▼
+┌───────────┐
+│ RS-Auger │
+└─────┬─────┘
+ │ Transport
+ ▼
+┌─────────────┐
+│ RS-Warehouse│
+└─────────────┘
+ Store
+```
+
+Together these plugins create a complete automated resource collection and logistics system.
+
+---
+
+# Permissions
+
+| Permission | Description |
+| ---------------- | --------------------- |
+| `rs.auger.use` | Allows use of Augers |
+| `rs.auger.admin` | Administrative access |
+
+---
+
+# Installation
+
+1. Download the latest release.
+2. Place the jar into your server's `plugins` folder.
+3. Restart the server.
+4. Configure settings as desired.
+5. Enjoy automated vertical item transport.
+
+---
+
+# Performance
+
+RS-Auger was designed with long-term server operation in mind.
+
+Features include:
+
+* SQLite persistence
+* Chunk-safe processing
+* Whole-stack transfers
+* Efficient validation
+* Configurable machine lengths
+* Optimized inventory handling
+* Minimal server overhead
+
+---
+
+
+# Contributors
+
+### Big Pappa
+
+Project Creator
+Founder of RSScripting
+
+### Atlas
+Architecture, Design & Development Support
+
+---
+
+# Support
+If you encounter a bug or have a feature request, please open an issue in the GitHub repository.
+
+---
+
+# License
+
+MIT License
+See the LICENSE file for details.
+
+---
+
+
+ Built by RSScripting
+
+
+
+ Generate • Collect • Transport • Store
+
+```