valkia/aramgg_client

What it solves

This project provides a real-time assistant for League of Legends ARAM (All Random All Mid) mode. It helps players make better decisions during the champion selection phase and in-game, specifically by providing champion recommendations based on available slots and identifying Hextech Augments to suggest optimal builds and win rates.

How it works

The application uses a read-only connection to the League Client Update (LCU) API to track the game state and phase. Depending on the phase, it triggers different features:

• Champion Selection: It reads the current champion and bench status to provide tailored recommendations.
• In-Game: It uses PaddleOCR to capture and recognize the titles of the three Hextech Augment cards appearing on screen, mapping them to local data to display win rates and build suggestions in an overlay.
• Data Management: It uses a local-first approach, rendering cached or built-in data immediately while updating versions in the background.

Who it’s for

League of Legends players on Windows who want data-driven insights and build recommendations specifically for the ARAM game mode.

Highlights

• Read-only LCU integration: Ensures it does not automate actions like locking champions or swapping bench players.
• OCR-based Augment recognition: Specifically targets the left, middle, and right card positions to maintain accurate order.
• Local-first data: Minimizes latency by prioritizing local caches over remote API calls.
• Multi-language support: Synchronized switching between Simplified Chinese, English, and Traditional Chinese.
• Diagnostic tools: Built-in feedback forms with optional screenshot and log attachment for troubleshooting.