AutoMSG

AutoMSG



The ultimate lightweight announcement system for Minecraft 1.21.1 with HEX colors, Discord integration, and immersive sound effects.

Main Features
│➜ Modern HEX/RGB Support: Full support for #FFFFFF codes.
│ ➜ Create vibrant gradients and professional chat colors.
│➜ Discord Webhook Sync: Mirror every in-game announcement
│ ➜ directly to your Discord channel via native Webhooks.
│➜ Immersive Audio Feedback: Automatic "Happy Villager" sound
│➜ triggered for all players whenever a message is sent.
│➜ Smart Timer System: Flexible scheduling using d (days),
│➜ h (hours), m (minutes), and s (seconds) in config.yml.
│➜ Dynamic Placeholder Engine: Real-time updates for {player},
│➜ {online_players}, and {max_players} in any announcement.
│➜ Visual ID Management: Easy-to-use list system to track,
│➜ identify, and remove specific messages without errors.
│➜ Safety Syntax Shield: Built-in protection against wrong
│➜ commands to prevent plugin crashes or console errors.
│➜ Dual Language Core: Instant switching between English (en)
│➜ and Portuguese (pt) via dedicated translation files.
│➜ Instant Test Command: Real-time broadcast trigger to verify
│➜ colors, sounds, and webhooks without waiting for the timer.
│➜ Clean Resource Logic: Zero-dependency system ensuring
│➜ maximum performance and low MSPT impact on your server.

Commands
│➜ am help / am Opens the main help menu with all available features.
│➜ am test Manually triggers the current announcement for testing.
│➜ am list [ category ] Displays all registered announcements with their unique IDs.
│➜ am add [category] [ message] Adds a new formatted announcement to the system.
│➜ am remove [category] [id] Permanently deletes an announcement by its ID.
│➜ am reload Instantly reloads configurations, sounds, and languages.

Category Management Guide
The AutoMSG system is now fully modular. To manage announcements via commands, you must always specify the Category Name (the name of the `.yml` file without the extension).

Listing Announcements
Before removing or editing, you need to know the specific ID of a message.
Command: /am list <category>
Example: /am list tips
Description: Displays all messages from the tips.yml file. Each message will have a numerical ID next to it. The category prefix will also be displayed so you can see exactly how it looks for players.

➕ Adding New Announcements
You can add messages with HEX colors and placeholders directly through the chat.
Command: /am add <category> <message>
Example: /am add votes &b Vote now at #FF5555 our website!
Description: Inserts a new message at the end of the `votes.yml` list.
Pro Tip: You do not need to type the prefix in the command; the system automatically injects the prefix configured in that category's file.

❌ Removing Announcements (Smart Re-indexing)
The system is intelligent: when you remove an ID, the messages below it "slide up" to fill the gap, keeping the list sequential.
Command: /am remove <category> <id>
Example: /am remove rules 2
Description: Deletes the message with ID 2 from rules.yml. If a message with ID 3 existed, it will automatically become the new ID 2.

Applying Changes
After making manual edits to files (like changing intervals or sounds) or using add/remove commands, use the reload.
Command: /am reload
Description: Restarts all timers, reloads language translations, and refreshes the announcement lists for all categories at once.

Important Admin Tips
1. Available Categories: Ensure you use the exact names: `votes`, `tips`, `links`, `rules`, `motd`, or `other`.
2. Modern Colors: You can use HEX codes (e.g., `#66ff33`) in both the `/am add` command and the YAML files.
3. Placeholders: Use `{player}` for the player's name and `{online_players}` for the current player count.
4. Permissions: Only players with the `automsg.admin` permission (or OPs) can see Tab-Completion suggestions and execute these commands.




Permissions
│➜ automsg.admin Full access to all broadcast, management, and
│➜ reload commands.

I mportant Notice
│➜ Java 21 Required: This plugin is optimized for modern
│➜ environments and requires Java 21 to run on 1.21.x.
│➜ Sound Toggle: You can enable or disable the Villager
│➜ evolution sound directly in the Settings section.
│➜ Reporting: If you encounter any bugs, please use our GitHub
│➜ Issues section: GitHub Issues