Welcome Mat

A friendly way to roll out the welcome mat for players.

Загрузки: 1K
Подписчики: 4
Обновлён: 28 декабря 2025 г.
Лицензия: AGPL-3.0-or-later

Опубликован 18 ноября 2024 г.

Исходный код Сообщить об ошибке

WelcomeMat

Discord | GitHub

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, animations, and sounds to make players feel at home on every login.

Welcoming Splash

🎉 What's New!

Version 1.3.1 (Latest)

🍃 Folia-Ready Animations: Visual effects now use the latest Folia entity schedulers (1.21.8+) with automatic signature detection, clamped delays, and no unsafe Bukkit fallbacks.
🧠 Smarter Diagnostics: If future Folia builds introduce new scheduler signatures, they’re logged automatically so you can keep running the same jar everywhere.
🧾 Auto Version Metadata: plugin.yml now inherits the Gradle version, guaranteeing accurate version strings inside the jar.
🌌 Skyward & Copper Packs: Two new message packs inspired by the 1.21 “Chase the Skies” and “Copper Age” updates, selectable right from the GUI.

Version 1.2.x Highlights

Message Packs System: Multiple themed collections (default, friendly, professional, funny, RPG) with GUI switching.
Multi-Language Support: English and Spanish out of the box with easy CLI/GUI selection.
Improved Configuration Display: Human-friendly display names and cleaner GUI organization.

🔄 Compatibility

Fully tested on Bukkit/Spigot, Paper, Purpur, and Folia from Minecraft 1.13 through 1.21.10.
Region-aware scheduler paths keep Folia’s watchdog happy while the same jar continues to run flawlessly on single-threaded servers.

Features

🎨 Customizable Messages
- Rich join/leave text with color codes and placeholders
- Player-specific greetings and per-pack collections
- Display-name helpers and multi-language support (EN/ES)
📜 Welcome Titles
- Configurable title/subtitle timing and colors
🔊 Interactive Sounds
- Join/leave sounds with per-player toggles, volume, and pitch
✨ Animation System
- Fire Spiral, Green Spike Firework, and more join effects
- Folia-safe schedulers and per-player animation preferences
⚙️ Extensive Configuration
- Feature toggles, admin logging, instant /wm reload
- GUI-driven settings for packs, languages, sounds, and more

📋 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

Download the latest version of WelcomeMat
Place the .jar file in your server's plugins folder
Restart your server
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

Ченджлог

1.3.4Релиз1.21.9, 1.21.10, 1.21.11 · 28 декабря 2025 г.

WelcomeMat 1.3.4 - Username Hotfix & 1.21.11

🚀 What's New

Title Placeholder Support ✨
- Added support for the %player% placeholder in join titles and subtitles.
- You can now greet players by name directly in the center of their screen (e.g., &6Welcome, %player%!).
Minecraft 1.21.11 Support 🐎
- Verified compatibility with the "Mounts of Mayhem" update.
- Updated internal dependencies to the latest Spigot API to ensure smooth performance on the newest Minecraft builds.

🔄 Compatibility

Fully tested on Bukkit/Spigot, Paper, Purpur, and Folia from Minecraft 1.13 through 1.21.11.
Region-aware schedulers continue to provide a single-jar solution for both standard and Folia-based servers.

🐛 Fixes & Maintenance

Optimized title packet handling to ensure placeholders are replaced efficiently before being sent to the client.
Refined the ConfigManager logic to provide better fallback support for legacy title configurations.

Thanks for using WelcomeMat!
Found a bug or have a suggestion? Let us know here

1.3.3Релиз1.21.8, 1.21.9, 1.21.10 · 28 ноября 2025 г.

WelcomeMat 1.3.3 - Many Animations ✨

🚀 What's New

