Skip to content

🚀 Fortnite Stats v2.0.0 - Complete Modernization

Choose a tag to compare

View all tags
@michaellunzer michaellunzer released this 05 Sep 17:17
v2.0.0
f066a57
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🎉 Major Release: Complete Modernization for Home Assistant 2024+

This release completely modernizes the Fortnite Stats integration with a complete rewrite for Home Assistant 2024+ compatibility.

✨ What's New

🏗️ Architecture Modernization

  • Async/Await: Fully converted to modern async patterns
  • Config Flow: Replaced YAML configuration with modern UI-based setup
  • DataUpdateCoordinator: Implemented proper data management with automatic updates
  • Entity Structure: Updated to use modern SensorEntity and CoordinatorEntity

🎮 Enhanced Functionality

  • 54 Sensors: Comprehensive coverage of all platforms and game modes
  • Real-time Updates: Automatic updates every 5 minutes from fortnite-api.com
  • Multiple Platforms: Console (Xbox/PS/Switch) and PC (Keyboard & Mouse)
  • All Game Modes: Solo, Duo, and Squad statistics
  • Rich Attributes: Detailed metadata including eliminations per match, score per match, etc.

🎨 User Experience Improvements

  • Clean Naming: Simplified sensor names ("Console" instead of "Console (Xbox/PlayStation/Switch)")
  • Easy Setup: Just API key and username - no complex configuration
  • Comprehensive Stats: 9 different statistics per platform/mode combination
  • Modern UI: Updated documentation with clear setup instructions

🔧 Technical Improvements

  • API Migration: Switched from discontinued fortnite-python to fortnite-api.com
  • Error Handling: Robust error handling with graceful fallbacks
  • Platform Consolidation: Smart grouping of platforms by API endpoint
  • Clean Codebase: Removed all test files and duplicate code
  • Validation Compliance: Passes all Home Assistant and HACS validation checks

📊 Statistics Tracked

For each platform (Console/PC) and game mode (Solo/Duo/Squad):

  • Eliminations, Wins, Matches, Win Rate, K/D Ratio
  • Top 10 Finishes, Top 25 Finishes, Score, Minutes Played

🔄 Breaking Changes

  • Configuration: No longer uses YAML - setup through UI only
  • Sensor Names: Updated naming convention for cleaner display
  • API: Switched from fortnite-python to fortnite-api.com
  • Requirements: Home Assistant 2023.1.0+ required

📚 Documentation

  • Updated README.md with clear setup instructions
  • Added migration guide for existing users
  • Included comprehensive API key setup guide
  • Added professional screenshots

🧪 Testing

  • ✅ Tested with real Captain_Crunch88 data
  • ✅ Verified all 54 sensors work correctly
  • ✅ Confirmed real-time updates every 5 minutes
  • ✅ Tested both Console and PC platforms
  • ✅ Validated all game modes (Solo/Duo/Squad)
  • ✅ Fixed GitHub Actions hassfest validation
  • ✅ Fixed HACS integration validation

🎯 Ready for Production

This integration is now fully modernized and ready for production use with Home Assistant 2024+. All development files have been cleaned up, the codebase is professional and maintainable, and it passes all Home Assistant validation checks.

Migration Guide: See MIGRATION_GUIDE.md for upgrade instructions
API Key: Get your free API key at https://fortnite-api.com/
Documentation: https://github.com/michaellunzer/Home-Assistant-Custom-Component-Fortnite

Assets 2
Loading