BoostyBridge

BoostyBridge

Отказ от ответственности: BoostyBridge является неофициальным проектом. Данное программное обеспечение не связано с Boosty.to, не аффилировано с ней и не поддерживается ею официально в любой форме. Все товарные знаки являются собственностью соответствующих правообладателей.

Disclaimer: BoostyBridge is an unofficial project. This software is not affiliated with, maintained, authorized, endorsed, or sponsored by Boosty.to in any way. All trademarks are the property of their respective owners.

🇷🇺 Русский

BoostyBridge — это плагин с открытым исходным кодом для серверов Minecraft, предоставляющий интеграцию с платформой Boosty.to. Плагин автоматизирует выдачу и снятие игровых привилегий за подписку на Boosty.

Основные фишки

• Интеграция с Discord: Отправка красивых Embed-уведомлений в канал вашего Discord-сервера при успешной привязке аккаунта и оформлении подписки. (в разработке)
• Поддержка PlaceholderAPI: Выводите информацию о подписке в меню, Scoreboard или TAB с помощью удобных плейсхолдеров (список ниже).
• Умная защита: Проверка владения аккаунтом через Email в скрытом чат-режиме (можно отключить: verify_email: false).
• Авто-синхронизация: Фоновая проверка подписок. Если игрок отписался, права снимаются автоматически.
• Авто-обновление токенов: Достаточно настроить авторизацию всего один раз — плагин сам обновляет токены доступа.
• Любые БД: Поддержка локальной SQLite (по умолчанию) и MySQL для крупных сетей серверов.

Инструкция по настройке (auth_data & client_id)

Для работы плагина необходимо получить данные вашей сессии:

1. Зайдите на boosty.to под своим аккаунтом владельца блога.
2. Нажмите F12 (Инструменты разработчика) и перейдите во вкладку Storage (Хранилище) / Application (Приложение).
3. Слева в меню найдите раздел Local Storage -> https://boosty.to.
4. В списке найдите ключ auth и скопируйте его значение целиком (начинается с {%22accessToken%22...). Вставьте его в поле auth_data в config.yml.
5. Там же найдите ключ _clientId и скопируйте его значение в поле client_id в config.yml.

❗ ВАЖНО: Никому не передавайте эти данные! Они дают полный доступ к вашему аккаунту.

Команды и права

Плейсхолдеры (PlaceholderAPI)

• %boosty_level% — Возвращает название текущего уровня подписки (или None).
• %boosty_name% — Возвращает никнейм привязанного аккаунта Boosty.
• %boosty_is_linked% — Возвращает true, если аккаунт привязан, иначе false.
• %boosty_has_sub% — Возвращает true, если есть активная подписка.
• %boosty_global_subscribers% — Глобальный счетчик (возвращает общее количество игроков с активной подпиской на сервере).

Todo (В планах)

• Интеграция с PlaceholderAPI.
• Интеграция с Discord.
• Альтернативная верификация через личные сообщения на самом Boosty (отправка кода в ЛС).
• Улучшенная обработка лимитов API Boosty и расширенный дебаг-режим.
• GUI-меню для игроков.

🇬🇧 English

BoostyBridge is an open-source plugin for Minecraft servers that provides integration with the Boosty.to platform. It automates the process of giving and taking away in-game rewards for Boosty subscriptions.

Main Features

• Discord Integration: Send beautiful Embed notifications to your Discord channel when a player links their account and subscribes.
• PlaceholderAPI Support: Display subscription info in menus, scoreboards, or TAB using placeholders (list below).
• Smart Protection: Account ownership verification via Email in private chat mode (toggle via verify_email).
• Auto-Sync: Background subscription checks. Rewards are automatically removed if the subscription expires.
• Auto-refreshing Tokens: Setup once and forget — the plugin handles token refreshing internally.
• Database Support: Works with SQLite out-of-the-box or MySQL for server networks.

Setup Instructions (auth_data & client_id)

To enable the integration, you need to retrieve your session data:

1. Log in to boosty.to using your creator account.
2. Press F12 (Developer Tools) and go to the Storage / Application tab.
3. In the left menu, find Local Storage -> https://boosty.to.
4. Find the key named auth and copy its entire value (starts with {%22accessToken%22...). Paste it into the auth_data field in config.yml.
5. Find the key _clientId in the same list and copy its value into the client_id field in config.yml.

❗ IMPORTANT: NEVER share this data with anyone! It provides full access to your account.

Commands & Permissions

Placeholders (PlaceholderAPI)

• %boosty_level% — Returns the name of the current subscription tier (or None).
• %boosty_name% — Returns the linked Boosty account nickname.
• %boosty_is_linked% — Returns true if the account is linked, otherwise false.
• %boosty_has_sub% — Returns true if there is an active subscription.
• %boosty_global_subscribers% — Global counter (returns the total number of players with an active subscription on the server).

Todo

• PlaceholderAPI integration.
• Discord integration.
• Alternative verification via Boosty Direct Messages.
• Improved API rate limit handling and advanced debugging.
• GUI menu for players.

Лицензия / License

Проект распространяется по лицензии GPL-3.0. / Licensed under the GPL-3.0 License.