TitleBroadcast

# TitleBroadcast **Advanced scheduled broadcasting plugin for Paper servers with extensive customization options** ## 🌟 Features ### 📋 **Scheduled Broadcasting System** - **Automatic broadcasts** with fully customizable intervals - **Random or sequential** broadcast ordering - **Player-based conditions** - only broadcast when players are online - **Minimum player requirements** for broadcasts ### 🎨 **Multiple Display Types** - **📺 Titles & Subtitles** with custom fade timings - **📊 Action Bars** with duration control - **💬 Chat Messages** with custom prefixes - **🔗 Combination Support** - use multiple types simultaneously ### 🔊 **Enhanced User Experience** - **🎵 Sound Effects** - fully customizable per broadcast - **✨ Particle Effects** - with count, offset, and speed controls - **🎭 Rich Text Formatting** via Adventure API & MiniMessage - **🌈 Gradients & Colors** - modern text styling support ### 🔐 **Permission-Based Broadcasting** - **Fine-grained permissions** for different broadcast types - **Per-broadcast permission** requirements - **Receive permissions** for announcements, alerts, events, tips - **Admin permissions** for management commands ### 🌍 **World Management** - **World-specific broadcasts** - different messages for different worlds - **Disabled worlds** - exclude certain worlds from broadcasts - **Per-world broadcast lists** - complete customization ### ⚡ **Performance & Compatibility** - **🔥 Folia Support** - full compatibility with Folia servers - **📦 Permission Caching** - optimized performance for large servers - **🧵 Threaded Scheduler** - uses region scheduler when available - **🔌 PlaceholderAPI Integration** - dynamic content support ## 🎮 Commands | Command | Description | Permission | |---------|-------------|------------| | `/titlebroadcast` | Main command with help | `titlebroadcast.command` | | `/titlebroadcast reload` | Reload configuration | `titlebroadcast.reload` | | `/titlebroadcast list` | List all broadcasts | `titlebroadcast.list` | | `/titlebroadcast send <broadcast>` | Send specific broadcast | `titlebroadcast.send` | | `/titlebroadcast toggle` | View broadcast status | `titlebroadcast.toggle` | | `/titlebroadcast info` | Plugin information | `titlebroadcast.command` | | `/titlebroadcast next` | Show next scheduled broadcast | `titlebroadcast.list` | **Aliases:** `tb`, `broadcast`, `titlebc` ## 🔑 Permissions ### **Admin Permissions** - `titlebroadcast.command` - Use the main command - `titlebroadcast.reload` - Reload configuration - `titlebroadcast.list` - List broadcasts - `titlebroadcast.send` - Send manual broadcasts - `titlebroadcast.toggle` - Toggle broadcasts ### **Receive Permissions** *(Default: true)* - `titlebroadcast.receive.announcements` - Receive announcements - `titlebroadcast.receive.alerts` - Receive alerts - `titlebroadcast.receive.events` - Receive events - `titlebroadcast.receive.tips` - Receive tips ## ⚙️ Configuration ### **📝 camelCase Configuration** The plugin uses modern camelCase configuration throughout: ```yaml # Broadcast settings broadcastSettings: enabled: true intervalSeconds: 300 randomOrder: true onlyWhenPlayersOnline: true minimumPlayersRequired: 1 # Default display settings defaultDisplaySettings: title: enabled: true fadeInTicks: 10 stayTicks: 70 fadeOutTicks: 20 sound: enabled: true soundType: "ENTITY_EXPERIENCE_ORB_PICKUP" volume: 1.0 pitch: 1.0 ``` ### **🎨 Rich Broadcast Examples** ```yaml broadcasts: welcome: enabled: true permission: "titlebroadcast.receive.announcements" displaySettings: title: enabled: true text: "<gradient:#ff6b6b:#feca57>Welcome!</gradient>" fadeInTicks: 20 stayTicks: 60 fadeOutTicks: 20 subtitle: enabled: true text: "<color:#74b9ff>Enjoy your stay!</color>" sound: enabled: true soundType: "BLOCK_NOTE_BLOCK_CHIME" volume: 0.8 pitch: 1.2 particles: enabled: true particleType: "HEART" count: 5 ``` ## 🎯 MiniMessage Support Full support for Adventure API's powerful MiniMessage formatting: - **Gradients:** `<gradient:#ff6b6b:#feca57>Text</gradient>` - **Colors:** `<color:#FFFF00>Yellow text</color>` - **Decorations:** `<bold>Bold</bold>`, `<italic>Italic</italic>` - **Hover & Click Events:** Interactive text elements - **And much more!** ## 🔗 PlaceholderAPI Integration ### **Built-in Placeholders** - `{player}` - Player name - `{displayname}` - Player display name - `{world}` - Current world name - `{online}` - Online player count - `{tps}` - Server TPS - `{health}`, `{level}`, `{exp}` - Player stats ### **PlaceholderAPI Support** All PlaceholderAPI placeholders are supported when the plugin is installed! ## 🚀 Installation 1. **Download** the latest release 2. **Drop** the JAR file into your `plugins/` folder 3. **Restart** your server 4. **Configure** broadcasts in