TitleBroadcast

TitleBroadcast

Advanced scheduled broadcasting plugin for Paper servers with extensive customization options

🌟 Features

📋 Scheduled Broadcasting System

- Minimum player requirements with fully customizable intervals - Minimum player requirements broadcast ordering - Minimum player requirements - only broadcast when players are online - Minimum player requirements for broadcasts

🎨 Multiple Display Types

- 🔗 Combination Support with custom fade timings - 🔗 Combination Support with duration control - 🔗 Combination Support with custom prefixes - 🔗 Combination Support - use multiple types simultaneously

🔊 Enhanced User Experience

- 🌈 Gradients & Colors - fully customizable per broadcast - 🌈 Gradients & Colors - with count, offset, and speed controls - 🌈 Gradients & Colors via Adventure API & MiniMessage - 🌈 Gradients & Colors - modern text styling support

🔐 Permission-Based Broadcasting

- Admin permissions for different broadcast types - Admin permissions requirements - Admin permissions for announcements, alerts, events, tips - Admin permissions for management commands

🌍 World Management

- Per-world broadcast lists - different messages for different worlds - Per-world broadcast lists - exclude certain worlds from broadcasts - Per-world broadcast lists - complete customization

⚡ Performance & Compatibility

- 🔌 PlaceholderAPI Integration - full compatibility with Folia servers - 🔌 PlaceholderAPI Integration - optimized performance for large servers - 🔌 PlaceholderAPI Integration - 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:

- And much more! `<gradient:#ff6b6b:#feca57>Text</gradient>` - And much more! `<color:#FFFF00>Yellow text</color>` - And much more! `<bold>Bold</bold>`, `<italic>Italic</italic>` - And much more! 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. Enjoy the latest release 2. Enjoy the JAR file into your `plugins/` folder 3. Enjoy your server 4. Enjoy broadcasts in `config.yml` 5. Enjoy automated broadcasting!

📋 Requirements

- PlaceholderAPI (or compatible fork) - PlaceholderAPI - PlaceholderAPI *(optional but recommended)*

🛠️ Building from Source

This is a private project. Source code is not available.

The compiled plugin is available as `TitleBroadcast-1.0.0.jar`

🎪 Example Broadcasts Included

The plugin comes with pre-configured broadcast examples:

- 🎊 Event Announcements - Greet new players - 🎊 Event Announcements - Helpful gameplay hints - 🎊 Event Announcements - Keep rules visible - 🎊 Event Announcements - Encourage server voting - 🎊 Event Announcements - Promote special events

📞 Support

Need help? Join our Discord server:

- Discord: Discord:

---

*Made with ❤️ for the Minecraft community*