BoostyBridge
Automate in-game rewards and ranks based on active subscriptions from the Boosty
Автор: aeviww3183обновлён 4 окт. 2026 г.
УправлениеОбщениеУтилиты
Описание
BoostyBridge
Русский
BoostyBridge — это open-source плагин для серверов Minecraft с интеграцией Boosty.to. Он автоматически выдаёт и снимает игровые привилегии в зависимости от подписки пользователя.
Legal Disclaimer
RU: BoostyBridge никак не связан, не аффилирован, не спонсируется и не поддерживается платформой Boosty.to, её владельцами Зайа Солюшнс Лимитед (Zaya Solutions Limited), или их официальными представителями. Все торговые марки и права принадлежат их законным владельцам.
EN: BoostyBridge is in no way associated, affiliated, sponsored, endorsed, or officially connected with Boosty.to, its owners Zaya Solutions Limited (Зайа Солюшнс Лимитед), or any of its subsidiaries or affiliates. All product and company names are trademarks of their respective holders.
Основные возможности
- Верификация через личные сообщения бусти: Подтверждение привязки через код, отправленный в личные сообщения Boosty.
- Discord Webhook: Отправка событий (подписка, отвязка, истечение) в Discord.
- Автоматическая синхронизация: Проверка подписок в фоне и авто-снятие прав.
- PlaceholderAPI: Интеграция с TAB, scoreboards и другими плагинами.
- Админ команды: Принудительная отвязка, привязка, синхорнизация.
- Базы данных: SQLite (по умолчанию) и MySQL.
Плейсхолдеры
| Плейсхолдер | Описание |
|---|---|
%boosty_global_subscribers% | Общее число подписчиков |
%boosty_level% | Уровень подписки |
%boosty_name% | Ник на Boosty |
%boosty_is_linked% | Привязан ли аккаунт |
%boosty_has_sub% | Есть ли подписка |
Команды
| Команда | Описание | Права |
|---|---|---|
/boosty link <ник> | Привязка Boosty | Все |
/boosty info | Проверка статуса | Все |
/boosty reload | Перезагрузка | boosty.admin |
/boosty admin info <игрок> | Информация об игроке | boosty.admin |
/boosty admin unlink <игрок> | Отвязка | boosty.admin |
/boosty admin forcelink <игрок> <ник> | Принудительная привязка | boosty.admin |
/boosty admin forcesync | Принудительная синхронизация | boosty.admin |
Верификация при привязке аккаунта бусти
Доступны несколько способов:
-
Через личку бусти (основной)
- Пользователь получает код в личные сообщения
- Вводит его на сервере
-
Email (fallback)
- Используется, если в лс бусти отправить не удалось
TODO
- PlaceholderAPI
- DM-верификация
- Discord webhook
- Ручная синхронизация
(если появились идеи - создайте issues)
English
BoostyBridge is an open-source Minecraft plugin that integrates Boosty.to with your server. It automates reward management based on user subscriptions.
Features
- Secure Reward System: Ownership verification via Email or Boosty DMs.
- DM Verification: Link accounts using a code sent via Boosty direct messages.
- Discord Webhook Support: Send events directly to Discord.
- Automatic Sync: Background subscription checks.
- PlaceholderAPI Support
- bStats Metrics
- SQLite / MySQL support
Placeholders
| Placeholder | Description |
|---|---|
%boosty_global_subscribers% | Total subscribers |
%boosty_level% | Subscription level |
%boosty_name% | Boosty username |
%boosty_is_linked% | Linked status |
%boosty_has_sub% | Has active sub |
Commands
| Command | Description | Permission |
|---|---|---|
/boosty link <name> | Link account | None |
/boosty info | Check status | None |
/boosty reload | Reload config | boosty.admin |
/boosty admin info <player> | Player info | boosty.admin |
/boosty admin unlink <player> | Unlink | boosty.admin |
/boosty admin forcelink <player> <name> | Force link | boosty.admin |
/boosty admin forcesync | Force sync | boosty.admin |
Verification Methods
- Boosty DM (primary)
- Email (fallback if DM fails)
TODO
- PlaceholderAPI
- DM verification
- Discord webhook
- Manual sync command
License
Licensed under GPL-3.0
Последние версии
Все версии →release
BoostyBridge r1.3
r1.34 окт. 2026 г.32Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, paper, purpur, spigot
Что нового
## r1.3
исправлено #8
---
исправлен баг, из за которого отписавшиеся пользователи считались активными подписчиками.
раньше проверялось только наличие пользователя в ответе апи бусти, теперь в ответе проверяется его статус (active, inactive)
исправлены команды: /boosty admin forcesync, /boosty admin unlink
**Full Changelog**: https://github.com/aeviww/BoostyBridge/compare/r1.2...r1.3
release
BoostyBridge r1.2
r1.225 авг. 2026 г.29Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, paper, purpur, spigot
Что нового
## r1.2
исправление бага (#6)
### что исправлено
- нельзя привязать два майнкрафт-аккаунта к одному аккаунту Boosty и получить награды дважды. раньше защита не работала для кириллических ников (#6)
- `/boosty admin forcelink` тоже отказывает, если ник Boosty уже занят другим игроком.
- синхронизация предупреждает в консоли, если в базе остались дубликаты с прошлых версий, и больше не выдаёт им награды повторно
### после обновления
дубликаты, созданные до r1.2, плагин сам не удаляет. запусти `/boosty admin forcesync` и посмотри консоль: строки `is linked to more than one player` покажут спорные аккаунты, лишние снимаются через `/boosty admin unlink <игрок>`.
**full changelog**: https://github.com/elytrya/BoostyBridge/compare/r1.1...r1.2
release
BoostyBridge r1.1
r1.124 авг. 2026 г.13Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, paper, purpur, spigot
Что нового
## r1.1
исправление багов (#4, #5)
> [!IMPORTANT]
> **после обновления нужно вручную обновить токен.**
>
> что делать:
> 1. остановите сервер.
> 2. откройте [boosty.to](https://boosty.to) в браузере, залогиньтесь.
> 3. `F12` → **application** → **local storage** → `https://boosty.to` → ключ `auth` → скопируй значение целиком (вместе с `{ }`).
> 4. вставь его в `config.yml` в `auth.auth_data`, обязательно в кавычках:
> ```yaml
> auth:
> auth_data: "{%22accessToken%22:%22...%22,%22refreshToken%22:%22...%22,%22expiresAt%22:...}"
> client_id: "ваш_client_id"
> ```
>
> **если поле `client_id` пустое или равно `YOUR_CLIENT_ID`, автоматическое обновление токена работать не будет и подписки начнут "слетать" через несколько дней.**
### что исправлено
- подписки больше не сбрасываются, если Boosty не ответил или токен временно не сработал (#4)
- исправлено обновление токена (ошибка `Failed to refresh token. Response code: 400`) - запрос приведён к формату официального api
- убрано шифрование токена
- ранги теперь выдаются игрокам с пробелами в нике Boosty (#5)
**full changelog**: https://github.com/elytrya/BoostyBridge/compare/r1.0...r1.1
release
BoostyBridge r1.0
r1.025 июл. 2026 г.38Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, paper, purpur, spigot
Что нового
## (changelog) r1.0
### безопасность
-- убрана инъекция команд через `%boosty_name%`
-- убрана json/embed-инъекция в дискорд-сообщениях
-- коды подтверждения теперь с ttl 5 минут, лимитом 3 попытки и `SecureRandom`
-- добавлен ssl для mysql (`database.mysql.use_ssl`)
-- токен boosty теперь хранится в зашифрованном виде
### очередь наград
-- награды не теряются, если игрок был не в сети - выдаются при следующем входе
-- уведомление игроку о начисленных за время отсутствия наградах
-- новые настройки `rewards_queue.*` и сообщение `reward_queue_delivered`
### дискорд интеграция
-- привязка с подтверждением кодом в лс
-- при автоопределении аккаунта сначала спрашивается «это точно ваш аккаунт?» с кнопками да/нет, роль выдаётся только после подтверждения
-- исправлен футер и плейсхолдеры в эмбедах выдачи/снятия роли
#### команды
- `/boosty discord confirm` / `/boosty discord reject` - подтверждение или отклонение найденного аккаунта
### производительность
-- изменена работа с бдшкой
-- плейсхолдеры `%boosty_*%` больше не грузят главный поток (кэш, `placeholders.cache_seconds`)
-- запросы к базе в командах вынесены в асинхрон
-- добавлены индексы в таблицы плагина
-- исправлена утечка потоков дискорд-бота при выключении и релоаде
### библиотеки
-- jda подгружается через `libraries:`
### исправления
-- `/boosty admin forcesync` - исправлено
-- новые поля конфига читаются с дефолтами, старые конфиги не ломаются
в целом: общие улучшения производительности и оптимизация базы, пофикшено много багов и утечек, **обновление рекомендовано к установке**
если вы обнаружите какие-либо ошибки, пожалуйста, создайте issue на гитхабе
## New Contributors
* @iBuseWinner made their first contribution in https://github.com/elytrya/BoostyBridge/pull/3
**Full Changelog**: https://github.com/elytrya/BoostyBridge/compare/b0.3...r1.0
beta
BoostyBridge b0.3
b0.322 мая 2026 г.45Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
## (Changelog) b0.3
### Исправления и улучшения
### Дискорд интеграция
-- Добавлен дискорд бот с автоматической выдачей и снятием роли в соответствии с активной наградой:
#### Команды
* `/boosty discord <discord_username>` - привязка дискорд аккаунта к игровому профилю.
* `/boosty admin setdiscord <player> <new_discord>` - изменение привязанного дискорд аккаунта игрока (админ)
#### Новые права
* `boosty.admin.setdiscord` доступ к изменению дискорд аккаунта игрока.
-- Логирование выдачи/снятия роли дискорд
-- Оптимизация работы плагина и исправление ошибок, связанных с отсутствующими сообщениями в конфигурации
-- Добавлены сообщения загрузки и проверки при привязке дискорд аккаунта и проверке подписки бусти.
-- Связь с DiscordSRV
-- Исправление ошибок
если вы обнаружите какие-либо ошибки, пожалуйста, создайте issue на гитхабе
**Full Changelog**: https://github.com/elytrya/BoostyBridge/compare/b0.2...b0.3
beta
BoostyBridge b0.2
b0.227 апр. 2026 г.34Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
## (Changelog) b0.2
### Исправления и улучшения
* **исправлены пермиссионы**:
* `boosty.link` — привязка своего аккаунта (`/boosty link`).
* `boosty.info` — просмотр своей информации (`/boosty info`).
* `boosty.reload` — перезагрузка плагина (`/boosty reload`).
* `boosty.admin.*` — полный доступ к админ-командам.
* **админ права:**
* `boosty.admin.*`
* `boosty.admin.unlink`
* `boosty.admin.info`
* `boosty.admin.forcelink`
* `boosty.admin.forcesync`
* **исправлен таб комплитер /boosty**
если вы обнаружите какие-либо ошибки, пожалуйста, создайте issue на гитхабе
**Full Changelog**: https://github.com/Elytrya/BoostyBridge/compare/b0.1.1...b0.2
beta
BoostyBridge b0.1
b0.119 апр. 2026 г.26Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
## (Changelog) b0.1
### Исправления и улучшения
- добавлена поддержка Discord webhook: теперь события (подписка, отвязка, истечение и т.д.) можно отправлять в Discord
- добавлена альтернативная верификация через личные сообщения Boosty: пользователь получает код и подтверждает привязку прямо в игре
- добавлен fallback через Email: если не удалось отправить сообщение в Boosty, используется проверка через почту (если включено в конфиге)
- улучшена система локализации: ошибки больше не захардкожены и полностью вынесены в `messages.yml`
если вы обнаружите какие-либо ошибки, пожалуйста, создайте issue на GitHub
---
### Fixes and Improvements
- added Discord webhook support: events (subscriptions, unlink, expiration, etc.) can now be sent to Discord
- added Boosty DM verification: users receive a code via Boosty direct messages and confirm it in-game
- added email fallback: if DM delivery fails, email verification will be used (if enabled in config)
- improved localization system: error messages are no longer hardcoded and are fully configurable via `messages.yml`
if you encounter any bugs, please open an issue on GitHub
**Full Changelog**: https://github.com/Elytrya/BoostyBridge/compare/a0.4...b0.1.1
alpha
BoostyBridge a0.4
a0.413 апр. 2026 г.30Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
## (Changelog) a0.4
### Исправления и улучшения
- теперь /boosty выводит список помоощь, а не пустое сообщение
- убран дублирующий код в базах данных: весь повторяющийся код mysql и sqlite перенесен в один общий класс.
- добавлена команда /boosty admin forcesync: ручной запуск синхронизации всех игроков с boosty.
если вы обнаружите какие-либо ошибки, пожалуйста, создайте issues на гитхабе
---
### fixes and Improvements
- fixed /boosty command: it now displays the help menu instead of an empty message when used without arguments.
- database optimization: removed duplicate code by moving shared MySQL and SQLite logic into a single base class.
- new command /boosty admin forcesync: added a way to manually trigger synchronization for all players with Boosty.
if you encounter any bugs, please open an issue on GitHub.
alpha
BoostyBridge a0.3
a0.39 мар. 2026 г.24Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
### (Changelog) a0.3
#### Исправления и улучшения
* **Поддержка PlaceholderAPI**: Добавлены новые плейсхолдеры для отображения данных Boosty:
* `%boosty_global_subscribers%` — общее количество активных подписчиков.
* `%boosty_level%` — название уровня подписки (или "None").
* `%boosty_name%` — имя пользователя на Boosty.
* `%boosty_is_linked%` — статус привязки аккаунта (`true`/`false`).
* `%boosty_has_sub%` — наличие активной подписки (`true`/`false`).
* **Метрики bStats**: Интегрирована система сбора статистики.
* Добавлена возможность отключения в `config.yml` (`bstats: true/false`).
Примечание:
Эта версия является альфа-релизом. Рекомендуется протестировать его на тестовом сервере перед использованием в продакшене. Если вы обнаружите какие-либо ошибки, пожалуйста, создайте issues.
---
#### Fixes and Improvements
* **PlaceholderAPI Support**: Added new placeholders to display Boosty data:
* `%boosty_global_subscribers%` — total count of active subscribers.
* `%boosty_level%` — subscription level name (or "None").
* `%boosty_name%` — user's Boosty display name.
* `%boosty_is_linked%` — account linkage status (`true`/`false`).
* `%boosty_has_sub%` — active subscription check (`true`/`false`).
* **bStats Metrics**: Integrated anonymous data collection.
* Added a toggle in `config.yml` to enable/disable metrics (`bstats: true/false`).
Note:
This version is an alpha release. It is recommended to test it on a test server before using in production. If you find any bugs, please create an Issue in the repository.
alpha
BoostyBridge a0.2
a0.28 мар. 2026 г.21Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
### (Changelog) a0.2
#### Исправления и улучшения:
* **Исправлено обновление данных**: устранена ошибка, из-за которой новые значения `auth_data` и `client_id` не подхватывались без полной перезагрузки всего сервера. Теперь изменения вступают в силу мгновенно после `/boosty reload`.
* **Улучшенное логирование:** Критические ошибки авторизации (например, недействительный токен) теперь всегда выводятся в консоль. Это работает даже при выключенном режиме отладки (`debug: false`), чтобы вы могли сразу узнать о проблеме.
Примечание:
Эта версия является альфа-релизом. Рекомендуется протестировать его на тестовом сервере перед использованием в продакшене. Если вы обнаружите какие-либо ошибки, пожалуйста, создайте issues.
---
### (Changelog) a0.2
#### Frival and Improvement:
* **Fixed data update**: the error has been fixed, due to which the new values `auth_data` and `client_id` were not picked up without a complete reboot of the entire server. Now the changes come into effect instantly after `/boosty reload.
* **Advanced logging:** Critical errors of authorization (for example, invalid token) are now always displayed in the console. This works even when debugging mode is offlines so you can immediately learn about the problem.
Note:
This version is an alpha release. It is recommended to test it on a test server before using in production. If you find any bugs, please create an Issue in the repository.