Create README.md

README.md

@@ -0,0 +1,76 @@
+
+# Discord Bot Setup Guide
+
+This guide explains how to create, configure, and run a Discord bot that responds to commands in a specific channel and reads data from a Google Sheet.
+
+---
+## Step 1: Create Your Bot on Discord
+
+1. **Go to the Discord Developer Portal**  
+   Visit [Discord Developer Portal](https://discord.com/developers/applications).
+
+2. **Create a New Application**  
+   Click on **"New Application"** and give your bot a name (e.g., "MyBot").
+
+3. **Add a Bot to the Application**  
+   Once the application is created, click on **"Bot"** in the left menu and then click **"Add Bot"**.
+
+4. **Copy the Authentication Token**  
+   Under "TOKEN", click on **"Copy"** to copy your **token** (keep it safe and don't share it!).
+   
+---
+## Step 2: Install Python Dependencies
+
+If you don't have Python installed, download it here: [Python](https://www.python.org/downloads/).
+
+Then, install the required libraries via pip:
+
+```bash
+pip install discord.py pandas gspread oauth2client
+```
+
+- `discord.py`: for interacting with the Discord API.
+- `pandas`: for manipulating the Google Sheets data.
+- `gspread` and `oauth2client`: for accessing Google Sheets (if your file is private).
+---
+
+## Step 5: Add Your Authorized Channel ID
+
+- Replace `AUTHORIZED_CHANNEL_ID = 123456789012345678` with the ID of the channel where you want to allow the command.
+- To get the channel ID, enable **Developer Mode** in Discord (User Settings > Advanced > Developer Mode), then **right-click** your channel and select **"Copy ID"**.
+
+---
+## Step 6: Obtain Your Google Sheet URL
+
+1. If your Google Sheet is **public**: Go to your Google Sheets file, then click on **"File" > "Publish to the web"** and copy the URL.
+2. If your Google Sheet is **private**, you will need to configure a **Google API key** and use it with `gspread` (this requires additional setup).
+
+For a **public file**, the URL will look like this:  
+`https://docs.google.com/spreadsheets/d/YOUR_FILE_ID/edit#gid=0`
+
+Replace `"YOUR_GOOGLE_SHEET_URL"` with your actual URL in the code.
+
+---
+## Step 8: Run Your Bot
+
+1. **Save your `bot.py` file** and make sure your Discord token is correct.
+2. **Run the bot** using the following command in your terminal:
+
+```bash
+python bot.py
+```
+
+---
+## Step 9: Invite the Bot to Your Server
+
+1. Go to the Discord Developer Portal and in **"OAuth2"** -> **"URL Generator"**.
+2. Check the required **permissions** like `bot` and `messages.read` to allow your bot to read and send messages.
+3. Copy the generated URL and open it in your browser to invite your bot to your Discord server.
+
+---
+## Summary
+
+- **The bot only responds** in a specific channel (using the channel ID).
+- It **ignores** the command in other channels.
+- It **reads data** from the **Google Sheet** only when the `!siege` command is called.
+---