# WelcomeMessages<\/p>\n
<\/p>\n
A **simple, lightweight** welcome message plugin that actually works and doesn’t break your server. Now with **enhanced security** and **improved stability**!<\/p>\n
<\/p>\n
## \u2728 Features<\/p>\n
<\/p>\n
– **Smart Messages** – Different messages for new players vs returning ones
\n– **Custom Rank System** – Define unlimited custom ranks with any names
\n– **12 Text Animations** – typing, fade, slide, wave, rainbow, glitch, typewriter, bounce, shake, pulse, matrix, scramble
\n– **Fancy Effects** – Particles, sounds, titles, fireworks – all optional and configurable
\n– **RGB & Gradients** – Support for modern color codes and rainbow text
\n– **Config Validation** – Won’t crash your server with bad settings
\n– **PlaceholderAPI Support** – Use data in other plugins and chat
\n– **Full Spigot Compatibility** – Works on Spigot, Paper, Purpur, and Pufferfish
\n– **Enhanced Security** – Improved security with input validation and rate limiting
\n– **Rate Limiting** – Built-in command cooldowns to prevent spam
\n– **Input Sanitization** – Protection against malicious input and injection
\n– **Memory Management** – Automatic cleanup to prevent memory leaks
\n– **Thread Safety** – Fully thread-safe operations for maximum stability
\n– **Not Annoying** – Everything’s configurable, nothing’s forced<\/p>\n
<\/p>\n
## \ud83c\udfae What It Does<\/p>\n
<\/p>\n
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!).<\/p>\n
<\/p>\n
## \ud83d\ude80 Quick Start<\/p>\n
1. Drop the jar into your plugins folder
\n2. Restart your server
\n3. Edit the config files to your liking
\n4. Done! (Plugin validates your config so it won’t crash)<\/p>\n
<\/p>\n
## \ud83d\udccb Commands<\/p>\n
– `\/welcome` – Shows help (or `\/wm` for short) <\/p>\n ## \ud83d\udd27 Configuration<\/p>\n 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.<\/p>\n <\/p>\n ## \ud83c\udfc6 Custom Rank System<\/p>\n **NEW in v1.2.0!** Define unlimited custom ranks in your `config.yml`:<\/p>\n “`yaml **Perfect for:** **How it works:** ## \ud83c\udfa8 Text Animations<\/p>\n **NEW in v1.2.5!** 12 stunning text animations that play in the action bar:<\/p>\n – **typing** – Typewriter effect with realistic typing speed **Features:** ## \ud83c\udfa8 PlaceholderAPI Support<\/p>\n Works with any plugin that supports PlaceholderAPI: ## \ud83d\udee0\ufe0f Performance<\/p>\n – Async everything (your TPS will thank me) ## \ud83d\udccb Changelog<\/p>\n ### v1.3.4 – Theme System & Firework Safety Improvements ### v1.3.1 – Security & Performance Improvements ### v1.2.5 – Animation System & Bug Fixes ## \ud83d\udd10 Permissions<\/p>\n ### Admin Permissions ### Player Permissions ### Rank Permissions (Custom!) ### Effect Permissions ### Message Permissions ### Bypass Permissions ## \ud83e\udd1d Contributing<\/p>\n Found a bug? Open an issue. ## \ud83d\udcc4 License<\/p>\n MIT License – do whatever you want with it.<\/p>\n —<\/p>\n **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.<\/p>\n","protected":false},"excerpt":{"rendered":" Lightweight welcome\/join messages plugin for Minecraft 1.21.X with effects, rank support, and actual performance<\/p>\n","protected":false},"featured_media":169537,"template":"","meta":{"_minecraft_slug":"welcomemessages","_minecraft_project_id":"hHuqnSY7","_minecraft_author":"FiveDollaGobby","_minecraft_license":"MIT","_minecraft_downloads":591,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"welcomemessages.zip","_minecraft_size_bytes":710997,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T10:19:36.867347Z","_minecraft_date_created":"2025-09-22T20:46:50.596648Z","_minecraft_date_modified":"2025-10-03T05:07:55.945868Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/welcomemessages","_minecraft_icon_attachment_id":169537,"_minecraft_imported_at":"2026-06-09T20:19:48+00:00","_minecraft_import_hash":"864721157759518d7aefdab57e068b4a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,127,128,867,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,73,74,38,78,79,80,81,82],"class_list":["post-169536","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/welcome reload` – Reloads the config (with validation!)
\n– `\/welcome test` – Test messages without joining\/leaving
\n– `\/welcome testall` – Test all features and animations
\n– `\/welcome testanim
\n– `\/welcome stats` – See join counts and stuff
\n– `\/welcome reset
\n– `\/welcome toggle` – Toggle your own messages on\/off
\n– `\/welcome version` – Check what version you’re running<\/p>\n
\ncustom-ranks:
\n enabled: true
\n ranks:
\n – name: “founder”
\n permission: “welcome.rank.founder”
\n priority: 100
\n – name: “coowner”
\n permission: “welcome.rank.coowner”
\n priority: 90
\n – name: “manager”
\n permission: “welcome.rank.manager”
\n priority: 80
\n – name: “moderator”
\n permission: “welcome.rank.moderator”
\n priority: 70
\n – name: “helper”
\n permission: “welcome.rank.helper”
\n priority: 60
\n – name: “vip”
\n permission: “welcome.rank.vip”
\n priority: 50
\n – name: “member”
\n permission: “welcome.rank.member”
\n priority: 40
\n“`<\/p>\n
\n– Multiple VIP tiers (VIP1, VIP2, VIP3, VIP4)
\n– Custom server ranks (Builder, Helper, Moderator, etc.)
\n– Any rank structure you want<\/p>\n
\n1. Define ranks in `config.yml` (in priority order)
\n2. Add messages for each rank in `messages.yml`
\n3. Give players `welcome.rank.
\n4. Plugin automatically detects and uses the highest rank<\/p>\n
\n– **fade** – Smooth fade in\/out effect
\n– **slide** – Text slides in from different directions
\n– **wave** – Text waves up and down
\n– **rainbow** – Colorful rainbow cycling effect
\n– **glitch** – Matrix-style glitch effect
\n– **typewriter** – Character-by-character reveal
\n– **bounce** – Bouncy text animation
\n– **shake** – Shaking text effect
\n– **pulse** – Pulsing text animation
\n– **matrix** – Matrix-style falling characters
\n– **scramble** – Text scrambling effect<\/p>\n
\n– Private action bar animations (no chat spam!)
\n– Configurable duration and type per message
\n– Works with all message types (join, quit, first join)
\n– Smooth performance with async processing<\/p>\n
\n– `%welcome_joincount%` – How many times they’ve joined
\n– `%welcome_firstjoin%` – Is this their first time?
\n– `%welcome_status%` – New Player, Regular Player, etc.
\n– `%welcome_rank%` – Their rank (VIP, ADMIN, etc.)
\n– `%welcome_messagesdisabled%` – Are their messages disabled?
\n– `%welcome_lastseen%` – When they last joined
\n– `%welcome_firstjointime%` – When they first joined
\n– `%welcome_time_since_last_seen%` – How long since last join
\n– `%welcome_time_since_first_join%` – How long since first join
\n– `%welcome_total_unique_joins%` – Total unique joins on server
\n– `%welcome_join_ordinal%` – Ordinal of their join (1st, 2nd, etc.)
\n– `%welcome_player_ordinal%` – Their join count ordinal
\n– `%welcome_time_greeting%` – Time-based greeting (morning\/afternoon\/evening)
\n– `%welcome_server_uptime%` – Server uptime<\/p>\n
\n– Smart caching (not the dumb kind)
\n– Optional metrics (off by default because privacy)
\n– No database files cluttering your server
\n– Cross-version compatibility (Spigot, Paper, Purpur, Pufferfish)<\/p>\n
\n– **\ud83c\udf86 FIXED: Firework Damage Issue** – Fireworks no longer cause damage to players during welcome effects
\n– **\ud83c\udfa8 IMPROVED: Theme System** – Enhanced theme conflict detection and resolution with automatic validation
\n– **\u23f0 FIXED: Time Range Overlaps** – Resolved overlapping time-based theme conflicts (morning\/afternoon\/evening\/night)
\n– **\ud83d\udcc5 ENHANCED: Date Range Logic** – Improved year rollover handling for seasonal themes (winter, christmas, etc.)
\n– **\ud83d\udd0d NEW: Theme Validation** – Automatic detection and reporting of theme configuration conflicts on startup
\n– **\ud83d\udee1\ufe0f IMPROVED: Error Handling** – Better validation for date and time parsing with comprehensive error logging
\n– **\u26a1 PERFORMANCE: Memory Management** – Enhanced cleanup system for firework effects to prevent memory leaks
\n– **\ud83d\udd27 CODE QUALITY** – Zero linter errors, improved code structure and documentation<\/p>\n
\n– **\ud83d\udd12 Security Improvements** – Fixed various security issues and improved code safety
\n– **\u26a1 Rate Limiting System** – Built-in command cooldowns to prevent spam and abuse
\n– **\ud83d\udee1\ufe0f Input Sanitization** – Protection against malicious input and injection attacks
\n– **\ud83d\udcbe Memory Management** – Automatic cleanup system to prevent memory leaks
\n– **\ud83d\udd27 Thread Safety** – All operations are now fully thread-safe
\n– **\ud83d\udeab Integer Overflow Protection** – Prevents crashes from large configuration values
\n– **\u2705 Null Pointer Safety** – Comprehensive null checks throughout the codebase
\n– **\ud83e\uddf9 Resource Leak Prevention** – Proper cleanup of all resources
\n– **\u26a1 Performance Improvements** – Replaced Random with ThreadLocalRandom
\n– **\ud83d\udcca Better Error Handling** – Improved logging and error recovery
\n– **\u2728 Code Quality** – Zero linter errors, perfect code quality<\/p>\n
\n– **\ud83c\udfa8 12 Text Animations** – typing, fade, slide, wave, rainbow, glitch, typewriter, bounce, shake, pulse, matrix, scramble
\n– **\ud83c\udfaf Action Bar Display** – Private animations (no chat spam!)
\n– **\ud83d\udd27 Bug Fixes** – Fixed typing animations, typewriter cursor, and all linter errors
\n– **\u26a1 Performance** – Optimized animation rendering and compatibility<\/p>\n
\n– `welcome.*` – Everything (all permissions)
\n– `welcome.reload` – Reload command
\n– `welcome.stats` – Stats command
\n– `welcome.reset` – Reset command
\n– `welcome.version` – Version command
\n– `welcome.testall` – Test all command
\n– `welcome.testanim` – Test animation command<\/p>\n
\n– `welcome.toggle` – Toggle command
\n– `welcome.test` – Test command<\/p>\n
\n– `welcome.rank.
\n– Examples: `welcome.rank.founder`, `welcome.rank.vip4`, `welcome.rank.helper`<\/p>\n
\n– `welcome.effects.title` – Title effects
\n– `welcome.effects.sound` – Sound effects
\n– `welcome.effects.particle` – Particle effects
\n– `welcome.effects.firework` – Firework effects<\/p>\n
\n– `welcome.messages.join` – Join messages
\n– `welcome.messages.quit` – Quit messages
\n– `welcome.messages.firstjoin` – First join messages
\n– `welcome.messages.returning` – Returning player messages<\/p>\n
\n– `welcome.bypass.cooldown` – Bypass message cooldown
\n– `welcome.bypass.effects` – Bypass effect restrictions<\/p>\n
\nFixed a bug? Open a PR.
\nWant a feature? Also GitHub!<\/p>\n