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, ✨ 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 <✨>.
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 <✨>streaming live</✨>"
    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