RexWelcome

A powerful welcome message plugin for Minecraft servers with randomized titles, first-join tracking, and PlaceholderAPI integration.

---

✨ Features

• Randomized Welcome Titles - Multiple title variations for both first-time and returning players
• First-Join Detection - Different messages and actions for new vs returning players
• Join Number Tracking - Track who was the 1st, 2nd, 3rd player to ever join
• First-Join Commands - Execute custom commands when players join for the first time
• Broadcast System - Announce first-time joins to all online players
• PlaceholderAPI Integration - Custom placeholders for use in other plugins
• Advanced Color Support - Legacy codes, hex colors, and MiniMessage format
• Join Sounds - Customizable sounds when players join
• Chat Clearing - Optional chat clear before welcome messages
• Hot Reload - Reload configuration without restarting

---

📋 Requirements

• Java 21 (Required)
• Minecraft 1.20.4+ (Paper recommended, Spigot compatible)
• PlaceholderAPI (Optional, for placeholder support in other plugins)

---

🎮 Commands

| Command | Aliases | Description | Permission |
|---------|---------|-------------|------------|
| /rexwelcome | /rw | Main plugin command | - |
| /rw reload | - | Reload configuration | rexwelcome.reload |
| /rw info | - | Show plugin information | - |
| /rw help | - | Show help message | - |

---

🔐 Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| rexwelcome.reload | Reload plugin configuration | op |
| rexwelcome.info | View plugin information | op |
| rexwelcome.help | View help message | op |

---

🏷️ Placeholders

PlaceholderAPI Placeholders

Use these in any plugin that supports PlaceholderAPI:

| Placeholder | Description | Example |
|-------------|-------------|---------|
| %rexwelcome_playernumber% | Player's join number | 42 |
| %rexwelcome_totalplayers% | Total unique players | 150 |
| %rexwelcome_player_<N>% | Name of Nth player | Steve |

Example Usage:

# In DeluxeChat, EssentialsX, or any PAPI-compatible plugin
format: "&7[#%rexwelcome_playernumber%] &f{USERNAME}: {MESSAGE}"
message: "&aYou are player #%rexwelcome_playernumber%!"
message: "&7First player: %rexwelcome_player_1%"

Internal Placeholders

Use these inside RexWelcome's config.yml:

| Placeholder | Description |
|-------------|-------------|
| %player% | Player's name |
| %displayname% | Player's display name |
| %prefix% | Plugin prefix |
| %online% | Online player count |
| %max_players% | Maximum players |
| %total_players% | Total unique players |
| %joincount% | Alias for %total_players% |

---

🎨 Color Formats

RexWelcome supports multiple color formats:

# Legacy color codes
message: "&aGreen &bAqua &cRed &eYellow"

# Hex colors
message: "&#ff5733Orange text"
message: "#ff5733This also works"

# MiniMessage format
message: "<color:#ff5733>Orange</color>"
message: "<gradient:#ff0000:#00ff00>Gradient text</gradient>"
message: "<bold><#FFD700>Bold gold text</bold>"

---

🎲 Randomized Titles

RexWelcome can display random titles from a list each time a player joins:

Returning Players

returning-player:
  titles:
    - title: "&#FFD700WELCOME BACK!"
      subtitle: "&fWe missed you, &e%player%&f!"
    - title: "&#FF6B6BYOU'RE BACK!"
      subtitle: "&7Good to see you again!"
    - title: "&#00FF7FBACK AGAIN?"
      subtitle: "&fOf course you are!"

First-Time Players

first-join:
  titles:
    - title: "&#00BFFF✨ WELCOME!"
      subtitle: "&fThis is your first time here!"
    - title: "&#FFD700🌟 FIRST TIME!"
      subtitle: "&eYou're player #%total_players%!"
    - title: "&#FF69B4WELCOME NEWBIE!"
      subtitle: "&fEnjoy your stay!"

---

⚙️ First-Join Features

First-Join Commands

Execute commands automatically when a player joins for the first time:

first-join:
  enabled: true
  commands:
    - "give %player% diamond 5"
    - "eco give %player% 1000"
    - "advancement grant %player% only story/mine_diamond"

First-Join Messages

first-join:
  messages:
    - "&7"
    - "%prefix%&#00BFFF✨ Welcome &f%player%&b!"
    - "&7• &fYou are player #&#f75634%total_players%"
    - "&7• &fVisit: &#f75634https://rexsystems.cc"
    - "&7• &fRead the rules: &#f75634/rules"
    - "&7"

Broadcast System

Announce when someone joins for the first time:

broadcast:
  enabled: true
  message: "%prefix%&#f75634%player% &fhas joined for the first time! &7(Player #&e%joincount%&7)"

---

🔊 Join Sounds

Play a sound when players join:

sounds:
  join:
    enabled: true
    sound: "ENTITY_PLAYER_LEVELUP"
    volume: 1.0
    pitch: 1.0

See Bukkit Sound Documentation for all available sounds.

---

📦 Installation

1. Download RexWelcome.jar from the Releases page
2. Place the JAR file in your server's plugins/ folder
3. (Optional) Install PlaceholderAPI
4. Restart your server
5. Edit plugins/RexWelcome/config.yml to customize
6. Use /rw reload to apply changes without restarting

---

📊 Player Data Storage

Player data is stored in plugins/RexWelcome/playerdata.yml:

players:
  550e8400-e29b-41d4-a716-446655440000:
    join-number: 1
    name: "Steve"
    first-join: 1673472000000
  550e8400-e29b-41d4-a716-446655440001:
    join-number: 2
    name: "Alex"
    first-join: 1673472100000

This tracks:

• join-number - Order in which players joined (1st, 2nd, 3rd, etc.)
• name - Player's username
• first-join - Timestamp of first join

---

🔗 Links

• 📖 Full Documentation
• 💻 GitHub Repository
• 🐛 Bug Reports
• 🌐 Website
• 📊 bStats

---

💬 Support

Need help? Found a bug? Have a suggestion?

• Open an issue on GitHub
• Check the documentation

---

📈 Statistics

---

Developed with ❤️ by RexSystems • Version 1.0.0