From b644516fd80a67c11e007e3061d7468084198fa0 Mon Sep 17 00:00:00 2001 From: Nitya Gosain Date: Fri, 10 Apr 2026 21:41:35 +0530 Subject: [PATCH 1/5] Add Ticket & Support System documentation Added documentation for the Ticket & Support System, detailing features and commands. --- docs/TICKETS.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/TICKETS.md diff --git a/docs/TICKETS.md b/docs/TICKETS.md new file mode 100644 index 0000000..1f0b509 --- /dev/null +++ b/docs/TICKETS.md @@ -0,0 +1,23 @@ +# Ticket & Support System + +Eigen Bot uses a professional thread-based support system to keep your server channels clean while providing high-touch assistance. + +## Features +- **Thread-Based**: Every ticket is a private thread, preventing channel clutter. +- **Multiple Categories**: General Support, Bug Reports, Feature Requests, Partnerships, and more. +- **Persistent Panels**: Button-based interfaces that remain active after bot restarts. +- **Staff Controls**: Specific roles can be assigned to "Claim" or "Force Close" tickets. + +## Commands +| Command | Description | +| :--- | :--- | +| `/ticketpanel` | Create a persistent ticket panel with buttons. | +| `/ticketlog` | Configure the channel for ticket action logs. | +| `/ticketsupport` | Set the role allowed to handle general support. | +| `/ticketreport` | Set the role for handling user reports. | +| `/ticketpartner` | Set the role for partnership management. | +| `/tickets` | List all open, closed, or total tickets. | +| `/ticketstats` | View performance metrics of your support team. | +| `/forceclose` | (Admin) Immediately archive and close a ticket thread. | + +[← Back to README](../README.md) From 027084b9087e482e8134a2221aef9dcf4410e99b Mon Sep 17 00:00:00 2001 From: Nitya Gosain Date: Fri, 10 Apr 2026 21:42:24 +0530 Subject: [PATCH 2/5] Add gaming and engagement systems documentation Added details about gaming and engagement systems including Counting Game, CodeBuddy Quizzes, and Daily Quest System. --- docs/GAMES.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/GAMES.md diff --git a/docs/GAMES.md b/docs/GAMES.md new file mode 100644 index 0000000..add8e3a --- /dev/null +++ b/docs/GAMES.md @@ -0,0 +1,21 @@ +# Gaming & Engagement Systems + +Eigen Bot integrates multiple systems to reward active members and foster friendly competition. + +## Counting Game +An anti-grief counting system with highscore tracking. +- **Anti-Double Count**: Prevents users from counting twice in a row (3 warnings = fail). +- **Save Protection**: Uses **Personal Saves** or **Server Saves** to prevent a reset to 0. +- **Commands**: `/setcountingchannel`, `?highscoretable`, `?donateguild` (Donate 1.0 personal save to gain 0.5 server save). + +## CodeBuddy Quizzes +Automated coding challenges to test your community's knowledge. +- **Leaderboards**: Track weekly and all-time streaks. +- **Commands**: `/codeweek`, `/codestreak`, `/codeflex` (Generates a stat card). + +## Daily Quest System +Earn rewards by completing daily tasks (e.g., answer 5 quizzes + count 5 numbers). +- **Rewards**: Earn **Streak Freezes** (protects CodeBuddy streaks) and **Saves** (protects the Counting Game). +- **Commands**: `?dailyquest`, `?inventory`. + +[← Back to README](../README.md) From 62a60a3c0fe5f3c89bcdd739fd6611573b4eef4b Mon Sep 17 00:00:00 2001 From: Nitya Gosain Date: Fri, 10 Apr 2026 21:44:52 +0530 Subject: [PATCH 3/5] Add full feature library documentation This document contains a comprehensive list of features including the Starboard System, Tag System, Election & Voting, and various utility and community modules. --- docs/FEATURES.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/FEATURES.md diff --git a/docs/FEATURES.md b/docs/FEATURES.md new file mode 100644 index 0000000..7024d34 --- /dev/null +++ b/docs/FEATURES.md @@ -0,0 +1,25 @@ +# Full Feature Library + +This document contains the complete list of utility, fun, and community modules. + +## Starboard System +Automatically highlight high-quality community content. +- `?starboard setup` : Define channel, emoji, and reaction threshold. +- `?starboard cleanup` : Admin tool to remove invalid or deleted entries. + +## Tag System +Store and retrieve custom text snippets. +- `?tags create ` : Save a reusable snippet. +- `?tag ` : Fetch a saved tag. + +## Election & Voting +- `?election create <candidates>` : Start a democratic vote. +- Supports **Weighted Voting** based on user roles or tenure. + +## Utility & Community +- **AFK**: `?afk [reason]` - Auto-responds to mentions when you're away. +- **Birthdays**: `?setbirthday <DD/MM>` - Automated birthday wishes. +- **Suggestions**: `/suggest <text>` - Creates an embed with voting reactions and a discussion thread. +- **Disboard Tracker**: `/bumplb` - View the leaderboard for users who bump the server. + +[← Back to README](../README.md) From 47716905914793959cdcf1e213f004896df7b15c Mon Sep 17 00:00:00 2001 From: Nitya Gosain <nityagosain@gmail.com> Date: Fri, 10 Apr 2026 21:53:32 +0530 Subject: [PATCH 4/5] Add advanced setup guide and technical architecture --- docs/SETUP_GUIDE.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/SETUP_GUIDE.md diff --git a/docs/SETUP_GUIDE.md b/docs/SETUP_GUIDE.md new file mode 100644 index 0000000..42e85af --- /dev/null +++ b/docs/SETUP_GUIDE.md @@ -0,0 +1,25 @@ +# Advanced Setup & Technical Architecture + +## Docker Deployment +### Using Docker Compose +```yaml +services: + bot: + build: . + env_file: .env + restart: always +``` +Run with: `docker-compose up -d` + +## Database Management +Eigen Bot uses **aiosqlite** for high-performance asynchronous operations. +- `botdata.db`: Main storage for tickets and CodeBuddy. +- `tags.db`: Dedicated tag storage. +- `starboard.db`: Starboard message mapping. + +## Security +- **Environment Variables:** Sensitive tokens are never hardcoded. +- **Permission Checks:** Role-based access control (RBAC) ensures only authorized users can use Admin/Staff commands. +- **Sanitization:** All user inputs are sanitized to prevent SQL injection. + +[← Back to README](../README.md) From 8f30a56bdfad04d99ea316691c4f3e8ae971a2f6 Mon Sep 17 00:00:00 2001 From: Nitya Gosain <nityagosain@gmail.com> Date: Fri, 10 Apr 2026 22:07:13 +0530 Subject: [PATCH 5/5] Update README.md --- README.md | 493 ++++++++++-------------------------------------------- 1 file changed, 90 insertions(+), 403 deletions(-) diff --git a/README.md b/README.md index 53d429a..84d54f8 100644 --- a/README.md +++ b/README.md @@ -1,465 +1,152 @@ -# Eigen Bot - Comprehensive Discord Community Bot +# Eigen Bot > **A feature-rich, production-ready Discord bot for community engagement, support tickets, entertainment, and powerful moderation tools.** -Eigen Bot is an all-in-one Discord bot designed for thriving communities. Built with modern async Python and discord.py, it offers a complete suite of features from support ticket systems and starboard highlights to voting systems and custom tags—all with hybrid command support (both prefix `?` and slash `/` commands). +Eigen Bot is an all-in-one Discord bot designed for thriving communities. Built with modern async Python and discord.py, it offers a modular suite of features accessible via hybrid commands (both prefix `?` and slash `/` commands). ---- - -## Developers -- [@youngcoder45](https://github.com/youngcoder45) -- [@1Frodox](https://github.com/1Frodox) - ---- - -## Command Types - -Eigen Bot supports **hybrid commands** - both prefix and slash commands: - -- **Prefix Commands** (Legacy): `?command` (e.g., `?dailyquest`, `?helpmenu`) - - Most commands use prefix commands for backward compatibility - - Fast, familiar, and don't require slash command permissions - -- **Slash Commands** (Modern): `/command` (e.g., `/help`, `/timestamp`) - - Selected commands available as slash commands for modern Discord experience - - Auto-complete and built-in Discord UI - - Limited to essential commands to stay within Discord's 100 command limit - -**Tip:** Use `?helpmenu` or `/help` to explore all available commands! - ---- - -## Core Features - -### ** Ticket System** -Professional support ticket management using Discord threads: - -**Features:** -- **Multiple Categories**: General Support, Bug Reports, Feature Requests, Partnership, Reports, Other Issues -- **Thread-Based Tickets**: Each ticket is a private thread with organized discussions -- **Interactive UI**: Button-based interface for creating and managing tickets -- **Ticket Controls**: Close tickets, claim tickets (for staff), automatic archiving -- **Customizable Roles**: Set different roles for support, reports, and partnerships -- **Ticket Logging**: Optional logging channel for all ticket actions -- **Persistent Panels**: Create ticket panels that survive bot restarts -- **Numbered Tickets**: Auto-incrementing ticket numbers for easy tracking - -**Commands:** -- `/ticketpanel` - Create a persistent ticket panel -- `/ticketlog` - Configure ticket logging channel -- `/ticketsupport` - Set support team role -- `/ticketreport` - Set report team role -- `/ticketpartner` - Set partnership team role -- `/tickets` - List all tickets (open, closed, or all) -- `/ticketstats` - View ticket system statistics -- `/forceclose` - Force close a ticket (admin) - -### ** Starboard System** -Highlight the best messages in your community: -- **Automatic Highlighting**: Messages that reach a star threshold appear in starboard -- **Customizable**: Set custom star emoji, adjustable threshold, self-starring toggle -- **Beautiful Embeds**: Dynamic colors based on star count, author thumbnails, timestamps -- **Real-time Updates**: Starboard messages update as stars are added/removed -- **Attachment Support**: Video attachments are linked in the starboard post so Discord can render previews/players -- **Smart Handling**: Tracks who starred what, prevents duplicates, handles uncached messages -- **Admin Tools**: `?starboard_cleanup` to remove invalid entries - -### ** Tag System** -Create and share custom text snippets: -- **Create Tags**: `?tags create <name> <content>` - Store reusable text -- **Retrieve Tags**: `?tag <name>` - Quickly fetch stored content -- **Edit Tags**: `?tags edit <name> <new_content>` - Update existing tags -- **Delete Tags**: `?tags delete <name>` - Remove unwanted tags -- **List Tags**: `?tags list` - View all server tags -- **Usage Tracking**: Tracks how many times each tag is used - -### ** Election/Voting System** -Democratic decision-making for your community: -- **Create Elections**: `?election create <title> <candidates> [duration]` -- **Weighted Voting**: Vote strength based on user roles/tenure -- **Multiple Candidates**: Support for 2-10 candidates per election -- **Live Results**: Real-time vote counting and display -- **Interactive Voting**: Button-based voting interface -- **Timed Elections**: Auto-close after specified duration - -### ** CodeBuddy System** -Engage your community with coding challenges and leaderboards: -- **Coding Quizzes**: Test your knowledge with automated coding questions -- **Leaderboards**: Weekly, all-time, and streak tracking -- **Stats & Flex**: Personal statistics and shareable stat cards -- **Engagement**: Earn points for correct answers and climb the ranks - -### ** Daily Quest System** -Complete daily challenges to earn powerful rewards! Inspired by popular quest systems: - -**Features:** -- **Daily Checklist**: Reset every 24 hours with fresh challenges -- **Quest Tasks**: - - Answer 5 CodeBuddy quiz questions - - Count 5 valid numbers in the counting channel -- **Rewards**: - - **Streak Freezes**: Protect your quiz streak when you answer wrong (consumes 1.0) - - **Saves**: Protect the counting game when you ruin the count (consumes 1.0) -- **Progress Tracking**: Monitor your daily quest completion in real-time - -**Commands:** -- `?dailyquest` / `?dq` / `?quests` - View daily quest progress -- `/dailyquest` - View quest progress (slash command) -- `?inventory` / `?inv` - Check your streak freezes and saves - -**How It Works:** -1. Complete either quest (Quiz or Counting) -2. Each quest completion awards **0.2** streak-freeze + **0.5** save -3. Inventory caps: max **2.0** streak-freezes and **4.0** saves -4. Use rewards strategically to maintain your streak and protect counting! - -### ** Fun Commands** -Entertainment and engagement features: -- **Programming Jokes**: `?joke` - Get a clean programming-related joke -- **Compliments**: `?compliment [@user]` - Give professional programming compliments -- **Fortune**: `?fortune` - Receive a programming-themed fortune -- **Trivia**: `?trivia` - Programming trivia questions -- **8-Ball**: `?8ball <question>` - Magic 8-ball responses -- **Coin Flip**: `?coinflip` - Heads or tails -- **Dice Roll**: `?roll [size] [count]` - Roll dice -- **Fridge**: `?fridge` / `/fridge` - Send a fridge image - -### ** Community Engagement** -Build an active, engaged community: -- **Random Quotes**: `?quote` - Inspirational programming quotes -- **Memes**: `?meme` - Random programming memes -- **Suggestions**: `?suggest <text>` / `/suggest <text>` - Posts a suggestion embed, adds vote reactions, and opens a discussion thread -- **Disboard Bump Leaderboard**: Tracks Disboard `/bump` activity in a configured channel with leaderboards and stats - -### ** Utility Commands** -Helpful tools for server management: -- **Emote List**: `?emotes [search]` - Browse server emojis -- **Member Count**: `?membercount` - View current server member count -- **Random Color**: `?randomcolor` - Generate random hex colors -- **Reminders**: `?remindme <time> <message>` - Set personal reminders -- **Timestamps**: `/timestamp` - Generate Discord timestamps with timezone support - -### ** Support & Feedback** -Connect with our support team: -- **Bug Reports**: `?bug` or `/bug` - Report bugs directly to our support server -- **Feature Requests**: `/newfeature` - Suggest new features or improvements -- **Feedback**: `/feedback` - Share your feedback with a 1-5 star rating -- **Support Server**: `?support` or `/support` - Get the support server invite link -- All reports are sent directly to our support team for review - -### ** AFK System** -- **Set AFK**: `?afk [reason]` - Set your AFK status with an optional reason -- **Auto-respond**: Bot automatically notifies users when they mention you -- **Time Tracking**: Shows how long you've been AFK -- **Smart Removal**: Automatically removes AFK status when you send a message - -### ** Birthday System** -Celebrate community birthdays: -- **Set Birthday**: `?setbirthday <DD/MM>` - Register your birthday -- **Birthday List**: `?birthdays` - View upcoming birthdays -- **Announcements**: Automatic birthday wishes on your special day -- **Privacy**: Only stores day and month, not year - -### ** Counting Game** -Run a server counting game with anti-grief protections and highscores: -- **Set Channel**: `/setcountingchannel <channel>` - Admin-only, choose the counting channel -- **Double-count Warnings**: Counting twice in a row gives `⚠️` warnings (3 warnings triggers a fail) -- **Save Protection**: If someone posts the wrong number, the bot tries to consume a **personal save** first, then a **server save**; otherwise the count resets to 0 -- **Deleted Number Logging**: If a valid counting number is deleted, the bot announces who deleted it -- **Highscore Marker**: When the server reaches/ties the highscore, the message is marked with ✅ + 🏆 until the count is ruined -- **Highscore Table**: `?highscoretable` / `/highscoretable` (and `?highscores`) - View recent highscore history -- **Donate Saves to Server Pool**: `?donateguild` / `?dg` - Donate **1.0** personal save; server gains **0.5** save -- **View Server Save Pool**: `?guildsaves` - Show current server saves (needs **1.0** to protect a ruined count) - -### ** Staff Applications** -Collect staff applications via DMs and review them in a configurable channel: -- **Post Panel**: `?panel` / `/panel` - Admin-only, posts the staff application panel -- **Set Review Channel**: `/setapps [channel]` - Admin-only, change where applications are sent (can be changed anytime) -- **View User Applications**: `/applications <user>` - View a user’s application history - -### ** Voice (Just For Fun)** -Simple voice utilities: -- **Join Voice**: `?join-vc` / `/join-vc` - Bot joins your current voice channel (won’t join empty channels) -- **Auto Leave**: Bot disconnects when the last non-bot user leaves - -### ** Admin & Moderation** -Powerful tools for server administrators: -- **Bot Management**: `?reload <cog>` - Reload cogs on the fly -- **Command Sync**: `?sync` - Sync slash commands -- **Permission-Based**: All admin commands restricted to administrators/bot owner +[**Quick Start**](#quick-start) • [**Feature Index**](#feature-index) • [**Detailed Setup**](./docs/SETUP_GUIDE.md) • [**Support Server**](https://discord.gg/yourlink) --- -## Technical Excellence - -### **Architecture & Design** -- **Async/Await**: Full async implementation for optimal performance -- **Hybrid Commands**: Every command works with both `?` prefix and `/` slash commands -- **Cog-Based Structure**: Modular design for easy maintenance and extensibility -- **Type Hints**: Comprehensive type annotations throughout codebase -- **Error Handling**: Graceful error handling with user-friendly messages - -### **Database & Persistence** -- **SQLite**: File-based database for tags, starboard, invites, and tickets -- **aiosqlite**: Async SQLite operations for better performance -- **CodeBuddy Database**: Separate database for coding leaderboards -- **Data Integrity**: Proper constraints, indexes, and transaction handling - -### **Performance & Reliability** -- **Connection Pooling**: Efficient database connection management -- **Caching**: Smart caching for starboard and invite systems -- **Rate Limiting**: Built-in cooldown management -- **Graceful Degradation**: Continues working even if some features fail -- **Comprehensive Logging**: Detailed logs for debugging and monitoring - -### **Security & Safety** -- **Environment Variables**: Secure token and config storage -- **Permission Checks**: Role-based command access control -- **Input Validation**: Sanitization of user inputs -- **SQL Injection Prevention**: Parameterized queries throughout +### Quick Links +* **[Ticket System](./docs/TICKETS.md)** — Professional thread-based support management. +* **[Gaming & Quests](./docs/GAMES.md)** — Counting game, CodeBuddy, and Daily Quests. +* **[Full Feature List](./docs/FEATURES.md)** — Comprehensive command library. +* **[Advanced Configuration](./docs/SETUP_GUIDE.md)** — Docker, Env Vars, and Database info. --- -## Installation & Setup - -### **Prerequisites** -- Python 3.11 or higher -- FFMpeg (for TTS command) -- Discord Bot Token ([Get one here](https://discord.com/developers/applications)) -- Git (for cloning) - -### **Quick Start** - -1. **Clone the Repository** - ```bash - git clone https://github.com/youngcoder45/Eigen-bot-In-Python.git - cd Eigen-bot-In-Python - ``` - -2. **Create Virtual Environment** - ```bash - python -m venv .venv - - # Linux/macOS - source .venv/bin/activate - - # Windows - .venv\\Scripts\\activate - ``` - -3. **Install Dependencies** - ```bash - pip install -r requirements.txt - ``` - -4. **Configure Environment** - ```bash - cp .env.example .env - # Edit .env with your bot token and settings - ``` - -5. **Run the Bot** - ```bash - python bot.py - ``` - -### **Environment Variables** - -Create a `.env` file with the following: - -```env -# Required -DISCORD_TOKEN=your_bot_token_here - -# Bot Configuration -OWNER_ID=your_discord_user_id -LOG_LEVEL=INFO - -# Development (optional) -# For faster slash command sync (guild-scoped). You can provide one or many guild IDs. -# Preferred (multi-guild): comma-separated or JSON list -GUILD_IDS=1410939321812258928,1263067254153805905 -# Backwards compatible (single guild): -GUILD_ID=your_test_server_id - -# CodeBuddy (optional) -QUESTION_CHANNEL_ID=channel_id_for_coding_questions -``` - ---- - -## Usage Guide - -### **Command Prefixes** -- **Prefix Commands**: `?command` (e.g., `?help`) -- **Slash Commands**: `/command` (e.g., `/help`) -- **Hybrid**: Most commands support both formats! - -### **Ticket Commands** -``` -/ticketpanel [#channel] [support_role] - Create ticket panel -/ticketlog [#channel] - Set ticket log channel -/ticketsupport [role] - Set support team role -/tickets [status] [user] - List tickets -/ticketstats - View statistics -/forceclose <ticket_id> [reason] - Force close ticket -``` - -### **Starboard Commands** -``` -?starboard setup #channel <threshold> <emoji> - Setup starboard -?starboard stats - View statistics -?starboard toggle - Enable/disable -``` +### Quick Start +Get Eigen Bot running in under 2 minutes. Ensure you have **Python 3.11+** and **FFMpeg** installed. -### **Tag Commands** +#### 1. Clone the repository ``` -?tag <name> - Retrieve a tag -?tags create <name> <content> - Create new tag -?tags edit <name> <content> - Edit existing tag -?tags delete <name> - Delete a tag -?tags list - List all tags +git clone [https://github.com/youngcoder45/Eigen-bot-In-Python.git](https://github.com/youngcoder45/Eigen-bot-In-Python.git) +cd Eigen-bot-In-Python ``` -### **CodeBuddy Commands** +#### 2. Setup Virtual Environment ``` -/codeweek - Weekly coding leaderboard -/codestreak - View streak leaderboard -/codeleaderboard - All-time leaderboard -/codestats [@user] - View coding stats -/codeflex - Generate stats card image +python -m venv .venv +source .venv/bin/activate # Windows: .venv\Scripts\activate ``` -### **Fun Commands** +#### 3. Install Dependencies ``` -?joke - Programming joke -?compliment [@user] - Give compliment -?fortune - Programming fortune -?trivia - Programming trivia -?8ball <question> - Magic 8-ball -?coinflip - Flip a coin -?roll [size] [count] - Roll dice -?fridge - Send a fridge image +pip install -r requirements.txt ``` -### **Suggestions Commands** +#### 4. Configure & Run ``` -/setsuggestchannel #channel - Set the channel where suggestions are posted (Manage Server) -/suggest <text> - Submit a suggestion (posts embed + vote reactions + discussion thread) -``` - -### **Bump Leaderboard Commands (Disboard)** -``` -/setbumpchannel #channel - Set the bump channel to track Disboard bumps (Manage Server) -/bumplb - Show the bump leaderboard (top 10) -/bumpstats - Show bump totals and most recent bumper -?mybumps - Show your bump stats -?blb / ?bst / ?topbump - Prefix aliases -/addbumps @user <amount> - Admin: add bumps to a user -/removebumps @user <amount> - Admin: remove bumps from a user +cp .env.example .env # Add your DISCORD_TOKEN to .env +python bot.py ``` --- -## Economy Bot (Separated) +### Essential Env Vars -Economy and casino features have been moved to a separate bot. Check the `another-bot/` folder for: -- Economy system (balance, work, daily, weekly, etc.) -- Casino games (blackjack, roulette, slots, etc.) -- Economy admin commands - -See `another-bot/README.md` and `another-bot/MIGRATION_SUMMARY.md` for setup instructions. +| Variable | Description | +|------------------|-----------------------------------------------------------| +| `DISCORD_TOKEN` | Required. Your bot application token. | +| `OWNER_ID` | Your Discord user ID for admin overrides. | +| `GUILD_IDS` | Comma-separated IDs for fast slash command syncing. | --- -## Database Files - -``` -├── botdata.db # Main database (tickets, codebuddy) -├── tags.db # Tag system -├── starboard.db # Starboard system -└── invites.db # Invite tracker (if enabled) -``` - -Other persisted data (JSON, stored in `data/`): -- `data/quotes.json` - Quote dataset for `?quote` - -Suggestions config and bump leaderboard data are stored in `botdata.db`. +## Feature Index + +Every module is moved to detailed markdown files in `/docs` for easy scanning. +### Support Tickets +Thread-based categories (Bugs, Support, Partnerships) with persistent button panels. +### Engagement Games +Anti-grief Counting game, CodeBuddy quizzes, and Daily Quest rewards. +### Starboard System +Automatic highlighting of community-voted content with dynamic embeds. +### Tag System +High-speed custom text snippet storage and retrieval. +### Elections & Voting +Democratic decision-making with weighted roles. +### Staff Applications +DM-based application system with admin review channels. --- -## Docker Deployment +## Secondary Information -### **Using Docker** -```bash -# Build image -docker build -t eigen-bot . +<details> +<summary><b>Fun & Utility Commands</b></summary> -# Run container -docker run -d --env-file .env eigen-bot -``` +### Fun +- `?joke` +- `?trivia` +- `?8ball` +- `?coinflip` +- `?roll` +- `?fridge` -### **Using Docker Compose** -```bash -docker-compose up -d -``` +### Utility +- `?afk` +- `?setbirthday` +- `?remindme` +- `/timestamp` ---- - -## Contributing - -We welcome contributions! Here's how: - -1. **Fork** the repository -2. **Create** a feature branch -3. **Commit** your changes -4. **Push** to the branch -5. **Open** a Pull Request - ---- +### Social +- `?quote` +- `?meme` +- `/suggest` +- `/bumplb` -## License +Full details available in **FEATURES.md** -This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details. +</details> --- -## Legal +<details> +<summary><b>Technical Excellence</b></summary> -- **Terms of Service**: [View Terms](TERMS_OF_SERVICE.md) -- **Privacy Policy**: [View Privacy Policy](PRIVACY_POLICY.md) +### Architecture +Modular Cog-based structure for easy hot-reloading (`?reload`). +### Persistence +Uses **aiosqlite** for async database operations across dedicated `.db` files. +### Security +Role-based access control (RBAC) and parameterized SQL queries to prevent injection. +### Deployment +Fully containerized for **Docker** and **Docker Compose**. -By using Eigen Bot, you agree to our Terms of Service and Privacy Policy. +</details> --- -## Support & Documentation +<details> +<summary><b>Contributing & Legal</b></summary> -### **Getting Help** -- **Bug Reports**: [Open an issue](https://github.com/youngcoder45/Eigen-bot-In-Python/issues) -- **Feature Requests**: [Open an issue](https://github.com/youngcoder45/Eigen-bot-In-Python/issues) +### Contribute +We welcome PRs! See **[CONTRIBUTING.md](CONTRIBUTING.md)** ---- +### Economy +Economy features have moved to the `another-bot/` repository. -## Acknowledgments +### License +[MIT License](LICENSE) -Built with: -- [discord.py](https://github.com/Rapptz/discord.py) - Discord API wrapper -- [aiosqlite](https://github.com/omnilib/aiosqlite) - Async SQLite -- [python-dotenv](https://github.com/theskumar/python-dotenv) - Environment management +### Legal +[Terms of Service](TERMS_OF_SERVICE.md) | [Privacy Policy](PRIVACY_POLICY.md) -Special thanks to the discord.py community and all contributors! +</details> --- <div align="center"> -**Eigen Bot** - Where Community Meets Support +## Eigen Bot +### Where Community Meets Support + +Developed by **[@youngcoder45](https://github.com/youngcoder45)** & **[@1Frodox](https://github.com/1Frodox)** [GitHub](https://github.com/youngcoder45/Eigen-bot-In-Python) • [Issues](https://github.com/youngcoder45/Eigen-bot-In-Python/issues) Made with ❤️ for Discord communities </div> - -