hyp-userinfo-bot

Hypixel User Info Bot

Project Introduction

Hypixel User Info Bot is a data-query bot running on Tencent QQ Instant Messaging platform.
The bot allows QQ users to query public player statistics from the Hypixel Minecraft server, including general profile data and multiple game modes such as BedWars, SkyWars, Duels, and SkyBlock.

This project is non-commercial, closed-source, and free for end users.
It does not modify, automate gameplay, or interact with Hypixel servers directly, and only retrieves publicly available data via the official Hypixel API.

API Usage Description

The bot uses the Hypixel Public API to retrieve player data based on user-provided Minecraft usernames or UUIDs.

Typical API usage includes:

• Player profile endpoint (basic information such as level, karma, last login)
• Game mode statistics endpoints (BedWars, SkyWars, Duels, SkyBlock)

Each user command usually triggers 1–3 API requests, depending on the requested game mode.

Examples:

• /hyp <username> → 1 API request
• /bw <username> → 1 API request
• /sb <username> → 2–3 API requests (due to SkyBlock profile structure)

Expected Request Volume

• Estimated daily active users: 50–200
• Estimated average requests per user per day: 3–5
• Estimated total API requests per day: 300–1,000
• Peak usage occurs during evenings and weekends (UTC+8)

The bot includes rate-limit protection and will temporarily reject requests if limits are approached.

Caching Strategy

To reduce unnecessary API calls and comply with rate limits, the bot implements the following caching rules:

• Player profile data: cached for 5 minutes
• Game mode statistics: cached for 5–10 minutes
• SkyBlock data: cached for 10 minutes
• Cache is invalidated automatically after expiration
• Repeated queries for the same player within the cache window do not trigger new API requests

Caching is handled in memory and/or lightweight storage, depending on runtime environment.

User Commands (QQ)

• /hyp <username> – Query general Hypixel player information
• /bw <username> – Query BedWars statistics
• /sw <username> – Query SkyWars statistics
• /duel <username> – Query Duels statistics
• /sb <username> – Query SkyBlock profile data

Example Output

Chinese example:

/hyp Dream

Hypixel 玩家数据: 玩家名: Dream 等级: 80.06 Karma: 4017370 首次登入: 2013-07-22T13:42:36 上次登入: 2023-06-04T01:29:59 当前状态: 离线

Compliance Statement

• This project complies with Hypixel API Terms of Service
• No private or sensitive user data is collected
• No data is sold or redistributed for commercial purposes
• The bot only displays API data directly to the requesting user