AuraSkills

New Features

• Add trait placeholders
  • `%auraskills_trait_[trait]%` gets the effective level of a trait
  • `%auraskills_trait_[trait]_bonus%` gets the bonus level of a trait (level excluding the base value)
  • `%auraskills_trait_[trait]_menu%` gets the trait in the same format displayed in the stats menu
• Add mana ability placeholders (thanks Erik)
  • `%auraskills_mability_[ability]%` gets the player's mana ability level
  • `%auraskills_mability_[ability]_value%` gets the mana ability value
  • `%auraskills_mability_[ability]_active%` returns true if mana ability is active, false otherwise
• Add MythicMobs hook to fix issues with damage (thanks Erik)
  • Add takeMana mechanic
    • Syntax: takeMana{m=number}
  • Add giveSkillXP mechanic
    • Syntax: giveSkillXP{xp=number,s=skill}
  • Add hasMana condition for MythicCrucible
    • Syntax: hasMana{m=number}
• Add cause and excluded_cause options to entity source
  • These options can be optionally added to filter DamageCause
• Add directly_to_inventory option to config.yml to make all bonus item drops from luck traits and loot always add directly to the player's inventory instead of being dropped in the world
  • This option does not affect vanilla item drops

Changes

• Bleed no longer creates invulnerable damage frames
• Add Turkish, Finnish, and Thai messages

Bug Fixes

• Fix disabled abilities showing in level progression menu items
• Fix hex colors in stat names not working in menus
• Fix the WorldGuard hook not loading blocked_check_replace_regions option
• Fix user data being reset in some cases
• Fix block luck not applying to players in Adventure mode
• Fix CustomSkill not showing defined messages in menus

API Changes

• Add openMenu methods and registerContext to MenuManager
• Add parseItem and parseMultipleItems to ItemManager, allowing parsing of ItemStack from a ConfigurationNode
• Add passesFilter to ItemManager
• Add loot API for accessing existing loot tables and registering new loot types
  • New loot tables can be loaded by using NamespacedRegistry#setLootDirectory
• Add SourceManager API for getting sources of a type
• Remove the extra repositories that were required to load the dependency in 2.0.6

New Features

• Add support for custom menus
  • Create a new file in the menus folder to create a custom menu
  • Follows the same format as existing menus, though templates and components will not work
  • Supports PlaceholderAPI and click actions like existing menus
• Add openmenu command
  • Syntax: `/skills openmenu <menuName> [player] [properties] [page]`
  • If player is not specified, the menu opens for the sender
  • The properties argument is a JSON string required to open some menus
    • For example, `{"skill":"Skill:mining"}` should be passed when opening the level_progression, abilities, sources, and leaderboard menu
  • The page argument starts at 0 for the first page
  • Requires the auraskills.command.openmenu permission (defaults to op)
• Add ability placeholders
  • `%auraskills_[ability]%` gets the ability level
  • `%auraskills_[ability]_value%` gets the ability value
  • `%auraskills_[ability]_value_2%` gets the secondary value of the ability if there is one
  • Replace `[ability]` with the default English name of an ability in lowercase
  • AuraSkills placeholders will now show in the tab completion of /papi parse

Bug Fixes

• Disable level up chat message for empty string
• Fix Minecraft version parsing error on initial releases like 1.20
• Placed saplings that grow into logs will now give XP
• Fix track option not working in level_progression menu
• Fix LootDropEvent Cause being unknown for some loot tables
• Fix ProtocolLib error with Geyser players
• Fix Terraform crash with AdvancedEnchantments

API Changes

• Add MenuManager API to extend existing and create custom menus
  • Accessible with AuraSkillsBukkit#getMenuManager
  • Can be used to define behavior for custom items and templates in default or custom menus
  • Add NamespacedRegistry#setMenuDirectory for loading external menu files, which are automatically merged with default menu files before being loaded
• Make TerraformBlockBreakEvent accessible in the API

New Features

• Add track and use_track options to sources menu
  • Used to rearrange the source items in any way rather than just a rectangle
• Add custom_model_data option to source item filter meta
  • To use, add it to a custom XP source item filter section for filtering a specific model data

Changes

• Update messages and move identical messages across languages to global.yml

Bug Fixes

• Fix Regions API errors
• Fix hex colors not working in titles and boss bar
• Fix trailing color codes not working in stat symbols
• Fix user skill levels being below start_level when increased
• Fix multiplier command displaying incorrect values
• Fix newlines not working in reward chat messages
• Fix Retrieval detecting tridents as arrows
• Fix skill reset command not using config start_level
• Fix Lightning Blade being activated by thorns
• Fix Alchemist replacing lore and not working for custom effects
• Fix hex colors not working in skill messages
• Fix errors with WorldGuard 7.1

New Features:

