Skip to content

zerebos/TableTennisDB

Repository files navigation

TableTennisDB 🏓

Discord Bots

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

🔗 Add to Server (Traditional)

Add TableTennisDB to your Discord server:

Add to Server

💬 Support

Need help? Join our support server 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 <name> - Look up player rankings and information
  • /rankings - View current ITTF rankings
  • /tournament <name> - Tournament information and results

Equipment Lookup

  • /rubber <name> - Rubber specifications and ratings
  • /blade <name> - Blade specifications and characteristics
  • /balls <name> - 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
  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.


Get started today! Add TableTennisDB to your account and discover the ultimate table tennis companion for Discord.

Add to AccountAdd to ServerSupport Server

About

Discord bot for table tennis equipment stats, world rankings, schedules and more!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages