🎁 [Hypixel] DailyRewards

✨ Features

🎯 Automated Reward System

• 🔗 Smart Link Detection - Automatically detects Hypixel reward links in chat
• ⚡ One-Click Claiming - Claims rewards instantly with a single click
• 🎮 In-Game Integration - Seamless Minecraft experience

🎨 Beautiful Interactive UI

• 🃏 Card-Based Reward Selection - Choose from beautifully animated reward cards
• 🌈 Rarity-Based Colors - Visual distinction for different reward rarities:
  • 🟫 Common - Gray
  • 🔵 Rare - Aqua
  • 🟣 Epic - Light Purple
  • 🟡 Legendary - Gold
• 🔄 Smooth Flip Animations - Satisfying card reveal animations
• 📱 Modern Interface - Clean, responsive design

⚙️ Customizable Configuration

• 🎭 Animation Settings - Toggle flip animations and adjust speed
• 💾 Persistent Settings - Configuration saves automatically

🔧 Technical Features

• 🌐 HTTP Integration - Secure communication with Hypixel's reward system
• 🎵 Sound Effects - Audio feedback for reward claiming
• 📊 Error Handling - Robust error management and user feedback
• 🔄 Auto-Retry - Automatic retry on network failures (coming-soon)

🚀 Installation

📱 Easy Installation (Recommended)

1. Install via Modrinth App or your favorite launcher
2. Search for "[Hypixel] DailyRewards" or use this link: Download on Modrinth
3. Click Install - all dependencies will be handled automatically!

🛠️ Manual Installation

Prerequisites

• Minecraft 1.21.5
• Fabric Loader 0.16.14+
• Java 21+

Required Dependencies

• 📚 Fabric API 0.127.1+1.21.5
• 🌐 Fabric Language Kotlin 1.13.3+kotlin.2.1.21

Optional Dependencies

• ⚙️ Cloth Config 18.0.145 - For in-game configuration (Required if you want the config GUI)
• 📋 ModMenu 9.0.0

Steps

1. Download the latest version from Release
2. Install all required dependencies listed above
3. Place all .jar files in your mods folder
4. Launch Minecraft with Fabric
5. Join Hypixel and wait for reward links to appear in chat
6. Choose a reward to claim it

🎮 Commands

⚙️ Configuration

Access the configuration menu via /dailyrewards or through Mod Menu.

🎛️ Available Settings

🎨 Screenshots

🖼️ Gallery

🔧 API Integration

🌐 Hypixel Rewards API

The mod integrates seamlessly with Hypixel's official rewards system:

• Secure HTTPS communication
• Token-based authentication
• Real-time reward tracking
• Error recovery mechanisms

📡 Network Features

• Automatic link parsing from chat messages
• Background reward fetching
• Cached reward data for offline viewing
• Rate limiting to respect API limits

🛠️ Building from Source

Prerequisites

• Java 17+
• Git

Build Steps

# Clone the repository
git clone https://github.com/Cqseur/DailyRewards.git
cd DailyRewards

# Build the mod
./gradlew clean build

# The built mod will be in build/libs/

Development Setup

# Run in development environment
./gradlew runClient

🎯 How It Works

🔄 Reward Flow

1. Detection - Mod monitors chat for Hypixel reward links
2. Parsing - Extracts reward tokens from URLs
3. Fetching - Retrieves reward data from Hypixel API
4. Display - Shows beautiful card-based selection interface
5. Claiming - Submits selection and receives rewards

🎮 User Experience

• Zero Configuration - Works out of the box
• Non-Intrusive - Only appears when rewards are available
• Fast Claims - Minimal clicks to claim rewards
• Visual Feedback - Clear success/error indicators

📊 Compatibility & Integration

✅ Tested Environments

🔧 Mod Compatibility

✅ Fully Compatible

• ⚙️ Cloth Config - Configuration menus
• 📋 ModMenu - In-game mod management

⚠️ May Have Issues

• Optifine - Potential rendering conflicts with overlays
• Sodium + Iris - Generally works, test thoroughly
• Canvas/Other Renderers - Not extensively tested

🎮 Launcher Support

• ✅ Modrinth App (Recommended - Automatic)
• ✅ CurseForge/Overwolf (Manual install)
• ✅ MultiMC/PolyMC/Prism (Manual install)
• ✅ ATLauncher (Manual install)
• ✅ Vanilla Launcher (Manual install)

🔗 Links & Community

📱 Official Platforms

• 🟢 Modrinth - Download & Updates
• 📊 Modrinth Versions - Version History
• 📝 Changelog - Release Notes
• 🖼️ Gallery - Screenshots

🚀 Development & Support

• 🤖 GitHub Repository - Source Code
• 🐛 Bug Reports - GitHub Issues
• 💬 Discord Support - Join Community
• 📊 Project Stats - Modrinth Analytics

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

📋 Contributing Guidelines

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🐛 Bug Reports

Please use the GitHub Issues tab to report bugs.

Include:

• Minecraft version
• Mod version
• Steps to reproduce
• Error logs (if any)

📜 License

This project is licensed under the LGPL-3.0-only License - see the LICENSE file for details.

🙏 Credits & Acknowledgments

👥 Development Team

• Cqseur - Lead Developer
• Claude 4.0 🤖 - Author of this beautiful description

🎯 Special Thanks

• Hypixel Team - For the amazing reward system and API
• Fabric Community - For the excellent modding framework
• Kotlin Community - For the beautiful programming language
• Modrinth Team - For the best mod distribution platform

🛠️ Built With

• Fabric - Minecraft Modding Framework
• Kotlin - Primary Programming Language
• OkHttp - HTTP Client for reward API
• Jsoup - HTML parsing for link detection
• Cloth Config - Configuration system
• Minecraft Yarn - Minecraft Mappings