Hypixel Player Stats Bot

by Honrine

📌 About

This is a Hypixel player Stats query bot running on Tencent QQ. It allows you to fetch player data such as:

Player level, karma, language, Stats
Bedwars stats (kills, beds, FKDR, etc.)
Skywars stats (KD, wins/losses, souls, coins, etc.)

This is a closed-source project. You can freely use the bot via QQ command interface.

Technical Details for API Usage

API Usage

Our Hypixel player Stats QQ bot interacts with the Hypixel API primarily by:

Core Function: Receiving user commands on QQ (e.g., /hyp [PlayerName], /bw [PlayerName], /sw [PlayerName]). Upon receiving a command, the bot calls the Hypixel API to retrieve relevant player data and formats it for QQ.

API Endpoints: Primarily uses the GET /player endpoint to fetch comprehensive player information including UUID, level, achievement points, and detailed game mode statistics (especially for Bedwars and Skywars). Occasionally, other resource-related endpoints (e.g., /resources/games) might be used, but at a very low frequency.

Authentication: All requests to the Hypixel API include a valid **API Key** assigned to this project for authentication.

Data Processing: The bot parses the JSON data returned by the API, extracting and calculating key metrics like Bedwars K/D, FKDR, and W/L, as well as Skywars K/D and win rates, to present them clearly to QQ users.

Expected Request Volume

Based on current user activity, we estimate the following API request volume:

Average Frequency: We anticipate an average of **5-10 API requests per minute**.

Peak Times: During high-activity periods (e.g., evenings, weekends), request volume might increase, but we do not expect it to exceed **20-30 API requests per minute**.

Daily Total: The estimated daily total requests range from **7,200 to 14,400**. In extreme cases, the total daily requests might reach **43,200**.

User Base: The bot currently serves a small community, with moderate growth anticipated. We continuously monitor request volumes and will adjust our caching strategies or notify the API provider if needed.

Caching Rules

To optimize performance, reduce redundant requests, and adhere to API best practices, we implement the following caching strategy:

Cached Content: We primarily cache general player statistics (e.g., level, achievements, Karma) and core game mode statistics like Bedwars and Skywars.

Cache Expiry (TTL):

General Player Data (e.g., /hyp command results): Cached for **5-10 minutes**. Data that changes less frequently, like Karma or achievement points, has a longer cache time.

More Real-time Data (e.g., player online Stats, some game mode statistics): Cached for **2-5 minutes** to ensure reasonable freshness.

Caching Mechanism: The bot's backend uses an in-memory cache or simple file/database caching to store recently queried data.

Cache Refresh: When cached data expires, the next user query for that player automatically triggers a new API request to fetch and refresh the data. We might consider implementing time-based batch refreshes in the future for further optimization.

Objective: Through effective caching, we aim to reduce actual requests to the Hypixel API by at least **60-80%**, thereby lowering server load and improving user experience.

💻 Bot Commands

Interact with the bot using the following commands:

/hyp [PlayerName]: Get a player's general Hypixel stats.
/bw [PlayerName]: Get a player's Bedwars stats.
/sw [PlayerName]: Get a player's Skywars stats.

🧾 /hyp Honrine

Player name: Honrine
Level: 158.81
Karma: 6.46M
Missions completed: 1,289
Challenges completed: 2,162
Achievement points: 4,555
Rank bonuses: 40
Language: English
First login: 2023-03-18 18:27:31
Last login: N/A
Last logout: N/A
Current Stats: Offline or closed state API
Continuous advertising reward: 3

🛏️ /bw Honrine

Level: 170✫ (Experience progress: 4379 / 5000)
K/D: 0.76
FK/D: 2.99
W/L: 1.21
BB/L (Break the bed/lose the field): 1.04

📊 Record:
Total kills: 3,680
Total deaths: 4,829
Final kills: 1,919
Final Death: 641
Number of Wins: 719
Number of Losses: 593
Number of Destroyed Beds: 707
Number of Destroyed Beds: 678

🎯 Resource Collection:
Iron Ingots: 1.37M
Gold Ingots: 265.67K
Diamonds: 5,223
Emeralds: 1,364
Dream Tickets: 66
Total Ingots: 28,236

🔗 Winning Streak: ? (API is down or no data)

🌌 /sw Honrine

Level: 11✫ (Experience Progress: 916 / 1,500)
K/D: 0.84
M/A (Hit Rate): 0.23
W/L: 0.07
Play Time: 22 hours and 26 minutes

📊 Record:
Kills: 1,544
Deaths: 1,839
Hits: 328
Shots: 1,421
Wins: 123
Losses: 1,837
Assists: 198

🎯 Resources and Items:
Coins: 1.18M
Tokens: 597.50K
Souls: 404
Heads: 163
Opals: 2
Opal Fragments: 0
Brewed Potions: 0

🔗 Win Streak: 0