Welcome Player 1.0.0

Welcome Player gives your players a warm, modern first impression — without being annoying or spammy.

The plugin automatically detects whether someone is joining for the first time or coming back, then shows customized messages, optional rewards, a clean UI banner, and (if you want) sends notifications straight to Discord. It also tracks connection history, so players can check when they first joined and how often they’ve played.

What it does ?

• Detects first-time vs returning players

• Sends configurable private messages, global join messages (optional), and disconnect messages

• Gives custom rewards (with skin support)

• Displays a subtle, polished UI welcome banner

• Detects player country (with fallback)

• Sends Discord webhook embeds for joins and disconnects

• Tracks basic player stats (first join, last join, total connects)

• Integrates with BetterChat if installed

• Supports multiple languages using Oxide lang

And yes — everything can be turned on or off.

Examples (default behavior)

• First time player joins → welcome message, optional starter reward, UI banner, optional Discord notification

• Returning player joins → short “welcome back” message, optional loyalty reward

• Player disconnects → optional global message + Discord embed

• Player runs /welcomestats → sees their join history + country + total connections

Config :

{
  "First Time Player Settings": {
    "Enable First Time Welcome": true,
    "Send Global Message": true,
    "Private Message": "<size=18><color=#00ffff>Welcome</color> <color=#FFFFFF>{player}</color> to <color=#ff00ff>{server}</color></size>\n<size=14><color=#888888>It seems like this is your <color=#00ffff>first time</color> joining us</color></size>\n<size=12><color=#00ff00>Check your inventory for a welcome gift</color></size>",
    "Global Message": "<size=14><color=#00ff00>[+]</color> <color=#FFFFFF>{player}</color> <color=#00ff00>has joined us for the first time</color> from <color=#00ffff>{country}</color></size>",
    "Sound Effect": "assets/bundled/prefabs/fx/invite_notice.prefab",
    "Rewards (shortname:amount:skinId)": [
      "syringe.medical:3:0",
      "bandage:5:0",
      "apple:10:0",
      "syringe.medical:3:0",
      "bandage:5:0",
      "apple:10:0"
    ],
    "Message Display Duration (seconds)": 10.0
  },
  "Returning Player Settings": {
    "Enable Returning Player Welcome": true,
    "Send Global Message": true,
    "Private Message": "<size=18><color=#00ffff>Welcome Back</color> <color=#FFFFFF>{player}</color></size>\n<size=14><color=#888888>We're glad to see you came back to us</color></size>\n<size=12><color=#00ff00>Check your inventory for a loyalty reward</color></size>",
    "Global Message": "<size=14><color=#00ffff>[+]</color> <color=#FFFFFF>{player}</color> <color=#00ffff>has come back online</color> from <color=#00ffff>{country}</color></size>",
    "Sound Effect": "assets/bundled/prefabs/fx/notice/loot.copy.fx.prefab",
    "Rewards (shortname:amount:skinId)": [
      "syringe.medical:1:0",
      "syringe.medical:1:0"
    ],
    "Message Display Duration (seconds)": 8.0
  },
  "Disconnect Settings": {
    "Enable Disconnect Message": true,
    "Send Global Message": true,
    "Global Message": "<size=14><color=#ff00ff>[-]</color> <color=#FFFFFF>{player}</color> <color=#ff00ff>just went offline</color></size>"
  },
  "General Settings": {
    "Server Name (leave empty to use server hostname)": "",
    "Use IP-API for Country Detection": true,
    "Default Country (if detection fails)": "Unknown",
    "Welcome Delay (seconds after connect)": 2.0,
    "Show UI Welcome Banner": true,
    "UI Banner Duration (seconds)": 8.0,
    "Log Player Connections": true
  },
  "Discord Webhook Settings": {
    "Enable Discord Webhooks": false,
    "Webhook URL": "",
    "Embed Color - First Time (decimal)": 65280,
    "Embed Color - Returning (decimal)": 65535,
    "Embed Color - Disconnect (decimal)": 16711935,
    "Send First Time Join": true,
    "First Time Message": ":green_circle: **{player}** has joined for the first time from **{country}**",
    "Send Returning Player Join": true,
    "Returning Message": ":blue_circle: **{player}** has come back online from **{country}**",
    "Send Disconnect": true,
    "Disconnect Message": ":red_circle: **{player}** just went offline",
    "Include Player Steam ID": true,
    "Include Timestamp": true
  }
}