Note
A comprehensive multi-platform bot for THE FINALS game, providing real-time player statistics, leaderboard tracking, and tournament data across QQ, HeyBox, and Kook platforms. Built with modern async architecture and containerized deployment support.
Skip the setup and start using immediately. Our official bot instances are production-ready and fully maintained:
| Platform | How to Add |
|---|---|
Join group 1064038953 → Find bot in members → Add to your group |
|
| HeyBox | Direct Link |
| Kook | OAuth Authorization |
# Docker Compose (Recommended)
docker-compose up -d
# Traditional Python
python bot.pyThis overview covers the system's architecture, core components, and feature set. For detailed information about installation and configuration, see Installation and Setup. For a complete list of available commands, see Available Commands.
The bot provides comprehensive player data queries across multiple game modes. Access real-time ranking statistics with /rank and /r commands, explore World Tour tournaments via /wt, and track competitive performance in Quick Cash, Power Shift, and Death Match modes through dedicated commands. The system supports fuzzy player search with /ds, account binding for streamlined queries, and dynamic leaderboard trend visualization.
Weapon statistics are accessible through /weapon command, pulling detailed data including damage values, RPM, TTK calculations, and technical specifications. Club information can be queried with /club tags, while the /df command provides current season cutoff scores for competitive rankings.
| Platform | Status | Protocol | Feature Support |
|---|---|---|---|
| ✅ Active | Official Bot API | 100% Full feature support | |
| QQ Guild | ✅ Active | QQ Guild API | 100% Full feature support |
| HeyBox | ✅ Active | HeyBox Bot API | 100% Full feature support |
| Kook | ✅ Active | Kook Bot API | 95% Full feature support (platform limitations: no command list/autocomplete) |
Built on a plugin-based architecture with multi-platform provider abstraction, the bot seamlessly operates across QQ, HeyBox, and Kook platforms. Core infrastructure leverages Redis for high-performance data caching, Playwright for dynamic image generation, and FastAPI for RESTful API endpoints. The command processing pipeline handles parsing, validation, and execution through a structured event-driven system.
Visit our comprehensive documentation for detailed guides on deployment, configuration, and development.
This project is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
If you use or indirectly use our source code or copyrighted content, you must provide clear and visible attribution in your project.