NerkubJoinLeave - Premium Minecraft Plugin

Modern and fully customizable Join & Leave message plugin with advanced features for Minecraft servers 1.16+.

✨ Key Features

🎯 Conditional Messages (LuckPerms Integration)

• Different messages for different player groups
• Priority system to determine highest group
• Full LuckPerms API support

🎆 Advanced First Join Sequence

• Automatic new player detection
• Fireworks on first join
• Clickable messages in chat (hover text, clickable actions)
• Custom Title & Subtitle for new players
• Broadcast message for all online players
• Counter for total unique players

🔊 Sound Effects

• Sounds on join/quit
• Individual sounds for joining player
• Broadcast sounds for other online players
• Fully configurable (sound, volume, pitch)

📊 BossBar System

• Welcome BossBar on join
• Configurable color, style and duration
• Placeholder support (online players, max players, etc.)

🎨 Flexible Text Formatting

• MiniMessage - modern formatting (<gradient>, <rainbow>, hex colors)
• Legacy codes - classic &a, &b, &c
• Hybrid mode - support both simultaneously

💾 Three Data Storage Methods

1. YAML - simple files (recommended for small servers)
2. SQLite - local database (recommended for medium servers)
3. MySQL/MariaDB - remote database (ideal for BungeeCord networks)

⚡ Action System

Execute commands on join:

• [CONSOLE] - execute command as console
• [PLAYER] - player executes command
• [MESSAGE] - send message to player

🎁 Bonus Features

• /welcomemsg <player> - Welcome a new player
• Reload command - /betterjoin reload
• Permission system
• Debug mode

📦 Installation

1. Upload plugin to plugins/ folder
2. (Optional) Install LuckPerms for conditional messages
3. Restart server
4. Edit config.yml according to your needs
5. Use /betterjoin reload to reload changes

⚙️ Configuration

Storage Types

storage:
  type: SQLITE  # YAML, SQLITE, or MYSQL

Message Format

message-format: BOTH  # MINIMESSAGE, LEGACY, or BOTH

Example Join Message with MiniMessage

join:
  message:
    text: "<gradient:#00FF00:#00AA00>[+]</gradient> <yellow>{player}</yellow> <gray>joined the server!"

Example Group-Specific Messages

join:
  group-messages:
    vip:
      text: "<gray>[<gold>VIP</gold>] <gold>{player}</gold> <gray>joined the server!"
      broadcast: true
    default:
      text: "<gray>[<green>+</green>] <white>{player}</white> <gray>joined the server"
      broadcast: true

First Join Configuration

first-join:
  enabled: true
  firework:
    enabled: true
    power: 1
    type: BALL_LARGE
    colors:
      - "#FFD700"
      - "#FFA500"
  title:
    enabled: true
    title: "<gradient:#FFD700:#FFA500>Welcome!</gradient>"
    subtitle: "<gray>Enjoy your time on our server!"

🔧 Commands

Command	Permission	Description
/betterjoin	-	Show help
/betterjoin reload	betterspawn.reload	Reload configuration
/betterjoin info	-	Show plugin info
/welcomemsg <player>	betterspawn.welcomemsg	Welcome a player

🔐 Permissions

Permission	Description	Default
betterspawn.*	All permissions	OP
betterspawn.reload	Reload configuration	OP
betterspawn.welcomemsg	Use /welcomemsg	true
betterspawn.firstjoin.bypass	Skip first join sequence	OP

📝 Placeholders

Available in all messages:

• {player} - Player name
• {displayname} - Player display name
• {uuid} - Player UUID
• {world} - Player's world
• {online} - Number of online players
• {max} - Maximum players
• {group} - Player's primary group (LuckPerms)
• {count} - Total unique players (first join)

🎯 Usage Examples

Starter Kit for New Players

first-join:
  actions:
    enabled: true
    commands:
      - "[CONSOLE] give {player} diamond 5"
      - "[CONSOLE] lp user {player} parent add default"
      - "[MESSAGE] <gold>You received a starter kit!"
      - "[PLAYER] spawn"

Clickable Message

first-join:
  broadcast-message:
    text: "<green>{player} joined for the first time! </green><click:run_command:/welcomemsg {player}><hover:show_text:'<gold>Click!'><gold>[WELCOME]</gold></hover></click>"

🛠️ Technical Details

Requirements

• Minecraft: 1.16+ (Paper/Spigot)
• Java: 21+
• Soft Dependencies: LuckPerms (optional)

Technologies Used

• Paper API 1.21.4
• Adventure API (MiniMessage)
• HikariCP (Database Connection Pooling)
• SQLite / MySQL Support
• LuckPerms API

Version Support

• ✅ 1.16.x
• ✅ 1.17.x
• ✅ 1.18.x
• ✅ 1.19.x
• ✅ 1.20.x
• ✅ 1.21.x

🎨 MiniMessage Examples

Gradient Text

<gradient:#FF0000:#00FF00>Colorful gradient!</gradient>

Rainbow Text

<rainbow>Rainbow text!</rainbow>

Hover & Click

<hover:show_text:'This appears on hover'>Hover over me!</hover>
<click:run_command:/help>Click for help</click>

📊 Performance

• Asynchronous database operations
• Efficient connection pooling (HikariCP)
• Minimal TPS impact
• Optimized for large servers

🐛 Bug Reports

If you find a bug or have an idea for improvement, contact me on BuiltByBit!

📄 License

Premium plugin - Nerkub © 2026

---

Created by: Nerkub Website: BuiltByBit Version: 1.0-SNAPSHOT

💎 Thank you for your purchase!