Overview​

ShyamWelcome is a lightweight yet powerful plugin that turns every new player's first join into a memorable community event. When a new player joins your server, everyone gets notified — and players who say Welcome, Hi, or Hello in chat earn rewards for being friendly!

It's the easiest way to build a welcoming, engaged community — automatically.

Features​

• First-Join Broadcast — Announce every new player to the entire server with a fully customizable styled message, including the server's unique join count.
• Welcome Rewards — Players who type a welcome keyword (e.g. welcome, hi, hello, wb) within a configurable time window earn rewards via console commands.
• First-Join Rewards — Automatically give the new player a starting bonus (economy money, items, kits — anything via commands).
• Sound Effects — Play a customizable sound to all online players when someone joins for the first time.
• Discord Webhook Integration — Instantly send a beautiful embed to your Discord server announcing the new member, complete with player head avatar, join count, custom colors, and timestamps.
• JSON Logging — Every first join is logged to a logs.json file with player name, UUID, timestamp, and join count for easy tracking.
• PlaceholderAPI Support — Full PAPI support in messages, commands, and webhook content.
• Folia Compatible — Built from the ground up with Folia support, works perfectly on both Paper and Folia servers.
• Anti-Abuse — Configurable self-claim prevention so new players can't welcome themselves. Each player can only claim the reward once per new-player session.

How It Works​

1. A new player joins the server for the first time.
2. A broadcast message is sent to all online players and a sound effect plays.
3. The new player receives their first-join rewards automatically.
4. A welcome window opens (default: 15 seconds).
5. Any player who types a welcome keyword in chat during that window earns a reward.
6. The join is logged and optionally sent to Discord via webhook.

Commands & Permissions​

Aliases: /shyamwelcome

Configuration​

ShyamWelcome uses two config files for clean separation:

• config.yml — Core settings: prefix, welcome window duration, trigger keywords, sounds, rewards, and messages.
• webhook.yml — Discord integration: webhook URL, embed title, description, color, footer, and sender identity.

All messages support legacy color codes (&), hex colors (&#RRGGBB), and PlaceholderAPI placeholders.

Requirements​

• Server: Paper or Folia 1.20+
• Java: 21+
• Optional: PlaceholderAPI (for placeholder support)

Preview​