# 🎬 StreamAnnouncer Lite for Velocity ### **Free Edition — Bridge Your Streaming Community with Your Minecraft Network** > **Minecraft Velocity Proxy Plugin** | **Twitch Live Stream Notifications** | **Automatic Announcements** [![Velocity](https://img.shields.io/badge/Velocity-3.3.0+-00AA00?style=for-the-badge&logo=minecraft&logoColor=white)](https://papermc.io/software/velocity) [![Twitch](https://img.shields.io/badge/Twitch-Supported-9146FF?style=for-the-badge&logo=twitch&logoColor=white)](https://twitch.tv) [![Discord](https://img.shields.io/discord/1166265613241569381?style=for-the-badge&logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.com/invite/H2nsh8MNtr) [![Free Premium Evaluation](https://img.shields.io/badge/Premium-Free%20Evaluation%20Copy-FF75D8?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/H2nsh8MNtr) --- *Automatically announce live streams and keep your community engaged, all from within Minecraft, completely free.* > ### 🎁 Try Premium free > > **Want to test the full version before buying? Just ask.** > Message me on **[Discord](https://discord.com/invite/H2nsh8MNtr)** and I will send you a > **free evaluation copy of StreamAnnouncer Premium**, no payment and no commitment. > ⚠️ **This is the Lite (free) version of StreamAnnouncer.** > Premium adds **Kick support**, **stream rewards**, **MySQL** and **PlaceholderAPI**. > See the full comparison below.

--- ## 🌟 Why StreamAnnouncer Lite? Transform your Minecraft server into a streaming-friendly community hub — **for free**. **Make your content creators feel valued.** StreamAnnouncer Lite is the free **Velocity proxy plugin** for integrating **Twitch** with your Minecraft network. When streamers go live on **Twitch**, your entire network knows instantly — with beautiful, clickable notifications and real-time status updates. Everything runs directly on your proxy, no extra plugins needed. **Why choose StreamAnnouncer Lite?** - ✨ **100% free**: Core Twitch notifications at no cost - 🚀 **Velocity-native**: Built specifically for Velocity proxy servers - 🔧 **Highly customizable**: MiniMessage formatting, filters, and per-channel settings - 🪶 **Lightweight**: No backend plugin required — runs entirely on the Velocity proxy - 🔒 **Simple setup**: Get started in minutes with just your Twitch credentials --- ## ⚡ Key Features

### 📢 Smart Announcements - **Instant notifications** when streamers go live - Beautiful **MiniMessage** formatting with gradients & hover text - **Clickable "Watch Now"** buttons with stream title - Filter by **game category** or **title keywords** - Broadcast to **specific servers** or network-wide

