ServerPulse

Monitoring- und Analytics-Plugin für Minecraft-Netzwerke mit Unified-JAR-Ansatz. Eine Datei, zwei Laufzeiten:

• Spigot/Paper-Plugin auf den Game-Servern
• BungeeCord-Plugin auf dem Proxy

ServerPulse erfasst Performance- und Entity-Daten, erkennt Grenzwertverletzungen, kann Alerts an Discord senden und stellt optional REST-Endpunkte für Grafana/Prometheus/Influx bereit.

Features

• Live-Monitoring für TPS, MSPT, RAM, Chunks und Spieler
• Entity-Analyse pro Welt
• Schwellwertbasierte Warnungen (Warning/Critical)
• Trend-Analyse fuer Lastentwicklungen
• Notfallaktionen (Item-Clear, Mob-Clear, Auto-Diagnose)
• Discord-Integration für Alerts und tägliche Reports
• Netzwerk-Übersicht auf BungeeCord
• REST API für Metrik-Export (Prometheus, Simple JSON, Influx, JSON)
• Plugin Messaging zwischen Spigot und Bungee über serverpulse:data

Voraussetzungen

• Java 17
• Spigot/Paper 1.21+
• BungeeCord (optional, für Netzwerkmodus)

Optional:

• MySQL/MariaDB (wenn Datenbank aktiv genutzt wird)
• Discord Webhook (wenn Discord-Alerts/Reports genutzt werden)
• Grafana/Prometheus/InfluxDB (wenn REST/API-Export genutzt wird)

Installation (ohne Build)

Da die JAR von dir bereitgestellt wird, ist kein Build-Schritt nötig.

1) Spigot/Paper (Standalone oder Netzwerk-Server)

1. Lege die JAR in den Ordner plugins/ deines Spigot/Paper-Servers.
2. Starte den Server einmal, damit die config.yml erzeugt wird.
3. Passe die Konfiguration an.
4. Führe /serverpulse reload aus oder starte den Server neu.

2) BungeeCord (Proxy)

1. Lege dieselbe JAR in den plugins/-Ordner des BungeeCord-Proxys.
2. Starte den Proxy einmal, damit die config.yml erzeugt wird.
3. Aktiviere bei Bedarf rest-api und discord.
4. Starte den Proxy neu oder nutze /bpulse reload.

3) Netzwerkbetrieb (Spigot + Bungee)

• Installiere die JAR auf Proxy und allen relevanten Sub-Servern.
• Stelle sicher, dass mindestens ein Spieler online ist, damit Plugin-Messages von Spigot zum Proxy gesendet werden können.
• Der genutzte Channel ist serverpulse:data.

Schnellstart

Empfohlene Reihenfolge:

1. In config.yml general.debug: true setzen (nur für Initialtest).
2. Optional Datenbank aktivieren und Zugangsdaten setzen.
3. Optional Discord aktivieren und Webhook eintragen.
4. Optional rest-api.enabled: true auf dem Bungee-Proxy setzen.
5. Plugin neu laden.
6. Mit Befehlen prüfen:
   • Spigot: /serverpulse status
   • Bungee: /bpulse status

Konfiguration

Die zentrale Datei ist config.yml. Je nach Laufzeit (Spigot oder Bungee) werden die passenden Abschnitte genutzt.

Wichtige Bereiche

• general: Debug, Intervalle, Retention
• database: MySQL-Settings (nur Spigot)
• discord: Alerts/Reports für beide Seiten
• thresholds: Grenzwerte fuer Performance/Entities/Netzlast
• worlds: Welt-spezifische Overrides (Spigot)
• trend-analysis: Lasttrend-Erkennung (Spigot)
• emergency-actions: automatische Gegenmaßnahmen (Spigot)
• chat-monitoring: Muster- und Spam-Erkennung (Bungee)
• rest-api: API und Exportformate (Bungee)
• messages: Prefix und Textausgaben (Spigot)

Beispiel: Datenbank aktivieren

database:
  enabled: true
  host: "localhost"
  port: 3306
  database: "serverpulse"
  username: "root"
  password: "change-me"

Beispiel: Discord aktivieren

discord:
  enabled: true
  webhook-url: "https://discord.com/api/webhooks/..."
  report-webhook-url: ""
  bot-name: "ServerPulse"
  daily-report:
    enabled: true
    time: "08:00"

Beispiel: REST API aktivieren (Bungee)

