YTcounter (ЮТ каунтер)

Плагин для серверов Майнкрафт, который выводит количество подписчиков и подписок YouTube, TikTok и Twitch через PlaceholderAPI. Счётчики можно вставлять в голограммы, скорборд, список игроков, чат и другие плагины с поддержкой PlaceholderAPI.

Возможности

• Получает данные асинхронно и хранит их в кэше, чтобы не нагружать основной поток сервера.
• Обновляет значения через настраиваемый интервал.
• Поддерживает оформление сообщений MiniMessage и RGB-цвета.
• В сообщениях с поддержкой Adventure и MiniMessage число можно сделать ссылкой на канал.
• Работает с Paper, Spigot, Purpur, Pufferfish, Leaf и Folia.
• Даёт другим плагинам доступ к счётчикам через внутренний API.

Основные плейсхолдеры:

• %ytcounter_subscribers_DragonMC% — число подписчиков YouTube;
• %ytcounter_followers_dragonmc% — число подписчиков TikTok или Twitch;
• %ytcounter_name_DragonMC% — имя канала;
• %ytcounter_url_DragonMC% — ссылка на канал;
• %ytcounter_raw_DragonMC% — число без форматирования.

Команды

• /counter youtube <url> — добавить канал YouTube.
• /counter tiktok <url> — добавить профиль TikTok.
• /counter twitch <url> — добавить канал Twitch.
• /counter list — показать добавленные каналы.
• /counter remove <platform> <handle> — удалить канал.
• /counter reload — перечитать конфигурацию.
• /counter info — показать состояние плагина.
• /counter help — открыть справку.

Также доступны алиасы /ytcounter и /ytc.

Права

• ytcounter.use — использование основных команд.
• ytcounter.admin — просмотр списка и удаление каналов.
• ytcounter.reload — перезагрузка конфигурации.
• ytcounter.bypass-cooldown — обход задержки между командами.

Настройка

В plugins/YTCounter/config.yml укажите ключ YouTube в youtube.api-key, а для Twitch — twitch.client-id и twitch.client-secret. TikTok работает без ключа.

Полезные параметры:

• update-interval — интервал обновления данных в секундах;
• cache.enabled и cache.ttl — кэширование значений;
• format.use-locale-format и format.locale — формат отображения чисел;
• format.loading-text и format.error-text — текст при загрузке и ошибке;
• logging.level и logging.log-requests — подробность журнала.

Требования

Нужны PlaceholderAPI и Java 21 или выше.