![Announcement Preview](https://i.imgur.com/Rel921G.gif)

### 🔗 Player Self-Service - Players link channels with `/setchannel` - **Admin controls** for managing all links - **Transfer links** when usernames change - Full **permission system** for granular control

![Player commands preview](https://i.imgur.com/zK6PIVz.gif)

--- ## 🎮 Platform Support

| Platform | Live Detection | Lite | Premium | |:--------:|:--------------:|:----:|:-------:| | ![Twitch](https://img.shields.io/badge/Twitch-9146FF?style=flat-square&logo=twitch&logoColor=white) | ✅ | ✅ | ✅ | | ![Kick](https://img.shields.io/badge/Kick-53FC18?style=flat-square&logo=kick&logoColor=black) | ✅ | ❌ | ✅ | *Kick support and multi-stream viewer links are available in Premium. [Ask on Discord for a free evaluation copy](https://discord.com/invite/H2nsh8MNtr).*

--- ## 📊 Lite vs Premium Comparison

| Feature | Lite (Free) | Premium | |:--------|:-----------:|:-------:| | **Twitch** live/offline announcements | ✅ | ✅ | | **Kick** live/offline announcements | ❌ | ✅ | | Smart filters (game & title) | ✅ | ✅ | | Player self-service (`/setchannel`) | ✅ | ✅ | | Admin channel management | ✅ | ✅ | | MiniMessage formatting | ✅ | ✅ | | Auto update checker | ✅ | ✅ | | **Reward automation** (commands on start/stop/during) | ❌ | ✅ | | **Channel-specific commands** | ❌ | ✅ | | **Timed rewards** while streaming | ❌ | ✅ | | **MySQL** cross-server sync | ❌ | ✅ | | **PlaceholderAPI** integration | ❌ | ✅ | | **Multi-stream viewer** links (multiwatch.net) | ❌ | ✅ | | **Plugin messaging bridge** (backend server commands) | ❌ | ✅ | | **HMAC-signed** secure messaging | ❌ | ✅ | | **Streamer join** announcements | ❌ | ✅ |

--- ## 🔍 What Premium Adds, In Detail Everything below is premium only. The config keys are named so you can see exactly what you would be configuring. ### 🟢 Kick support A second platform alongside Twitch, with its own `kick.yml`: channel list, linked users, filters and messages. Lite is Twitch only. ### 🎁 Reward commands on stream start and stop `commands` in `twitch.yml` / `kick.yml`. Runs a list of commands when a channel goes live, and another when it stops, once **per linked Minecraft player**. Placeholders: `%player%`, `%channel%`, `%title%`, `%platform%`. Every command targets the servers you name, and `skip_offline_players` avoids firing for players who are not connected. ### 🎯 Per-channel commands `channelCommands`. The same start/stop hooks defined **per channel**, so a partnered streamer can trigger different rewards from everyone else. ### ⏱️ Timed rewards while live `timedCommands`. Repeats commands every `repeat_time` seconds (set in `config.yml`) for as long as the streamer stays live, for each linked player. The shipped example is `give %player% minecraft:diamond 1`. ### 🔗 Multi-stream viewer link `multiPlatformViewer`. Combines **every** channel currently live, across Twitch and Kick, into one shareable URL and broadcasts it on an interval to the servers you choose. The URL format is configurable, with working presets for multiwatch.net and multistream.me. ### 🗄️ MySQL sync Writes live state into three tables (`liveChannels`, `placeholders`, `linkedUsers`) so backend servers and other plugins can read who is live without talking to the proxy. ### 🔌 StreamAnnouncer-Bridge and PlaceholderAPI A companion plugin for your backend Paper/Spigot servers. The proxy sends commands over a plugin messaging channel and every message is signed with **HMAC-SHA256** using the `shared-secret` from `config.yml`, so a backend server will not act on a forged packet. PlaceholderAPI then exposes live status for scoreboards, tab lists and chat prefixes. ### 👋 Announce when the streamer joins `announce_only_if_streamer_on_server`. Holds the announcement back until the linked player is actually on the network, then announces, so nobody misses it because the streamer went live before joining. 📖 **[Full feature list for both editions](https://github.com/ax3lt/StreamAnnouncer-public#readme)** --- ## 🚀 Quick Start ``` 1. Install on Velocity proxy 2. Add your Twitch API credentials in twitch.yml 3. Add channels: /sav channels add twitch 4. Done! 🎉 ``` **Requirements:** - Velocity 3.3.0+ - Java 17+ - Twitch Developer credentials ([how to get them](https://dev.twitch.tv/console)) > 💡 **Note:** Unlike the premium version, the Lite edition does **not** require the [StreamAnnouncer-Bridge](https://github.com/ax3lt/StreamAnnouncer-public/releases) plugin on your backend servers. Everything runs on the Velocity proxy alone. --- ## 📸 Gallery

*Screenshots coming soon!*

--- ## 🛠️ Configuration Preview All messages use **MiniMessage** with full gradient, hover, and click support: ```yaml # Example: Live stream announcement now_streaming: "%prefix% %channel% is now LIVE! │ %title% ▶ WATCH NOW" # Available placeholders: %channel%, %title%, %url%, %platform%, %player% ``` --- ## 🔌 StreamAnnouncer-Bridge (Premium Only) The premium version supports a companion **[StreamAnnouncer-Bridge](https://github.com/ax3lt/StreamAnnouncer-public/releases)** plugin on your backend Spigot/Paper servers, enabling: - 🖥️ **Command execution from Velocity** — Give items, run reward commands when streamers go live/offline or during streaming. All messages are **HMAC-signed** for security. - 📊 **PlaceholderAPI support** — Display live streaming status in scoreboards, tab lists, chat prefixes, and more. > ⚠️ **The Lite version does not support the Bridge plugin.** Plugin messaging, MySQL sync, backend command execution, and PlaceholderAPI are all **premium-only** features. --- ## ⚡ Upgrade to Premium Want **Kick support**, **automated rewards**, **MySQL sync**, **PlaceholderAPI**, and more? ### 🎁 Try it free first Message me on Discord and I will send you a **free evaluation copy of Premium**, no payment and no commitment. Run it on your own network, then decide. 👉 **[Ask for a free Premium evaluation on Discord](https://discord.com/invite/H2nsh8MNtr)** --- ## 💬 Community & Support

[![Discord Server](https://img.shields.io/discord/1166265613241569381?style=for-the-badge&logo=discord&logoColor=white&label=Join%20Our%20Discord&color=5865F2)](https://discord.com/invite/H2nsh8MNtr) **Get help, share configs, and request features!**

--- ## 🏷️ Keywords & Tags

`minecraft` `velocity` `proxy` `plugin` `twitch` `streaming` `live stream` `announcer` `notification` `alert` `free` `lite` `integration` `automation` `content creator` `streamer` `broadcast` `chat` `announcement` `java` `kotlin` `minecraft server` `velocity plugin` `twitch integration` `live notifications` `stream alerts` `minecraft streaming` `gaming` `community` `server plugin` `proxy plugin` `minecraft proxy` `velocity proxy` `minimessage` `minecraft chat` `server notifications` `stream detection` `automatic announcements` `real-time` `live status` `streaming platform` `twitch api` `minecraft community` `content creator tools`

---

**Made with ❤️ for the Minecraft streaming community** *StreamAnnouncer Lite — Free Twitch Notifications for Velocity*

ax3lt

\me