Streamerplugin v1.0

StreamerPlugin
Advanced Live Stream Announcements | Paper 1.21.x

---

What does it do?

StreamerPlugin automatically detects when players on your server go live on Twitch or YouTube, and notifies the entire server with a full suite of announcements. TikTok and Instagram are supported via webhook. Players can also manually announce with /golive.

---

Notification Types

All of these fire simultaneously when a streamer goes live, and repeat on a configurable interval:

✦ Screen Title + Subtitle — Large centered text with customizable timing
✦ Boss Bar — Top bar with color, style and auto-dismiss timer
✦ Action Bar — Above-hotbar notification
✦ Chat Broadcast — Clickable message with stream URL
✦ Sound Effects — Unique sounds per event, fully configurable
✦ Stream Book — Written book with clickable WATCH NOW + social links

Every channel can be turned on or off independently.

---

Platform Support

| Platform | Detection Method |
|---|---|
| Twitch | Auto (Helix API polling) |
| YouTube | Auto (Data API v3 polling) |
| TikTok | Webhook (IFTTT/Zapier) |
| Instagram | Webhook (IFTTT/Zapier) |
| Any | Manual /golive command |

---

Smart Book System

• Scans player inventory before giving (never duplicates)
• Given to players who join after a stream started
• Re-given when a player rejoins (if they dropped it)
• Never given during repeat announcements (only on first announce or join)
• Drops at feet if inventory full (configurable)

---

GUIs

Admin Panel (/streamadmin gui)
— Toggle global notifications on/off
— View live streamer count
— See live streamer player heads
— Reload all configs

Streamer Profile (/streamer profile)
— View your linked Twitch, YouTube, TikTok, Instagram
— See your current live status
— Click any platform to open the URL

---

Commands


/golive <platform> [title]— Go live (players)
/streamer profile — Open profile GUI
/streamer setlink <platform> <handle> — Link social account
/streamer gooffline — Mark yourself offline /streamadmin announce <player> ... — Force announce (admin)
/streamadmin reload — Reload configs (admin) /streamadmin gui — Admin panel (admin)

Permissions
| Permission | Description | Default |
|---|---|---|
| streamerplugin.golive | Use /golive | All players | | streamerplugin.streamer | Use /streamer commands | All players | | streamerplugin.notify | Receive live notifications | All players | | streamerplugin.admin | Use /streamadmin | OP only |

---

Configuration Highlights

• All messages use MiniMessage format (gradients, bold, hover, click events)
• World filter (whitelist or blacklist mode)
• Per-sound control (name, volume, pitch)
• Boss bar color and style
• Title timing (fade-in, stay, fade-out in ticks)
• Webhook secret validation
• Debug mode

--

Requirements
| Requirement | Details |
|---|---|
| Server | Paper 1.21.x only (not Spigot, not Folia) |
| Java | 21+ |
| Twitch Detection | Twitch Developer App (free) |
| YouTube Detection | [URL='https://console.cloud.google.com']Google Cloud API Key with YouTube Data API v3 enabled (free) |
| TikTok / Instagram |
IFTTT, Zapier, or Make.com account (free tier works) |

---

Quick Setup

1. Drop StreamerPlugin.jar into your /plugins folder
2. Start the server to generate config files
3. Open plugins/StreamerPlugin/config.yml
4. Fill in your Twitch and YouTube credentials
5. For TikTok/Instagram: set up a webhook pointing to:
6. Players link their accounts with /streamer setlink
7. Reload with /streamadmin reload

Setup & Integration Guide
For detailed instructions on setting up API keys (Twitch/YouTube)
and configuring Webhooks (TikTok/Instagram) via IFTTT/Zapier,
please follow our official guide:

CLICK HERE FOR THE FULL SETUP GUIDE


▶︎ Showcase Video


Discord: Join here | Author: geturplugins