# Changelog v1.0.3 --- ### New Features: 1. **Configuration Management Enhancements**: - **Dynamic Key Merging**: - Automatically merges new configuration keys from the default `config.yml` into the existing file while preserving user-defined values. - Ensures that missing keys are seamlessly added without overwriting existing customisations. - **Versioning for Updates**: - Introduced `config-version` for streamlined updates and tracking. The plugin now identifies outdated configurations and updates them while preserving custom settings. 2. **bStats Integration**: - Introduced bStats analytics for usage tracking and plugin improvement. - Explicit logging added to indicate whether bStats is enabled or disabled, along with a prompt encouraging users to enable it to support development. 3. **New XP Settings**: - Added multiple configuration options for fine-grained XP control: - **`repair-cost-xp`:** When set to `false`, repairing items does not consume XP levels. Repair costs still apply but XP is ignored. - **`grindstone-refund-xp`:** When set to `false`, players do not gain XP when disenchanting items using a grindstone. - **`xp-in-creative`:** Determines whether players in Creative mode can earn XP. Defaults to `false`. - **`xp-global-disable`:** A master toggle to disable all XP rewards in the game. This setting overrides all other XP configurations. - **`xp-scaling-factor`:** Allows global scaling of XP rewards. Set to `1.0` for normal XP, `0.5` for half XP, and so on. --- ### Bug Fixes: - **Configuration Loading**: - Fixed an issue where missing configuration keys were not added during updates, leading to plugin disabling. - Ensured that configuration updates no longer override user-defined values. - **XP Handling Fixes**: - Corrected XP costs for anvils - Fixed an issue where grindstone XP refunds were not properly configurable, allowing for full control via the new `grindstone-refund-xp` option. --- ### Refactor Highlights: - **Full Codebase Refactor**: - Streamlined and modularised code for better maintainability. - **Improved Logging**: - Enhanced logging feedback for key operations such as configuration loading, task initialisation, and plugin lifecycle events. --- ### Recommended Steps: 1. **Configuration Update**: - Existing configurations should be automatically updated with new keys while preserving user settings. 2. **Testing**: - Test all new XP-related functionalities: - **Repair mechanics** to ensure XP costs are applied or ignored as configured. - **Grindstone disenchanting** to verify XP refunds match the settings. - **Global XP scaling** using the `xp-scaling-factor`.

## **Changelog v1.0.2** ### **Enhanced Compatibility** - Verified full support for Minecraft versions **1.21.1 up to 1.21.4**. --- ### **New Features** 1. **Raid Completion XP Distribution**: - Added XP distribution for **raid completions**. - XP is now directly awarded to all participating players, with a configurable amount (`xp-overrides.raids.COMPLETION`). - Players will no longer lose out on XP after successful raids. 2. **Grindstone XP Handling Improvements**: - Updated XP handling for **grindstone usage**, ensuring more accurate XP awards. --- ### **Bug Fixes** - **XP Drops for Bottle o' Enchanting**: - Corrected XP calculation for thrown Bottles o' Enchanting to match configured values accurately. - **XP Bypass Edge Cases**: - Fixed an issue where XP bypass logic failed for specific event scenarios (e.g., negative XP values). --- ### **Recommended Steps** - **Configuration Update**: - Add the new configuration entry (`xp-overrides.raids.COMPLETION` If this is missing, default values will be used, but for full customisation, regenerating the config is recommended. Update config with the below: ```yml raids: COMPLETION: 150.0 ``` - **Testing**: - Ensure you test raid completions, grindstone usage, and Bottles o' Enchanting XP functionality after updating. ---

# Changelog v1.0.1 - **Fractional XP System**: We now track partial XP to ensure no XP goes to waste. This means whenever you gain fractional XP, it accumulates until it becomes a whole number, and is then awarded to you. - **Creative XP Toggle**: There's a new option in the config to allow or disallow XP gains while in Creative mode. - **Debug Mode**: A new `debug` setting has been introduced to help with diagnostics. When enabled, more information is shown to users (with permission) and is logged in the console. - **More Customisation**: - **Blocks**: Configuration now supports per-block XP overrides. - **Furnace Extraction**: Smelting items in a furnace can now grant XP based on how many items are smelted. - **Enhanced Warnings**: Warnings now only show if debug mode is enabled. - **Minor Tweaks & Fixes**: Various behind-the-scenes improvements to performance and stability. # Breaking Change in Configuration - **Config Structure Updates**: We have introduced new config paths and settings (for example, `xp-overrides.blocks.*`, `xp-overrides.crafting.FURNACE.*`, fractional XP settings, and `xp-in-creative`). - **Recommendation**: **It is strongly recommended to delete your existing `config.yml`** and let the plugin generate a fresh version. If you continue to use an older config, you may encounter errors or miss out on the new features. # Other Notable Improvements 1. **Periodic Clean-ups**: The plugin now cleans up old damage data more effectively, preventing lag or memory usage from stale entries. 2. **Zero/Negative XP Bypasses**: If a source tries to grant zero or negative XP, the plugin will now skip it more gracefully. 3. **More XP Sources**: Additional checks for XP awarding in various events (like grindstone usage and block interactions).

# Changelog ## 1.0.0 - Initial Release ### Features - **Remove Experience Orb**: This plugin removes the vanilla experience orb and applies the XP directly to the player. - **Shared XP Distribution**: XP is shared among players based on their contribution to mob kills. - **Custom XP Overrides**: Configure XP values for mobs, skills, crafting, and miscellaneous actions in the `config.yml`. - **XP Retention**: Prevent XP loss on player death with configurable options. - **Free Enchanting**: Enable enchanting without consuming XP levels. - **Challenge Rewards**: Grant bonus XP for completing advancements. - **Comprehensive Configuration**: Easily customise all features through the `config.yml` file. - **Permissions**: Granular permission nodes for reloading the plugin and receiving warnings. ### Compatibility - Fully compatible with **Paper MC** version **1.21.4**. - Developed and tested on the latest Minecraft server environments. ### Additional Notes - Extensive documentation available for setup and configuration. - Built to support dynamic gameplay and balanced server progression.