Files
deskhub/minecraft-plugin/target/classes/config.yml
T
2026-10-21 16:45:36 +00:00

84 lines
4.1 KiB
YAML

# ──────────────────────────────────────────────────────────────────────────────
# 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: ""