Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions config/config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,13 @@
github: "https://github.com/ManagerX-Development/ManagerX"
topgg: "https://top.gg/bot/1368201272624287754"

# Module: Uptime Kuma Discord Status
uptime_kuma:
enabled: true
base_url: "https://status.oppro-network.de"
slug: "default"
update_interval: 60 # in seconds

# Performance & Cache
performance:
cache_timeout: 300
Expand Down Expand Up @@ -150,3 +157,4 @@
welcome: true
other:
setlang: true
setlang: true

Check warning on line 160 in config/config.yaml

View check run for this annotation

codefactor.io / CodeFactor

config/config.yaml#L160

Duplication of key "setlang" in mapping. (key-duplicates)
2 changes: 1 addition & 1 deletion docs/source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
author = 'ManagerX Development'
release = '2.0.0'
version = '2.0' # Kurzversion
language = 'en'
language = 'de'

# -- General configuration ---------------------------------------------------
extensions = [
Expand Down
293 changes: 91 additions & 202 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
@@ -1,202 +1,91 @@
========================================
🤖 ManagerX Documentation
========================================

**The Ultimate Discord Management Solution**

Powerful. Modular. Open Source.

.. image:: https://img.shields.io/badge/Version-2.0.0-e11d48?style=for-the-badge
:alt: Version 2.0.0
:target: https://github.com/ManagerX-Development/ManagerX/releases

.. image:: https://img.shields.io/badge/Python-3.11+-green.svg?style=for-the-badge
:alt: Python 3.11+

.. image:: https://img.shields.io/badge/License-GPL--3.0-yellow.svg?style=for-the-badge
:alt: GPL-3.0 License
:target: https://github.com/ManagerX-Development/ManagerX/blob/main/LICENSE

.. image:: https://img.shields.io/github/stars/ManagerX-Development/ManagerX?style=for-the-badge
:alt: GitHub Stars
:target: https://github.com/ManagerX-Development/ManagerX

ManagerX is a comprehensive Discord bot designed for modern server management. With advanced moderation, engaging entertainment features, detailed statistics, and a beautiful web dashboard, ManagerX brings your Discord server to the next level.

✨ **What Makes ManagerX Special:**

- 🎯 **Intuitive Commands** — Easy-to-use slash commands for all features
- 🛡️ **Powerful Moderation** — Anti-spam, warnings, timeouts, and more
- 📊 **Live Dashboard** — Real-time server statistics and status
- 🎮 **Fun & Games** — Entertainment commands and interactive games
- ⚙️ **Fully Configurable** — Customize every aspect of the bot
- 🔧 **Developer-Friendly** — Well-documented API and extensible architecture
- 🌍 **Global Ready** — Multi-language support
- 📜 **Active Development** — Regularly updated with new features

🚀 **Quick Start**

1. **New User?** Start with :doc:`user_guide/quick_start/index`
2. **Want to Contribute?** Check out :doc:`dev_guide/getting_started/index`
3. **Need Help?** Visit :doc:`user_guide/faq/index`

---

📚 Documentation Sections
=========================

**👥 User Guide**

Everything you need to know to use ManagerX on your server:

- Getting started and setup
- Command reference
- Feature overview
- Configuration options
- Troubleshooting

`→ Open User Guide <user_guide/index.html>`_

**👨‍💻 Developer Guide**

For developers who want to extend or self-host ManagerX:

- Architecture overview
- Installation & setup
- Bot development
- API development
- Testing & deployment
- Contributing guidelines

`→ Open Developer Guide <dev_guide/index.html>`_

---

🌟 Core Features
=================

.. list-table::
:class: feature-table
:widths: 20 80

* - **🛡️ Moderation**
- Anti-spam detection, warning system, user timeouts, kicks, bans, slowmode, votekick system, comprehensive logging
* - **🎮 Entertainment**
- Tic Tac Toe, Connect 4, Wikipedia search, jokes, weather information, interactive games
* - **📊 Statistics**
- User profiles with XP tracking, server statistics, leaderboards, achievement system, user activity monitoring
* - **⚙️ Management**
- Auto-roles on join, welcome/goodbye messages, channel management, global chat networks, configuration system
* - **📈 Insights**
- Server analytics, member insights, bot performance metrics, activity tracking
* - **🔌 Integration**
- REST API, web dashboard, real-time status updates, data export capabilities

---

💡 How to Use This Documentation
=================================

**For Server Owners & Moderators:**

Start with :doc:`user_guide/quick_start/index` guide. You'll learn how to add ManagerX to your server, configure it, and use all available commands.

**For Developers:**

Head over to :doc:`dev_guide/getting_started/index` to set up a development environment. The :doc:`dev_guide/architecture/index` will help you understand how ManagerX is built.

**For Contributors:**

Read :doc:`dev_guide/contributing/index` for contribution guidelines, code style, and the pull request process.

**For Self-Hosting:**

Check out :doc:`dev_guide/deployment/index` for production deployment instructions.

---

📖 Feature Categories
======================



---

🆘 Getting Help
================

**Documentation Issues?**

Found a typo or unclear section? `Report an issue <https://github.com/ManagerX-Development/ManagerX/issues>`_

**Bug Report?**

Create a detailed issue on `GitHub Issues <https://github.com/ManagerX-Development/ManagerX/issues>`_

**Feature Request?**

Suggest new features on GitHub or join our Discord community

**Community Support?**

Join our Discord server for real-time help and community discussion

---

📋 Version Information
=======================

- **Current Version:** 2.0.0
- **Python Required:** 3.11 or higher
- **License:** GPL-3.0
- **Last Updated:** January 2026
- **Stability:** Production Ready

---

Frequently Asked Questions
===========================

**Q: How do I invite ManagerX to my server?**

Check :doc:`user_guide/quick_start/index` for a complete invitation guide with screenshots.

**Q: How do I report bugs or request features?**

Please open an issue on the `GitHub Issues page <https://github.com/ManagerX-Development/ManagerX/issues>`_. Provide as much detail as possible.

**Q: Can I self-host ManagerX?**

Yes! See :doc:`dev_guide/deployment/index` for complete self-hosting instructions with multiple hosting options.

**Q: Which Python version is required?**
ManagerX requires **Python 3.8** or higher to function correctly.

Contributing
------------

We welcome contributions from the community! Whether it's bug reports, feature requests, or code improvements, feel free to get involved via our `GitHub Repository <https://github.com/Oppro-net-Development/ManagerX>`_. For more details, check the **Contributing** section in the Developer Guide.

---

**© 2026 ManagerX Development**
*Version 2.0.0-dev | Last Updated: December 7, 2025*

.. toctree::
:maxdepth: 2
:caption: 👥 User Guide:

user_guide/index
user_guide/getting_started
user_guide/moderation
user_guide/levels
user_guide/management
user_guide/dashboard

.. toctree::
:maxdepth: 2
:caption: 👨‍💻 Developer Guide:

dev_guide/index
dev_guide/architecture
dev_guide/installation
========================================
🤖 ManagerX Dokumentation
========================================

**Die ultimative Management-Lösung für deinen Discord-Server**

Leistungsstark. Modular. Open Source.

.. image:: https://img.shields.io/badge/Version-2.0.0-e11d48?style=for-the-badge
:alt: Version 2.0.0
:target: https://github.com/ManagerX-Development/ManagerX/releases

.. image:: https://img.shields.io/badge/Python-3.11+-green.svg?style=for-the-badge
:alt: Python 3.11+

.. image:: https://img.shields.io/badge/Lizenz-GPL--3.0-yellow.svg?style=for-the-badge
:alt: GPL-3.0 Lizenz
:target: https://github.com/ManagerX-Development/ManagerX/blob/main/LICENSE

ManagerX ist ein umfassender Discord-Bot, der für modernes Server-Management entwickelt wurde. Mit fortschrittlicher Moderation, Entertainment-Funktionen, detaillierten Statistiken und einem modernen Web-Dashboard bringt ManagerX deinen Server auf das nächste Level.

---

📖 Schnellzugriff
================

ManagerX ist in zwei Hauptbereiche unterteilt:

**👥 Benutzer-Handbuch**
------------------------

Alles, was du wissen musst, um ManagerX auf deinem Server zu nutzen:

- Erste Schritte & Installation
- Befehlsübersicht
- Feature-Erklärungen
- Dashboard-Konfiguration

`→ Zum Benutzer-Handbuch <user_guide/index.html>`_

**👨‍💻 Entwickler-Dokumentation**
----------------------------------

Für Entwickler, die ManagerX erweitern oder selbst hosten möchten:

- Architektur-Übersicht
- Installation & Setup
- API-Referenz
- Mitwirken am Projekt

`→ Zur Entwickler-Dokumentation <dev_guide/index.html>`_

---

🎮 Kern-Features
================

- 🛡️ **Moderation** — Anti-Spam, Warnungen und automatische Bestrafungen.
- 📊 **Detaillierte Statistiken** — Level-System, Aktivitäten und Leaderboards.
- ⚙️ **Einfache Verwaltung** — Ein modernes Web-Dashboard für alle Einstellungen.
- 🌍 **Global Chat** — Vernetze deinen Server mit anderen Communities.

---

🆘 Hilfe & Support
=================

Solltest du Fragen haben oder auf Probleme stoßen:

* **Support-Server:** Tritt unserem `Discord-Server <https://discord.gg/9T28DWup3g>`_ bei.
* **Bug melden:** Erstelle ein Issue auf `GitHub <https://github.com/ManagerX-Development/ManagerX/issues>`_.
* **FAQ:** Schau in unsere :doc:`user_guide/index` Sektion.

---

**© 2026 ManagerX Development**
*Version 2.0.0 | Letztes Update: April 2026*

.. toctree::
:maxdepth: 2
:hidden:
:caption: 👥 Benutzer-Handbuch:

user_guide/index

.. toctree::
:maxdepth: 2
:hidden:
:caption: 👨‍💻 Entwickler-Dokumentation:

dev_guide/index
47 changes: 23 additions & 24 deletions mxmariadb/connector.py
Original file line number Diff line number Diff line change
Expand Up @@ -29,31 +29,30 @@ def pool(self):
return MariaConnector._pool

async def connect(self):
async with MariaConnector._lock:
if MariaConnector._pool is None:
if not self.user or not self.database:
logger.error(f"DB-Credentials fehlen in {env_path}")
raise RuntimeError("Datenbankzugangsdaten fehlen.")
if MariaConnector._pool is None:
if not self.user or not self.database:
logger.error(f"DB-Credentials fehlen in {env_path}")
raise RuntimeError("Datenbankzugangsdaten fehlen.")

try:
logger.info(f"[DB] Verbinde zu {self.host}:{self.port} DB='{self.database}' als '{self.user}'...")
MariaConnector._pool = await aiomysql.create_pool(
host=self.host,
user=self.user,
password=self.password,
db=self.database,
port=self.port,
autocommit=False,
minsize=2,
maxsize=15,
echo=False,
pool_recycle=1800, # Connections nach 30 Min recyclen
connect_timeout=10, # Verbindungs-Timeout
)
logger.info("✅ MariaDB Pool erstellt.")
except Exception as e:
logger.critical(f"❌ Pool-Erstellung fehlgeschlagen: {e}")
raise
try:
logger.info(f"[DB] Verbinde zu {self.host}:{self.port} DB='{self.database}' als '{self.user}'...")
MariaConnector._pool = await aiomysql.create_pool(
host=self.host,
user=self.user,
password=self.password,
db=self.database,
port=self.port,
autocommit=False,
minsize=2,
maxsize=15,
echo=False,
pool_recycle=1800, # Connections nach 30 Min recyclen
connect_timeout=10, # Verbindungs-Timeout
)
logger.info("✅ MariaDB Pool erstellt.")
except Exception as e:
logger.critical(f"❌ Pool-Erstellung fehlgeschlagen: {e}")
raise

cls_name = type(self).__name__
if cls_name not in MariaConnector._initialized:
Expand Down
Loading
Loading