A friendly way to roll out the welcome mat for your players!

WelcomeMat is a lightweight, powerful plugin that enhances your server's welcome experience. It provides customizable join/leave messages, titles, and sounds to make your players feel welcome and create a more engaging atmosphere!

🎉 What's New!

Version 1.2.2

• ✅ Added support for Minecraft 1.21.5
  • Fully compatible from Minecraft 1.13 through 1.21.5
  • No breaking changes—just keeping things fresh and functional!

Version 1.2.1 Highlights

• Message Packs System: Multiple themed message collections (default, friendly, professional, funny, rpg)
• Multi-Language Support: Support for English and Spanish with easy language switching
• Improved Configuration Display: More user-friendly settings interface with display names

Features

• 🎨 Customizable Messages

  • Colorful join/leave messages
  • Fully customizable text and colors
  • Support for player name placeholders
  • Player-specific welcome messages
  • Display name support for configuration
  • Message packs with themed collections (friendly, professional, funny, rpg)
  • Multi-language support (English, Spanish)

• 📜 Welcome Titles

  • Eye-catching title and subtitle on join
  • Configurable duration and fade times
  • Full color code support

• 🔊 Interactive Sounds

  • Customizable join/leave sounds
  • Individual sound toggle for players
  • Support for both modern and legacy sound names
  • Volume and pitch control

• ✨ Animation System

  • Multiple animation effects
  • Green spike firework displays
  • Customizable animation timing
  • Per-player animation settings

• ⚙️ Extensive Configuration

  • Easy-to-use configuration file
  • Toggle features individually
  • Per-player sound preferences
  • Admin logging functionality
  • Reload configuration on the fly

📋 Commands

• /welcomemat or /wm - Base command
• /wm sound - Toggle join/leave sounds for yourself
• /wm reload - Reload the plugin configuration
• /wm help - Show help message
• /wm animation - Toggle join animations for yourself
• /wm language - Change the plugin language
• /wm pack - Change the message pack
• /wm config - Modify plugin configuration

🔑 Permissions

• welcomemat.reload - Allow reloading the configuration (default: op)
• welcomemat.bypass - Bypass welcome messages (default: false)
• welcomemat.sound.toggle - Allow toggling sounds (default: true)
• welcomemat.animation.toggle - Allow toggling animations (default: true)
• welcomemat.admin.log - Receive admin log messages (default: op)
• welcomemat.language - Allow changing the plugin language (default: op)
• welcomemat.pack - Allow changing message packs (default: op)
• welcomemat.config - Allow modifying plugin configuration (default: op)

📦 Installation

1. Download the latest version of WelcomeMat
2. Place the .jar file in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/WelcomeMat/config.yml

⚙️ Configuration

features:
  join-message: true
  leave-message: true
  join-title: true
  join-sound: true
  leave-sound: true
  other-players-sounds: true
  join-animation: true
  admin-logging: true

messages:
  join: "&e%player% &ajust joined the server!"
  leave: "&e%player% &chas left the server!"
  player-specific:
    example-player:
      join: "&6Welcome back, special player %player%!"
      leave: "&eGoodbye, special player %player%!"

titles:
  join:
    title: "&6Welcome!"
    subtitle: "&eEnjoy your stay!"

sounds:
  join:
    sound: ENTITY_PLAYER_LEVELUP
    volume: 1.0
    pitch: 1.0
  leave:
    sound: ENTITY_IRON_GOLEM_DEATH
    volume: 0.5
    pitch: 1.0

animations:
  green-spike:
    enabled: true
    duration: 40
    height: 2.0

# Message Packs
message-packs:
  # Currently selected pack (default, friendly, professional, funny, rpg)
  selected: "default"
  
  # Default pack (original messages)
  default:
    join:
      - "&e%player% &ajust joined the server!"
    leave:
      - "&e%player% &chas left the server!"
  
  # Friendly pack
  friendly:
    join:
      - "&d✨ &e%player% &ahas joined the party! &d✨"
      - "&aWelcome back, &e%player%&a! We missed you! &d❤"
    leave:
      - "&e%player% &7had to go... &cSee you soon! &d💕"
      - "&7Until next time, &e%player%&7! &d👋"

🌐 Language Support

WelcomeMat now supports multiple languages:

# Available languages: english, spanish
selected-language: "english"

languages:
  english:
    name: "English"
    messages:
      reload:
        success: "&aConfiguration reloaded successfully!"
      sound:
        enabled: "&aJoin/leave sounds enabled!"
        disabled: "&cJoin/leave sounds disabled!"
  spanish:
    name: "Español"
    messages:
      reload:
        success: "&a¡Configuración recargada con éxito!"
      sound:
        enabled: "&a¡Sonidos de entrada/salida activados!"
        disabled: "&c¡Sonidos de entrada/salida desactivados!"

🎵 Available Sounds

Modern (1.13+)

• ENTITY_PLAYER_LEVELUP
• ENTITY_IRON_GOLEM_DEATH
• BLOCK_NOTE_BLOCK_PLING
• BLOCK_NOTE_BLOCK_CHIME
• BLOCK_NOTE_BLOCK_BELL
• And more...

Legacy (1.8-1.12) (Under development)

• LEVEL_UP
• IRONGOLEM_DEATH
• NOTE_PLING
• NOTE_PIANO
• And more...

💡 Example Configurations

Professional Server with Message Packs

# Use the professional message pack
message-packs:
  selected: "professional"

# Set the language to English
selected-language: "english"

sounds:
  join:
    sound: BLOCK_NOTE_BLOCK_PLING
    volume: 0.8
    pitch: 1.5

animations:
  green-spike:
    enabled: true
    duration: 30
    height: 1.5

VIP Server with Custom Messages

messages:
  join: "&d✨ &e%player% &ahas joined the party! &d✨"
  leave: "&e%player% &7had to go... &cSee you soon!"
  player-specific:
    VIP_Player:
      join: "&6⚡ The legendary &e%player% &6has arrived! ⚡"
      leave: "&6The legend &e%player% &6must go... &7Until next time!"

sounds:
  join:
    sound: ENTITY_PLAYER_LEVELUP
    volume: 1.0
    pitch: 1.2

animations:
  green-spike:
    enabled: true
    duration: 50
    height: 2.5

📝 Support

If you encounter any issues or have suggestions:

• Create an issue on our GitHub repository
• Join our Discord server

---

Made with ❤️ by angeldev0

Download • Source • Discord