- 📍 Overview
- 📦 Features
- 📂 Structure
- 💻 Installation
- 🏗️ Usage
- 🌐 Hosting
- 📄 License
- 👏 Authors
This repository contains the Pokémon Generation Bot, a Discord bot providing users with images and normalized stats (0-31) for all Pokémon across all generations, including shiny variants. The bot utilizes Python with the discord.py library and an SQLite database (optional). Data is primarily sourced from PokeAPI.
| Feature | Description | |
|---|---|---|
| 1 | /p!info Command |
Retrieves detailed Pokémon information, including stats and image. |
| 2 | /p!p Command |
Displays Pokémon image and normalized stats (0-31). Supports shiny variants using "shiny [Pokémon Name]". |
| 3 | /p!start Command |
Provides initial instructions on bot usage. |
| 4 | Shiny Pokémon Support | Retrieves and displays both regular and shiny Pokémon variants. |
| 5 | Image Caching | Caches images locally to reduce API calls and improve performance. |
| 6 | Error Handling | Includes robust error handling for API failures, invalid input, and missing data. |
| 7 | Asynchronous Operations | Uses asynchronous operations for improved responsiveness and efficiency. |
| 8 | Modular Design | Follows a modular design with separate files for commands and utility functions. |
| 9 | Credit System (Future) | Foundation laid for a future credit system to enhance user engagement. |
| 10 | Admin Permissions (Future) | Foundation laid for future administrative controls for bot management. |
text
pokemon-generation-bot/
├── bot.py
├── commands/
│ ├── info.py
│ ├── pokemon.py
│ └── start.py
├── data/
│ └── pokemon.db
├── images/
├── .env
├── requirements.txt
└── tests/
├── test_commands.py
└── test_utils.py
- Python 3.9+
pip
-
Clone the repository: bash git clone https://github.com/coslynx/Pokemon-Discord-Info-Bot.git cd Pokemon-Discord-Info-Bot
-
Create a virtual environment (recommended): bash python3 -m venv .venv source .venv/bin/activate
-
Install dependencies: bash pip install -r requirements.txt
-
Configure
.env(replace placeholders with your Discord bot token and PokeAPI base URL):cp .env.example .env
-
Run the bot: bash python bot.py
-
Invite the bot to your Discord server.
-
Use the commands:
/p!start,/p!p [Pokémon Name],/p!info [Pokémon Name]
Hosting instructions would depend on your chosen platform (e.g., Heroku, AWS, Google Cloud). A Dockerfile is provided for containerization to facilitate deployment. Ensure your chosen platform has Python 3.9+, discord.py (2.1.0 or later), requests (2.31.0 or later), Pillow (10.0.0 or later), and aiosqlite (0.18.0 or later) installed. You will also need to set the DISCORD_TOKEN and POKEAPI_BASE_URL environment variables.
This Minimum Viable Product (MVP) is licensed under the GNU AGPLv3 license.
This MVP was entirely generated using artificial intelligence through CosLynx.com.
No human was directly involved in the coding process of the repository: Pokemon-Discord-Info-Bot
For any questions or concerns regarding this AI-generated MVP, please contact CosLynx at:
- Website: CosLynx.com
- Twitter: @CosLynxAI
Create Your Custom MVP in Minutes With CosLynxAI!
