Breaking Changes
- The plugin now requires at least Java 21
- Support for Minecraft 1.17-1.19 has been dropped

New Features
- Add 1.21.5 support
- Add stat_info menu
- This allows players to see exactly how their stat and trait levels are calculated
- Accessed by clicking any of the stat items (glass panes) in the stats menu (/stats)
- The menu is tab-based and shows stat modifiers by default. Trait modifiers can be viewed by clicking on the tab buttons on the right.
- Each tab shows any base value, value from skill rewards, and custom modifiers
- Add percentage-based stat and trait modifiers
- Modifiers now have an operation value that defines how they are applied
- The `add_percent` operation multiplies the stat level by 1+value/100
- For example, a modifier with value 50 multiplies the stat by 1.5
- The values for all `add_percent` modifiers for a stat are added together before multiplying the stat (additive multiplier)
- The `multiply` operation directly multiplies the stat level by the value
- For example, a modifier with value 2 doubles the stat level
- Each `multiply` modifier is applied separately (multiplicative modifier)
- All existing modifiers use the `add` operation, which is the basic addition to the stat level
- All `add` modifiers are applied before any `add_percent` or `multiply` modifiers
- The following existing commands have been modified to add an operation argument:
- `/skills modifier add <player> <stat> <name> <value> [operation] [silent] [stack]`
- `/skills trait add <player> <trait> <name> <value> [operation] [silent] [stack]`
- `/skills item modifier add <player> <stat> <value> [operation] [lore]`
- `/skills item trait add <player> <trait> <value> [operation] [lore]`
- `/skills armor modifier add <player> <stat> <value> [operation] [lore]`
- `/skills armor trait add <player> <trait> <value> [operation] [lore]`
- The `operation` argument is optional and defaults to `add`
- Add temporary modifiers
- Temporary modifiers are automatically removed after certain amount of time
- Use the following commands to add temporary stat and trait modifiers:
- `/skills modifier addtemp <player> <stat> <name> <value> <duration> [pauseOffline] [operation] [silent] [stack]`
- `/skills trait addtemp <player> <trait> <name> <value> <duration> [pauseOffline] [operation] [silent] [stack]`
- The `duration` argument is in the format `[years]y[months]mo[days]d[hours]h[minutes]m[seconds]s`
- Examples of valid durations are `5s`, `10m`, and `4d2m1s`
- The `pauseOffline` argument defines whether the remaining duration should stop counting down when the player is offline (defaults to false)
- Add block requirements
- Block requirements are customizable restrictions on breaking, placing, or harvesting blocks
- Requirements are defined in requirement.blocks.list in config.yml
- Each element in the list can have the following keys:
- `material` - The name of the block to add requirements for (required)
- `allow_break` - Whether to ignore requirements on block break (defaults to false)
- `allow_place` - Whether to ignore requirements on block place (defaults to false)
- `allow_harvest` - Whether to ignore requirements on block harvest (defaults to false)
- When none of the above allow options are defined, the block cannot be broken, placed, or harvested when requirements are not met
- `requirements` - A map list of the requirement nodes for this block. Each element in the list can have the following keys:
- `type` - The type of requirement, which can be `skill_level`, `permission`, `excluded_world`, or `stat`
- `message` - The error message to send to the player when the requirement is not met. Supports MiniMessage and PlaceholderAPI (optional).
- Each type has specific keys below that must be added to define type behavior. These keys are added in the same indent level as `type`.
- The `skill_level` type requires the player to be at least a specific level in a skill. Keys:
- `skill` - The name of the skill to add a level requirement for
- `level` - The minimum skill level the player must be
- The `permission` type requires the player to have a specific permission node. Keys:
- `permission` - The permission node required
- The `excluded_world` type defines a list of worlds that will make the requirement fail if the player is in one of them. Keys:
- `worlds` - The list of worlds to not allow the player to be in
- The `stat` type requires the player to be at least a specific stat level. Keys:
- `stat` - The name of the stat to add a level requirement for
- `value` - The minimum stat value that the player must be
- General options related to the block requirement system are in requirement.blocks:
- `enabled` - Whether block requirements are checked at all
- `bypass_in_creative_mode` - Whether to ignore block requirements for players in creative mode (defaults to true)
- `bypass_if_op` - Whether to ignore block requirements for players that are op (defaults to false)
- Add addition protections against removing items from menus
- Enable by setting `menus.removal_protection` in config.yml to true (false by default)
- Add `speed_reduction` option to Stun ability
- Add translatable messages for command descriptions and update notification
- Add `item_model` support in menu and loot items
- Add `percent_format` and `current_xp_format` options to skills menu
- Add `xp_format` option to sources menu
- Add `format` option to stat reward to configure decimals
- Add Nexo support

Changes
- Update Polish, Chinese Simplified, and German messages
- Storing modifiers with SQL has been moved from the key_values table to a new modifiers table
- Existing modifiers will be migrated automatically
- A new schema_migrations table stores previously applied migrations
- Remove Oraxen support

Bug Fixes
- Fix default item options like glow being saved when updating files
- Fix errors when Anvil Discount is not loaded