ntoneee/minecraft-telegram-bridge

Плагин под Minecraft-сервера для интеграции с чатом Telegram

Minecraft-Telegram Bridge

This repo is archived. Consider taking a look on vanutp/tgbridge — a feature-rich and better supported mod compatible with several mod loaders.

Этот репозиторий не будет обновляться. Если вы ищете мод для Minecraft со сходным функционалом, обратите внимание на vanutp/tgbridge — он новее, поддерживается, имеет больший функционал и совместим с несколькими платформами.

Добро пожаловать! 👋

Этот плагин позволяет интегрировать чат Minecraft в группу Telegram и наоборот. Вот как это работает:

Плагин не работает с серверами на Forge, Fabric и официальном ядре Minecraft. Он совместим с серверами, которые поддерживают плагины под Spigot, например, Spigot, Paper или Purpur.

Установка

Плагин совместим с Spigot-совместимыми серверными ядрами, например Spigot, Paper, Purpur.

Скачайте последнюю версию из Releases (файл minecraft-telegram-bridge-{версия}-all.jar) и скопируйте в папку plugins/ вашего сервера.

Настройка

Для настройки плагина используются 2 файла в папке plugins/Minecraft-Telegram_Bridge:

• lang.yml для сообщений бота в Telegram и Minecraft
• config.yml для настройки поведения бота

В config.yml необходимо задать значения telegram-token и telegram-chat-id — токен бота и ID чата, с каким связать Minecraft, соответственно. Подробнее о том, как это сделать, в гайде.

Расширенная настройка

Для расширенной настройки следуйте инструкциям в файлах lang.yml и config.yml (на английском языке).

Сборка плагина из исходного кода

Убедитесь, что у вас установлена Java версии 17.

Склонируйте репозиторий, перейдите в папку с плагином и запустите команду в зависимости от ОС:

• ./gradlew shadowJar на Linux и MacOS
• .\gradlew.bat shadowJar на Windows

Пример для Unix:

git clone https://github.com/ntoneee/minecraft-telegram-bridge.git`
cd minecraft-telegram-bridge
./gradlew shadowJar

Если вы ранее не устанавливали Gradle версии 7.4, то gradlew установит его за вас.

Собранный JAR-файл будет расположен по адресу build/libs/minecraft-telegram-bridge-версия-all.jar. Название файла зависит от директории, в которую вы склонируете репозиторий.

minecraft-telegram-bridge's Issues

Spammy join/leave messages

When a player has bad internet connection, he can reconnect to the server several times. In this case, every time he reconnects, bot sends 2 messages to the linked chat.
Possible solution — detect such reconnects on player join (last time player left was less than, e.g., 30 seconds ago) and delete the message about leaving instead of sending one about joining.

Kick self from Telegram (player feature request)

Add README with build instructions and configuration manual

Telegram original message entities are ignored

Consider telegram message:

Hello!

Expected Minecraft message:

[User] Hello!

But, hence in latest version message entities are ignored, the message results into

[User] Hello!

Minecraft supports message formatting, hence it is possible to reproduce most message entities in Minecraft chat:

• Bold §l
• Strikethrough §m
• Underline §n
• Italic §o
• "Obfuscated" (spoiler): §k
• Reset formatting: §r

URLs should also be broadcasted as URLs. Minecraft also seems to support URLs in chats.

Use Gradle build system instead of built in IntelliJ

Contact

Hey bro give me your telegram contact 🙏

lang.yml needs to be updated from plugin

The file lang.yml is written by plugin once -- on first plugin launch, hence requiring server administrator action to update lang.yml on plugin update which adds new strings to it. Otherwise, a NullPointerException will be thrown on attempt to use undefined string.

Error text

Command to reload configs

Since /reload command is dangerous and can lead to memory leaks, there should be a way to reload plugin configuration without server restart. It should be a Minecraft command like /tgreload, which reloads config.yml and lang.yml from plugin directory.