Custom Announcer

<div align="center">

📢 CustomAnnouncer 📢

Lightweight & Highly Customizable Player Announcement System

Paper 1.21+

Java 21+

*Send professional announcements to your players with unprecedented control and flexibility*

</div>

---

✨ Features

🎯 Template System

- Easy Management: Define reusable announcements in `config.yml` - Easy Management: Create as many announcement templates as needed - Easy Management: Modify templates without restarting the server

📢 Multiple Display Types

- Mix & Match - Classic text-based announcements - Mix & Match - Large center-screen messages with optional subtitles - Mix & Match - Non-intrusive top-of-screen notifications - Mix & Match - Full-width progress bar announcements - Mix & Match: Combine multiple types in a single announcement

🎨 Advanced Color & Formatting System

- Nested Formatting: `&4`, `&c`, `&a`, and all 16 base colors - Nested Formatting: `&#FF5733` for precise color control - Nested Formatting: <gradient:#FF5733:#33FF57>text</gradient> - Nested Formatting: <rainbow>Rainbow Text</rainbow> with automatic cycling - Nested Formatting: Full text styling support - Nested Formatting: Combine multiple effects seamlessly

🎯 Flexible Targeting System

- Real-Time Delivery: Send announcements to every online player - Real-Time Delivery: Send to specific players or groups - Real-Time Delivery: Instant distribution to targets

📝 Custom Announcements

- Instant Delivery: Build announcements without pre-configured templates - Instant Delivery: Choose type, colors, duration, and targets - Instant Delivery: `/announce custom <type> <duration> <text> <targets>` - Instant Delivery: Create and send in seconds

🔐 Permission-Based Access

- Secure by Default: `announcer.use` permission for announcement commands - Secure by Default: OP-only access for safety

⚙️ Powerful Commands

- `/announce <template> <all|player1 player2>` - Send template-based announcement - `/announce custom <type> <duration> <text> <targets>` - Send custom announcement - `/announce reload` - Hot-reload configuration without restart - Smart Tab Completion: Full autocompletion for all commands

---

---

📦 Installation

1. Reload the latest `CustomAnnouncer.jar` from releases 2. Reload the jar file in your server's `plugins/` folder 3. Reload your server to generate the default configuration 4. Reload `plugins/CustomAnnouncer/config.yml` to your needs 5. Reload with `/announce reload` or restart your server

---

🎮 Usage Examples

For Server Admins

Send Template Announcement to All Players ``` /announce welcome all ```

Send to Specific Players ``` /announce important Player1 Player2 Player3 ```

Create Custom Announcement ``` /announce custom TITLE 10 "&6&lHappy Friday Everyone!" all ```

Reload Configuration ``` /announce reload ```

---

📋 Permissions

| Permission | Description | Default | |------------|-------------|---------| | `announcer.use` | Send announcements | op | | `announcer.reload` | Reload configuration | op |

---

🌟 Why CustomAnnouncer?

✅ Easy to Use: Simple commands and intuitive configuration

✅ Beautiful Output: Professional color and formatting options

✅ Highly Customizable: Every aspect is configurable

✅ Zero Dependencies: Only requires Paper API

✅ Performance Optimized: Lightweight and efficient

---

Support

- contact me on discord nickname: we_rt, only with important bug related things

---

🌟 License

The source code is not publicly available, but if you want to edit something in the plugin for your own needs, update the plugin to a new version or anything else, contact me on discord nickname: we_rt and we will definitely come to an agreement

---

<div align="center">

Made with ❤️ for the Minecraft community