📋 Requirements

• Node.js v22.11.0
• npm v10.9.0

📦 Download: Node.js & npm

📥 Steps

1. Clone the repository:

   git clone https://github.com/MeoMunDep/Discord-Autobot.git
   cd "discord-autobot"
   

2. Install dependencies:

   npm install
   

   ⚠️ If you see an Execution Policy error on Windows:

   Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
   

   Then rerun:

   npm install
   

3. Configure the bot: Edit the configs.json file to suit your preferences.

4. Prepare input files:

   • 📄 tokens.txt — Discord tokens (one per line)
   • 🆔 servers.json — Server details including guild IDs, invite codes, and channel configurations (see detailed explanation below)
   • 🌐 proxies.txt — Proxies (optional)
   • 📜 messages.yaml — Messages (multi-language)
   • 🗂️ error_channels.json — Stores failed channels/servers (automatically generated/updated)

📌 Helpful links:

• 🔑 Get tokens: Here
• 💬 Get chat ID: Here
• 📡 Get channel/server ID: Here

🧾 Example configs.json

{
  "maxAccountsAtOnce": 1,
  "delay_between_accounts": 15,
  "delay_each_channel": [5, 7],
  "delay_each_chat": [10, 15],
  "time_to_restart_all_accounts": 963,

  "auto_chat": true,
  "submit_x_url": false,
  "delete_message": false,
  
  
  "join_server": false,
  "leave_server": false,

  "enable_replies": true,
  "ai_reply_chance": 0.7,

  "enable_reactions": true,
  "reaction_chance": 0.7,
  
  "ai_providers": {
    "poe": [""],
    "groq": [""],
    "gemini": [""],
    "openrouter": [""]
  },

  "image_generation_providers": {
    "freepik": [""]
  },

  "voice_chat": {
    "enabled": true,
    "server_id": "",
    "channel_id": "",
    "user_id": ""
  }
}

The servers.json file is the heart of your bot configuration. It defines which servers to interact with and what actions to perform in each channel.

📚 Basic Structure

The file should be a JSON array containing server objects. Each server represents a Discord server you want the bot to interact with.

[
  {
    "name": "Server Name",
    "guild_id": "1234567890123456789",
    "invite_id": "inviteCode",
    "channels": { ... },
    "enabled": true
  }
]

🔑 Field Explanations

1️⃣ name (String - Required)

• What it is: A friendly name for the server (for your reference only)
• Example: "Curious", "My Gaming Server", "Crypto Community"
• Purpose: Helps you identify servers in logs and configuration

2️⃣ guild_id (String - Required)

• What it is: The Discord server's unique ID
• How to get it: Follow this guide
• Example: "1417067849926705235"
• Purpose: Used for leaving servers when leave_server: true in configs

3️⃣ invite_id (String - Required)

• What it is: The invite code for joining the server
• Example: "altiuslabs" (from discord.gg/altiuslabs)
• Special values:
  • "" (empty string) - Don't join this server
  • "none" - Don't join this server
  • "unknown" - Don't join this server
• Purpose: Used for joining servers when join_server: true in configs

4️⃣ enabled (Boolean - Required)

• What it is: Controls whether the bot processes this server
• Values:
  • true - Bot will process this server (send messages, join, etc.)
  • false - Bot will skip this server completely
• Purpose: Allows you to temporarily disable servers without deleting their configuration

5️⃣ channels (Object - Required)

This is where you define what the bot does in each channel. It has three categories:

🗨️ Channel Types

📝 raw_chat - Text Messages

Send regular text messages to channels.

Format:

"raw_chat": {
  "CHANNEL_ID": "MESSAGE_TO_SEND"
}

Special Values:

• "__random_message" - Bot will use AI or random message from messages.yaml
• Any specific text - Bot will send exactly this text (e.g., "gm", "Hello!")

Example:

"raw_chat": {
  "1417068171243815002": "__random_message",
  "1417084328504197250": "gm",
  "9876543210987654321": "Hello everyone!"
}

What happens:

• In channel 1417068171243815002: Bot sends AI-generated or random message
• In channel 1417084328504197250: Bot sends "gm"
• In channel 9876543210987654321: Bot sends "Hello everyone!"

🤖 command_chat - Bot Commands

Send slash commands or bot commands to channels.

Format:

"command_chat": {
  "CHANNEL_ID": "COMMAND_TO_EXECUTE"
}

Example:

"command_chat": {
  "1234567890123456789": "/claim daily",
  "9876543210987654321": "/rewards"
}

What happens:

• In channel 1234567890123456789: Bot executes /claim daily command
• In channel 9876543210987654321: Bot executes /rewards command

Note: This feature requires the bot to be configured for the specific bot's command structure.

🖼️ image_chat - AI-Generated Images

