- Для версий
- 1.21.✘
- Java
- Исходный код
- https://github.com/QuickProducts/QuickTgReward
- Зависимости
- Vault, LuckPerms (необязательные, для соответствующих наград)
💙 QuickTgReward — награды за подписку на Telegram
Объедините Minecraft-сервер и Telegram-сообщество: предложите игрокам награду за подписку и автоматизируйте её выдачу.
📥 Скачать JAR v1.0.0 · 📖 Документация · 💻 Исходный код
✨ О плагине
QuickTgReward — плагин для Paper от QuickProducts, который связывает игровой аккаунт с Telegram и позволяет получать настраиваемые награды за подписку на канал. Игрок привязывает аккаунт одноразовым кодом, подписывается на ваше сообщество и забирает награду на сервере. Проверка подписки выполняется через Telegram Bot API.
Такой сценарий помогает познакомить игроков с каналом проекта, где вы публикуете новости, анонсы обновлений и события. Администрации не нужно вручную сопоставлять ники с Telegram-аккаунтами и проверять каждую заявку на приз: привязка и получение награды проходят через интерфейс плагина.
Награды можно адаптировать под экономику и правила сервера. Настройте разовый приветственный подарок или повторяемое вознаграждение с интервалом — например, еженедельный бонус. Выберите предметы, опыт, деньги, действия LuckPerms или серверные команды, а сообщения и оформление приведите к стилю вашего проекта.
В Minecraft игрок взаимодействует с меню в чате: MiniMessage, градиенты и кликабельные кнопки делают основные действия доступными без длинных инструкций. В Telegram его встречает бот с inline-меню, профилем, статусом подписки и информацией о следующей награде.
⚙️ Совместимость
| Параметр | Значение |
|---|---|
| Версия ресурса | v1.0.0 |
| Ядро | Paper |
| Minecraft | 1.21.1+, ветка 1.21.x по README |
| Java | 21 |
| Telegram | Собственный бот и канал для проверки подписки |
| Хранилище | SQLite, пул соединений HikariCP |
| Необязательные зависимости | Vault, LuckPerms, PlaceholderAPI |
| Лицензия | MIT |
| Разработчик | QuickProducts |
Указаны заявленные требования проекта; совместимость с каждой отдельной сборкой Paper не означает отдельного подтверждённого тестирования.
🎁 Возможности
| Возможность | Что это даёт вашему серверу |
|---|---|
| Привязка Minecraft ↔ Telegram | Связь аккаунтов через одноразовый код |
| Проверка подписки | Проверка участия в канале через getChatMember |
| Разные виды наград | Предметы, команды, Vault, опыт, LuckPerms и случайные награды |
| Одноразовые и повторяемые награды | Приветственные подарки и регулярные бонусы |
| Настраиваемые кулдауны | Управление интервалами между получениями |
| Меню в Minecraft-чате | Кликабельные действия, MiniMessage и градиенты |
| Telegram-бот с inline-меню | Привязка, получение награды и просмотр профиля |
| Настройка оформления | Собственные тексты, кнопки и цвета |
| Хранение данных | SQLite и транзакции для защиты от повторной выдачи |
| Асинхронные запросы к Telegram | Сетевое взаимодействие вынесено в асинхронные операции |
| Права и подсказки команд | Разделение доступа игроков и администрации, автодополнение |
Награды под ваш игровой режим
• Предметы — ресурсы или другие игровые предметы в качестве бонуса.
• Игровая валюта — денежные награды через интеграцию с Vault.
• Опыт — награды опытом для развития персонажа.
• LuckPerms — действия с правами и группами согласно настройке награды.
• Команды — выполнение настроенных серверных команд.
• Случайные награды — настройка случайных вознаграждений.
Состав наград задаётся в rewards.yml. Например, для сервера выживания можно подготовить ресурсный бонус, а для проекта с экономикой — денежное поощрение. Конкретные суммы, предметы и интервалы выбирает администратор.
🔄 Как это работает для игрока
1. Введите /tg, чтобы открыть главное меню.
2. Используйте /tg link и получите одноразовый код привязки.
3. Откройте Telegram-бота и завершите привязку Minecraft-аккаунта.
4. Подпишитесь на указанный канал.
5. Находясь на сервере, запросите награду через /tg reward или соответствующий пункт меню бота.
6. Проверяйте состояние аккаунта через /tg status. Для повторяемой награды дождитесь окончания настроенного кулдауна.
📦 Установка и первый запуск
1. Установите плагин
1. Подготовьте сервер Paper 1.21.1+ с Java 21.
2. Скачайте QuickTgReward-1.0.0.jar.
3. Поместите JAR в папку plugins/ сервера.
4. При необходимости установите дополнительные плагины для выбранных интеграций.
5. Запустите сервер, чтобы QuickTgReward создал конфигурационные файлы.
2. Подключите Telegram
1. Откройте @BotFather и создайте бота командой /newbot.
2. В файле plugins/QuickTgReward/telegram.yml укажите токен в bot.token.
3. В bot.username внесите username бота без символа @.
4. Добавьте бота в нужный канал как администратора для проверки подписки.
5. Укажите идентификатор канала в channel.id: публичный @username либо числовой ID вида -100....
6. В channel.invite-link добавьте ссылку для перехода игроков в канал.
Токен бота храните в конфигурации сервера и не публикуйте вместе со скриншотами, логами или исходниками.
3. Настройте награды и проверьте работу
1. Отредактируйте награды в rewards.yml и интервалы в config.yml.
2. При желании измените тексты и оформление в messages.yml, telegram.yml и gui.yml.
3. Перезапустите сервер или примените настройки командой /qtgreward reload.
4. Проверьте состояние бота: /qtgreward status.
5. Пройдите путь игрока: привязка → подписка → получение награды.
Необязательные зависимости
| Плагин | Когда нужен |
|---|---|
| Vault | Для денежных наград; требуется также совместимый провайдер экономики |
| LuckPerms | Для наград, использующих интеграцию с правами и группами |
| PlaceholderAPI | Объявлен в plugin.yml как необязательная зависимость; список плейсхолдеров в README не приведён |
Устанавливайте зависимости для используемых функций. Все три плагина указаны как softdepend, а не обязательные зависимости запуска.
🗂️ Конфигурационные файлы
Файлы настроек находятся в plugins/QuickTgReward/.
| Файл | Назначение |
|---|---|
| config.yml | Общие параметры, кулдауны и лимиты |
| messages.yml | Сообщения для игроков в Minecraft |
| telegram.yml | Подключение бота, тексты и кнопки Telegram |
| rewards.yml | Состав наград и выполняемые действия |
| gui.yml | Цвета и оформление интерфейса |
| database.yml | Настройки SQLite и пула соединений |
💬 Команды и права доступа
Команды игрока
| Команда | Действие | Право доступа |
|---|---|---|
| /tg | Открыть главное меню | qtgreward.use |
| /tg link | Получить код привязки | qtgreward.link |
| /tg unlink confirm | Подтвердить отвязку аккаунта | qtgreward.unlink |
| /tg reward | Запросить награду | qtgreward.reward |
| /tg status | Посмотреть статус аккаунта | qtgreward.status |
| /tg help | Открыть справку | qtgreward.use |
Альтернативные имена основной команды: /telegram и /tgreward. Права игрока по умолчанию включены в plugin.yml.
Команды администратора
| Команда | Действие | Право доступа |
|---|---|---|
| /qtgreward reload | Перезагрузить конфигурацию | qtgreward.admin.reload |
| /qtgreward status | Проверить состояние Telegram-бота | qtgreward.admin |
| /qtgreward give <player> <reward> | Выдать выбранную награду | qtgreward.admin.give |
| /qtgreward reset <player> | Сбросить данные наград игрока | qtgreward.admin.reset |
| /qtgreward unlink <player> | Принудительно отвязать аккаунт | qtgreward.admin.unlink |
| /qtgreward check <player> | Проверить данные игрока | qtgreward.admin.check |
<player> — имя игрока, <reward> — идентификатор настроенной награды. Подставляйте значения без угловых скобок. Для доступа к основной административной команде в plugin.yml требуется qtgreward.admin; административные права по умолчанию доступны операторам сервера.
Выберите вопрос ниже — каждый ответ открывается отдельно.
Да. Проект распространяется по лицензии MIT. Исходный код находится в репозитории QuickProducts/QuickTgReward, а готовый JAR — в разделе Releases.
Для этой публикации указаны Paper 1.21.1+ и Java 21. README обозначает ветку Minecraft 1.21.x. Поддержка других ядер и более старых версий здесь не заявляется.
Да. Создайте бота через @BotFather, внесите токен и username в telegram.yml, затем добавьте бота администратором канала и укажите канал в настройках.
Да. Состав наград задаётся в rewards.yml, а общие настройки кулдаунов и лимитов — в config.yml. Плагин поддерживает одноразовые и повторяемые награды: можно настроить как первый подарок, так и регулярный бонус.
Нет. Все три указаны как необязательные зависимости. Vault нужен для соответствующих денежных наград, LuckPerms — для связанных с ним действий. PlaceholderAPI объявлен как softdepend; документированного списка плейсхолдеров в README нет.
Код одноразовый и по описанию проекта действует 5 минут; срок настраивается. Получите новый код через /tg link и проверьте, не достигнут ли лимит попыток.
Проверьте bot.token, username бота и доступ сервера к Telegram. Посмотрите сообщения в консоли: например, token not set указывает на отсутствие токена. После исправления настроек перезапустите сервер или выполните /qtgreward reload.
Убедитесь, что бот добавлен администратором именно в нужный канал, а channel.id указан правильно. Проверьте, что игрок подписался с того Telegram-аккаунта, который привязан к Minecraft. Дополнительную информацию об ошибке ищите в логах сервера.
Игрок должен быть онлайн. Проверьте привязку, подписку, доступность награды и кулдаун. Затем проверьте rewards.yml, права игрока и необходимые интеграции: Vault с экономикой или LuckPerms для соответствующих действий.
В README заявлены хранение данных в SQLite, транзакции и защита от повторной выдачи. Для повторяемых наград используются кулдауны. При диагностике неожиданной повторной выдачи проверьте, не запущены ли два экземпляра плагина.
Да. Тексты Minecraft находятся в messages.yml, тексты и кнопки бота — в telegram.yml, оформление — в gui.yml. В Minecraft-интерфейсе поддерживаются MiniMessage, градиенты и кликабельные кнопки.
При ClassNotFoundException используйте готовый Shadow JAR из официального релиза. При SQLException проверьте доступ сервера к папке plugins/QuickTgReward/data. Сообщения об ошибках и настройки подключения помогут уточнить причину.
🔗 Скачать и узнать больше
| Ссылка | Назначение |
|---|---|
| 📥 QuickTgReward-1.0.0.jar | Прямая загрузка плагина |
| 📦 Релиз 1.0.0 | Страница версии и файлы релиза |
| 💻 Репозиторий | Исходный код проекта |
| 📖 README | Документация, настройка и сборка |
| 🔐 plugin.yml | Объявленные команды, права и зависимости |
QuickTgReward · v1.0.0 · QuickProducts
Ваше Telegram-сообщество - новые возможности для игроков вашего Minecraft-сервера.
