Discord TCG Bot

A Discord bot that implements a Trading Card Game (TCG) system with card collecting and trading mechanics. Battles and other features coming soon!

Features

• Card collection system with different rarities and sets
• Card trading between users
• Card fusion system
• Pack opening mechanics
• User profiles with collection statistics
• Currency system for purchasing packs
• Experience and leveling system

Commands

All commands use the /tcg prefix:

Collection Management

• /tcg open - Open a new pack of cards (Costs credits)
• /tcg view [rarity] [set] - View your card collection with optional rarity and set filters
• /tcg showcollection - Display your complete card collection
• /tcg inspect <card_name> - View detailed information about a specific card
• /tcg profile [@user] - View your or another user's collection statistics and card breakdown

Trading System

• /tcg trade offer <cards> <for> <user> - Offer a trade to another user
• /tcg trade accept <trade_id> - Accept a trade offer
• /tcg trade cancel <trade_id> - Cancel a trade offer
• /tcg tradeup - Trade up multiple cards of the same rarity for a higher rarity card

Card Fusion

• /tcg fuse <card1> <card2> - Fuse two cards to create a special fused card

Economy

• /tcg earn - Earn currency (with cooldown)
• /tcg givecurrency <user> <amount> - [Admin] Give currency to a user

Utility

• /tcg help - List all available commands and their functions

Scripts

Card Management

• generateCardImages.js - Generate card images and sync card data to the database
  • Usage: npm run generate-images
  • Generates images for cards that need them
  • Updates cards.json with image URLs
  • Syncs all cards to the MongoDB database

Bot Management

• deployCommands.js - Deploy slash commands to Discord
  • Usage: npm run deploy-commands
  • Registers all commands with Discord's API

Database Management

• resetBot.js - Reset the bot's database state
  • Usage: npm run reset-bot
  • Clears all user data, collections, and trades
  • Use with caution!

Migration Scripts

• migrateLastWaterDrink.js - Migration script for legacy data
  • Usage: npm run migrate-water-drink
  • Migrates data from the old water drink system

Setup

1. Clone the repository
2. Install dependencies:

   npm install

3. Create a .env file with the following variables:

   DISCORD_TOKEN=your_bot_token
   MONGODB_URI=your_mongodb_uri
   

4. Deploy commands:

   npm run deploy-commands

5. Start the bot:

   npm start

Configuration

The bot's configuration can be modified in src/config/config.js:

• Currency name and costs
• Experience and leveling settings
• Card rarity probabilities
• Cooldown timers
• Other game mechanics

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.