Inspiration

It all just started as a first time hackathon project and ended up being a good experience

How I Built It

Codex Runeterran was built as a full-stack AWS-powered application:

Frontend: React + Tailwind CSS for a fantasy-themed UI (scroll parchment, runic fonts, responsive design).

Backend: Node.js + Express hosted on EC2, connected through API Gateway.

AI Layer: AWS Bedrock (Claude 3 Sonnet) generates immersive stories from analyzed gameplay data.

Data Source: Riot Games API provides match and account data across all global regions.

Infrastructure: CloudFront + S3 for static hosting, PM2 for process management, and caching for API optimization.

Each scroll is created by analyzing a summoner’s last year of matches, summarizing trends, and passing them to the AI for story generation.

What I Learned

Integrating Riot’s regional and platform routing system was more complex than expected — but it taught me how distributed APIs work.

Working with AWS Bedrock helped me understand prompt engineering, data summarization, and inference cost optimization.

Learned to design scalable, serverless architectures with CloudFront, API Gateway, and EC2.

Improved my frontend responsiveness and theming skills, making data visualization feel like a storybook.

Challenges

Riot API’s strict rate limits required caching and batching strategies.

Handling multi-region lookups (Americas, Europe, Asia) for different summoner platforms was tricky.

Creating natural, non-repetitive AI narratives involved iterative prompt refinement and balancing creativity with factual accuracy.

Deploying multiple AWS components while maintaining secure key management across environments.

A Touch of Math

To balance load and avoid throttling, match requests per player were limited using:

Requests

per minute

RateLimit Regions Queried Requests per minute ​

= Regions Queried RateLimit ​

This ensured data was fetched efficiently while staying under Riot’s API constraints.

🌍 Looking Forward

Next, I want to:

Add player comparison scrolls and leaderboards

Migrate cache to DynamoDB

Introduce multi-language storytelling

Let players share their scrolls directly with friends

In the end, Codex Runeterran isn’t just an app — it’s a Runeterran historian, turning gameplay into legend and data into destiny.

Built With

Share this project:

Updates