LiveAnnouncer

PlaceholderAPI Support (New)

LiveAnnounce now supports PlaceholderAPI, allowing you to customize how the player is displayed using external placeholders such as prefixes, groups, and more.

How It Works

* The {player} placeholder is now configurable via player-format. * You can use PlaceholderAPI placeholders like %vault_prefix%, %luckperms_prefix%, %player_name%, etc. * Other placeholders like {platform}, {link}, and {color} remain unchanged.

Example Configuration

player-format: "%luckperms_prefix% %player_name%"

announcement-formats:
  default:
    description: "<red>{player}</red> is now streaming!"

Notes

* PlaceholderAPI is optional, but recommended for advanced formatting. * Compatible with plugins like Vault, LuckPerms, and others.

LiveAnnounce - MiniMessage Support

LiveAnnounce now supports MiniMessage, allowing you to create dynamic announcements with gradients, rainbow patterns, and RGB colors.

Setup Instructions

1. Open the config.yml file. 2. Navigate to the announcement-formats section. 3. Use MiniMessage tags like <gradient:color1:color2> or <rainbow>. 4. The plugin is compatible with both Legacy (&) and MiniMessage codes, but you CANNOT mix both styles in the same message or configuration line. 5. Use /la reload to apply the changes. Example Configuration:

announcement-formats:
  default:
    line1: "<gradient:#555555:#aaaaaa><bold>--------------------------</bold></gradient>"
    title: "<yellow>⚡</yellow> <reset>{color}<bold>¡LIVE ON {platform_upper}!</bold> <yellow>⚡</yellow>"
    description: "<red>{player}</red> <reset>is now <rainbow>streaming live</rainbow>"
    link: "<white>Join now!</white> {color}&n{link}"
    hover: "<yellow>Click to open the <bold>stream</bold>!"
    line2: "<gradient:#555555:#aaaaaa><bold>--------------------------<bold></gradient>"

Discord Webhooks (New in v1.1.4)

LiveAnnounce now supports native, asynchronous Discord integration! You can automatically send elegant Embed messages to your Discord server whenever a player announces their live stream in-game.

Setup Instructions

1. Open the config.yml file. 2. Under the discord section, set enabled: true. 3. Paste your Discord channel Webhook URL into webhook-url. 4. Customize the Embed message title, description, and color to your liking. 5. Use /la reload or restart your server. Example Configuration:

discord:
  enabled: true
  webhook-url: "https://discord.com/api/webhooks/..."
  embed:
    color: 16711680 # Red color in decimal format
    title: "⚡ ¡{player} is live on {platform}! ⚡"
    description: "Join now by clicking here!\n{link}"

LiveAnnounce v1.1.3 – Sound Effects System & Configuration Improvements

New Features:

- Configurable sound effects when announcements are broadcast - Per-player success sound for command execution feedback - Global toggle to enable/disable all sounds via config.yml - Customizable sound, volume, and pitch for each event type

Configuration Improvements:

- Added complete sound settings section in config.yml - Better organized configuration structure with clear comments

Internal Optimizations:

- Code cleanup and better package organization - Improved project structure for easier maintenance - Enhanced error handling for better plugin stability

LiveAnnounce v1.1.2 – Proxy Update

New Features: - Brand new proxy system with Velocity support - Automatic Velocity proxy detection on Paper servers - Manual proxy configuration through config.yml - Standalone mode for servers without proxy Performance Improvements: - Optimizations in cross-server message sending - Better communication channel handling How it works: - Installation: The plugin must be installed on servers behind the proxy (DO NOT install on the PROXY itself!) - Enable proxy system: In config.yml, change proxy.enabled: false to true - Configure Velocity: Set velocity-enabled: true and proxy.has-network: true - Paper requirement: Velocity support only works on Paper servers (not Spigot) - Channel registration: The plugin automatically registers the required channels for cross-server communication - Automatic standalone mode: If no proxy is detected, the plugin automatically works in standalone mode Future Improvements: - BungeeCord support in future versions - Advanced multi-proxy configuration - Usage metrics and statistics - Proxy behavior customization Note: If you find any bugs or issues, please report them on our GitHub repository: https://github.com/devkopi/liveannounce

LiveAnnounce v1.1.1 – Cooldown System and Performance Evolution

New Features

