🤖 ManagerX Discord Bot
Der ultimative All-in-One Bot für professionelles Community Management
╔══════════════════════════════════════════════════════════════════════╗
║ ║
║ 🤖 Professionelles Discord Bot Framework für Communities 🚀 ║
║ ║
║ Moderation • Leveling • Welcome • TempVC • Globalchat • Stats ║
║ ║
╚══════════════════════════════════════════════════════════════════════╝
Entwickelt von OPPRO.NET Development | ⚡ Powered by OPPRO.NET Network™
📦 Quick Install
📥 Detaillierte Installation • ✨ Features • 📖 Dokumentation • 💬 Support
🛡️ Moderation & Sicherheit🔒 Advanced Moderation Toolkit Moderation Commands:
/ban - Permanenter Server-Ausschluss
/kick - User vom Server entfernen
/mute - Temporäres Timeout verhängen
/warn - Verwarnungen aussprechen
/timeout - Zeitlich begrenzte Stummschaltung
/purge - Massen-Nachrichtenlöschung
Anti-Spam Engine:
✓ Intelligente Spam-Erkennung
✓ Duplicate Message Detection
✓ Mention Spam Protection
✓ Link & URL Filter
✓ Custom Regex Patterns
✓ Configurable Thresholds
Moderation Logs:
✓ Vollständige Action History
✓ Reason Tracking
✓ Moderator Attribution
✓ Automatic Evidence Collection
✓ Appeal System Ready
📊 Community Engagement🎮 Gamification & Engagement Levelsystem Features:
XP System:
- Vollständig anpassbare XP-Raten
- Text & Voice Channel XP
- XP-Multiplier & Boosts
- Daily/Weekly Bonuses
Rewards:
- Automatische Rollenbelohnungen
- Custom Level-Up Messages
- Achievement System
- Milestone Rewards
Leaderboards:
- Server Top Rankings
- Global Leaderboards
- Category-Specific Rankings
- Historical Statistics
Welcome System:
✓ Benutzerdefinierte Embed-Designs
✓ Auto-Role Assignment
✓ Regel- & Info-Nachrichten
✓ User Counter Integration
✓ Custom Welcome Images
✓ Join/Leave Logging
|
🌐 Social & Communication💬 Cross-Server Communication Globalchat System:
Core Features:
- Echtzeit Cross-Server Chat
- Moderierte Kommunikation
- Server-übergreifende Community
- Report & Block Funktionen
- User Reputation System
Safety Features:
✓ Content-Filterung
✓ Blacklist System
✓ Admin-Kontrolle
✓ Spam Prevention
✓ Moderation Queue
✓ Appeal Process
Information Tools:
Wikipedia Integration:
- Direkte Artikelsuche
- Formatierte Previews
- Multi-Language Support
- Related Articles
- Quick Summaries
Weather System:
- Live-Wetterdaten
- 5-Tage Vorhersage
- Detaillierte Metriken
- Location Auto-Detection
- Weather Alerts
🎮 Interaktive Features🎙️ Dynamic Voice & Analytics Temporary Voice Channels:
User Control:
✓ Eigene Voice-Channel erstellen
✓ Custom Namen & Beschreibung
✓ User-Limit Management
✓ Permission Control
✓ Channel Transfer
Automation:
- Auto-Delete bei Inaktivität
- Category Organization
- Template System
- VIP Channel Options
Stats & Analytics:
Real-Time Metrics:
- Server Activity Tracking
- User Engagement Stats
- Command Usage Analytics
- Voice Channel Statistics
- Growth Metrics
Reports:
✓ Daily/Weekly Summaries
✓ Performance Dashboards
✓ Member Insights
✓ Trend Analysis
|
📋 Systemanforderungen
|
Minimum Requirements Operating System:
- Linux (Ubuntu 20.04+)
- Windows 10/11
- macOS 11+
Software:
- Python 3.10 oder höher
- pip (Python Package Manager)
- Git 2.0+
Resources:
- RAM: 512 MB minimum
- Storage: 200 MB freier Speicher
- Network: Stabile Internetverbindung
|
Empfohlene Konfiguration Production Environment:
- Linux Server (Ubuntu 22.04 LTS)
- Python 3.11+
- 1 GB+ RAM
- SSD Storage
- 24/7 Uptime Hosting
Optional Services:
- Discord Bot Token (Required)
- Weather API Key (Optional)
- Custom Domain (Optional)
- SSL Certificate (Optional)
|
⚡ Installation Guide
🐧 Linux / macOS Installation (Click to expand)
# ──────────────────────────────────────────────────────────
# Step 1: Repository klonen
# ──────────────────────────────────────────────────────────
git clone https://github.com/Oppro-net-Development/ManagerX.git
cd ManagerX
# ──────────────────────────────────────────────────────────
# Step 2: Virtual Environment erstellen (empfohlen)
# ──────────────────────────────────────────────────────────
python3 -m venv venv
source venv/bin/activate
# ──────────────────────────────────────────────────────────
# Step 3: Dependencies installieren
# ──────────────────────────────────────────────────────────
pip install --upgrade pip
pip install -r requirements.txt
# ──────────────────────────────────────────────────────────
# Step 4: Konfiguration erstellen
# ──────────────────────────────────────────────────────────
cp .env.example .env
nano .env # Passe TOKEN und andere Einstellungen an
# ──────────────────────────────────────────────────────────
# Step 5: Erste Datenbankinitialisierung
# ──────────────────────────────────────────────────────────
python -c "from utils.database import init_db; init_db()"
# ──────────────────────────────────────────────────────────
# Step 6: Bot starten
# ──────────────────────────────────────────────────────────
python main.py
# ──────────────────────────────────────────────────────────
# Optional: Systemd Service erstellen (für 24/7 Betrieb)
# ──────────────────────────────────────────────────────────
sudo nano /etc/systemd/system/managerx.service
# Füge Service-Konfiguration hinzu (siehe Dokumentation)
sudo systemctl enable managerx
sudo systemctl start managerx
🪟 Windows Installation (Click to expand)
# ──────────────────────────────────────────────────────────
# Step 1: Repository klonen
# ──────────────────────────────────────────────────────────
git clone https://github.com/Oppro-net-Development/ManagerX.git
cd ManagerX
# ──────────────────────────────────────────────────────────
# Step 2: Virtual Environment erstellen
# ──────────────────────────────────────────────────────────
python -m venv venv
venv\Scripts\activate
# ──────────────────────────────────────────────────────────
# Step 3: Dependencies installieren
# ──────────────────────────────────────────────────────────
python -m pip install --upgrade pip
pip install -r req.txt
# ──────────────────────────────────────────────────────────
# Step 4: Konfiguration erstellen
# ──────────────────────────────────────────────────────────
copy .env.example .env
notepad .env # TOKEN und Einstellungen anpassen
# ──────────────────────────────────────────────────────────
# Step 5: Datenbank initialisieren
# ──────────────────────────────────────────────────────────
python -c "from utils.database import init_db; init_db()"
# ──────────────────────────────────────────────────────────
# Step 6: Bot starten
# ──────────────────────────────────────────────────────────
python main.py
# ──────────────────────────────────────────────────────────
# Optional: Als Windows Service einrichten
# ──────────────────────────────────────────────────────────
# Siehe Dokumentation für NSSM Setup
🔧 Konfiguration
|
Environment Variables (.env) # ════════════════════════════════════════════════
# Discord Bot Configuration
# ════════════════════════════════════════════════
DISCORD_TOKEN=your_bot_token_here
DISCORD_CLIENT_ID=your_client_id
DISCORD_CLIENT_SECRET=your_client_secret
DISCORD_REDIRECT_URI=http://localhost:8080/callback
# ════════════════════════════════════════════════
# Optional API Keys
# ════════════════════════════════════════════════
WEATHER_API=your_openweathermap_api_key
# ════════════════════════════════════════════════
# Bot Settings
# ════════════════════════════════════════════════
BOT_PREFIX=!
DEBUG_MODE=false
LOG_LEVEL=INFO
# ════════════════════════════════════════════════
# Database Configuration
# ════════════════════════════════════════════════
DATABASE_PATH=./data/managerx.db
BACKUP_ENABLED=true
BACKUP_INTERVAL=24h
|
📍 Token erstellen
🔑 Wichtige Berechtigungen Required Intents:
✓ Server Members Intent
✓ Message Content Intent
✓ Presence Intent
Bot Permissions:
✓ Manage Roles
✓ Manage Channels
✓ Kick Members
✓ Ban Members
✓ Send Messages
✓ Embed Links
✓ Attach Files
✓ Manage Messages
✓ Read Message History
🌦️ Weather API Kostenloser API-Key: OpenWeatherMap |
🔄 Release Timeline
gantt
title ManagerX Development Timeline
dateFormat YYYY-MM-DD
section Releases
v1.0.0 Initial Release :done, 2023-01-01, 30d
v1.5.0 Welcome System :done, 2023-05-01, 45d
v1.6.0 Levelsystem :done, 2023-08-01, 60d
v1.7.0 TempVC System :done, 2023-11-01, 45d
v2.0.0 Major Refactor :done, 2024-06-01, 90d
v2.1.0 Enhancements :active, 2025-01-01, 60d
v2.5.0 Advanced Features :2025-04-01, 90d
| Version | Status | Datum | Key Features |
| v2.1.0 | 🔜 In Dev | Q1 2025 |
• Performance Optimierungen • Bug Fixes & Stability • Enhanced Error Handling • UI/UX Improvements |
| v2.0.0 | ✅ Current | 2024-12 |
• Komplettes Code Refactoring • Globalchat v2 Launch • Enhanced Statistics Module • Improved Database Architecture |
| v1.7.1 | 📦 Stable | 2024-08 |
• Feature Enhancements • Critical Bug Fixes • Security Updates |
| v1.7.0 | 📦 Archived | 2024-05 |
• TempVC System Implementation • Dynamic Voice Channel Management • User Control Features |
| v1.6.0 | 📦 Archived | 2024-02 |
• Advanced Levelsystem • XP & Rewards Engine • Leaderboard System |
| v1.5.0 | 📦 Archived | 2023-11 |
• Welcome System Launch • Auto-Role Assignment • Custom Embeds |
🗺️ Roadmap
|
🎯 v2.1.0 - Q1 2025 Focus: Stability & Polish
Features:
- Performance Tuning
- Memory Optimization
- Enhanced Logging
- Bug Fixes
Improvements:
- Error Recovery
- Database Indexing
- Command Response Time
- Resource Management
|
🚀 v2.2.0 - Q2 2025 Focus: New Features
Planned Features:
- Ticket System
- Advanced Polls
- Music Module
- Custom Commands 2.0
Enhancements:
- AI Integration
- Multi-Language Support
- Enhanced Analytics
- API Webhooks
|
💫 v2.3.0 - Q4 2025 Focus: Major Upgrade
Revolutionary Features:
- Web Dashboard
- Mobile App Support
- Plugin System
- Advanced AI Features
Architecture:
- Microservices
- Cloud-Native
- Horizontal Scaling
- GraphQL API
|
💡 Wie kann ich beitragen?
|
🐛 Bug Reports Fehler gefunden? |
✨ Feature Requests Idee für ein Feature? |
💻 Code Beiträge Code beisteuern? |
📖 Dokumentation Docs verbessern? |
📝 Commit-Konventionen
Wir verwenden standardisierte Commit-Prefixes für bessere Nachvollziehbarkeit:
| Präfix | Verwendung | Beispiel |
✨ FEATURE: |
Neue Funktion hinzugefügt | ✨ FEATURE: Add weather command integration |
🔄 UPDATE: |
Bestehende Funktion verbessert | 🔄 UPDATE: Improve levelsystem performance by 40% |
🐛 BUGFIX: |
Bug behoben (normal) | 🐛 BUGFIX: Fix welcome message formatting issue |
🚑 HOTFIX: |
Kritischer Bug behoben | 🚑 HOTFIX: Resolve critical database connection error |
📚 DOCS: |
Dokumentation aktualisiert | 📚 DOCS: Update installation guide with troubleshooting |
🗑️ DELETE: |
Code/Feature entfernt | 🗑️ DELETE: Remove deprecated legacy commands |
🎨 STYLE: |
Code-Style Änderungen | 🎨 STYLE: Refactor code to match PEP 8 standards |
♻️ REFACTOR: |
Code-Umstrukturierung | ♻️ REFACTOR: Restructure database module architecture |
⚡ PERF: |
Performance-Verbesserung | ⚡ PERF: Optimize query execution time |
🧪 TEST: |
Tests hinzugefügt/geändert | 🧪 TEST: Add unit tests for moderation module |
📌 Versionierungs-Schema
Um maximale Transparenz und Aktualität zu gewährleisten, nutzen wir eine duale Strategie:
- GitHub (Source Code): Nutzt das Semantic Versioning (Beispiel:
2.0.0). Dies markiert große Meilensteine und strukturelle Änderungen im Code. - PyPI (Distribution): Nutzt CalVer (Calendar Versioning) (Beispiel:
2.2026.1.9.1). Dies ermöglicht es Entwicklern, sofort zu erkennen, wie aktuell das installierte Paket ist.
| Plattform | Schema | Beispiel |
|---|---|---|
| GitHub | MAJOR.MINOR.PATCH | 2.0.0 |
| PyPI | MAJOR.JJJJ.MM.TT | 2.2026.01.09.1 |
🔧 Development Workflow
# ════════════════════════════════════════════════════════════════════════
# 1. Repository forken & klonen
# ════════════════════════════════════════════════════════════════════════
git clone https://github.com/YOUR_USERNAME/ManagerX.git
cd ManagerX
# ════════════════════════════════════════════════════════════════════════
# 2. Development Branch erstellen
# ════════════════════════════════════════════════════════════════════════
git checkout -b feature/amazing-feature
# Oder für Bugfixes:
git checkout -b bugfix/fix-critical-issue
# ════════════════════════════════════════════════════════════════════════
# 3. Development Environment aufsetzen
# ════════════════════════════════════════════════════════════════════════
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements-dev.txt
# ════════════════════════════════════════════════════════════════════════
# 4. Änderungen vornehmen und testen
# ════════════════════════════════════════════════════════════════════════
# Code schreiben...
python main.py # Bot testen
pytest tests/ # Unit Tests ausführen
# ════════════════════════════════════════════════════════════════════════
# 5. Code Style prüfen
#
Metadata
Release files for ManagerX 2.2026.1.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| managerx-2.2026.1.9.tar.gz | 124.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| managerx-2.2026.1.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 255.8 kB
Release files / managerx-2.2026.1.9.tar.gz
| Download URL | managerx-2.2026.1.9.tar.gz |
|---|---|
| Size | 124.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5d2d7a1a2b6a17a413093642b1c3e616d4e555fd4f6e9ba41b25ba69fdc1c569
|
|
BLAKE2b-256 checksum How to use checksums |
85ff4bc399325bf3d3314fefb4b5b07d9a82fe438e10dd950bb0be27a5535990
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.4
|
Release files / managerx-2.2026.1.9-py3-none-any.whl
| Download URL | managerx-2.2026.1.9-py3-none-any.whl |
|---|---|
| Size | 131.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
22e456ea1a855a5a92aec2267d5e94e7c808c919971327c8fa2b3a81ce99c1f0
|
|
BLAKE2b-256 checksum How to use checksums |
2b5aef42ea199f0609cc1339a491837009611568183aa5f244d401079697dd4e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.4
|