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]( https://modrinth.com/project/oAd9YfsP)
* Hangar: [Hangar]( https://hangar.papermc.io/Vunlior/CladeWelcome)
* SpigotMC: [SpigotMC]( https://www.spigotmc.org/resources/cladewelcome.135054/)

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)