WelcomeMessages

evening

A simple, lightweight welcome message plugin that actually works and doesn't break your server. Now with enhanced security and improved stability!

✨ Features

winter

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

afternoon

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 command
welcome.stats - Stats command
welcome.reset - Reset command
welcome.version - Version command
welcome.testall - Test all command
welcome.testanim - Test animation command

Player Permissions

welcome.toggle - Toggle command
welcome.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 effects
welcome.effects.sound - Sound effects
welcome.effects.particle - Particle effects
welcome.effects.firework - Firework effects

Message Permissions

welcome.messages.join - Join messages
welcome.messages.quit - Quit messages
welcome.messages.firstjoin - First join messages
welcome.messages.returning - Returning player messages

Bypass Permissions

welcome.bypass.cooldown - Bypass message cooldown
welcome.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.

WelcomeMessages

Compatibility

Minecraft: Java Edition

Platforms

Links

Creators

Details

WelcomeMessages

✨ Features

🎮 What It Does

🚀 Quick Start

📋 Commands

🔧 Configuration

🏆 Custom Rank System

🎨 Text Animations

🎨 PlaceholderAPI Support

🛠️ Performance

📋 Changelog

v1.3.4 - Theme System & Firework Safety Improvements

v1.3.1 - Security & Performance Improvements

v1.2.5 - Animation System & Bug Fixes

🔐 Permissions

Admin Permissions

Player Permissions

Rank Permissions (Custom!)

Effect Permissions

Message Permissions

Bypass Permissions

🤝 Contributing

📄 License