WelcomeMessages
A simple, lightweight welcome message plugin that actually works and doesn't break your server. Now with enhanced security and improved stability!
✨ Features
- Smart Messages - Different messages for new players vs returning ones
- Custom Rank System - Define unlimited custom ranks with any names
- 12 Text Animations - typing, fade, slide, wave, rainbow, glitch, typewriter, bounce, shake, pulse, matrix, scramble
- Fancy Effects - Particles, sounds, titles, fireworks - all optional and configurable
- RGB & Gradients - Support for modern color codes and rainbow text
- Config Validation - Won't crash your server with bad settings
- PlaceholderAPI Support - Use data in other plugins and chat
- Full Spigot Compatibility - Works on Spigot, Paper, Purpur, and Pufferfish
- Enhanced Security - Improved security with input validation and rate limiting
- Rate Limiting - Built-in command cooldowns to prevent spam
- Input Sanitization - Protection against malicious input and injection
- Memory Management - Automatic cleanup to prevent memory leaks
- Thread Safety - Fully thread-safe operations for maximum stability
- Not Annoying - Everything's configurable, nothing's forced
🎮 What It Does
Makes your server feel more alive with custom join/quit messages. First time players get a special welcome, regulars get their own messages, and your VIPs can have fancy entrances with fireworks and everything. NEW in v1.3.4: Fixed firework damage issues and enhanced theme system with automatic conflict detection. Previous v1.3.1: Enhanced security with rate limiting and input sanitization. Previous v1.2.5: 12 stunning text animations that play in the action bar (no chat spam!).
🚀 Quick Start
- Drop the jar into your plugins folder
- Restart your server
- Edit the config files to your liking
- Done! (Plugin validates your config so it won't crash)
📋 Commands
/welcome - Shows help (or /wm for short)/welcome reload - Reloads the config (with validation!)/welcome test - Test messages without joining/leaving/welcome testall - Test all features and animations/welcome testanim <type> - Test specific animation types/welcome stats - See join counts and stuff/welcome reset <player> - Reset a player's data/welcome toggle - Toggle your own messages on/off/welcome version - Check what version you're running
🔧 Configuration
Everything's in config.yml and messages.yml. The config is actually readable and the plugin validates it on startup so you won't get random crashes.
🏆 Custom Rank System
NEW in v1.2.0! Define unlimited custom ranks in your config.yml:
custom-ranks:
enabled: true
ranks:
- name: "founder"
permission: "welcome.rank.founder"
priority: 100
- name: "coowner"
permission: "welcome.rank.coowner"
priority: 90
- name: "manager"
permission: "welcome.rank.manager"
priority: 80
- name: "moderator"
permission: "welcome.rank.moderator"
priority: 70
- name: "helper"
permission: "welcome.rank.helper"
priority: 60
- name: "vip"
permission: "welcome.rank.vip"
priority: 50
- name: "member"
permission: "welcome.rank.member"
priority: 40
Perfect for:
- Multiple VIP tiers (VIP1, VIP2, VIP3, VIP4)
- Custom server ranks (Builder, Helper, Moderator, etc.)
- Any rank structure you want
How it works:
- Define ranks in
config.yml (in priority order)
- Add messages for each rank in
messages.yml
- Give players
welcome.rank.<rankname> permissions
- Plugin automatically detects and uses the highest rank
🎨 Text Animations
NEW in v1.2.5! 12 stunning text animations that play in the action bar:
- typing - Typewriter effect with realistic typing speed
- fade - Smooth fade in/out effect
- slide - Text slides in from different directions
- wave - Text waves up and down
- rainbow - Colorful rainbow cycling effect
- glitch - Matrix-style glitch effect
- typewriter - Character-by-character reveal
- bounce - Bouncy text animation
- shake - Shaking text effect
- pulse - Pulsing text animation
- matrix - Matrix-style falling characters
- scramble - Text scrambling effect
Features:
- Private action bar animations (no chat spam!)
- Configurable duration and type per message
- Works with all message types (join, quit, first join)
- Smooth performance with async processing
🎨 PlaceholderAPI Support
Works with any plugin that supports PlaceholderAPI:
%welcome_joincount% - How many times they've joined%welcome_firstjoin% - Is this their first time?%welcome_status% - New Player, Regular Player, etc.%welcome_rank% - Their rank (VIP, ADMIN, etc.)%welcome_messagesdisabled% - Are their messages disabled?%welcome_lastseen% - When they last joined%welcome_firstjointime% - When they first joined%welcome_time_since_last_seen% - How long since last join%welcome_time_since_first_join% - How long since first join%welcome_total_unique_joins% - Total unique joins on server%welcome_join_ordinal% - Ordinal of their join (1st, 2nd, etc.)%welcome_player_ordinal% - Their join count ordinal%welcome_time_greeting% - Time-based greeting (morning/afternoon/evening)%welcome_server_uptime% - Server uptime
🛠️ Performance
- Async everything (your TPS will thank me)
- Smart caching (not the dumb kind)
- Optional metrics (off by default because privacy)
- No database files cluttering your server
- Cross-version compatibility (Spigot, Paper, Purpur, Pufferfish)
📋 Changelog
v1.3.4 - Theme System & Firework Safety Improvements
- 🎆 FIXED: Firework Damage Issue - Fireworks no longer cause damage to players during welcome effects
- 🎨 IMPROVED: Theme System - Enhanced theme conflict detection and resolution with automatic validation
- ⏰ FIXED: Time Range Overlaps - Resolved overlapping time-based theme conflicts (morning/afternoon/evening/night)
- 📅 ENHANCED: Date Range Logic - Improved year rollover handling for seasonal themes (winter, christmas, etc.)
- 🔍 NEW: Theme Validation - Automatic detection and reporting of theme configuration conflicts on startup
- 🛡️ IMPROVED: Error Handling - Better validation for date and time parsing with comprehensive error logging
- ⚡ PERFORMANCE: Memory Management - Enhanced cleanup system for firework effects to prevent memory leaks
- 🔧 CODE QUALITY - Zero linter errors, improved code structure and documentation
v1.3.1 - Security & Performance Improvements
- 🔒 Security Improvements - Fixed various security issues and improved code safety
- ⚡ Rate Limiting System - Built-in command cooldowns to prevent spam and abuse
- 🛡️ Input Sanitization - Protection against malicious input and injection attacks
- 💾 Memory Management - Automatic cleanup system to prevent memory leaks
- 🔧 Thread Safety - All operations are now fully thread-safe
- 🚫 Integer Overflow Protection - Prevents crashes from large configuration values
- ✅ Null Pointer Safety - Comprehensive null checks throughout the codebase
- 🧹 Resource Leak Prevention - Proper cleanup of all resources
- ⚡ Performance Improvements - Replaced Random with ThreadLocalRandom
- 📊 Better Error Handling - Improved logging and error recovery
- ✨ Code Quality - Zero linter errors, perfect code quality
v1.2.5 - Animation System & Bug Fixes
- 🎨 12 Text Animations - typing, fade, slide, wave, rainbow, glitch, typewriter, bounce, shake, pulse, matrix, scramble
- 🎯 Action Bar Display - Private animations (no chat spam!)
- 🔧 Bug Fixes - Fixed typing animations, typewriter cursor, and all linter errors
- ⚡ Performance - Optimized animation rendering and compatibility
🔐 Permissions
Admin Permissions
welcome.* - Everything (all permissions)welcome.reload - Reload commandwelcome.stats - Stats commandwelcome.reset - Reset commandwelcome.version - Version commandwelcome.testall - Test all commandwelcome.testanim - Test animation command
Player Permissions
welcome.toggle - Toggle commandwelcome.test - Test command
Rank Permissions (Custom!)
welcome.rank.<rankname> - Any custom rank you define- Examples:
welcome.rank.founder, welcome.rank.vip4, welcome.rank.helper
Effect Permissions
welcome.effects.title - Title effectswelcome.effects.sound - Sound effectswelcome.effects.particle - Particle effectswelcome.effects.firework - Firework effects
Message Permissions
welcome.messages.join - Join messageswelcome.messages.quit - Quit messageswelcome.messages.firstjoin - First join messageswelcome.messages.returning - Returning player messages
Bypass Permissions
welcome.bypass.cooldown - Bypass message cooldownwelcome.bypass.effects - Bypass effect restrictions
🤝 Contributing
Found a bug? Open an issue.
Fixed a bug? Open a PR.
Want a feature? Also GitHub!
📄 License
MIT License - do whatever you want with it.
Made by FiveDollaGobby - because the other welcome plugins were either abandoned, bloated, or cost money for basic stuff. This one's free, always will be.
