Overview

VIPJoinMessage is a comprehensive Minecraft plugin designed to enhance server engagement by displaying custom join messages and playing unique sounds for players with special permissions. Perfect for highlighting VIP members, staff ranks, and premium players on your server.

Key Features

Rank-Based Join Messages

• Fully customizable join messages for different player ranks

• Support for unlimited ranks with individual permissions

• Priority system ensures the highest rank is always displayed

• Placeholder support (%player%, %rank%) for dynamic content

Custom Sound Effects

• Unique sounds for each rank (thunder for owners, level-up for admins, etc.)

• Configurable volume and pitch settings

• Option to broadcast sounds to all players or just the joining player

• Built-in sound validation with error handling

⚙️ Advanced Configuration

• Separate configuration files (config.yml, messages.yml)

• Hot-reload functionality with /vipjoin reload command

• Optional prefix system that can be toggled on/off

• Automatic suppression of default Minecraft join/quit messages

Customization Options

• Full color code support (&4, &l, &7, etc.)

• Configurable message broadcasting (all players vs. individual)

• Easy addition/removal of ranks without code changes

• Professional English localization

Default Ranks

• Owner - Thunder sound, priority 1

• Admin - Level-up sound, priority 2

• Moderator - Chime sound, priority 3

• Helper - Bell sound, priority 4

• VIP - Experience orb sound, priority 5

Technical Specifications

• API Version: 1.21

• Compatibility: Minecraft 1.16.5+

• Dependencies: None (Bukkit/Spigot/Paper)

• Performance: Lightweight, minimal server impact

• Permissions: Individual rank permissions (vjm.owner, vjm.admin, etc.)

Installation

1. Drop the plugin JAR into your server's plugins/ folder

1. Restart your server

1. Configure ranks and messages in the generated config files

1. Assign permissions to players using your preferred permissions plugin

Commands & Permissions

• /vipjoin reload - Reload configuration (Permission: vjm.admin)

• Default Rank Permissions: vjm.owner, vjm.admin, vjm.moderator, vjm.helper, vjm.vip