Wall_lii is a Twitch and Discord bot that stores leaderboard and game data for Hearthstone Battlegrounds. It provides helpful commands for users to:

• Check a player's rank.
• Get a player's daily and weekly progress.
• View the top players in each server.
• Access relevant information about game mechanics.

Great news! No need to manually set up the bot yourself. Wall_lii is running and freely available to all Twitch streamers. To get started:

Go to https://wallii.gg/help to set up

Wall_lii automatically joins channels on its list when they go live.

If the bot does not respond to your commands, it is likely due to followers-only chat being enabled. To ensure the bot can respond:

• Add the bot as a VIP or Moderator, similar to other bots.

• !rank <game name>: Displays the player's rank and MMR in their highest-rated region.

  • Duo version: !duorank <game name>

• !day <game name>: Shows the player's starting MMR, current MMR, and a list of MMR changes from games played during the day. Resets daily at midnight PST.

  • Duo version: !duoday <game name>

• !yday <game name>: Works like !day but for yesterday.

  • Duo version: !duoyday <game name>

• !week <game name>: Provides weekly stats, including starting and current MMR, daily changes, and total games played during the week.

  • Duo version: !duoweek <game name>

• !lweek <game name>: Works like !week but for last week.

  • Duo version: !duolweek <game name>

• !peak <game name>: Shows the player's peak rating and associated server.

  • Duo version: !duopeak <game name>

• !buddy <game name>: Displays the player's current buddy and its stats.

• !goldenbuddy <game name>: Shows information about the player's golden buddy, including stats and progress to completion.

• !trinket <game name>: Provides details about the player's equipped trinkets and their effects.

• !8k <server>: Shows the first player to reach the 8000 MMR milestone on a specified server.

  • Example: !8k na for the NA server.

• !8k: Displays the first player to reach the 8000 MMR milestone globally, across all servers.

Milestone commands are available for all milestones in 1000-MMR increments, such as !9k, !10k, etc.

• !stats <server>: Displays server statistics, including the number of players, average rating, and the highest rating.

  • Examples:
    • !stats na: Stats for the NA server.
    • !stats: Stats for all servers (NA, EU, AP).
  • Duo version: !duostats <server>

• !top <server>: Lists the top 10 players for a specified server.

  • Examples:
    • !top na: Top 10 players in NA.
    • !top: Global top 10 players.
  • Duo version: !duotop <server>

• !goodbot: Praises the bot with a fun response.
• !wall_lii: Displays help and information about the bot’s features.

We welcome contributions from the community! Please maintain civility in Issues, Pull Requests, and all communication regarding this project.

Contributors can start by reviewing the bot’s functionality and suggesting or implementing enhancements. We recommend creating issues for discussions before submitting pull requests.

Running the twitch and discord bots require private credentials which you would have to set up with your own twitch/discord accounts and put them in a .env file. Most of the logic is in the leaderboard_queries.py file which can be run locally with the test_leaderboard_queries.py script.

This repository contains two Python scripts:

1. setup_local_dynamodb.py: Configures a local DynamoDB table for development and testing purposes.
2. test_leaderboard_queries.py: Runs queries against the local DynamoDB table to validate functionality and simulate leaderboard operations..

1. setup_local_dynamodb.py:

   • Prepares a local DynamoDB instance by creating the necessary table structure and configurations for testing.

2. test_leaderboard_queries.py:

   • Validates that the logic behind the twitch and discord commands works as expected.
   • Simulates leaderboard operations and queries to validate their functionality.