# VRBattles Discord Bot (Development) This is the development version of the VRBattles Discord Bot. It connects to the VRBattles API and provides various commands for users to interact with VRBattles data through Discord. ## Setup 1. Clone the repository: ```bash git clone cd discord-bot ``` 2. Install dependencies: ```bash npm install ``` 3. Create a `.env` file based on `.env.example`: ```bash cp .env.example .env ``` 4. Set up your development environment: - Create a new Discord Application at https://discord.com/developers/applications - Create a new bot for your application - Get your bot token and client ID - Create a new Supabase project at https://supabase.com - Get your Supabase URL and anon key 5. Update your `.env` file with the development credentials: ```env DISCORD_TOKEN=your_dev_bot_token CLIENT_ID=your_dev_client_id SUPABASE_URL=your_dev_supabase_url SUPABASE_KEY=your_dev_supabase_key NODE_ENV=development ``` ## Development Start the bot in development mode: ```bash npm run dev ``` Deploy slash commands to your development Discord server: ```bash npm run deploy-commands:dev ``` ## Available Commands - `/ping` - Test bot connectivity - `/finduser` - Find a user by username - `/matchhistory` - View match history - `/findteam` - Find a team by name - `/subscribe` - Subscribe to game notifications (Admin only) - `/unsubscribe` - Unsubscribe from game notifications (Admin only) - `/register_server` - Register Discord server with BattleBot (Admin only) - `/list_subscriptions` - List all game subscriptions (Admin only) ## API Integration The bot connects to the following APIs: - VRBattles API (`https://www.vrbattles.gg/api/`) - Discord API (via discord.js) - Supabase Database ## Contributing 1. Create a new branch for your feature: ```bash git checkout -b feature/your-feature-name ``` 2. Make your changes and commit them: ```bash git add . git commit -m "Description of your changes" ``` 3. Push to your branch: ```bash git push origin feature/your-feature-name ``` 4. Create a Pull Request to merge into the dev branch