A powerful Discord bot for server management and fun.

These details have not been verified by PyPI

Project links

Project description

ManagerX Banner

🤖 ManagerX Discord Bot

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

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

Besuche Discord Developer Portal
Klicke auf "New Application"
Gehe zu "Bot" → "Add Bot"
Kopiere den Token
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

📖 Vollständiges Changelog anzeigen →

🤝 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
#

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

2.2026.1.9

Jan 9, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

managerx-2.2026.1.9.tar.gz (124.8 kB view details)

Uploaded Jan 9, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

managerx-2.2026.1.9-py3-none-any.whl (131.1 kB view details)

Uploaded Jan 9, 2026 Python 3

File details

Details for the file managerx-2.2026.1.9.tar.gz.

File metadata

Download URL: managerx-2.2026.1.9.tar.gz
Upload date: Jan 9, 2026
Size: 124.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.4

File hashes

Hashes for managerx-2.2026.1.9.tar.gz
Algorithm	Hash digest
SHA256	`5d2d7a1a2b6a17a413093642b1c3e616d4e555fd4f6e9ba41b25ba69fdc1c569`
MD5	`3f9e91edca76c9406f75eb418d34c9de`
BLAKE2b-256	`85ff4bc399325bf3d3314fefb4b5b07d9a82fe438e10dd950bb0be27a5535990`

See more details on using hashes here.

File details

Details for the file managerx-2.2026.1.9-py3-none-any.whl.

File metadata

Download URL: managerx-2.2026.1.9-py3-none-any.whl
Upload date: Jan 9, 2026
Size: 131.1 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.4

File hashes

Hashes for managerx-2.2026.1.9-py3-none-any.whl
Algorithm	Hash digest
SHA256	`22e456ea1a855a5a92aec2267d5e94e7c808c919971327c8fa2b3a81ce99c1f0`
MD5	`627f7b467992a87dd5f1f1bc6cb8ad73`
BLAKE2b-256	`2b5aef42ea199f0609cc1339a491837009611568183aa5f244d401079697dd4e`

See more details on using hashes here.

ManagerX 2.2026.1.9

Navigation

Verified details

Owner

Unverified details

Project links

Meta

Classifiers

Project description

🤖 ManagerX Discord Bot

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

📦 Quick Install

🎯 Für End-User

👨‍💻 Für Entwickler

🎯 Was ist ManagerX?

🌟 Warum ManagerX?

✨ Feature-Übersicht

🛡️ Moderation & Sicherheit

📊 Community Engagement

🌐 Social & Communication

🎮 Interaktive Features

🚀 Installation & Setup

📋 Systemanforderungen

⚡ Installation Guide

🔧 Konfiguration

📋 Version History & Roadmap

🔄 Release Timeline

🗺️ Roadmap

🤝 Contributing & Development

💡 Wie kann ich beitragen?

📝 Commit-Konventionen

📌 Versionierungs-Schema

🔧 Development Workflow

Project details

Verified details

Owner

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes