Crystal Powers

Changelog

All notable changes to the Crystal Powers plugin will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

[0.1.0] - 2025-06-08

Added

#### Core Plugin Features - Complete plugin rebranding from "Origins" to "Crystal Powers" - Crystal Power system with 6 unique powers: Human, Avian, Enderian, Arachnid, Merling, and Phantom - Immersive chest-based GUI for crystal power selection with mystical theming - Persistent player data storage with YAML configuration - Command system with intuitive aliases and tab completion #### Crystal Powers - Human: Balanced baseline power with no special abilities or weaknesses - Avian: Flight ability, fall damage immunity, reduced health (8 hearts), weakness to projectiles - Enderian: Enhanced teleportation with ender pearls, night vision, water/rain damage vulnerability - Arachnid: Wall climbing when sneaking, night vision, poison immunity, reduced health (8 hearts) - Merling: Water breathing, faster swimming, underwater night vision, slower land movement - Phantom: Invisibility toggle (sneak + right-click), fall damage immunity, sunlight vulnerability, reduced health (7 hearts) #### Advanced Abilities Implementation - Flight system with proper game mode checks and persistence - Teleportation mechanics with enhanced ender pearl functionality - Wall climbing physics for Arachnid power - Invisibility mechanics with light level detection for Phantom - Swimming enhancements with speed modifiers for Merling - Damage immunity system for fall damage, poison, and other effects - Health modification system with proper attribute handling - Speed multipliers for land and water movement #### GUI System - Mystical chest interface with themed item representations - Interactive power selection with detailed tooltips and lore - Random power assignment option for fate-based selection - Confirmation system with permanent choice warnings - Visual feedback with chat messages and sound effects - Automatic GUI opening for new players #### Commands and Permissions - /crystalpower - Main command with GUI access - /cp, /power, /crystal - Command aliases for convenience - Subcommands: select, random, info, list, reload, debug - Permission system: crystalpowers.select, crystalpowers.admin, crystalpowers.bypass - Tab completion for all commands and crystal power names - Debug command for troubleshooting crystal power issues #### Technical Features - Event-driven architecture with comprehensive player event handling - Equipment management including Elytrian auto-elytra and restrictions - Potion effect system with permanent and temporary effects - Damage modification system with multipliers and immunities - Game mode compatibility ensuring proper functionality across all modes - Error handling with extensive logging and debug information #### Code Protection - yGuard integration ready for JAR obfuscation (Maven profile prepared) - Source code protection against reverse engineering - Build system integration with Maven for automated obfuscation #### Developer Features - Comprehensive API for other plugins to interact with Crystal Powers - Modular architecture with separated managers, models, and utilities - Extensive documentation with detailed README and code comments - Debug logging system for troubleshooting and development

Technical Details

#### Architecture - Package structure: com.crystalpowers.plugin with organized subpackages - Manager classes: CrystalPowerManager, PlayerDataManager - Model classes: CrystalPower, PlayerData with builder patterns - Event listeners: Comprehensive PlayerListener for all game events - GUI system: CrystalPowerBookGUI with chest-based interface - Utility classes: JsonBuilder, EncryptionUtil for data handling #### Data Management - YAML-based storage in playerdata.yml - UUID-based player identification for server compatibility - Cooldown system for crystal power changes (24-hour default) - Data persistence across server restarts - Automatic data migration from legacy Origins format #### Performance Optimizations - Efficient event handling with null checks and early returns - Minimal memory footprint with optimized data structures - Lazy loading of player data when needed - Scheduled tasks for delayed operations and checks

Compatibility

- Minecraft Version: 1.19.4+ - Server Software: Spigot, Paper (recommended) - Java Version: 17+ - Dependencies: None (standalone plugin)

Migration

- Complete migration from Origins plugin structure - Automatic data conversion from legacy Origins format - Preserved player selections during transition - Backward compatibility with existing configurations

Known Issues

- None reported in initial release

Security

- Permission-based access control for admin functions - Input validation for all commands and interactions - Safe data handling with proper encoding and validation - Code obfuscation ready for production deployment --- Note: This is the initial release of Crystal Powers, representing a complete rewrite and rebranding of the Origins plugin with enhanced features, improved architecture, and comprehensive crystal power implementations.