* Per-player cooldown system to prevent announcement spam * Configurable cooldown duration and messages via config.yml * Cooldown system reloadable without server restart * Async announcement pipeline for safer execution * Improved task scheduling between async processing and main thread * Clear separation between data preparation and message delivery

Performance Improvements

* Major reduction in main-thread workload * Announcement preparation moved off the main thread * Prevention of CPU spikes during announcement execution * Significant reduction in memory usage * Intelligent caching system for platform colors

Internal Changes

* Optimized architecture using DTO pattern * New AnnouncementData structure for efficient data handling * ColorCache system with automatic config change detection * Optimized channel extraction system * Reduced synchronous operations * Cleaner execution flow for announcements * Reduced unnecessary object creation * Arrays used instead of HashMaps for fixed formats * Improved template variable replacement performance * Better profiling results using Spark

Compatibility

* Fully backward compatible * No functional changes required for end users * Existing configurations continue working without modifications

Note about the next version (v1.1.2)

I’ve been working on a new feature focused on proxy-connected server networks, which will significantly expand the reach of announcements. I’m still polishing this feature to make sure stability and performance are solid before the official release. I also want to apologize for the delay in some updates. Part of this time went into major optimizations and preparing the plugin for bigger changes moving forward. Thank you for the patience and for supporting the project.

v1.0.4 - Configurable Announcement Formats

New Features: - Fully configurable announcement formats - Customize every part of stream announcements - Platform-specific colors - Set different colors for Twitch, YouTube, Kick, TikTok - Dynamic variables - Use {player}, {platform}, {color}, {link}, {channel} in your formats Customization Examples:

platform-colors:
  twitch: "&d"    # Purple
  youtube: "&c"   # Red
  kick: "&a"      # Green

announcement-formats:
  default:
    title: "&f⚡ {color}&l¡LIVE ON {platform_upper}! &f⚡"
    description: "&f{player} &7is now streaming live"
    link: "&7Join now! {color}&n{link}"

Note: This release focuses on customization. Performance optimizations coming in next update!

v1.0.3 - Configurable Messages & English Support

New Features: - Configurable Messages System - Customize all plugin messages from config.yml - English Aliases - Use /stream, /live, /livestream instead of just /directo Configuration Updates:

messages:
  no-permission: "&cYou don't have permission..."
  invalid-link: "&cInvalid link..."
  reloaded: "&aConfiguration reloaded..."
  # And more customizable messages

New Commands & Aliases:

Stream Announcement Add Commands: - /stream <link> - /live <link> - /livestream <link>

¡Thanks for using LiveAnnouncer!

LiveAnnounce v1.0.2 - New Update!

Configurable Prefix

- New! You can now customize the plugin's prefix from config.yml - Support for color codes (&) and formatting - Automatically applies to all plugin messages

Changes in Config.yml

```yaml

New: Prefix configuration

prefix: "&8[&bLiveAnnounce&8] &7"

v1.0.1 – Clickable Link Fix

This update fixes an issue where the link in the /directo announcement was not clickable in chat.

Changes

- Replaced plain text broadcast with a clickable chat component. - Added a ClickEvent to properly open the stream URL. - Improved announcement formatting and compatibility. Thanks for using LiveAnnouncer!

LiveAnnounce — Beta Release

This is the first public beta of LiveAnnounce. The plugin is fully functional, but some features may still receive adjustments before the stable v1.1 release.

Added

Core Features

- Main announcement command: /directo <url> - Automatic detection for major livestream platforms: Twitch, YouTube, Kick, TikTok. - Professional announcement formatting with clickable URL support. - Lightweight implementation optimized for performance.

Admin Commands

- /la help — Shows available commands - /la version — Displays plugin version - /la reload — Reloads the configuration - /la status — Shows plugin status - /la enable — Enables the plugin - /la disable — Disables the plugin

Permissions

- liveannounce.directo — Allows stream announcements - liveannounce.admin — Grants access to administrative commands

Configuration

Auto-generated configuration file:

enable: true

Compatibility

- Compatible with Minecraft versions 1.8 to 1.21 - Works on Spigot, Paper, Purpur, and any Bukkit-based server

Known Limitations (Beta)

- Multi-language support is planned but not yet included - Future updates will expand customization options for announcements

Notes

This beta version is intended to collect feedback and prepare for the upcoming stable release. Reports, suggestions, and contributions are welcome on GitHub.

Links

- Source Code: https://github.com/devkopi/liveannounce