CladeWelcome

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)

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.0.0.0.a * Author: Vunlior * Development Language: Java 17 * Supported Minecraft Versions: 1.17.x - 1.21.x * Build System: Maven Main Features 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) 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 Information Panel * Displays server information on player join * Shows player rank, online player count, and current time * Can be disabled for OPs and admins Integrations * PlaceholderAPI (optional) for advanced placeholders * Adventure API for modern text formatting * Update checking via Modrinth 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 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 Dependencies * PlaceholderAPI (optional) * Apache Commons Lang3 (for vulnerability fixes) 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 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?utm_source=chatgpt.… * Hangar: [Hangar](https://hangar.papermc.io/Vunlior/CladeWelcome?utm_source… * SpigotMC: [SpigotMC](https://www.spigotmc.org/resources/cladewelcome.135054/?u… 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. Mute System - players can disable join messages for themselves System Requirements * Java: 17 or higher * Minecraft Server: Paper, Spigot, or Purpur 1.17.x - 1.21.x * Memory: Minimal requirements (lightweight plugin) License and Rights The project was developed by Vunlior and is distributed through popular Minecraft plugin platforms. (Apache-2.0)

CladeWelcome v0.4.0.0.a-RELEASE Features - Supported: 1.20.x, 1.21.x - Multi-Language Architecture: Designed a modular localization system with native support for 10 languages (en, ru, uz, de, es, tr, fr, pl, pt, it). Built-in automatic generation of language files in the lang/ directory. - Dynamic Welcome Mechanics: Implemented comprehensive welcome triggers across key client UI components: Chat, Title/Subtitle, Actionbar, and BossBar. - Smart Content Randomization: Added support for string lists within localization files, enabling random welcome message rotation on each player join event. - First-Join Tracking: Integrated a dedicated first-join trigger featuring customizable visual effects (Firework) and unique community-wide welcome notifications. - Info Panel & Analytics: Implemented a customizable multi-line dashboard displaying real-time session statistics (Rank, Ping, Server Time, Online Count). Refactoring & Code Quality - Adventure API Integration: Fully migrated text rendering to the modern Adventure framework. Standardized native HEX-color parsing and gradient formatting, eliminating legacy Bukkit color code dependencies. - Robust Localization Fallback: Overhauled the internal normalize() method. If an invalid or corrupted language pack is detected, the plugin isolates the issue and seamlessly falls back to the master en.yml profile. - String Processing Optimization: Segmented the LangManager#getRaw() logic to differentiate between single-line entries and multi-line lists. String arrays are now reliably transformed into clean structural blocks using String.join(). Bug Fixes - Compilation & Entity Lifecycle: Resolved a critical compilation failure triggered by invalid entity-hiding method signatures within the spawnPrivateFirework logic. Firework lifecycle hooks now strictly adhere to safe Bukkit API standards. - Task Management: Fixed a potential memory leak during runtime plugin reloads. Active BossBar visibility tasks are now explicitly terminated via Bukkit.getScheduler().cancelTasks(). Dependencies - PlaceholderAPI Support: Added an optional soft-dependency hook. When PAPI is detected at runtime, external placeholders are parsed dynamically across all configured text interfaces.

CladeWelcome v0.3.1.0.a Added - ActionBar system - BossBar system Improvements - Fully refactored onEnable() / onDisable() (clean startup system) - Improved language system (LangManager + fallback support) - Added strict language validation (regex + whitelist) - Optimized join flow (no heavy logic inside Main) - Centralized message handling via config + lang.yml - Safer configuration handling (enabled flags everywhere) Changes - Moved all text to system-based keys: subtitle.welcome info.panel - Removed hardcoded messages from Main class - Separated responsibilities: LangManager → language handling only Main → event + logic handling only Fixes - Fixed /cw help and /cw lang not working in some cases - Fixed language reload errors - Fixed null-safe config handling - Fixed other bugs “Please use the stable version 0.3.0.0.a.”

CladeWelcome v0.3.0.0.a Date: 2026-05-10 Added - Multi-language system (10 languages): en, ru, uz, de, es, tr, fr, pl, pt, it - Chat Info Panel: Player rank Ping Online players Server time - Subtitle system (simple join message line) - Improved join sound system - Player groups system: default / op / admin - Server time display Improved - Optimized onJoin flow (split into modular methods) - Improved LangManager stability and loading - Reload system improved and more stable - Better random welcome message selection - Cleaned Info Panel & Subtitle logic - Faster plugin startup performance Fixed - Fixed invalid language input handling - Fixed fallback language issues - Fixed potential NullPointerException in LangManager - Fixed unstable language file loading - Fixed empty message list handling UI / UX Changes - Cleaner Info Panel layout - Simplified subtitle (minimal text) - Improved chat readability Technical Changes - Added language whitelist (ALLOWED_LANGS) - Improved language file structure - Better config handling system - Protection against invalid language input - Refactored code into clean modules (join / sound / info / subtitle) Version Info - Version: v0.3.0.0.a - Status: Stable Release of Plugin - Platform: Purpur / Paper compatible - API: Bukkit / Spigot / Paper

CLADEWELCOME Version: v0.2.0.0.a Date: 2026-05-09 FEATURES ADDED - First join message system added LANGUAGE SYSTEM - Multi-language support added: English (en) Russian (ru) Uzbek (uz) German (de) Spanish (es) Turkish (tr) - Fallback system (default → English) - Safe language switching via config and command COMMAND SYSTEM - /cw help — shows all commands - /cw status — plugin information - /cw lang <ru|en|uz|de|es|tr> — change language - /cw reload — reload plugin configuration PERMISSIONS SYSTEM - cladewelcome.reload - cladewelcome.lang SOUND SYSTEM Sound played on player join Different sounds based on group: - default players - OP players - admin players CORE SYSTEM - Event system (Listener) implemented - Updated: onEnable, onDisable FIXES & IMPROVEMENTS - Fixed join message handling logic - Fixed language fallback - Improved config loading reliability - Optimized language loading system - Stabilized codebase NOTES Stable version of plugin

CLADEWELCOME Version: v0.1.0.0.a Date: 2026-05-08 ---------------------------------- FEATURES ---------------------------------- - Player join message system added - Groups support (default / admin / op) - Config-based message system - Random message selection ---------------------------------- SYSTEM ---------------------------------- - Plugin core structure created - LangManager system added - Language support (ru / en / uz) - Added /cw reload command ---------------------------------- FIXES ---------------------------------- - Fixed message handling on join - Fixed language (EN) ---------------------------------- NOTES ---------------------------------- - Stable version of plugin