Skip to main content

ManagerX Banner

🤖 ManagerX Discord Bot

Der ultimative All-in-One Bot für professionelles Community Management


Version Next Release Last Commit License

Python Pycord SQLite Issues Stars Forks


╔══════════════════════════════════════════════════════════════════════╗
║                                                                      ║
║     🤖  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

🎯 Für End-User

# Bot direkt nutzen
pip install ManagerX

Mit Dokumentation:

pip install ManagerX[docs]

👨‍💻 Für Entwickler

# Development Setup
pip install ManagerX[dev]

Vollständige Installation:

pip install ManagerX[all]

📥 Detaillierte Installation • ✨ Features • 📖 Dokumentation • 💬 Support



🎯 Was ist ManagerX?

ManagerX ist ein hochmoderner, leistungsstarker Discord-Bot, der speziell für professionelles Community-Management entwickelt wurde. Mit modernster Architektur und einer Vielzahl an Features bietet ManagerX alles, was anspruchsvolle Discord-Server benötigen.


🌟 Warum ManagerX?

⚡ Blazing Fast
Optimierte SQLite-Architektur für maximale Performance
🛡️ Enterprise Security
Anti-Spam, Moderation-Logs und umfassende Sicherheitsfeatures
🎨 Hochgradig Anpassbar
Jedes Modul vollständig konfigurierbar für deine Bedürfnisse
🌍 Global Connected
Verbinde deine Community mit Servern weltweit via Globalchat
📈 Aktive Entwicklung
Regelmäßige Updates mit neuen Features und Verbesserungen
🆓 100% Open Source
Transparent, community-driven und kostenlos verfügbar
⚙️ Technical Specifications
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Status:         Production Ready ✓
Current:        v2.0.0
Next Release:   v2.1.0 (Q1 2025)

🔧 Technology Stack
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Language:       Python 3.10+
Framework:      py-cord + ezcord
Database:       SQLite3
API:            Discord API v10
Architecture:   Modular Cogs System

🌐 Deployment
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Platforms:      Linux, Windows, macOS
Hosting:        Cloud-Ready
Requirements:   512MB RAM (1GB+ rec.)
Uptime:         99.9%+ Verfügbarkeit

📦 Active Modules
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ Advanced Moderation System
✓ Dynamic Leveling & XP Engine
✓ Smart Welcome Automation
✓ Temporary Voice Channels
✓ Global Cross-Server Chat
✓ Real-Time Weather Data
✓ Wikipedia Integration
✓ Comprehensive Statistics
✓ Custom Command Framework


✨ Feature-Übersicht

Entdecke die leistungsstarken Module von ManagerX


🛡️ 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


🚀 Installation & Setup

Starte ManagerX in wenigen Minuten


📋 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

  1. Besuche Discord Developer Portal
  2. Klicke auf "New Application"
  3. Gehe zu "Bot" → "Add Bot"
  4. Kopiere den Token
  5. Füge ihn in .env ein

🔑 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



📋 Version History & Roadmap

Entwicklungsgeschichte und zukünftige Features


🔄 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



🤝 Contributing & Development

Werde Teil unseres Open-Source Projekts!


💡 Wie kann ich beitragen?

🐛 Bug Reports

Fehler gefunden?
Issue erstellen →

✨ Feature Requests

Idee für ein Feature?
Feature vorschlagen →

💻 Code Beiträge

Code beisteuern?
Pull Request →

📖 Dokumentation

Docs verbessern?
Docs bearbeiten →


📝 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)

Source distribution for ManagerX 2.2026.1.9
File Size Uploaded
managerx-2.2026.1.9.tar.gz 124.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ManagerX 2.2026.1.9
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

2.2026.1.9 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page