rest-api:
  enabled: true
  host: "0.0.0.0"
  port: 8081
  api-key: "CHANGE_ME"
  formats:
    prometheus:
      enabled: true
      endpoint: "/metrics"
    simple-json:
      enabled: true
      endpoint: "/grafana"
    influxdb:
      enabled: true
      endpoint: "/influx"
    json:
      enabled: true
      endpoint: "/api"

Befehle

Spigot/Paper

Hauptbefehl: /serverpulse Alias: /pulse

Subcommands:

• /serverpulse status - Aktueller Performance-Status
• /serverpulse report - Manueller Monitoring-Report
• /serverpulse world <welt> - Detailansicht einer Welt
• /serverpulse entities [welt] - Entity-Übersicht
• /serverpulse reload - Konfiguration neu laden
• /serverpulse debug - Debug- und Laufzeitinfos
• /serverpulse clear <items|mobs> [welt] - Notfallbereinigung

BungeeCord

Hauptbefehl: /bpulse Aliase: /bsp, /networkpulse

Subcommands:

• /bpulse status - Netzwerk-Schnellstatus
• /bpulse network - Netzwerk-Statistik
• /bpulse servers - Detailansicht aller Sub-Server
• /bpulse report - Daily Report sofort an Discord senden
• /bpulse reload - Bungee-Konfiguration neu laden

Permissions

Spigot/Paper

• serverpulse.use
• serverpulse.admin
• serverpulse.status
• serverpulse.report
• serverpulse.world
• serverpulse.entities
• serverpulse.reload
• serverpulse.debug

Hinweis: Für clear wird in der aktuellen Implementierung serverpulse.admin geprüft.

BungeeCord

• serverpulse.bungee.use
• serverpulse.bungee.admin (für /bpulse reload)

REST API Endpunkte (Bungee)

Bei aktiviertem REST-Server sind standardmäßig folgende Endpunkte vorgesehen:

• Prometheus: /metrics
• Grafana Simple JSON: /grafana
• Influx-Format: /influx
• JSON API: /api

Host, Port, API-Key und Endpunkte sind in rest-api konfigurierbar.

Betriebsmodi

• Standalone (nur Spigot/Paper): Lokales Monitoring auf einem Server
• Netzwerkmodus (Spigot + Bungee): Aggregation und zentrale Sicht auf Proxy-Ebene

Troubleshooting

Keine Daten auf Bungee sichtbar

• Prüfen, ob die JAR auch auf den Spigot-Servern installiert ist.
• Prüfen, ob Spieler online sind (Plugin Messaging benötigt initial einen Spieler-Context).
• Prüfen, ob keine Firewall den Proxy-Port für REST blockiert (falls REST genutzt wird).
• general.debug: true aktivieren und Logs auf beiden Seiten prüfen.

Datenbankverbindung fehlgeschlagen

• Zugangsdaten in database prüfen.
• Erreichbarkeit und Port der DB prüfen.
• Sicherstellen, dass der DB-User Rechte auf die angegebene Datenbank hat.

Discord sendet keine Nachrichten

• discord.enabled: true gesetzt?
• Webhook-URL korrekt?
• Netzwerkzugriff vom Server auf Discord vorhanden?

REST API nicht erreichbar

• rest-api.enabled: true auf Bungee gesetzt?
• Host/Port korrekt und frei?
• Firewall/Sicherheitsgruppe prüfen.

Projektstruktur (Kurzüberblick)

• Spigot Einstieg: de.serverpulse.spigot.SpigotPlugin
• Bungee Einstieg: de.serverpulse.bungee.BungeePlugin
• Gemeinsamer Messaging-Channel: de.serverpulse.network.NetworkMessage
• Ressourcen: plugin.yml, bungee.yml, config.yml

⚠️ Urheberrecht & Nutzungsbedingungen

ServerPulse ist urheberrechtlich geschützt. © M_Viper – Alle Rechte vorbehalten.

• ❌ Die Weitergabe dieses Plugins an Dritte ist strengstens untersagt
• ❌ Das Verändern, Dekompilieren oder Bearbeiten des Codes ist nicht erlaubt
• ❌ Eine Veröffentlichung – auch in veränderter Form – ist verboten
• ❌ Der Verkauf oder die kommerzielle Nutzung ist nicht gestattet
• ✅ Die Nutzung ist ausschließlich für den privaten Serverbetrieb erlaubt

Wer gegen diese Bedingungen verstößt, macht sich strafbar und kann rechtlich belangt werden.

Version

Aktuelle Plugin-Version laut Konfiguration: 1.0.0