Changelog
All notable changes to CladeWelcome will be documented in this file.

[1.2.0.0.a] - 2026-05-26
Added

• Performance Mode system
  • Light mode for maximum performance
  • Heavy mode with full features enabled
• Debug Mode
  • Detailed console logging
  • Easier troubleshooting
• Configuration Validation
  • Animation type validation
  • BossBar color validation
  • Clickable action validation
  • URL validation
• Component Cache System
  • 5 minute TTL cache
  • Automatic cleanup on reload
  • Improved performance
• Group Sound System
  • Different sounds for different groups
  • Custom volume and pitch
  • Compatibility fallback support
• BossBar Gradient Support
  • Gradient colors
  • Gradient animation compatibility
• Multiple Clickable Commands
  • Support for semicolon-separated commands
• Async Language Loading
  • Faster startup performance
• JavaDoc Documentation
  • Improved developer documentation
• Full README Documentation
  • Installation guide
  • Configuration guide
  • Troubleshooting section

Fixed

• Fixed hex color support in all animations
  • RainbowAnimation
  • GradientAnimation
  • TypingAnimation
  • ScrollingAnimation
  • WaveAnimation
  • PulsingAnimation
• Fixed clickable chat system
  • Better URL detection
  • Fixed click events
  • Added compatibility fallback
• Fixed deprecated method warnings
  • hideJoinMessage
  • hideQuitMessage
  • sendLegacyTitle
• Fixed update checker display
  • Prevents empty version display
• Improved error handling
  • Better try-catch handling
  • Improved stack traces
  • Better logging
• Fixed sound playback fallback system
• Added player settings file creation logging

Changed

• Updated startup/shutdown banners
  • Update checker status
  • MySQL status
  • Animation status
  • Platform support information
• Updated Discord links
  • https://discord.gg/S3gkVgxk
• Updated configuration structure
  • performance-mode
  • debug
  • sounds.default
  • sounds.groups
  • bossbar.gradient-enabled
  • bossbar.gradient-colors

Removed

• Removed hover hints from clickable chat

Technical Improvements

• Better code organization
• Improved performance
• Better compatibility support
• Improved logging system
• Better error recovery

Configuration
Added:


performance-mode: light

debug:
enabled: false


sounds:
default:
sound: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.0


sounds:
groups:
admin:
sound: BLOCK_NOTE_BLOCK_PLING


bossbar:
gradient-enabled: false
gradient-colors:
- "#FF0000"
- "#00FF00"
- "#0000FF"

Supported Platforms

• Paper
• Purpur
• Spigot

Requirements

• Java 17+
• Minecraft 1.17.x - 1.21.x

Author
Vunlior

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 - Описание проекта

Общая информация

CladeWelcome - это плагин для Minecraft серверов (Paper/Spigot/Purpur), который предоставляет расширенную систему приветственных сообщений для игроков при входе и выходе с сервера.

- Версия: 1.0.0.0.a
- Автор: Vunlior
- Язык разработки: Java 17
- Поддерживаемые версии Minecraft: 1.17.x - 1.21.x
- Система сборки: Maven

Основные функции

1. Система сообщений
- Кастомные сообщения входа/выхода с поддержкой плейсхолдеров
- Группы сообщений на основе прав (admin, op, default)
- Случайный выбор из списка сообщений для каждого события
- Поддержка многоязычности (10 языков: en, ru, uz, de, es, tr, fr, pl, pt, it)

2. Визуальные эффекты
- Звуковые эффекты при входе игроков
- Subtitles (подзаголовки) с настраиваемой задержкой
- ActionBar сообщения с настраиваемой длительностью
- BossBar с настраиваемым цветом и стилем
- Фейерверки при первом входе игрока

3. Информационная панель
- Отображение информации о сервере при входе
- Показывает ранг игрока, количество онлайн, текущее время
- Возможность отключения для OP и админов

4. Интеграции
- PlaceholderAPI (опционально) для расширенных плейсхолдеров
- Adventure API для современного форматирования текста
- Проверка обновлений через Modrinth

5. Управление
- Команда `/cw` для управления плагином
- Подкоманды:
- `/cw help` - справка
- `/cw reload` - перезагрузка конфигурации
- `/cw lang <язык>` - смена языка
- `/cw status` - статус плагина
- `/cw toggle` - включение/выключение сообщений входа для себя

6. Система разрешений
- `cladewelcome.admin` - административные команды
- `cladewelcome.reload` - перезагрузка плагина
- `cladewelcome.lang` - смена языка
- `cladewelcome.status` - просмотр статуса
- `cladewelcome.op` - сообщения для OP
- `cladewelcome.default` - сообщения по умолчанию
- `cladewelcome.toggle` - отключение сообщений для себя

Технические особенности

Конфигурация
- config.yml - основная конфигурация плагина
- lang/*.yml - файлы локализации

Зависимости
- PlaceholderAPI (опционально)
- Apache Commons Lang3 (для исправления уязвимостей)

Конфигурируемые параметры

Сообщения (messages)
- Включение/выключение сообщений входа/выхода

Звуки (sounds)
- Включение/выключение звуковых эффектов

Subtitle (subtitle)
- Включение/выключение подзаголовков
- Задержка отображения

ActionBar (actionbar)
- Включение/выключение
- Длительность отображения

BossBar (bossbar)
- Включение/выключение
- Цвет (BLUE, RED, GREEN, etc.)
- Стиль (SOLID, SEGMENTED, etc.)
- Длительность отображения

Фейерверки при первом входе (first-join-firework)
- Включение/выключение

Информационная панель (info-panel)
- Включение/выключение
- Отключение для OP
- Отключение для админов

Проверка обновлений (update-check)
- Включение/выключение автоматической проверки

Статистика (stats)
- Счётчик уникальных входов

Поддерживаемые плейсхолдеры

- `%player%` - имя игрока
- `%ping%` - пинг игрока
- `%online%` - количество игроков онлайн
- `%unique%` - номер уникального входа
- `%rank%` - ранг игрока
- `%time%` - текущее время
- `%version%` - версия плагина
- `%lang%` - текущий язык
- И любые плейсхолдеры PlaceholderAPI (если установлен)

Ссылки на скачивание
- Modrinth: https://modrinth.com/project/oAd9YfsP
- Hangar: https://hangar.papermc.io/Vunlior/CladeWelcome
- SpigotMC: https://www.spigotmc.org/resources/cladewelcome.135054/

Особенности реализации

1. Асинхронная загрузка - языки и конфигурация загружаются асинхронно
2. Поддержка legacy и modern - автоматическое определение и использование Adventure API или legacy методов
3. Кроссплатформенность - работа на Paper, Spigot и Purpur
4. Оптимизация - использование ConcurrentHashMap для потокобезопасности
5. Кастомные события - PlayerWelcomeEvent для интеграции с другими плагинами
6. Система мута - игроки могут отключать сообщения входа для себя

Требования к системе

- Java: 17 или выше
- Minecraft Server: Paper, Spigot или Purpur 1.17.x - 1.21.x
- Память: Минимальные требования (плагин лёгкий)

Лицензия и права

Проект разработан Vunlior и распространяется через популярные платформы для Minecraft плагинов. (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.4.0.0.a-RELEASE
Features

• 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-10

✨ 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