T1s Welcomer

Warning: This project is built only for my private server; if you happen not to find the right version, you might want to compile it yourself. After all this is just a simple project.

Warning: IF YOU ARE DOWNLOADING VERSION 1.1.1 AND BENEATH PLEASE ADD ADVENTURE PLATFORM OR ELSE SERVER WILL CRASH!

🌟 T1sWelcomer

T1sWelcomer is a powerful yet lightweight server-side mod for Fabric 1.21+ designed to give server owners full control over player join and leave notifications. Ditch the boring yellow vanilla text and create a professional, vibrant atmosphere for your community!

✨ Key Features

• First-Time vs. Returning Join Messages: Give your new players a warm, unique welcome while keeping regular return messages concise.
• Custom join-quit messages: Get rid of boring vanilla join/quit message. Futhermore, this mod work great with LuckPerms for custom roles!
• MiniMessage Support: Leverage the full power of Kyori MiniMessage. Use tags like <rainbow>, <gradient>, <bold>, or simple colors like <red> without messy color codes.
• LuckPerms Integration: Automatically fetches and displays player Prefixes and Suffixes. Perfectly compatible with your existing rank system.
• Smart “Wait for Ground” Logic: Prevents messages from sending before a player has finished loading, ensuring they actually see the welcome text when they “touch grass.”
• Sound Effects: Optional XP-level-up sound upon joining to grab the player’s attention.
• Zero Client-Side Requirement: Players don’t need to install this mod to see the beautiful messages!

🛠️ Commands & Permissions

| Command | Description | Permission |
| :— | :— | :— |
| /t1swelcomer reload | Reloads the configuration file instantly. | t1swelcomer.command.reload |

Note: If LuckPerms is not installed, the command defaults to OP Level 2.

📂 Configuration

The config file is located at config/t1swelcomer.json.

Available Placeholders:

• <player>: The player’s display name.
• <prefix>: The player’s LuckPerms prefix.
• <suffix>: The player’s LuckPerms suffix.

📄 Sample Configuration (config/t1swelcomer.json)

Here is an example of how your configuration file will look with MiniMessage formatting:

{
  "enableJoinQuitMessages": true,
  "delayTicks": 40,
  "waitForGround": true,
  "playXpSound": true,
  "globalJoinMessage": "<prefix><white><player></white><suffix> <yellow>joined the server.</yellow>",
  "globalQuitMessage": "<prefix><white><player></white><suffix> <gray>left the server.</gray>",
  "firstJoinMessage": [
    "<yellow>==========================================</yellow>",
    "<gold><bold>WELCOME <player> TO THE SERVER!</bold></gold>",
    "<yellow>==========================================</yellow>"
  ],
  "returnJoinMessage": [
    "<aqua>Welcome back, <player>!</aqua>"
  ]
}

🚀 Installation

1. Drop the .jar file into your server’s mods folder.
2. Ensure you have Fabric API installed (IF YOU ARE DOWNLOADING T1SWELCOMER VERSION 1.1.1 AND BENEATH PLEASE ADD ADVENTURE PLATFORM OR ELSE SERVER WILL CRASH ..)
3. (Optional) Install LuckPerms to enable prefix/suffix support..
4. Restart the server and customize the messages in the generated config file!

📜 License

This project is licensed under the MIT License. Feel free to use it in any modpack!