Changelog

All notable changes to the Crystal Powers plugin will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[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.