University Moderation Bot 🤖

Unified moderation and utility platform for Discord and Telegram, featuring music, games, schedules, and community management.

---

✨ Core Features

Cross-Platform

• 🔄 Unified Configuration - Single settings for both platforms
• 📝 Centralized Logging - Comprehensive event and error tracking
• 🗃️ Database Integration - PostgreSQL backend for persistent data
• 🔄 Version Control - Track changes and updates

Discord-Specific

• 🎵 Music Player - Stream music via Lavalink
• 🎮 Mafia Game - Host mafia games on your server
• 👑 Role Management - Assign and moderate roles
• 📅 Event Scheduling - Create and notify about events
• 🔊 Voice Channel Automation - Dynamic voice channel creation
• 🌈 RGB Decorations - Customize server appearance
• 📊 Activity Tracking - Monitor user engagement

Telegram-Specific

• 📅 Schedule Integration - Sync and manage events
• 🔄 Discord Synchronization - Cross-platform data sharing

---

🧰 Tech Stack

• Core:
• Discord:
• Telegram:
• Database:
• Music:
• APIs:
• Web:
• Utilities:

---

⚙️ Installation & Setup

Prerequisites

• Python 3.8+
• PostgreSQL
• Java Runtime Environment (for Lavalink)

Steps

1. Clone repository

   git clone https://github.com/Zebaro24/University-Moderation.git
   cd university-moderation

2. Create virtual environment

   python -m venv venv
   # Windows
   venv\Scripts\activate
   # Linux/Mac
   source venv/bin/activate

3. Install dependencies

   pip install -r requirements.txt

4. Configure environment
   Copy .env.example to .env and fill in your details:

   TELEGRAM_API=your_telegram_token
   DISCORD_API=your_discord_token
   DB_NAME=database_name
   DB_USER=database_user
   DB_PASSWORD=database_password
   DB_HOST=localhost
   DB_PORT=5432
   SPOTIFY_CLIENT_ID=your_spotify_client_id
   SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
   OWM_API_KEY=your_openweathermap_key

5. Set up Lavalink

   • Configure application.yml
   • Start the server:

   java -jar Lavalink.jar

---

🚀 Launching the Bot

python worker.py

---

🗂️ Project Structure

discord_bot/          # Discord modules
├── mafia/            # Mafia game mechanics
├── music/            # Music player
├── roles/            # Role management
├── timetable/        # Schedule for Discord
telegram_bot/         # Telegram modules
├── timetable/        # Schedule for Telegram
tg_ds/                # Shared functions
timetable/            # Core schedule logic
.env                  # Environment variables
config.py             # Application configuration
database_func.py      # Database functions
main_bot_function.py  # Core bot functions
requirements.txt      # Dependencies
worker.py             # Main executable

---

🎮 Feature Highlights

Discord Features	Telegram Features

---

🛠️ API & Extensibility

Database Functions

Use database_func.py for database operations:

from database_func import add_event, get_events

# Add event
add_event(guild_id, "Meeting", "2023-12-31 20:00")

# Get events
events = get_events(guild_id)

Adding Discord Commands

from discord_bot.discord_command import register_command

@register_command(name="hello", description="Says hello")
async def hello(ctx):
    await ctx.send(f"Hello {ctx.author.name}!")

---

📬 Contact

• Developer: Denys Shcherbatyi
• Email: zebaro.work@gmail.com