G1ax Spear Optimizer

🎯 Overview

G1ax Spear Optimizer enhances spear combat in Minecraft with visual feedback and improved responsiveness. This client-side mod provides charge indicators and damage previews to help you time your attacks more effectively.

---

✨ Key Features

🎮 Combat Enhancement

Charge State Visualization

• Visual progress bar showing spear charge level
• Color-coded indicators (green → yellow → red)
• Screen shake effects during overcharge state

Damage Preview System

• Real-time damage calculation display
• Velocity-based damage multipliers
• Enchantment consideration (planned)

Improved Visual Feedback

• HUD elements for combat information
• Smooth charge state transitions
• Clear visual cues for optimal timing

⚙️ Technical Approach

Client-Side Processing

• Local charge state tracking
• Damage calculation based on player velocity
• Visual-only enhancements (no gameplay modification)

Performance Focused

• Lightweight implementation (~2-5 MB memory)
• Minimal FPS impact (<1 FPS typical)
• Efficient caching systems

---

🎮 How to Use

1. Install: Place the JAR file in your mods folder
2. Launch: Start Minecraft with Fabric loader
3. Play: Hold right-click with a spear to see charge indicators
4. Time Attacks: Use the visual feedback to optimize your timing

No configuration required - works immediately after installation!

---

📊 Current Functionality

Version 1.0.0

• ✅ Basic spear charge visualization
• ✅ Damage preview display
• ✅ Visual progress indicators
• ✅ Screen shake effects
• ✅ HUD rendering system

---

⚙️ Technical Specifications

• Minecraft Version: 1.21.11
• Mod Loader: Fabric
• Java: 21+
• Dependencies: Fabric API 0.141.1+
• Side: Client-only
• License: MIT

---

🔐 Compatibility & Safety

✅ Vanilla Compatible - Works on standard Minecraft servers ✅ Client-Side Only - No server modifications required ✅ Performance Safe - Minimal system resource usage ✅ Open Source - MIT licensed with full transparency

---

🐛 Current Limitations

• Network synchronization features are placeholders
• Some advanced rendering features disabled for 1.21.11 compatibility
• Enchantment integration not yet implemented
• Damage calculation is simplified

Note: These limitations don't affect the core visual feedback functionality.

---

🤝 Support & Development

• Source Code: GitHub Repository
• Issue Tracking: GitHub Issues
• Feature Requests: GitHub Discussions

---

📜 License

This project is licensed under the MIT License - see the repository for details.

---