Installation
1. Place the
.jar file in your Minecraft server's
plugins folder.
2. Restart your server to generate the default configuration file.
3. Configure the plugin (see Configuration below).
4. Use
/scheduledannouncements reload to apply changes without restarting.
Configuration
1. Open the
plugins/ScheduledAnnouncements/config.yml file.
2. Customise the global settings and individual announcements as needed. There are lots of comments in the config file to help guide you.
3. Save the file.
Example
config.yml:
```
settings:
prefix:
text: "[Announcement]"
color: "gold"
message_color: "yellow"
announcements:
server_advertise:
cron: "0 0/30 * * * ?"
message: "Our server is awesome!"
prefix:
text: "[Ad]"
color: "green"
message_color: "aqua"
discord_invite:
cron: "0 0 */3 * * ?"
message: "Join our Discord! |
https://discord.gg/yourserver"
prefix:
text: ""
message_color: "light_purple"
```
Cron Expressions
Cron expressions allow you to schedule announcements with precision.
Use this cron expression generator for help: https://www.freeformatter.com/cron-expression-generator-quartz.html
Format: Second Minute Hour DayOfMonth Month DayOfWeek Year
Examples:
- `0 0/30 * * * ?`: Every 30 minutes
- `0 0 12 * * ?`: Every day at 12:00 PM
- `0 15 10 ? * MON-FRI`: At 10:15 AM, Monday through Friday
Colors
Use color names from NamedTextColor for customising your announcements:
https://jd.advntr.dev/api/4.17.0/net/kyori/adventure/text/format/NamedTextColor.html
In-game Commands
/scheduledannouncements reload: Reloads the plugin configuration.
Tips
- To add a clickable URL, append it to the message after a pipe character (|).
- Invalid cron expressions will be logged as warnings and skipped.
- You can disable the prefix for specific announcements by setting the prefix text to an empty string.