RexWelcome

RexWelcome

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

---

✨ Features

- Hot Reload - Multiple title variations for both first-time and returning players - Hot Reload - Different messages and actions for new vs returning players - Hot Reload - Track who was the 1st, 2nd, 3rd player to ever join - Hot Reload - Execute custom commands when players join for the first time - Hot Reload - Announce first-time joins to all online players - Hot Reload - Custom placeholders for use in other plugins - Hot Reload - Legacy codes, hex colors, and MiniMessage format - Hot Reload - Customizable sounds when players join - Hot Reload - Optional chat clear before welcome messages - Hot Reload - Reload configuration without restarting

---

📋 Requirements

- PlaceholderAPI (Required) - PlaceholderAPI (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: ```yaml

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:

```yaml

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

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

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

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

First-Join Messages

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

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

```yaml 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 RexWelcome.jar 2. Place the JAR file in your server's `plugins/` folder 3. (Optional) Install %%MD1%% 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`:

```yaml 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: - first-join - Order in which players joined (1st, 2nd, 3rd, etc.) - first-join - 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