Animation test upgrades
- /wm animation test <name|random> hot-swaps every registered effect without forcing logouts
- Perfect for staff tours, screenshots, and animation QA on live servers
Confetti Burst stability
- Dust transition payloads keep Folia/Paper from logging Bukkit color errors
- Sparkle helpers ensure the rainbow spray renders consistently on 1.13+
Automatic config migrations
- ConfigFileMigrator backs up configs, merges defaults, and moves legacy message packs into messages.yml
- Keeps custom tweaks intact across upgrades

🔄 Compatibility

Fully tested on Bukkit/Spigot, Paper, Purpur, and Folia from Minecraft 1.13 through 1.21.10

🐛 Fixes & Maintenance

Guardrails for /wm animation test prevent reload loops and keep previews smooth
Documentation now mirrors every /wm subcommand so admins can follow along in-game

Thanks for using WelcomeMat!
Found a bug or have a suggestion? Let us know here

1.3.1Релиз1.21.8, 1.21.9, 1.21.10 · 28 ноября 2025 г.

WelcomeMat 1.3.1 – Folia Ready 🍃

🚀 What's New

Folia-safe join animations
- Uses the latest entity schedulers on 1.21.8+ with automatic signature detection
- Clamps delays/periods to keep Folia’s watchdog happy
- Skips unsafe Bukkit fallbacks if Folia changes again
Fresh message packs inspired by 1.21
- New “Skyward” and “Copper Age” packs themed after Chase the Skies & the Copper Age updates
- Selectable from the in-game GUI alongside the classic packs
Accurate version metadata
- plugin.yml now inherits the Gradle project version, so every jar reports the right release

🔄 Compatibility

Fully tested on Bukkit/Spigot, Paper, Purpur, and Folia from Minecraft 1.13 through 1.21.10

🐛 Fixes & Maintenance

Added diagnostic logging when Folia exposes unfamiliar scheduler signatures
General polish on resource filtering and build configuration

Thanks for using WelcomeMat!
Found a bug or have a suggestion? Let us know here

1.2.2Релиз1.21.3, 1.21.4, 1.21.5 · 24 апреля 2025 г.

WelcomeMat 1.2.2 – Version Bump ⚙️

🆕 What's New

Added compatibility with Minecraft 1.21.5
- Fully tested and confirmed support
- Seamless experience from 1.13 through 1.21.5

🧹 Minor Maintenance

No new features or bugfixes in this update
Just keeping things up-to-date for the latest Minecraft release

Thanks for using WelcomeMat!
Found a bug or have a suggestion? Let us know here

1.2.1Релиз1.21.2, 1.21.3, 1.21.4 · 17 марта 2025 г.

WelcomeMat 1.2.1 - Bugfixes 🐛

🌟 Fixed Features

Fixed message packs system
- Multiple themed welcome messages
- Easy switching between styles
- Support for custom message collections
Fixed multi-language support
- English and Spanish languages available
- Easy language switching via commands
- Expandable language framework
Fixed configuration management
- User-friendly config commands
- Improved settings organization
- Interactive configuration interface

🛠️ Improvements

Enhanced tab completion
- More intuitive command structure
- Better command feedback
Improved GUI interfaces
- Added language selection menu
- Message pack selection interface
Enhanced user experience
- Better error messages
- More helpful command guidance

🐛 Bug Fixes

Fixed various message formatting issues
Resolved configuration loading edge cases
Fixed permission inheritance issues
Improved error handling across all features

🔧 Technical

Improved code organization
Enhanced performance optimization
Better error logging and debugging capabilities
Updated to latest Spigot API compatibility

Please submit bug reports and issues here

1.2.0Релиз1.21.2, 1.21.3, 1.21.4 · 25 февраля 2025 г.

WelcomeMat 1.2.0

🌟 New Features

Added bStats integration for anonymous usage tracking
- Track active installations
- Help guide future development
- (Can be opped out with /wm config set analytics false)
Enhanced animation effects system
- Added new animation effect
- Improved particle animations
- Better performance optimization
Implemented admin action logging
- Track configuration changes
- Monitor command usage
- Enhanced troubleshooting capabilities

