https://github.com/zerebos/tabletennisdb
Discord bot for table tennis equipment stats, world rankings, schedules and more!
https://github.com/zerebos/tabletennisdb
discord discord-bot tabletennis zackrauen-com
Last synced: 5 months ago
JSON representation
Discord bot for table tennis equipment stats, world rankings, schedules and more!
- Host: GitHub
- URL: https://github.com/zerebos/tabletennisdb
- Owner: zerebos
- License: mit
- Created: 2017-12-20T09:53:58.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-06-18T07:07:28.000Z (about 1 year ago)
- Last Synced: 2025-10-24T04:45:39.670Z (9 months ago)
- Topics: discord, discord-bot, tabletennis, zackrauen-com
- Language: TypeScript
- Size: 501 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TableTennisDB 🏓
[](https://top.gg/bot/317185553349214209)
A comprehensive Discord bot for table tennis enthusiasts featuring player rankings, equipment specifications, and personal profiles.
## 🚀 Quick Start
### 🌐 Add to Account (Recommended)
**New!** Install TableTennisDB to your Discord account for DM access and cross-server functionality:
[**Add to Your Account**](https://discord.com/oauth2/authorize?client_id=317185553349214209&integration_type=1&scope=applications.commands)
### 🔗 Add to Server (Traditional)
Add TableTennisDB to your Discord server:
[**Add to Server**](https://discord.com/oauth2/authorize?client_id=317185553349214209&permissions=2147863616&scope=bot%20applications.commands)
### 💬 Support
Need help? Join our [support server](https://discord.gg/MZ8hrES9Dd) for assistance and updates.
## ✨ Features
### 👤 Personal Profiles
Create and manage your table tennis profile with equipment and playing style information:
- **Equipment tracking** - Forehand rubber, backhand rubber, blade
- **Playing style** - Strengths, weaknesses, playstyle description
- **Cross-server sync** - Your profile works across all servers
- **DM access** - Edit and view profiles in direct messages
```
/profile edit # Create or edit your profile
/profile view # View your profile
/profile view @user # View another user's profile
```
### 📊 Player Rankings & Information
Look up current ITTF rankings and player statistics:
- **Player lookup** - Search for any ITTF-ranked player
- **Current rankings** - View top players in various categories
- **Tournament data** - Information about major tournaments
```
/player Fan Zhendong # Look up a specific player
/rankings # View current top rankings
/tournament World Championships # Tournament information
```
### 🏓 Equipment Database
Comprehensive equipment specifications from RevSpin:
- **Rubber specifications** - Speed, spin, control ratings
- **Blade information** - Weight, layers, playing characteristics
- **Ball specifications** - Official tournament balls
- **Autocomplete search** - Fast and accurate equipment lookup
```
/rubber Tenergy 05 # Look up rubber specifications
/blade Viscaria # Look up blade information
/balls DHS DJ40+ # Ball specifications
```
### 🔍 Smart Search
Advanced search capabilities with fuzzy matching:
- **Partial name matching** - Find equipment even with incomplete names
- **Category suggestions** - Get recommendations when exact matches aren't found
- **Autocomplete** - Suggestions as you type
## 🎯 User Installation Benefits
When you **Add to Account**, you get:
- ✅ **DM Access** - Use all commands in direct messages
- ✅ **Cross-Server Profiles** - Your profile works everywhere
- ✅ **Personal Use** - Access bot features without server installation
- ✅ **Mobile Friendly** - Perfect for on-the-go equipment research
- ✅ **Privacy** - Use commands privately without server spam
Perfect for:
- 🛒 Equipment research while shopping online
- 💬 Sharing player stats in private conversations
- 🏓 Quick lookups during tournaments or practice
- 📱 Mobile access when you need information fast
## 📋 Command Reference
### Profile Commands
- `/profile view` - View your profile
- `/profile view @user` - View another user's profile
- `/profile edit` - Create or edit your profile
### Player & Rankings
- `/player ` - Look up player rankings and information
- `/rankings` - View current ITTF rankings
- `/tournament ` - Tournament information and results
### Equipment Lookup
- `/rubber ` - Rubber specifications and ratings
- `/blade ` - Blade specifications and characteristics
- `/balls ` - Ball information and specifications
### Utility
- `/help` - Comprehensive help and command guide
- `/about` - Bot information and statistics
- `/ping` - Check bot status and response time
## 🛠️ Technology Stack
- **Discord.js** - Modern Discord API wrapper
- **TypeScript** - Type-safe development
- **Bun** - Fast JavaScript runtime
- **RevSpin API** - Equipment database integration
- **ITTF Data** - Official ranking information
## 📈 Statistics
TableTennisDB serves thousands of table tennis players across multiple Discord servers, providing:
- Real-time ITTF ranking data
- Comprehensive equipment database
- Cross-platform profile management
- Fast, reliable command execution
## 🔒 Privacy & Data
- Profile data is securely stored
- Data is only used for bot functionality
- Cross-server profile sync respects user privacy
- No data is shared with third parties
## 🤝 Contributing
TableTennisDB is actively maintained and updated. For bug reports, feature requests, or contributions:
1. Join our [support server](https://discord.gg/MZ8hrES9Dd)
2. Report issues through Discord or GitHub
3. Suggest new features and improvements
4. Submit pull requests for improvements
We welcome contributions from the table tennis and Discord bot communities!
## 📄 License
TableTennisDB is open source software licensed under the [MIT License](LICENSE).
---
**Get started today!** Add TableTennisDB to your account and discover the ultimate table tennis companion for Discord.
[**Add to Account**](https://discord.com/oauth2/authorize?client_id=317185553349214209&integration_type=1&scope=applications.commands) • [**Add to Server**](https://discord.com/oauth2/authorize?client_id=317185553349214209&permissions=2147863616&scope=bot%20applications.commands) • [**Support Server**](https://discord.gg/MZ8hrES9Dd)