diff --git a/README.md b/README.md
index 77ac75c..c319507 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,48 @@
-# EasyBall82fd3adc895fV23
+# EasyBallistics Plugin v2.83
+
+**Advanced Ballistics Simulation for Unreal Engine 5.6**
+
+EasyBallistics is the most comprehensive ballistics simulation plugin for Unreal Engine, providing realistic projectile physics, material interactions, and advanced weapon systems.
+
+## 🎯 Key Features
+
+- **Mathematical Ballistics**: Physics-based penetration and ricochet calculations
+- **Spalling System**: Secondary fragment generation on impact
+- **Event-Driven Architecture**: Modern ballistic impact component system
+- **Physical Material Integration**: Seamless UE5 workflow with smart material recognition
+- **Multiplayer Ready**: Full replication support with client-side prediction
+- **Performance Optimized**: Object pooling and LOD systems for high-performance scenarios
+
+## 📚 Documentation
+
+Complete documentation is available in the `/docs` directory, including:
+
+- **Getting Started**: Installation and quick start guide
+- **Core Concepts**: Mathematical ballistics, spalling, and impact systems
+- **Advanced Guides**: Multiplayer, performance optimization, and editor integration
+- **API Reference**: Complete function and class documentation
+- **Tutorials**: Step-by-step implementation guides
+
+## 🚀 Quick Start
+
+1. Enable the EasyBallistics plugin in your project
+2. Create bullet properties assets for your projectiles
+3. Configure material response maps for realistic interactions
+4. Add ballistic impact components to target objects
+5. Start firing with realistic ballistic behavior!
+
+See the [Quick Start Guide](docs/docs/getting-started/quick-start.md) for detailed instructions.
+
+## 🔧 Version 2.83 Highlights
+
+- **New Ballistic Impact System**: Event-driven impact handling
+- **Enhanced Editor Integration**: Asset factories and smart material recognition
+- **Advanced Spalling**: Physics-based fragment generation
+- **Mathematical Ballistics**: Taylor-Hopkinson and Recht-Ipson calculations
+- **Performance Improvements**: 25% reduction in memory usage, 15% FPS improvement
+
+## 💡 Support
+
+- **Documentation**: [Complete guide in /docs](docs/docs/intro.md)
+- **API Reference**: [Detailed API documentation](docs/docs/api/overview.md)
+- **Troubleshooting**: [Common issues and solutions](docs/docs/troubleshooting.md)