TelegramChatBridge ist ein Bukkit/Spigot-Plugin für Minecraft-Server, das den In-Game-Chat mit einer Telegram-Chatgruppe verbindet. Es ermöglicht eine nahtlose Kommunikation zwischen Minecraft-Spielern und Telegram-Nutzern, indem Nachrichten in beide Richtungen gesendet werden können. Das Plugin unterstützt Funktionen wie den Wechsel des Chatmodus, die Verknüpfung von Konten und Benachrichtigungen für Ereignisse (z. B. Spielerbeitritt/-austritt, Tode, Fortschritte, Serverstart/-stopp).

Funktionen

Bidirektionaler Chat: Nachrichten von Minecraft nach Telegram und umgekehrt senden.
Chatmodi: Wechsel zwischen Minecraft- und Telegram-Chatmodus mit den Befehlen /chat und /tg.
Kontoverknüpfung: Verknüpfung von Minecraft-Konten mit Telegram-Konten über den Befehl /link.
Ereignisbenachrichtigungen: Konfigurierbare Benachrichtigungen für Spielerbeitritt/-austritt, Tode, Fortschritte, Schlafevents und Serverstart/-stopp.
Anpassbare Nachrichten: Konfiguration der Nachrichtenformate für Telegram-zu-Minecraft- und Minecraft-zu-Telegram-Kommunikation.
Admin-Befehle: Verwaltung des Plugins mit dem Befehl /tb (reload, info, help).
Berechtigungen: Unterstützt Berechtigungen für normale Nutzer (telegramchat.use) und Admins (telegramchat.admin).

Installation

Lade die neueste Version von TelegramChatBridge.jar von der Releases-Seite herunter.
Platziere die .jar-Datei im plugins-Ordner deines Minecraft-Servers.
Starte den Server neu, um die Standardkonfigurationsdatei (config.yml) zu generieren.
Bearbeite die config.yml mit deinem Telegram-Bot-Token und der Chat-ID.
Starte den Server erneut, um die Konfiguration zu übernehmen.

Konfiguration

Die Konfiguration des Plugins befindet sich in der config.yml. Hier ist ein Beispiel:

telegram:
  bot-token: "dein-telegram-bot-token"
  chat-id: "deine-telegram-chat-id"
  send-to-telegram: true
  send-to-chat: true
  join-and-leave-event: true
  death-event: true
  advancement-event: true
  sleep-event: false
  server-start-stop: false

messages:
  telegram-to-minecraft: "&7[&3TG &r-> &2MC&7] &f{username}: &r{message}"
  minecraft-to-telegram: "[MC -> TG] {username}: {message}"
  telegram-echo: "&7[&2MC &r-> &3TG&7] &f{username}: &r{message}"
  mode-set-telegram: "&aDu bist jetzt im Telegram-Chatmodus."
  mode-set-minecraft: "&aDu bist jetzt im Minecraft-Chatmodus."

bot-token: Dein Telegram-Bot-Token, den du von BotFather erhalten hast.
chat-id: Die ID der Telegram-Chatgruppe, die mit Minecraft verbunden werden soll.
send-to-telegram: Aktiviert/deaktiviert das Senden von Minecraft-Nachrichten an Telegram.
send-to-chat: Aktiviert/deaktiviert das Senden von Telegram-Nachrichten an Minecraft.
Ereignisschalter: Aktiviert/deaktiviert Benachrichtigungen für bestimmte In-Game-Ereignisse.
Nachrichtenformate: Anpassung der Nachrichten mit Platzhaltern {username} und {message}.

Befehle

/tg: Wechselt in den Telegram-Chatmodus.
/chat: Wechselt in den Minecraft-Chatmodus.
/link: Verknüpft dein Minecraft-Konto mit einem Telegram-Konto.
/tb [reload|info|help]: Verwaltet das Plugin (einige Unterbefehle nur für Admins).

Berechtigungen

telegramchat.use: Erlaubt die Nutzung der Plugin-Befehle (Standard: true).
telegramchat.admin: Erlaubt die Nutzung von Admin-Befehlen wie /tb reload (Standard: op).

Anforderungen

Minecraft-Server: Kompatibel mit Spigot/Bukkit-Servern mit API-Version 1.21 oder höher.
Java: Java 8 oder höher.
Telegram-Bot: Ein Telegram-Bot, erstellt über BotFather, mit einem gültigen Bot-Token.
Abhängigkeiten: Keine zusätzlichen Plugins erforderlich.

Erstellen

Um das Plugin selbst zu erstellen:

Klone das Repository: git clone https://github.com/deinbenutzername/TelegramChatBridge.git
Navigiere in das Projektverzeichnis: cd TelegramChatBridge
Erstelle es mit Maven: mvn clean package
Finde die kompilierte .jar-Datei im target-Ordner.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe die LICENSE-Datei für Details.

Support

Für Probleme, Funktionswünsche oder Fragen öffne bitte ein Issue auf der GitHub Issues-Seite.