1.2.5 Update OMG :D

Author: FiveDollaGobby

CURSEFORGE_DESCRIPTION.md

@@ -0,0 +1,240 @@
+# WelcomeMessages v1.2.5
+
+> **CurseForge Compatible** - This description is optimized for CurseForge's markdown renderer
+
+<div align="center">
+
+![WelcomeMessages Logo](https://img.shields.io/badge/WelcomeMessages-v1.2.5-blue?style=for-the-badge)
+
+**The Ultimate Welcome Plugin for Minecraft Servers**
+
+*Clean, lightweight, and packed with features that actually work!*
+
+[![Minecraft Version](https://img.shields.io/badge/Minecraft-1.21.x-green?style=flat-square)](https://minecraft.net)
+[![Java Version](https://img.shields.io/badge/Java-21-orange?style=flat-square)](https://openjdk.java.net)
+[![Spigot Compatible](https://img.shields.io/badge/Spigot-Compatible-yellow?style=flat-square)](https://spigotmc.org)
+[![Paper Compatible](https://img.shields.io/badge/Paper-Compatible-red?style=flat-square)](https://papermc.io)
+
+</div>
+
+---
+
+## 🎉 What's New in v1.2.5
+
+### ✨ **12 Amazing Text Animations**
+WelcomeMessages now includes a complete animation system with 12 different effects:
+
+- **Typing** - Character-by-character reveal with perfect color handling
+- **Typewriter** - Classic typewriter effect with blinking cursor
+- **Fade** - Smooth fade-in effect with opacity changes
+- **Slide** - Text slides in from the side
+- **Wave** - Text waves up and down like ocean waves
+- **Rainbow** - Colors cycle through rainbow spectrum
+- **Glitch** - Random characters appear and disappear
+- **Bounce** - Text bounces up and down with varying heights
+- **Shake** - Text shakes left and right randomly
+- **Pulse** - Text pulses in brightness (bright → yellow → gray)
+- **Matrix** - Matrix-style falling characters with green color
+- **Scramble** - Text scrambles with random characters, then reveals correctly
+
+### 🎯 **Action Bar Display**
+- Animations are **private to the target player** (no chat spam!)
+- Configurable duration for each animation
+- Different animations for join, quit, and first-join messages
+- Perfect color code preservation
+- Smooth performance optimization
+
+### 🛠️ **Bug Fixes & Improvements**
+- **FIXED:** Typing animations now work perfectly with color codes
+- **FIXED:** Typewriter animation with proper blinking cursor
+- **FIXED:** All linter errors and warnings (zero errors!)
+- **IMPROVED:** Performance and compatibility across all server types
+
+---
+
+## 🚀 Key Features
+
+### 🎨 **Visual Excellence**
+- **RGB & Gradient Support** - Modern color codes and rainbow text
+- **12 Text Animations** - Make your messages truly special
+- **Custom Rank System** - Unlimited custom ranks with any names
+- **Smart Effects** - Particles, sounds, titles, fireworks (all optional)
+
+### 🔧 **Admin-Friendly**
+- **Config Validation** - Won't crash your server with bad settings
+- **PlaceholderAPI Support** - 13+ placeholders for other plugins
+- **Full Spigot/Paper Compatibility** - Works on both server types
+- **Async Performance** - Your TPS will thank you
+- **Smart Caching** - Optimized for server performance
+
+### 👥 **Player Experience**
+- **Personal Toggle** - Players can turn messages on/off
+- **Join Counter** - Tracks player visits and saves data
+- **First Join Detection** - Special messages for new players
+- **Rank-Based Messages** - VIPs get VIP treatment
+- **Private Animations** - No chat spam, just beautiful effects
+
+---
+
+## 📋 Commands
+
+| Command | Description | Permission |
+|---------|-------------|------------|
+| `/welcome` | Show help menu | `welcome.use` |
+| `/welcome reload` | Reload configuration | `welcome.reload` |
+| `/welcome test` | Preview your join message | `welcome.test` |
+| `/welcome testall` | Test all features including animations | `welcome.testall` |
+| `/welcome testanim <type> [player]` | Test specific animation types | `welcome.testanim` |
+| `/welcome toggle` | Turn your messages on/off | `welcome.toggle` |
+| `/welcome stats [player]` | Check join count statistics | `welcome.stats` |
+| `/welcome reset [player]` | Reset player data | `welcome.reset` |
+| `/welcome version` | Show plugin version | `welcome.use` |
+
+---
+
+## 🎮 Animation Testing
+
+Test all the amazing animations with these commands:
+
+```bash
+# Test all features including animations
+/welcome testall
+
+# Test specific animation types
+/welcome testanim typing      # Character-by-character reveal
+/welcome testanim typewriter  # Typewriter with blinking cursor
+/welcome testanim bounce      # Bouncy text effect
+/welcome testanim matrix      # Matrix-style falling characters
+/welcome testanim scramble    # Scramble and reveal effect
+# ... and 7 more animation types!
+```
+
+---
+
+## ⚙️ Configuration
+
+### Animation Settings
+```yaml
+animations:
+  enabled: true
+  default-duration: 60
+  default-type: "typing"
+  use-action-bar: true
+  show-final-in-chat: true
+  
+  join:
+    enabled: false  # Disabled by default to prevent chat spam
+    type: "typing"
+    duration: 60
+  quit:
+    enabled: false  # Disabled by default to prevent chat spam
+    type: "fade"
+    duration: 40
+  first-join:
+    enabled: true   # First join animations are special
+    type: "rainbow"
+    duration: 80
+```
+
+### Custom Rank System
+```yaml
+custom-ranks:
+  enabled: true
+  ranks:
+    - "owner"      # Server owner
+    - "admin"      # Administrator  
+    - "moderator"  # Moderator
+    - "mvp"        # MVP rank
+    - "vip"        # VIP rank
+    - "premium"    # Premium rank
+    - "donator"    # Donator rank
+    - "member"     # Member rank
+```
+
+---
+
+## 🔗 PlaceholderAPI Support
+
+If you have PlaceholderAPI installed, you can use these placeholders:
+
+| Placeholder | Description |
+|-------------|-------------|
+| `%welcome_join_count%` | Player's join count |
+| `%welcome_first_join%` | Whether it's player's first join |
+| `%welcome_messages_disabled%` | Whether player has messages disabled |
+| `%welcome_last_seen%` | Time since player was last seen |
+| `%welcome_first_join_time%` | When player first joined |
+| `%welcome_time_since_last_seen%` | Time since last seen |
+| `%welcome_time_since_first_join%` | Time since first join |
+| `%welcome_total_unique_joins%` | Total unique players who joined |
+| `%welcome_join_ordinal%` | Player's join order (1st, 2nd, etc.) |
+| `%welcome_player_ordinal%` | Player's current position |
+| `%welcome_status%` | Player status (New/Returning) |
+| `%welcome_rank%` | Player's highest rank |
+| `%welcome_time_greeting%` | Time-based greeting |
+| `%welcome_server_uptime%` | Server uptime |
+
+---
+
+## 📊 Performance
+
+- **Async Everything** - Your TPS will thank you
+- **Smart Caching** - Not the dumb kind
+- **Optional Metrics** - Off by default for privacy
+- **Works on Potato Servers** - Optimized for all server sizes
+- **Zero Linter Errors** - Perfect code quality
+
+---
+
+## 🛡️ Compatibility
+
+- **Minecraft:** 1.21.x
+- **Java:** 21 (required by Minecraft)
+- **Server Software:** Spigot, Paper, Purpur, Pufferfish
+- **Permission Plugins:** LuckPerms, PEX, GroupManager, etc.
+- **Other Plugins:** PlaceholderAPI, bStats
+
+---
+
+## 📥 Installation
+
+1. Download the `WelcomeMessages-1.2.5.jar` file
+2. Place it in your server's `/plugins` folder
+3. Restart your server
+4. Edit the configuration files to your liking
+5. Enjoy your new welcome system!
+
+---
+
+## 🎯 Why Choose WelcomeMessages?
+
+- **No Bloat** - Does one thing and does it well
+- **No Premium Features** - Everything is included
+- **Actually Works** - No crashes, no broken updates
+- **Modern Features** - RGB colors, animations, PlaceholderAPI
+- **Admin Friendly** - Config validation, easy setup
+- **Player Friendly** - Personal toggles, beautiful effects
+- **Performance Focused** - Async, caching, optimization
+- **Community Driven** - Open source, active development
+
+---
+
+## 🐛 Support & Feedback
+
+- **GitHub Issues:** Report bugs and request features
+- **Discord:** Join our community for support
+- **Wiki:** Comprehensive documentation available
+- **Updates:** Regular updates with new features and fixes
+
+---
+
+<div align="center">
+
+**Made with ❤️ by FiveDollaGobby**
+
+*The welcome plugin that actually works!*
+
+[![GitHub](https://img.shields.io/badge/GitHub-Repository-black?style=for-the-badge&logo=github)](https://github.com/FiveDollaGobby/WelcomeMessages)
+[![Download](https://img.shields.io/badge/Download-Latest-green?style=for-the-badge)](https://github.com/FiveDollaGobby/WelcomeMessages/releases)
+
+</div>