CladeWelcome

General Information

CladeWelcome is a plugin for Minecraft servers (Paper/Spigot/Purpur) that provides an advanced welcome message system for players when joining and leaving the server.

• Version: 1.1.0.0.a
• Author: Vunlior
• Development Language: Java 17
• Supported Minecraft Versions: 1.17.x - 1.21.x
• Build System: Maven

Main Features

1. Message System

• Custom join/quit messages with placeholder support
• Permission-based message groups (admin, op, default)
• Random message selection from a list for each event
• Multi-language support (10 languages: en, ru, uz, de, es, tr, fr, pl, pt, it)

2. Visual Effects

• Sound effects when players join
• Subtitles with configurable delay
• ActionBar messages with configurable duration
• BossBar with configurable color and style
• Fireworks on a player's first join

3. Information Panel

• Displays server information on player join
• Shows player rank, online player count, and current time
• Can be disabled for OPs and admins

4. Per-Player Module Toggling (NEW)

• Players can disable individual welcome modules using /cw toggle <module>
• Supported modules: sounds, subtitle, actionbar, bossbar, messages, firework, panel
• Settings persist across server restarts
• Optional MySQL database support for centralized storage

5. Database Storage (NEW)

• Optional MySQL support for player settings
• Automatic fallback to YAML file storage
• HikariCP connection pooling for performance

• Graceful error handling

6. Integrations

• PlaceholderAPI (optional) for advanced placeholders
• Adventure API for modern text formatting
• Update checking via Modrinth

7. Management

/cw command for plugin management

Subcommands:

• /cw help - help menu
• /cw reload - reload configuration
• /cw lang <language> - change language
• /cw status - plugin status
• /cw toggle - enable/disable join messages for yourself
• /cw toggle <module> - enable/disable specific modules (sounds, subtitle, actionbar, bossbar, messages, firework, panel)

8. Permission System

• cladewelcome.admin - administrative commands
• cladewelcome.reload - reload the plugin
• cladewelcome.lang - change language
• cladewelcome.status - view plugin status
• cladewelcome.op - OP messages
• cladewelcome.default - default messages
• cladewelcome.toggle - disable messages for yourself

Technical Features

Configuration

• config.yml - main configuration file
• lang/*.yml - localization files
• player-settings.yml - local player settings storage (if MySQL not used)

Dependencies

• PlaceholderAPI (optional, soft dependency) - Uses reflection for compatibility with any version
• Apache Commons Lang3 (for vulnerability fixes)
• HikariCP (for MySQL connection pooling)
• MySQL Connector/J (for MySQL support)

Configurable Settings

Messages

• Enable/disable join and quit messages

Sounds

• Enable/disable sound effects

Subtitle

• Enable/disable subtitles
• Display delay

ActionBar

• Enable/disable
• Display duration

BossBar

• Enable/disable
• Color (BLUE, RED, GREEN, etc.)
• Style (SOLID, SEGMENTED, etc.)
• Display duration

First Join Fireworks

• Enable/disable

Information Panel

• Enable/disable
• Disable for OPs
• Disable for admins

Database (NEW)

• Enable/disable MySQL storage
• Host, port, database name, username, password

Update Check

• Enable/disable automatic update checking

Statistics

• Unique join counter

Supported Placeholders

• %player% - player name
• %ping% - player ping
• %online% - online player count
• %unique% - unique join number
• %rank% - player rank
• %time% - current time
• %version% - plugin version
• %lang% - current language
• Any PlaceholderAPI placeholders (if installed)

Download Links

• Modrinth: Modrinth
• Hangar: Hangar
• SpigotMC: SpigotMC

Implementation Details

1. Asynchronous Loading - languages and configurations are loaded asynchronously
2. Legacy and Modern Support - automatic detection and usage of Adventure API or legacy methods
3. Cross-Platform Compatibility - works on Paper, Spigot, and Purpur
4. Optimization - uses ConcurrentHashMap for thread safety
5. Custom Events - PlayerWelcomeEvent for integration with other plugins
6. Per-Player Module System - players can customize their welcome experience
7. Database Support - optional MySQL for centralized player settings

System Requirements

• Java: 17 or higher
• Minecraft Server: Paper, Spigot, or Purpur 1.17.x - 1.21.x
• Memory: Minimal requirements (lightweight plugin)
• Database (optional): MySQL 5.7+ for player settings storage

License and Rights

The project was developed by Vunlior and is distributed through popular Minecraft plugin platforms. (Apache-2.0)