Upload via GUI (67 Dateien)

2026-10-21 16:45:36 +00:00
parent dc19180a77
commit 8385fdabf2
50 changed files with 1948 additions and 0 deletions
@@ -0,0 +1,5 @@
+name: DeskHub-Minecraft
+main: de.deskhub.minecraft.bungee.BungeePlugin
+version: 1.0.0
+author: M_Viper
+description: Legt in DeskHub ein Ticket an, wenn ein Minecraft-Server offline geht.
@@ -0,0 +1,83 @@
+# ──────────────────────────────────────────────────────────────────────────────
+# DeskHub-Minecraft: legt in DeskHub ein Ticket an, wenn ein Minecraft-Server offline geht.
+# Eine Jar für Spigot, Paper und BungeeCord.
+#
+#  • Auf dem BungeeCord-Proxy: prüft die Server von außen und meldet einen Ausfall in Echtzeit (empfohlen).
+#  • Auf Spigot/Paper: erkennt beim nächsten Start, dass der Server abgestürzt oder abgeschaltet worden war.
+#  Am besten beides einsetzen: Proxy meldet sofort, der Server liefert die Gewissheit nach dem Neustart.
+#
+# Nach Änderungen:  /deskhubmc reload   Testen:  /deskhubmc test
+# ──────────────────────────────────────────────────────────────────────────────
+
+deskhub:
+  # Adresse eurer DeskHub-Installation, ohne Pfad. Bitte https verwenden (der Schlüssel wird mitgeschickt).
+  url: "https://support.example.de"
+  # API-Schlüssel: DeskHub-Adminportal, Verwalten, API-Schlüssel, neuer Schlüssel mit dem Recht "Tickets anlegen".
+  # Tipp: Im Schlüssel die IP-Adresse des Minecraft-Servers eintragen, dann ist er nur von dort nutzbar.
+  api-key: ""
+  # Absender der Tickets (es kommt keine Mail dorthin, aber DeskHub verlangt eine gültige Adresse)
+  requester-name: "Minecraft-Überwachung"
+  requester-email: "minecraft@example.de"
+  # Wartezeit auf DeskHub in Sekunden
+  timeout-seconds: 10
+
+ticket:
+  # Zahlen aus DeskHub. 0 = Standard von DeskHub.
+  # Zu finden im Adminportal: Abteilungen / Prioritäten öffnen, die Zahl steht am Ende der Adresse (…?id=3).
+  department-id: 0
+  priority-id: 0
+  # Optional: Hilfethema (legt Abteilung und Priorität automatisch fest, wenn die beiden oben 0 sind)
+  help-topic-id: 0
+
+  # Texte. Platzhalter: {server} {time} {source} {lastSeen} {downtime}
+  offline:
+    subject: "[Minecraft] {server} ist offline"
+    message: |
+      Der Minecraft-Server "{server}" ist seit {time} nicht mehr erreichbar.
+
+      Erkannt von: {source}
+      Bitte den Server prüfen und neu starten.
+  crash:
+    subject: "[Minecraft] {server} war nicht erreichbar (Absturz oder Ausfall)"
+    message: |
+      Der Minecraft-Server "{server}" wurde nicht ordnungsgemäß beendet (Absturz, Prozess beendet oder Stromausfall).
+
+      Letztes Lebenszeichen: {lastSeen}
+      Neu gestartet: {time}
+      Ausfalldauer: ca. {downtime}
+
+      Bitte die Logdateien prüfen.
+  shutdown:
+    subject: "[Minecraft] {server} wurde heruntergefahren"
+    message: 'Der Minecraft-Server "{server}" wurde um {time} heruntergefahren.'
+  test:
+    subject: "[Minecraft] Testticket von {server}"
+    message: |
+      Das ist ein Testticket des DeskHub-Minecraft-Plugins. Die Verbindung zu DeskHub funktioniert.
+
+      Server: {server}
+      Zeit: {time}
+
+# Nur BungeeCord: Der Proxy prüft die Server von außen.
+monitor:
+  # Alle wie viele Sekunden geprüft wird
+  interval-seconds: 30
+  # Wie oft die Prüfung hintereinander fehlschlagen muss, bevor ein Ticket entsteht (verhindert Tickets bei kurzen Aussetzern)
+  failures-before-ticket: 3
+  # Frühestens nach so vielen Minuten gibt es für denselben Server wieder ein Ticket (verhindert Ticket-Flut, wenn ein Server ständig ausfällt)
+  cooldown-minutes: 30
+  # true: Server, die seit dem Start des Proxys noch nie online waren, werden ignoriert (z. B. absichtlich abgeschaltete Server)
+  ignore-never-online: true
+  # Welche Server überwacht werden (Namen aus der Proxy-Konfiguration). Leer = alle.
+  servers: []
+
+# Nur Spigot/Paper: Der Server meldet sich selbst.
+backend:
+  # Wie oft das Lebenszeichen geschrieben wird (Sekunden)
+  heartbeat-seconds: 10
+  # Ticket beim nächsten Start, wenn der Server zuvor abgestürzt oder hart beendet worden war
+  ticket-on-crash: true
+  # Ticket auch beim normalen Herunterfahren (/stop, Neustart). Meist unerwünscht, deshalb aus.
+  ticket-on-shutdown: false
+  # Name des Servers in den Tickets. Leer = "Minecraft-Server (Port 25565)"
+  server-name: ""