AstrumAutoMessages
A powerful and feature-rich automatic message plugin for Spigot/Paper servers with support for clickable links, tooltips, commands, and multi-language support.

Features

• ✅ Periodic automatic messages in chat
• Clickable Links - Open URLs directly from chat
• Hover tooltips
• ⚡ Clickable commands
• Multi-language support (English, Portuguese, and custom translations)
• Sequential or random mode
• Full color code support
• ⚙️ Simple configuration
• Reload without server restart

What Makes AstrumAutoMessages Different?
Unlike other automatic message plugins, AstrumAutoMessages allows you to create clickable links in messages. Instead of showing ugly URLs in chat like https://discord.gg/12321, you can create elegant messages like:

[Astrum] Join our Discord! Click here

When the player clicks on "Click here", the link opens automatically in their browser!

Installation

1. Download the .jar file
2. Place it in your server's plugins folder
3. Restart the server
4. Configure the config.yml file as needed
5. Use /am reload to reload the configuration

Building from Source
mvn clean package
The .jar file will be generated in target/AstrumAutoMessages-1.0-SNAPSHOT.jar

Configuration
Edit the file plugins/AstrumAutoMessages/config.yml:

# Language (available: en-US, pt-BR)
# Players can create custom translations by copying a messages file
language: en-US

# Interval between messages (in seconds)
interval: 300

# Display mode: sequential (in order) or random
mode: sequential

# Message prefix (supports colors with &)
prefix: "&8[&6Astrum&8] &r"

# Auto messages
messages:
- "&aVisit our website! {link:&e&nClick here: https://yoursite.com}"
- "&bJoin our Discord! {link:&d&nClick here: https://discord.gg/example}"

Message Syntax
Clickable Links
{link:text:url}
Example:

- "Visit our site! {link:&e&nClick here: https://myserver.com}"

Tooltips (Hover Text)
{tooltip:text:tooltip message}
Example:

- "Did you know? {tooltip:&e&nHover here:&7This is a secret tip!}"

Clickable Commands
{cmd:text:command}
Example:

- "Don't forget to vote! {cmd:&e&n/vote:vote}"

Multiple Elements
You can combine multiple elements in the same message:

- "&aHello! {link:&eVisit our site: https://site.com} or {cmd:&dSee store:/store}"

Colors
Use & followed by a color code:

• &a = Green
• &b = Aqua
• &c = Red
• &d = Light purple
• &e = Yellow
• &f = White
• &0-9 = Other colors
• &l = Bold
• &n = Underline
• &o = Italic

Commands
All commands support aliases: /automessage, /am, /automsg

Command Description Permission
/automessage reload Reload configuration automessage.admin
/automessage start Start auto messages automessage.admin
/automessage stop Stop auto messages automessage.admin
/automessage list List all messages automessage.admin
/automessage info Show plugin information automessage.admin
/automessage test <number> Test a specific message automessage.admin
Permissions

• automessage.admin - Allows using all commands (default: OP)

Multi-language Support
Available Languages

• en-US (English - United States) - Default
• pt-BR (Português - Brasil)

Creating Custom Translations

1. Go to the plugin folder: plugins/AstrumAutoMessages/
2. Copy an existing translation file (e.g., messages_en-US.yml)
3. Rename it to messages_LANGUAGE.yml (e.g., messages_es-ES.yml for Spanish)
4. Translate all messages in the file
5. Set language: LANGUAGE in config.yml
6. Reload the plugin with /automessage reload

Translation File Structure
# Plugin startup/shutdown messages
plugin:
enabled: "&aAstrumAutoMessages enabled successfully!"
disabled: "&cAstrumAutoMessages disabled!"

# Command messages
command:
no-permission: "&cYou don't have permission to use this command!"
reload:
success: "&aConfiguration reloaded successfully!"
# ... more messages

Note: All plugin messages (commands, errors, info) are translatable. Only the automatic messages configured in config.yml need to be manually changed.

Usage Examples
Example 1: Discord Announcement
- "&d&lDiscord &8» &7Join our Discord! {link:&b&nClick here: https://discord.gg/yourserver}"

Example 2: Store
- "&6&lVIP Store &8» &7Get your VIP rank! {link:&e&nAccess store: https://store.yourserver.com}"

Example 3: Rules
- "&c&lRules &8» &7Read our rules at {link:&4&n/rules: https://yourserver.com/rules}"

Example 4: Voting
- "&a&lVote &8» &7Vote for the server and get rewards! {cmd:&2&n/vote:vote}"

Example 5: Tip with Tooltip
- "&e&lTip &8» {tooltip:&6&nHover here for a tip!:&7Use /help to see all available commands!}"

Example 6: Mixed Elements
- "&bServer &8» {link:&eWebsite: https://site.com} | {cmd:&aRules:/rules} | {tooltip:&dInfo:&7Hover for server info!}"

Requirements

• Minecraft 1.8 - 1.21+ (compatible with most versions)
• Spigot/Paper
• Java 8+

Support
To report bugs or suggest improvements, open an issue in the project repository.