• Add xp_format and percent_format boss bar options
• Add options to sources menu to change source template area

Changes:

• Reduce jar size by removing unnecessary libraries
• Update it and ru messages (regen required to get changes)

Bug Fixes:

• Fix mana ability cooldowns not being saved when re-logging
• Fix placeholders not working after PlaceholderAPI reload
• Fix NoSuchMethodError on older versions
• Fix long delay in leaderboard updating on startup
• Fix acf section of messages file not applying
• Fix abilities showing in menus and messages above max_level
• Fix trait max_mana is not loaded error
• Fix mana ability is not loaded error
• Fix formatting not working in menu titles
• Fix stack overflow when opening skills menu with too much XP
• Fix mana command help not showing parameter names

New Features:

• Add formula option to damage_reduction trait
• Add scale_xp_with_health entity source option
  • This is true by default for entity sources with damage trigger
• Add mana.enabled option to more easily disable mana

Bug Fixes:

• Fix skills menu migration breaking
  • If you have already migrated and your skills menu is broken, delete your menus/skills.yml to let it regenerate
• Fix permission-blocked skills increasing stat levels
• Fix entity sources with damage trigger not scaling XP with damage
• Fix Bleed not giving XP on entity death/damage
• Fix disabled traits still showing in stats menu
• Fix skill name commands not working

API Changes:

• Add DamageXpGainEvent

New Features:

• Add excluded_enchantments option for Enchanted Strength in abilities.yml
• Add lore_wrapping_width option in config.yml

Bug Fixes:

• Fix NPCs being unable to attack mobs
• Fix Fleeting not being removed after heal commands
• Fix console error when using Vault without an economy plugin

New Features:

• Add formula support in money rewards

Bug Fixes:

• Fix item modifier NBT conversion breaking items
• Fix action_bar.enabled option not fully working
• Fix message file headers
• Fix rank command error

The 2.0 update is a complete recode of the plugin codebase, overhauling existing systems to make everything more modular and customizable. The most visible change is that the plugin has been renamed to AuraSkills.

There are too many changes to list here, so read the full release notes.

If you are migrating from Beta, you must read the migration guide, not everything will migrate automatically!

As always, please report any issues to the Discord server.

New Features:

• Add support for Minecraft 1.20.2

Bug Fixes:

• Fix bug with mana and stat modifiers

Bug Fixes:

• Ensure all String case calls use ROOT locale to fix config bugs
• Fix level progression menu bugs with non-default items_per_page
• Fix multiplier permissions set to false being functional
• Fix excessive health stat error
• Fix disabled XP multiplier abilities applying in sources menu
• Fix Archery spawner-multiplier option not working
• Fix split slimes and magma cubes not applying spawner-multiplier
• Fix Bleed applying when not unlocked
• Fix XP multiplier abilities apply sometimes when not unlocked
• Fix combined skill leaderboard placeholder not working
• Fix empty sources menu pages with many disabled sources
• Make source item base XP and multiplied XP rounding consistent
• Fix Sorcery giving XP when blocked or disabled
• Fix resethealth command not working with RCON
• Fix MiniMessage hex color support in menus
• Remove automatic loot file updating
• Fix Wise Effect overflow mana when allow-over-max-mana is false

New Features:

• Add support for Minecraft 1.20
• New Foraging Sources:
  • Cherry Log
  • Cherry Leaves
  • Pink Petals
• New Farming Sources:
  • Torchflower
  • Pitcher Plant
• New Fighting/Archery Sources:
  • Camel
  • Sniffer

Changes:

• Add Japanese messages
• Delay update checking and improve logic so new updates aren't marked as outdated
• Remove preemptive player skull loading since it is no longer necessary
• Add disable_health_check option to Sharp Hook (false by default)
  • When true, Sharp Hook will activate regardless of whether the entity was actually damaged
• Update Brazilian Portuguese and French messages

Bug Fixes:

• Fix incorrect items being displayed in the level progression menu at some skill levels
• Fix reset PlayerData not saving when save-blank-profiles was false
• Fix modifiers not being removed when item is put in chest on login
• Fix Farming XP being doubled when breaking crops
• Fix desc_upgrade_value message not applying to mana ability item in abilities menu
• Fix armor stands giving Fighting/Archery XP when damage-based is true
• Fix some PlayerData memory leaks

New Features:

• Add PlaceholderAPI support to menu titles
• Add support for context-specific display names and lore on template items

Changes:

• Update Russian, Polish, and Simplified Chinese messages

Bug Fixes:

• Fix AureliumAPI.addArmorMultiplier adding item multiplier instead of armor
• Fix allow-over-max-mana set to false not working with Wise Effect
• Fix errors with skull_meta.placeholder_uuid when PlaceholderAPI is not on the server

Changes:

