Streamerplugin 1.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> [url] [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](https://dev.twitch.tv/console/apps) (free) |
| YouTube Detection | [Google Cloud API Key](https://console.cloud.google.com) 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