ModGuard

[EN] English Description

ModGuard is a powerful, highly efficient all-in-one moderation solution for Minecraft servers.

It combines all critical administration tools into a single, resource-friendly system to keep your server clean and secure.

ModGuard was specifically designed for server administrators who value performance and intuitive usability. With a modern GUI dashboard and advanced features like Vanish and Freeze, it provides everything you need for professional team management.

Features

• Central Mod GUI: Manage all online players through a clear menu (/mod).
• Vanish System: Become invisible to players including fake join/quit messages.
• Advanced Sanctions: Ban, Mute, Kick and Warn system with data storage.
• Live Monitoring: Open inventories (Invsee) or freeze players when suspicious (Freeze).
• Real-time Information: Detailed user info including IP address, ping and warn history.
• Chat Management: Global chat clear and automatic word filter (Blacklist).
• Custom Blacklist: Fully customizable word filter in the configuration to automatically block insults and advertisements.
• Alt Account Detection: Identifies players who are likely the same person (via IP matching) to effectively prevent ban evasion.
• Resource Efficient: Optimized code for minimal server load (Single-Class design).
• Compatible: Developed for Paper and Spigot (1.20+).

Setup & Installation

1. Drag the JAR file into your /plugins folder and restart the server.
2. In /config.yml you can adjust the word filter and the slowchat delay.
3. Make sure your team has the permission simplemod.mod.

Permissions

Permission management is handled via common permission plugins such as LuckPerms. We recommend creating groups (e.g. mod, admin) and assigning the corresponding nodes.

simplemod.mod Full Access. Allows the use of all commands (/ban, /vanish, /freeze, etc.), access to the /mod GUI and the ability to see invisible players.

simplemod.bypass.slowchat Chat Advantage. Allows sending messages without delay even when slowchat is active.

Commands

/modgui
Opens the graphical moderation dashboard

/vanish
Makes you invisible to other players

/freeze <name>
Freezes a player at their current position. If the player is already frozen, running the command again will unfreeze them.

/userinfo <name>
Shows all technical data (IP, UUID, warns) of a player

/invsee <name>
Opens a player's inventory

/mute <name> <time> [reason]
Blocks a player's chat (e.g. 1h, 30m)

/warn <name> [reason]
Issues a warning

/warns <name>
View all warnings for the player

/kick <name> [reason]
Kicks a player from the server immediately

/unban <name>
Removes a permanent ban

/unmute <name>
Removes a chat mute

/remove-timeout <name>
Removes an active time punishment

/clearchat
Clears the entire global chat

License & Contact

License: See the metadata section of this project (MIT License).
Support: For questions or feedback contact us at support@g-nav.at

[DE] Deutsche Beschreibung

ModGuard ist eine leistungsstarke, hocheffiziente All-in-One Moderationslösung für Minecraft-Server.

Es vereint alle kritischen Administrations-Werkzeuge in einem einzigen, ressourcenschonenden System, um deinen Server sauber und sicher zu halten.

ModGuard wurde speziell für Server-Administratoren entwickelt, die Wert auf Performance und eine intuitive Bedienung legen. Mit einem modernen GUI-Dashboard und fortschrittlichen Features wie Vanish und Freeze bietet es alles, was du für professionelles Team-Management benötigst.

Features

• Zentrales Mod-GUI: Verwalte alle Online-Spieler über ein übersichtliches Menü (/mod).
• Vanish-System: Werde unsichtbar für Spieler inklusive gefälschter Join/Quit-Nachrichten.
• Advanced Sanctions: Ban-, Mute-, Kick- und Warn-System mit Daten-Speicherung.
• Live-Überwachung: Öffne Inventare (Invsee) oder friere Spieler bei Verdacht ein (Freeze).
• Echtzeit-Informationen: Detaillierte Nutzer-Infos inklusive IP-Adresse, Ping und Warn-Historie.
• Chat-Management: Globaler Chat-Clear und automatischer Wort-Filter (Blacklist).
• Eigene Blacklist: Vollständig anpassbarer Wortfilter in der Konfiguration, um Beleidigungen und Eigenwerbung automatisch zu blockieren.
• Alt-Account Erkennung: Identifiziert Spieler, die wahrscheinlich dieselbe Person sind (über IP-Abgleich), um Bann-Umgehungen effektiv zu verhindern.
• Ressourcenschonend: Optimierter Code für minimale Serverlast (Single-Class-Design).
• Kompatibel: Entwickelt für Paper und Spigot (1.20+).

Setup & Installation

1. Ziehe die JAR-Datei in deinen /plugins Ordner und starte den Server neu.
2. In der /config.yml kannst du den Wortfilter und die Slowchat-Verzögerung anpassen.
3. Stelle sicher, dass dein Team die Berechtigung simplemod.mod besitzt.

Berechtigungen (Permissions)

Die Verwaltung der Rechte erfolgt über gängige Permission-Plugins wie LuckPerms. Wir empfehlen, Gruppen zu erstellen (z.B. mod, admin) und die entsprechenden Nodes zuzuweisen.

simplemod.mod Vollzugriff. Ermöglicht die Nutzung aller Befehle (/ban, /vanish, /freeze, etc.), den Zugriff auf das /mod GUI sowie das Sehen von unsichtbaren Spielern.

simplemod.bypass.slowchat Chat-Vorteil. Erlaubt es, Nachrichten ohne Zeitverzögerung zu senden, auch wenn der Slowchat aktiv ist.

Befehle

/modgui
Öffnet das grafische Moderations-Dashboard

/vanish
Macht dich unsichtbar für andere Spieler

/freeze <name>
Friert einen Spieler an seiner Position ein. Wenn er bereits eingefroren ist, wird er beim erneuten Ausführen des Commands wieder aufgetaut.

/userinfo <name>
Zeigt alle technischen Daten (IP, UUID, Warns) eines Spielers

/invsee <name>
Öffnet das Inventar eines Spielers

/mute <name> <zeit> [grund]
Sperrt den Chat für einen Spieler (z.B. 1h, 30m)

/warn <name> [grund]
Erteilt eine Verwarnung

/warns <name>
Alle Warns des Spielers einsehen

/kick <name> [grund]
Wirft einen Spieler sofort vom Server

/unban <name>
Hebt eine permanente Sperre auf

/unmute <name>
Hebt eine Chatsperre auf

/remove-timeout <name>
Entfernt eine aktive Zeitsperre

/clearchat
Leert den gesamten globalen Chat

Lizenz & Kontakt

Lizenz: Siehe Metadaten-Bereich dieses Projekts (MIT License).
Support: Bei Fragen oder Feedback kontaktiere uns unter support@g-nav.at

---

See my other projects
Check out my other projects on Modrinth.

---

Support

Support: support@g-nav.at

Information

Made by gamingMAX
Compatible with Spigot and PaperMC
Supported versions: 1.20.x & 1.21.x