WelcomeMessage

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

- CMI 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

- MySQL - 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)

```yaml 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)

```yaml 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)

```yaml main-menu: title: "&6&l⭐ Join Messages ⭐" size: 45

rarity-buttons: overrides: mythic: material: END_CRYSTAL name-format: "&d&l✦ %rarity% Messages ✦" ```

---

📋 Requirements

- Optional: 1.17 - 1.21.x - Optional: 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.