🛠️ Improvements

Revamped configuration system
- More user-friendly settings
- Better organization of options
- Improved documentation
Enhanced command system
- More intuitive command structure
- Better error messages
- Improved command feedback
Updated GUI interface
- Cleaner menu layouts
- More responsive interactions
- Better visual feedback

🐛 Bug Fixes

Fixed various animation synchronization issues
Resolved configuration loading edge cases
Fixed permission inheritance issues
Improved error handling across all features

🔧 Technical

Improved build system
Enhanced code documentation
Better error logging and debugging capabilities
Updated to latest Spigot API (1.21.4)

Please submit bug reports and issues here

1.1.1Релиз1.21.1, 1.21.2, 1.21.3 · 19 ноября 2024 г.

WelcomeMat 1.1.1

🌟 New Features

Added customizable join effects system
- Multiple effect types: Spiral, Helix, Fountain, Burst
- Configurable particles and colors
- Per-player toggle option
- Permission-based access
Added effects toggle to GUI menu
Added /wm effects command to toggle effects

🛠️ Improvements

Enhanced database system with better error handling
Added config fallback for database operations
Improved GUI menu organization
Better initialization order for plugin components

🐛 Bug Fixes

Fixed inventory interaction issues with GUI
Fixed database table creation on first run
Fixed sound preference persistence
Fixed effect preference handling

🔧 Technical

Added proper database connection management
Improved error logging for database operations
Added database migration support
Code organization improvements

Please submit bug reports and issues here

1.0.5Релиз1.21.1, 1.21.2, 1.21.3 · 18 ноября 2024 г.

WelcomeMat v1.0.5

New Features

Added per-player sound toggle system
- Players can now toggle join/leave sounds with /wm sound
- Preferences are saved between server restarts
- Default enabled for all players
Added support for legacy sound names (1.8-1.12)
Added welcomemat.sound.toggle permission

Changes

Improved sound system to only play for other players
Added ANSI colored console messages
Added fancy ASCII art on plugin startup
Updated default configuration with more sound examples

Bug Fixes

Fixed sound import issues
Fixed color code handling in messages
Fixed legacy version compatibility

Documentation

Added comprehensive sound list to config
Added example configurations
Improved config comments and organization

WelcomeMat

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

🎉 What's New!

Version 1.3.1 (Latest)

Version 1.2.x Highlights

🔄 Compatibility

Features

📋 Commands

🔑 Permissions

📦 Installation

⚙️ Configuration

🌐 Language Support

🎵 Available Sounds

Modern (1.13+)

Legacy (1.8-1.12) (Under development)

💡 Example Configurations

Professional Server with Message Packs

VIP Server with Custom Messages

📝 Support

Ченджлог

WelcomeMat 1.3.4 - Username Hotfix & 1.21.11

🚀 What's New

🔄 Compatibility

🐛 Fixes & Maintenance

WelcomeMat 1.3.3 - Many Animations ✨

🚀 What's New

🔄 Compatibility

🐛 Fixes & Maintenance

WelcomeMat 1.3.1 – Folia Ready 🍃

🚀 What's New

🔄 Compatibility

🐛 Fixes & Maintenance

WelcomeMat 1.2.2 – Version Bump ⚙️

🆕 What's New

🧹 Minor Maintenance

WelcomeMat 1.2.1 - Bugfixes 🐛

🌟 Fixed Features

🛠️ Improvements

🐛 Bug Fixes

🔧 Technical

WelcomeMat 1.2.0

🌟 New Features

🛠️ Improvements

🐛 Bug Fixes

🔧 Technical

WelcomeMat 1.1.1

🌟 New Features

🛠️ Improvements

🐛 Bug Fixes

🔧 Technical

WelcomeMat v1.0.5

New Features

Changes

Bug Fixes

Documentation

Комментарии