# BoostyBridge [![Version](https://img.shields.io/badge/version-a0.3-orange)](#) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![Platform](https://img.shields.io/badge/platform-Spigot_|_Paper_1.21+-green)](https://papermc.io/) > **Отказ от ответственности:** 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](https://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`. ❗ **ВАЖНО:** Никому не передавайте эти данные! Они дают полный доступ к вашему аккаунту. ### Команды и права | Команда | Описание | Права | | :--- | :--- | :--- | | `/boosty link <ник>` | Привязать аккаунт Boosty. | Доступно всем | | `/boosty info` | Узнать статус своей привязки. | Доступно всем | | `/boosty reload` | Перезагрузить конфиг плагина. | `boosty.admin` | | `/boosty admin info <игрок>` | Проверить данные игрока. | `boosty.admin` | | `/boosty admin unlink <игрок>` | Отвязать аккаунт игрока. | `boosty.admin` | | `/boosty admin forcelink <игрок> <ник>` | Привязать аккаунт принудительно. | `boosty.admin` ### Плейсхолдеры (PlaceholderAPI) * `%boosty_level%` — Возвращает название текущего уровня подписки (или `None`). * `%boosty_name%` — Возвращает никнейм привязанного аккаунта Boosty. * `%boosty_is_linked%` — Возвращает `true`, если аккаунт привязан, иначе `false`. * `%boosty_has_sub%` — Возвращает `true`, если есть активная подписка. * `%boosty_global_subscribers%` — Глобальный счетчик (возвращает общее количество игроков с активной подпиской на сервере). ### Todo (В планах) - [x] Интеграция с 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](https://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 | Command | Description | Permission | | --- | --- | --- | | `/boosty link ` | Link a Boosty account. | None | | `/boosty info` | Check your link status. | None | | `/boosty reload` | Reload the plugin config. | `boosty.admin` | | `/boosty admin info ` | Check a player's data. | `boosty.admin` | | `/boosty admin unlink ` | Unlink a player's account. | `boosty.admin` | | `/boosty admin forcelink ` | Force link an account. | `boosty.admin` | ### 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 - [x] 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**.

BoostyBridge

r1.0

b0.3

b0.2

b0.1

a0.4

a0.3

a0.2