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

1. Download the latest release
2. Place the JAR file in your plugins folder
3. Restart your server
4. Configure config.yml and menu.yml to your needs
5. 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.