Russian🇷🇺

ChatSync - это мощный плагин для серверов Minecraft на базе Paper 1.21, который улучшает систему чата и интегрирует её с Telegram. Плагин добавляет локальный и глобальный чаты, специальные префиксы для игроков и администраторов, а также двустороннюю синхронизацию с Telegram-ботом для логирования сообщений и достижений.

Основные функции:

Локальный и глобальный чат:
- Обычные сообщения (например, "привет") видны только в радиусе 50 блоков (настраиваемо).
- Сообщения с префиксом "!" (например, "!привет") отправляются в глобальный чат и видны всем игрокам на сервере.
Специальные префиксы:
- Обычные игроки: Синяя кирка (⛏) перед ником.
- Администраторы (OP): Красный меч (⚔) перед ником.
- Формат: [Префикс] Ник: Сообщение.
Интеграция с Telegram-ботом:
- Логирует глобальные сообщения и достижения игроков в указанный Telegram-чат.
- Сообщения из Telegram отправляются в глобальный чат Minecraft.
- Поддержка режимов тем (topics) в Telegram: Команда /specstart в боте запускает логирование в отдельную тему, и только сообщения из этой темы передаются в игру.
- Конфигурация: API-ключ бота и ID чата указываются в config.yml.
Дополнительно:
- Полностью настраиваемо через конфиг.
- Отменяет стандартный чат Minecraft для полной интеграции.
- Зависимости: Telegram Bots API (добавьте в pom.xml для сборки).

Этот плагин идеален для сообществ, которые хотят связать Minecraft-сервер с Telegram-каналом для кросс-платформенного общения, мониторинга и вовлечения игроков. Установка простая: скачайте JAR, настройте config.yml и перезапустите сервер.

English🇺🇸

ChatSync is a powerful plugin for Minecraft servers based on Paper 1.21, which enhances the chat system and integrates it with Telegram. The plugin adds local and global chats, special prefixes for players and administrators, as well as two-way synchronization with a Telegram bot for logging messages and achievements.

Key Features:

Local and Global Chat:
- Regular messages (e.g., "hello") are visible only within a 50-block radius (configurable).
- Messages with the "!" prefix (e.g., "!hello") are sent to the global chat and visible to all players on the server.
Special Prefixes:
- Regular players: Blue pickaxe (⛏) before the nickname.
- Administrators (OP): Red sword (⚔) before the nickname.
- Format: [Prefix] Nick: Message.
Telegram Bot Integration:
- Logs global messages and player achievements to the specified Telegram chat.
- Messages from Telegram are sent to the Minecraft global chat.
- Support for topic modes in Telegram: The /specstart command in the bot starts logging in a separate topic, and only messages from this topic are transmitted to the game.
- Configuration: Bot API key and chat ID are specified in config.yml.
Additionally:
- Fully configurable via config.
- Cancels the default Minecraft chat for full integration.
- Dependencies: Telegram Bots API (add to pom.xml for building).

This plugin is ideal for communities that want to link a Minecraft server with a Telegram channel for cross-platform communication, monitoring, and player engagement. Installation is simple: download the JAR, configure config.yml, and restart the server.