• Add scale_base_chance option to Fishing and Excavation loot abilities
  • Option added to Treasure Hunter, Epic Catch, Metal Detector, and Lucky Spades abilities
  • If true, calculating drop chance will multiply ability value by base_chance in loot pool instead of adding

Bug Fixes:

• Fix "Plugin is creating timing - this is deprecated behavior" warning on Paper
• Fix command parameter names not showing in command help

Bug Fixes:

• Revert skill leveler event priority changes to fix placed block XP dupe
• Fix Speed Mine and Treecapitator activating on placed blocks

Changes:

• Rename hooks config option from enable to enabled

Bug Fixes:

• Fix armor modifiers to support 1.19.4 hotbar swap feature
• Fix DecentHolograms name already exists error
• Fix plugin not loading for Java 8-16

New Features:

• Add support for Minecraft 1.19.4
• Add DecentHolograms support
  • Set which hologram plugin to use in the hooks section of config.yml
• Add placeholder %aureliumskills_actionbar_status%
• Add reset-skills-on-death option

Changes:

• Update Polish messages
• Switch to Gradle and reorganize codebase into submodule bukkit
• Remove commons-lang usage from menu library

Bug Fixes:

• Fix dispensers bypassing armor requirements
• Fix transfer command corrupting YAML playerdata
• Increase skill leveler event priority to fix incompatibilities

Changes:

• Add Dutch messages

API Changes:

• The addXp methods in AureliumAPI will no longer grant XP for disabled skills

Bug Fixes:

• Fix mana ability raise sending empty chat messages
• Fix NaN showing on rank item when leaderboard is empty
• Fix error when using boss bar single mode
• Fix region memory leak when worlds are unloaded or deleted
• Fix arrow duplication crash with some protected regions
• Fix Bleed activating when it shouldn't in some protected regions
• Fix error when using Archery damage-based leveler
• Fix Disenchanter grindstone exp exploit

New Features:

• Add PlaceholderAPI support to boss bars
• Add Terraform max_blocks option to change the number of blocks broken
• Add transfer command to migrate player data between accounts
• Add use-suffix option for action and boss bar to toggle level xp suffix formatting
• Add WorldGuard flags for controlling each individual skill's XP gain
  • Flag name is aureliumskils-xp-gain-skillname

Changes:

• No longer send ability chat messages if message string is empty
• Make xp_gained placeholder work in boss bar messages
• Remove unnecessary .0 in numbers with suffix formatting

Bug Fixes:

• Fix memory leak with spawner multiplier option
• Fix mana not regenerating due to Absorption activation not being removed
• Fix potential NPE in SkillBossBar
• Fix blank lines in menu for disabled abilities when using non-English languages

Changes:

• Add support for Minecraft 1.19.3
• Update Simplified Chinese, Russian, and Korean messages

API Changes:

• Add EntityXpGainEvent for modifying XP of Fighting/Archery before multipliers

Bug Fixes:

• Cancel out block loot if Slimefun block
• Prevent re-looting the same blocks over and over

New Features:

• Add values list option for XP requirements instead of an equation
• Add average placeholders to get the average skill level of a player
  • Add %aureliumskills_average%, %aureliumskills_average_int%, and %aureliumskills_average_1% placeholders

Changes:

• Sweeping attacks are now ignored when checking for Lightning Blade activation to reduce chat spam
• Make upgrade description format in abilities menu configurable using 'menus.abilities.desc_upgrade_value' message
• Allow leaderboard placeholders to work without specifying a player

Bug Fixes:

• Fix some newer blocks not working as custom block XP sources
• Fix boss bar memory leak

New Features:

• Add /skills profile skills and /skills profile stats commands to view the skill and stat levels of other players, including offline players
  • Requires aureliumskills.profile permission, op by default

API Changes:

• Add getTotalLevel method to get combined skill level of a player

Bug Fixes:

• Relocate Adventure API to fix warnings with other plugins that use Adventure
• Set new player skill levels to 1 on first join

Bug Fixes:

• Fix NoSuchMethod MiniMessage error on some server versions

New Features:

• Add MiniMessage formatting support to menus

Changes:

• Arrows created by the Piercing ability can no longer be picked up
• Update action bar compatibility for 1.19

Bug Fixes:

• Fix Sharp Hook logic error
• Fix NoSuchMethod error on versions 1.14-1.14.3

New Features:

• Add cooldown_ticks option to First Strike ability
• Add blocked-grindstone-enchants Forging option to stop XP gain from custom curses
• Add aureliumskills-custom-loot WorldGuard flag to toggle custom loot table functionality

Bug Fixes:

• Fix Piercing arrows multiplying by blocking shield
• Fix sources menu showing multiplied XP incorrectly

Bug Fixes:

• Fix missing names in sources menu for 1.19 sources