Generate and send AI images to channels using Freepik API. Get Freepik API key from here: Link

Format:

"image_chat": {
  "CHANNEL_ID": "IMAGE_GENERATION_PROMPT"
}

Example:

"image_chat": {
  "1435601397591703675": "Curious browser",
  "9876543210987654321": "Beautiful sunset over mountains",
  "1111222233334444555": "Cyberpunk city at night"
}

What happens:

• In channel 1435601397591703675: Bot generates image with prompt "Curious browser" and sends it
• In channel 9876543210987654321: Bot generates "Beautiful sunset over mountains" image
• In channel 1111222233334444555: Bot generates "Cyberpunk city at night" image

Requirements:

• Must have freepik API key configured in configs.json
• If Freepik fails, bot automatically falls back to Pollinations.ai (free, no API key needed)

📋 Complete Example

[
  {
    "name": "Curious Community",
    "guild_id": "1417067849926705235",
    "invite_id": "curious",
    "channels": {
      "raw_chat": {
        "1417068171243815002": "__random_message",
        "1417084328504197250": "gcurious"
      },
      "command_chat": {
        "1417068171243815003": "/daily claim"
      },
      "image_chat": {
        "1435601397591703675": "Curious browser logo"
      }
    },
    "enabled": true
  },
  {
    "name": "Gaming Server",
    "guild_id": "9876543210987654321",
    "invite_id": "gaming123",
    "channels": {
      "raw_chat": {
        "1111111111111111111": "gm",
        "2222222222222222222": "__random_message"
      },
      "command_chat": {},
      "image_chat": {}
    },
    "enabled": true
  },
  {
    "name": "Disabled Server (Not Active)",
    "guild_id": "5555555555555555555",
    "invite_id": "oldserver",
    "channels": {
      "raw_chat": {
        "3333333333333333333": "test message"
      },
      "command_chat": {},
      "image_chat": {}
    },
    "enabled": false
  }
]

⚙️ How Bot Processes Servers

1. Read servers.json - Loads all server configurations
2. Check enabled - Skips servers with enabled: false
3. Join Server (if join_server: true in configs) - Uses invite_id
4. Process Channels (if auto_chat: true in configs):
   • Processes raw_chat channels → Sends text messages
   • Processes command_chat channels → Executes commands
   • Processes image_chat channels → Generates and sends images
5. Leave Server (if leave_server: true in configs) - Uses guild_id
6. Repeat for next server

💡 Tips & Best Practices

✅ DO:

• Use descriptive names for servers to easily identify them
• Set enabled: false to temporarily disable servers without losing configuration
• Leave channel categories empty {} if not using them
• Use "__random_message" for more natural, varied conversations
• Test with one server first before adding multiple servers

❌ DON'T:

• Don't delete server entries - use enabled: false instead
• Don't put channel IDs in quotes within objects (they're already strings)
• Don't forget commas between objects in arrays
• Don't use invalid JSON syntax (use a JSON validator if unsure)

🔍 Finding Channel IDs

1. Enable Developer Mode in Discord (Settings → Advanced → Developer Mode)
2. Right-click on any channel
3. Click "Copy Channel ID"
4. Paste the ID into servers.json

Visual Guide

🐛 Troubleshooting

📌 Run the bot

node index_meomundep.js

⬆️ Update the bot

git pull

🔍 How It Works

1. Reads configuration from configs.json
2. Logs in using provided tokens from tokens.txt
3. Applies proxy per account (if available in proxies.txt)
4. Processes each server from servers.json:
   • ✅ Checks if server is enabled: true
   • ➕ Joins server (using invite_id) if join_server: true
   • 💬 Sends messages/commands/images to channels if auto_chat: true
   • ➖ Leaves server (using guild_id) if leave_server: true
5. Logs every event with timestamps and colored output
6. Waits for delays between actions (configurable)
7. Repeats automatically after timeToRestartAllAccounts seconds

📝 Logs and Timestamps

• Each log entry includes a timestamp
• Timestamp format follows chat_language setting
• Color-coded logs for easy reading:
  • 🟢 Green - Success
  • 🔴 Red - Error
  • 🟡 Yellow - Warning
  • 🔵 Blue - Info
  • 🟣 Purple - Processing

⚠️ Important Notes

• ✅ Ensure all tokens are valid and have required permissions
• 🌐 Use proxies to avoid rate limits or bans (one proxy per token recommended)
• ⏱️ Tune delay settings carefully for larger account sets
• 📊 Monitor logs for errors and adjust servers.json accordingly
• 🔒 Keep your tokens and API keys private and secure
• 🚫 Don't share your tokens.txt file with anyone
• 💾 Bot automatically saves errors to error_channels.json to avoid retrying failed channels