Skip to content

README.md

Latest commit

 

History

History
78 lines (52 loc) · 1.81 KB

README.md

File metadata and controls

78 lines (52 loc) · 1.81 KB
Raw

BaseFinder

BaseFinder is a Discord bot built with nextcord that helps Clash of Clans players find base layout links from YouTube videos — including War, CWL, and Legend bases for Town Hall levels 15–17.

🛠 Features

  • 🎯 Slash command: /find_bases to search by Town Hall and base type
  • 🔍 Filters recent uploads from hand-picked YouTube channels
  • 🔗 Extracts official Clash of Clans layout links from video descriptions
  • 🧠 Smart caching and API key rotation to avoid YouTube quota limits
  • 📩 Sends results privately via DM to reduce chat spam

🚀 Getting Started

1. Clone and install dependencies

git clone https://github.com/leaskeg/BaseFinder.git
cd BaseFinder
pip install -r requirements.txt

2. Create a .env file

DISCORD_TOKEN=your_discord_bot_token
API_KEYS=your_youtube_api_key1,your_youtube_api_key2

You can get YouTube Data API v3 keys from the Google Cloud Console.

3. Add channel IDs

Edit or create a channels.txt file, with one YouTube channel ID per line:

UCk7iPlcw-X7_3IMLqN2Vj2w
UCa9iS8-4Yxay_Nd0gBz8i9A
...

4. Run the bot

python basefinder.py

✅ Slash Command Usage

/find_bases base_level: TH16 base_type: War
  • Returns up to 5 layout links from recent videos matching your criteria.
  • Sends them to your DMs to keep the chat clean.

📦 Requirements

  • Python 3.8+
  • nextcord
  • python-dotenv
  • google-api-python-client

Install everything via:

pip install -r requirements.txt

🤝 Contributing

Got a new feature idea or found a bug? Feel free to fork the repo and open a PR!

📜 License

MIT License

Made with ❤️ for the Clash of Clans community by leaskeg