WelcomeMessage Plugin

Customizable join messages for your Minecraft server!

Give your players the ability to stand out with unique, purchasable join messages. From standard greetings to legendary announcements, WelcomeMessage adds personality to every server join.

✨ Features

🎭 Multiple Rarity Tiers

Fully Configurable Rarities - Create unlimited custom rarity tiers (Standard, Rare, Legendary, Mythic, or any custom tier you want!)
Each rarity has customizable display names and color codes
Add or remove rarities directly from config.yml

📝 Complete Menu Customization

Separate menu.yml - Every menu element is configurable
Customize titles, item names, lore texts, materials, and positions
Change button layouts and decoration styles
Full color code support (&codes)

💰 Economy Integration

Vault Support - Works with any Vault-compatible economy plugin
CMI Support - Direct CMI economy integration
Set custom prices for each message
Economy can be disabled for admin-only message distribution

📊 Database Options

SQLite - Zero configuration, works out of the box
MySQL - For multi-server setups with shared data
Configurable table prefixes
Auto-reconnection support

⏱️ Timed Messages

Give messages with flexible duration formats
Supports: 1hour, 1day, 1week, 1month, permanent
Messages automatically expire when time runs out
Players can see remaining time in menus

🎮 Admin Commands

Command	Description
`/welcomemessage`	Open the messages menu
`/welcomemessage give <player> <message_id> [duration]`	Give a message to a player
`/welcomemessage remove <player> <message_id>`	Remove a message from a player
`/welcomemessage list`	List all available messages
`/welcomemessage reload`	Reload configuration

🔐 Permissions

Permission	Description	Default
`welcomemessage.use`	Use the messages menu	Everyone
`welcomemessage.admin`	Admin commands (give, remove, reload)	OP

📸 Screenshots

Coming soon...

🔧 Configuration Examples

Custom Rarities (config.yml)

rarities:
  common:
    display-name: "Common"
    color-code: "&7"
  epic:
    display-name: "Epic"
    color-code: "&5"
  mythic:
    display-name: "Mythic"
    color-code: "&d"

Custom Messages (config.yml)

welcome-messages:
  dragon_king:
    name: "&6Dragon King"
    rarity: mythic
    message: "&6🐉 &c&lDRAGON KING &6%player% &chas arrived! &6🐉"
    price: 5000
    icon: DRAGON_EGG

Menu Customization (menu.yml)

main-menu:
  title: "&6&l⭐ Join Messages ⭐"
  size: 45
  
rarity-buttons:
  overrides:
    mythic:
      material: END_CRYSTAL
      name-format: "&d&l✦ %rarity% Messages ✦"

📋 Requirements

Minecraft: 1.17 - 1.21.x
Java: 17+
Optional: Vault + Economy plugin (for purchases)
Optional: CMI (alternative economy)

🚀 Installation

Download the latest release
Place the JAR file in your plugins folder
Restart your server
Configure config.yml and menu.yml to your needs
Use /welcomemessage reload after changes

💡 Tips

Use %player% placeholder in messages to show player names
Set price: 0 for unpurchasable (admin-only) messages
Disable default join message with default-message-enabled: false
Create themed message packs for events or seasons!

📄 License

This plugin is provided as-is for use on Minecraft servers.

WelcomeMessage