mcMMO 2.3.002

• Fixed mcMMO failing to start on Spigot 26.3 servers
• Improved performance of repairing items in mcMMO
• Lowered the default Pale_Hanging_Moss XP for Herbalism in experience.yml (See notes)
• Fixed a read error while updating the FlatFile database overwriting mcmmo.users with only the players read before the error (Thanks cyrne1-7208)
• Fixed FlatFile players losing their progress when their data could not be read as they joined
• Fixed FlatFile saves overwriting another player's data when a new player joined with a name that player used to have
• Fixed FlatFile databases not storing a player's new name until something else about them changed
• Fixed SQL databases keeping two players under the same name, or taking a name away from the wrong player when someone changed names
• Fixed a couple of rare issues with SQL players stored before mcMMO kept UUIDs
• Fixed plugins that look up an offline player through mcMMO giving them back a name another player has taken since
• Fixed leaderboards, /mcconvert, and commands such as /inspect and /mcremove mishandling players who lost their name to another player
• Fixed FlatFile database saves reporting success when mcmmo.users could not be written
• Fixed the FlatFile database being rewritten at every startup once more than one player had lost their name to another player
• (API) DatabaseManager.newUser(Player) and newUser(String, UUID) on the FlatFile database now return an unloaded profile when mcmmo.users cannot be read or already has a row with that UUID
• (API) DatabaseManager.saveUser on the FlatFile database now finds a player's row by UUID
• (API) DatabaseManager.saveUser and newUser(String, UUID) now require a UUID on the FlatFile and SQL databases
• (API) Added UsernamePlaceholder, the name given to players who lost their name to another player, which DatabaseManager lookups by name now ignore
• (API) DatabaseManager.loadPlayerProfile(OfflinePlayer) now replaces the stored name with the player's only while they are online
• (API) SQLDatabaseManager.loadPlayerProfile(String) and loadPlayerProfile(UUID, String) now give the profile the name stored for the player, as FlatFile does, and loadPlayerProfile(UUID, String) no longer changes stored names
• (API) Added DatabaseManager.getStoredUsersWithUUIDs and the PlayerNameAndUUID record, which tell apart players who share a stored name
• (API) Deprecated FlatFileDatabaseManager.LEGACY_INVALID_OLD_USERNAME, use UsernamePlaceholder instead
• (Codebase) Crossbow ricochet reflection no longer modifies the arrow velocity and block face normal vectors it is given (Thanks cyrne1-7208)

NOTES:
To get the lower Pale_Hanging_Moss XP, set 'Experience_Values.Herbalism.Pale_Hanging_Moss' to 1 in experience.yml, or delete experience.yml to generate a new one.

• Added compatibility for new blocks and items from Minecraft 26.3 to mcMMO
• Added poplar doors, trapdoors, fences, fence gates, buttons, pressure plates, signs, hanging signs, shelves, and straw beds to the ability/tool blacklists
• Added poplar leaves and shelf mushrooms to the blocks Tree Feller clears as part of a tree
• Changed Super Breaker to treat concrete, concrete stairs, and concrete slabs like other pickaxe-target blocks
• Improved performance of locale message color formatting and skill name matching (Thanks wling-art)
• Fixed endermen flagged by the 'ExploitFix.EndermanEndermiteFarms' countermeasure giving full combat XP (See notes)
• Fixed Graceful Roll using the normal Roll damage threshold instead of its own (See notes)
• Fixed a rare error when multiple players logged in at the same time after a server restart (Thanks Warriorrrr)
• Fixed a rare error when structures grew on Folia servers (Thanks Warriorrrr)
• Fixed Rupture never playing its bleed sound, the BLEED entry in sounds.yml works again
• Fixed the 'ItemMaterialCategory' field in repair.vanilla.yml and salvage.vanilla.yml being ignored (See notes)
• Fixed next level XP requirements overflowing at extreme skill levels or dropping to zero and below with zero or negative XP formula values in experience.yml
• Fixed the ExperienceAPI methods setXPOffline, setLevelOffline, and removeXPOffline never saving their changes
• Fixed leftover banked XP being lost when a plugin cancelled a level up event
• Fixed rare errors and stale text in messages fetched while /mcreloadlocale was running
• Added the missing 'Experience_Formula.Player_Tamed.Multiplier' entry to the default experience.yml (See notes)
• Added Woodcutting XP values for Poplar_Log, Stripped_Poplar_Log, Poplar_Wood, and Stripped_Poplar_Wood to experience.yml
• Added Herbalism XP values for Red_Shrub and Shelf_Mushroom to experience.yml
• Added Bonus_Drops.Woodcutting.Poplar_Log and Bonus_Drops.Woodcutting.Poplar_Wood to config.yml
• Added Bonus_Drops.Herbalism.Red_Shrub and Bonus_Drops.Herbalism.Shelf_Mushroom to config.yml
• Lowered the default copper XP values for Mining and Smelting in experience.yml (See notes)
• Changed the default potion names in potions.yml from 'Potion Of' to 'Potion of' to match vanilla (Thanks rasmus123d) (See notes)
• Removed the unused 'Skills.Swords.SerratedStrikes.BleedTicks' and 'Skills.Swords.Rupture.Explosion_Damage' settings from advanced.yml (See notes)
• Removed the unused 'Skills.Mining.BlastMining.DebrisReduction' and 'Skills.Mining.BlastMining.DropMultiplier' settings from advanced.yml (See notes)
• Removed the unused 'Options.Chunklets' and 'Options.ConversionRate' settings from hidden.yml
• Removed the unused firework and Flux entries under 'Particles' in config.yml (See notes)
• Removed the inert Tree Feller Rank_2 through Rank_5 entries and the unused Fishing Mastery block from skillranks.yml (See notes)
• Removed the unused DEFLECT_ARROWS, ABILITY_ACTIVATED_BERSERK, and TIRED entries from sounds.yml
• Updated Simplified Chinese (zh_CN) locale with translations for the new /xprate, level-up sound, and Scrap Collector messages, plus revised existing entries (Thanks TAHAamaBOT)
• Removed the unused 'Fishing.Exhausting' locale entry
• (API) Deprecated the unused Blast Mining getDebrisReduction, getDropMultiplier, and getBlastMiningRankLevel methods in AdvancedConfig and MiningManager
• (API) Fixed Permissions.tridentsLimitBreak and Permissions.macesLimitBreak checking the wrong permission nodes
• (Codebase) Removed the AdvancedConfig getSerratedStrikesTicks and getRuptureExplosionDamage methods along with their settings
• (Codebase) Removed the TIRED, ABILITY_ACTIVATED_BERSERK, and DEFLECT_ARROWS constants from the SoundType enum

NOTES:

• experience.yml and config.yml auto-update on startup, so the new Woodcutting and Herbalism XP values and Bonus_Drops entries are added to existing configs automatically.
• Copper was giving more XP than rarer ores like Iron, these values were set when copper first came out and never got looked at again. For Mining Copper_Ore is now 500 (was 1400) and Deepslate_Copper_Ore is now 750 (was 1900). For Smelting Raw_Copper and Copper_Ore are now 15 (was 75), Deepslate_Copper_Ore is now 25 (was 100), and Copper_Nugget is now 15 (was 85).
• You will have to adjust experience.yml to get the balance changes, or delete it to generate a new one.
• The potion rename is cosmetic and only applies to a freshly generated potions.yml, existing files keep the old names unless you edit them. Brewing still works either way since recipes are matched by effect and not by name.
• Endermen marked by the 'ExploitFix.EndermanEndermiteFarms' countermeasure are meant to give no combat XP, this protection works again. Servers that want enderman and endermite farms to give XP can turn the setting off in experience.yml.
• Graceful Roll now negates up to 14 damage as set by 'Skills.Acrobatics.GracefulRoll.DamageThreshold' in advanced.yml, it previously used the normal Roll threshold of 7.
• The default repair.vanilla.yml labeled the material field 'ItemMaterialCategory' while mcMMO was looking for 'MaterialType' instead, so the value was ignored and guessed from the item instead. mcMMO now reads 'ItemMaterialCategory' and falls back to 'MaterialType' if it isn't there, if neither is set the type is still guessed from the item like before. Custom repair and salvage configs do not need updating. The material type only decides which per-material repair or salvage permission applies, and the guess was only wrong for SHIELD (now WOOD) and WARPED_FUNGUS_ON_A_STICK (now STRING).
• The Player_Tamed multiplier has existed since 2.1.148 but was never written to the default experience.yml, so nobody could see it. Combat XP from mobs tamed by a player is multiplied by this value, it defaults to 0.0 which is what mcMMO has been using all along, so tamed mobs still give no XP unless you change it.
• The settings removed from config.yml, advanced.yml, hidden.yml, skillranks.yml, and sounds.yml had no effect, gameplay is unchanged. Existing config files do not need updating, leftover entries are ignored. Blast Mining bonus drops and debris have not used the removed settings for a long time, and Tree Feller has a single rank, the extra rank entries did nothing. The removed Particles entries are Ability_Activation, Ability_Deactivation, LargeFireworks, Flux, LevelUp_Enabled, and LevelUp_Tier, none of which triggered anything, the working particle toggles are untouched.

• Added support for running commands when players reach chosen skill levels or power levels (See notes)
• Added scoreboard support for Folia servers (Thanks albert4719) (See notes)
• Added PlaceholderAPI leaderboard rank-position placeholders for all skills except child skills (Salvage, Smelting) and for overall power level (See notes)
• Added PlaceholderAPI skill name placeholders %mcmmo_skillname_<skill>% and %mcmmo_skillname_header_<skill>% (See notes)
• Improved SQL leaderboard query performance on large databases (See notes)
• Added automatic per-skill leaderboard indexes for SQL databases (See notes)
• Changed SQL leaderboard ordering for players with identical levels (See notes)
• Added /mclevelupsound command for players to toggle the level-up sound (See notes)
• Added decimal XP rate support to /xprate, rates like 1.5 now work
• Added per-skill XP rates to /xprate, for example /xprate mining 5.3 (See notes)
• Added a no-argument /xprate (also usable as /xprate show) that shows the current XP rates and how long each has been active (See notes)
• Changed /xprate to no longer require the true/false event argument, it defaults to true (See notes)
• Changed /xprate to reject rates below the configured XP rate (See notes)
• Added a console warning when a chunk's placed-block data cannot be read, instead of resetting it silently
• Changed Cripple's default sound to the mace smash ground sound (See notes)
• Changed XP rate event admin notifications to show the command sender as a hoverable @name with their UUID on hover in chat, and as name (UUID) in the console, instead of appending the UUID to their name
• Changed skill name tab completion to suggest lowercase names in commands like /mctop, /skillreset, and /mmoxpbar
• Changed messages that include a skill name to use the nicely capitalized 'Overhaul.Name' locale entries instead of the all-caps 'SkillName' entries (See notes)
• Changed fishing anti-exploit checks to run before other plugins see the catch (Thanks FireML) (See notes)
• Changed skill rank unlock notifications to only play the unlock sound once when many unlocks arrive back to back
• Changed skill rank unlock notifications to show one at a time at a steady pace per player (See notes)
• Changed salvage anvils to tell players which Salvage requirements they are missing when clicking with a salvageable item before Scrap Collector is unlocked
• Changed Hylian Luck to no longer send a chat message when a treasure is found
• Improved performance when gaining XP, rolling skill chances, checking skill ranks, and reading config settings and permissions
• Improved performance of combat processing, block and placed-block handling, and many other event handlers including furnaces, fishing, inventories, pets, and commands
• Fixed an exploit where breaking and quickly replacing multi-block plants granted Herbalism XP without the plants breaking (See notes)
• Fixed cactus and chorus plants only granting Herbalism XP for the block that was hit (See notes)
• Fixed Berserk reducing damage instead of boosting it on Paper 26.1.2+ (See notes)
• Fixed Disarm, Rupture, Cripple, Momentum, Critical Strikes, Armor Impact, and Greater Impact activating far less often than intended on Paper 26.1.2+ (See notes)
• Fixed Skull Splitter dealing far less AoE damage than intended on Paper 26.1.2+ (See notes)
• Fixed the 'mcmmo.perks.xp.25percentboost' permission and its per-skill child nodes not being registered (See notes)
• Fixed Maces Cripple playing an extra anvil break sound that could not be disabled in sounds.yml (See notes)
• Fixed Super Breaker and Tree Feller mishandling durability on items with a custom max_damage component (See notes)
• Fixed Tree Feller ignoring durability damage changes made by other plugins via PlayerItemDamageEvent
• Fixed Acrobatics Dodge exploit prevention never limiting Dodge XP from a single mob (See notes)
• Fixed 'ExploitFix.Combat.XPCeiling.Damage_Limit' in experience.yml being ignored (See notes)
• Fixed Salvage and Repair confirmations being able to act on a different item than the one prompted (See notes)
• Fixed armor sometimes being equipped instead of salvaged when right-clicking a salvage anvil
• Fixed scoreboards for Salvage and Smelting not updating until the skill command was used again
• Fixed power level tags being able to get stuck showing 0 under player names (See notes)
• Fixed the stats scoreboard including skills hidden by missing permissions in its power level
• Fixed localized skill commands being blocked by command whitelist plugins (See notes)
• Fixed 'Database_Purging.Old_User_Cutoff' never purging inactive users (See notes)
• Fixed purging powerless users removing comment lines from the flatfile database
• Fixed inspect scoreboards not refreshing when the inspected player levels up
• Fixed the Leaf Blower and Catalysis guides in the en_US locale showing wrong unlock levels
• Fixed placed-block tracking data being lost or corrupted when a world's height limits shrink (See notes)
• Fixed skill success chances modified by other plugins being 100 times smaller than intended (See notes)
• Fixed Disarm, Critical Strikes, Armor Impact, and Greater Impact ignoring attack strength for players without the Lucky perk (See notes)
• Fixed cancelled level change events corrupting skill levels changed with /mmoedit (See notes)
• Fixed an error when another plugin cancelled a level change for a player whose data was not loaded (See notes)
• Fixed REGENERATION potion entries in potions.yml, treasures.yml, and fishing_treasures.yml failing to match their potion type (See notes)
• Fixed riders of spawner, egg, nether portal, and bred mobs not being tagged for reduced combat XP
• Fixed splash potions not applying saturation when another custom effect is listed before it
• Fixed splash saturation potions not keeping their particle and icon visibility settings
• Fixed Alchemy not recognizing potions whose custom effects are stored in a different order than in potions.yml
• Fixed shift-right-clicking ingredients into brewing stands overstacking a full ingredient slot and refusing transfers from full stacks
• Fixed the early game XP boost being able to award XP inside WorldGuard regions that deny mcMMO XP
• Fixed a small memory leak from fishing hand tracking when players log out
• Fixed an error when another plugin tames an animal with a non-player owner
• Fixed an error when a pet owned by a non-player deals damage
• Fixed an error when a non-player entity clicks or drags in a furnace or brewing stand inventory
• Fixed an error when another plugin fires a fish catch carrying a non-item entity
• Fixed an error when adding levels to Salvage or Smelting (See notes)
• Fixed an error when another plugin reads raw skill XP for Salvage or Smelting
• Fixed the -s flag on /addxp, /addlevels, and /mmoedit not silencing the confirmation sent to the command sender (See notes)
• Fixed 'Invalid mcMMO skill' console spam when other plugins check skill names through the API (See notes)
• Fixed an error when reading XP requirements for offline players while 'Experience_Formula.Cumulative_Curve' is enabled
• Fixed a memory leak from Call of the Wild summons that died before their duration ended
• Fixed an error when players below 11 HP used a Chimaera Wing underground
• Fixed custom sound IDs in sounds.yml causing errors on Spigot 1.21.3 and newer (See notes)
• Fixed the unsupported-version scoreboard warning printing gibberish instead of the Minecraft version
• Fixed mcMMO command tab-completion never suggesting player names to the console
• Fixed /mmoedit, /addxp, and /addlevels suggesting skill names for the value argument when a skill or 'all' was already given
• Fixed Green Terra and Green Thumb not converting dirt paths to grass
• Fixed Holy Hound activating at Environmentally Aware's unlock level instead of its own
• Fixed Super Breaker not activating on copper blocks, cut copper, and their slab and stair variants
• Fixed twisting vines not being handled as multi-block plants by Herbalism
• Fixed Herbalism double drops not working on beetroots
• Fixed using bone meal on a placed nether wart block clearing its placed-block tracking
• Fixed mobs losing their custom names when hit while 'Mob_Healthbar.Display_Type' is DISABLED
• Fixed player data changes made while a save was in progress sometimes being lost
• Fixed player data tracking for shutdown saves not being thread-safe on Folia
• Fixed console messages mentioning '[D] ' mid-message being hidden when Verbose_Logging is off
• Fixed skill chance and duration display formatting not being thread-safe on Folia
• Fixed /mmoxpbar disable sending a chat message for every skill instead of just the summary
• Fixed corrupt placed-block region files being kept locked after a failed load and producing errors that did not name the file
• Fixed a single unwritable chunk being able to abort the remaining placed-block saves during shutdown and chunk unload
• Fixed skill name arguments in commands not accepting English skill names on servers using a non-English locale
• Fixed localized skill commands rewriting command arguments that repeat the skill name
• Fixed players being fireproof against other players while their mcMMO data was still loading
• Fixed several event handlers modifying fishing, block damage, interaction, and inventory events at MONITOR priority (See notes)
• Fixed the Shake ability's McMMOPlayerShakeEvent never being fired to other plugins
• Fixed /inspect not checking permissions when used on offline players (See notes)
• Fixed a thread-safety issue that could cause incorrect FlatFile leaderboard results
• Fixed renamed players' leftover database rows showing up in /mctop and being counted by /mcrank on SQL databases (See notes)
• Fixed FlatFile leaderboards not retrying a failed rebuild until the next refresh interval
• Fixed the outdated-server startup warning naming Minecraft 1.20.4 instead of the required 1.20.5
• Fixed an error when /mmodebug was used before the player's data finished loading (Thanks Warriorrrr)
• Added 'Feedback.ActionBarNotifications.SubSkillUnlocked.SendToActionBar' to advanced.yml, an opt-in to show skill rank unlock messages on the action bar (See notes)
• Added new config file level_up_commands.yml to set up level up commands (See notes)
• Added 'ExploitFix.AcrobaticsDodgeXpFarming' to experience.yml (See notes)
• Added 'Skills.Mining.BlastMining.RemoteDetonationDistance' to advanced.yml (See notes)
• Added 'General.PlaceholderAPI.Leaderboards.Max_Tracked_Rank' to config.yml
• Added 'General.Leaderboards.Refresh_Interval_Seconds.SQL' to config.yml
• Added 'General.Leaderboards.Refresh_Interval_Seconds.FlatFile' to config.yml
• Added 'mcmmo.commands.mclevelupsound' permission node
• Added 'mcmmo.commands.xprate.show' permission node
• Removed the unused Leaf Blower Rank_2 and Rank_3 entries from skillranks.yml
• Removed the /mmocompat command, it has been non-functional for years
• Removed the 'Scoreboard.Types.Skill.LevelUp_Board' and 'LevelUp_Time' settings from config.yml, they had no effect (See notes)
• Added locale entries 'Commands.xprate.current', 'Commands.xprate.invalid', 'Commands.LevelUpSound.On', 'Commands.LevelUpSound.Off', and 'Commands.Description.mclevelupsound'
• Added locale entries 'Commands.xprate.none', 'Commands.xprate.current.skill', 'Commands.xprate.tooLow', 'Commands.xprate.duration', 'Commands.xprate.skill.globalApplies', 'Commands.xprate.skill.cleared', 'Commands.Event.XP.Skill', and 'XPRate.Event.Skill' for the /xprate changes
• Updated locale entries 'Commands.Event.XP' and 'XPRate.Event' to name the global XP rate
• Added locale entries 'Notifications.Admin.XPRate.Skill.Start.Self' and 'Notifications.Admin.XPRate.Skill.Start.Others'
• Added locale entries 'Notifications.Admin.Sender.Display', 'Notifications.Admin.Sender.UUID.Hover', and 'Notifications.Admin.Sender.UUID.Console' for the admin notification sender identity
• Added locale entries 'Salvage.Skills.ScrapCollector.Locked' and 'Salvage.Skills.ScrapCollector.LockedAndItem' for the salvage anvil requirement messages
• Updated locale entry 'Commands.Description.xprate' for the /xprate changes
• Removed unused locale entries 'Commands.xprate.proper.0', 'Commands.xprate.proper.1', 'Commands.xprate.proper.2', 'Commands.xprate.modified', 'Commands.xprate.over', 'Commands.xprate.started.0', and 'Commands.xprate.started.1'
• Removed the now-unused locale entry 'Herbalism.HylianLuck'
• (API) Added LevelUpCommandAPI so other plugins can register level up commands or their own callbacks and unregister them later (See notes)
• (API) Deprecated RankUtils.resetUnlockDelayTimer, unlock notification pacing is now handled automatically per player
• (API) SkillTools.getLocalizedSkillName now returns the message-friendly 'Overhaul.Name' locale value instead of the all-caps 'SkillName' value
• (API) Added SkillTools.getHeaderBannerSkillName for the all-caps 'SkillName' locale value used by headers and skill command matching
• (API) Added XPRATE_MODIFY_SKILL to SensitiveCommandType for per-skill XP rate admin notifications
• (API) McMMOScoreboardObjectiveEvent is only fired on non-Folia servers (See notes)
• (API) Skill rank unlock notifications now fire McMMOPlayerNotificationEvent like other notification types
• (API) McMMOPlayerLevelDownEvent fired by /mmoedit now reports the number of levels lost instead of the new absolute level
• (API) ProbabilityUtil.percent is deprecated and no longer used internally
• (API) EventUtils.simulateBlockBreak overloads without a FakeBlockBreakEventType are deprecated in favor of the variant that takes one
• (API) The no-op ScoreboardManager.enablePlayerSkillLevelUpScoreboard is deprecated for removal
• (API) mcMMO now prevents other plugins from modifying its internal material maps
• (API) Deprecated the unused NMSConstants, NMSVersion, FixSpellingNetheriteUtil, SkillActivationType, and ObjectiveType classes for removal
• (API) Deprecated DelayedHerbalismXPCheckTask and HerbalismManager#awardXPForBlockSnapshots for removal
• (API) Deprecated unused public utility methods and fields
• (API) Deprecated the misspelled PlayerProfile#getChimaerWingDATS in favor of getChimaeraWingDATS
• (API) McMMOPlayer#addXp and McMMOPlayer#addLevels now fire the XP and level change events and process level ups instead of writing raw values (See notes)
• (API) Added DatabaseManager#readLeaderboardSnapshot for reading every leaderboard scope in one call
• (Codebase) Added scoreboard-library 2.8.0 as a shaded dependency for the packet-based scoreboard implementation
• (Codebase) Added ViaVersion to plugin.yml softdepend
• (Codebase) Large internal cleanup and refactor of the listener and utility classes

NOTES:
-- Combat abilities on Paper 26.1.2+ --
Paper 26.1.2 changed attack cooldown timing during melee hits, which silently weakened these effects to a fraction of their configured damage and activation rates. Version 2.2.053 fixed most damage bonuses; this build fixes the remaining effects. No config changes required.
The activation chance of Disarm, Critical Strikes, Armor Impact, and Greater Impact scales with the vanilla attack cooldown, but that scaling was only being applied to players with the Lucky perk. Weak attacks now lower the odds for everyone; this affects all server software, not just Paper.

(API) UnarmedManager#berserkDamage/disarmCheck, AxesManager#criticalHit/impactCheck/greaterImpact/skullSplitterCheck, SwordsManager#processRupture/serratedStrikes, MacesManager#processCripple, SpearsManager#potentiallyApplyMomentum, CombatUtils#applyAbilityAoE, and McMMOPlayer#getAttackStrength are deprecated in favor of overloads that take an attack strength scale.

-- Skill RNG --
Only affects servers running plugins that adjust mcMMO skill success chances through the API; adjusted chances were previously reduced to roughly one hundredth of their intended value, making affected skills almost never succeed.

-- Silent flag for XP commands --
/addxp, /addlevels, and /mmoedit accept -s as the last argument to run silently; the flag now also silences the confirmation echoed back to the command sender. Plugins that award XP by dispatching these commands from the console should append -s to keep the server log quiet.

-- Invalid skill name messages --
Skill name lookups that do not match any skill (usually other plugins validating names through the API, but also command typos) no longer print an 'Invalid mcMMO skill' warning to the console. The message is now debug output, visible by enabling 'General.Verbose_Logging' in config.yml.

-- Potions --
REGENERATION potion entries and their long/strong variants in potions.yml, treasures.yml, and fishing_treasures.yml could fail to load. Old names like REGEN still convert correctly, no config changes are needed.

-- Scoreboards and power level tags --
Scoreboards on Folia (and Folia forks like Canvas) now use a packet-based implementation, since the Bukkit scoreboard API is not safe to use there. Paper and Spigot servers keep the existing Bukkit scoreboard implementation and are unaffected.
If a Folia server runs a newer Minecraft version than this mcMMO build supports for packet scoreboards (currently the 26.2.x line), scoreboards are disabled with a startup warning until mcMMO updates.
(API) The packet-based implementation still fires McMMOScoreboardMakeboardEvent and McMMOScoreboardRevertEvent, but there is no Bukkit Objective on Folia so McMMOScoreboardObjectiveEvent is not fired there.
Power level tags could get stuck showing 0 for players whose data was still loading, and older builds with 'Power_Level_Tags' enabled could leave stale power level displays saved in world data; leftovers are now cleaned up automatically on startup. On Minecraft 26.1 clients the power level can still render on holograms and pets due to a client bug that Mojang fixed in 26.2.

-- Salvage and Repair --
The Salvage/Repair confirm click now has to be made with the same item that triggered the prompt; if the held item changes during the confirmation window you get a new prompt instead. While a confirmation is pending the prompted item can't be used, which stops vanilla armor quick-swap from equipping or swapping armor mid-confirmation.

-- XP and exploit fixes --
Multi-block plants (bamboo, sugar cane, kelp, cactus, chorus trees, and hanging vines) now grant XP for the rest of the plant only after those blocks have actually broken, so breaking a segment and instantly replacing it no longer pays XP for blocks that never broke. Cactus and chorus trees also now grant XP for the whole plant instead of just the block that was hit. No config changes are needed.
The mcmmo.perks.xp.25percentboost permission family now behaves like the 10, 50, and 150 percent variants; previously only mcmmo.perks.xp.25percentboost.all had any effect.
Dodge XP farming prevention now has its own 'ExploitFix.AcrobaticsDodgeXpFarming' setting in experience.yml, enabled by default; existing config files do not need updating. A single mob stops handing out Dodge XP after a handful of dodges and recovers after about a minute without being dodged. 'ExploitFix.Acrobatics' continues to control the Roll anti-exploit checks.
'ExploitFix.Combat.XPCeiling.Damage_Limit' in experience.yml now works; the combat XP damage ceiling was previously always 100 no matter what the config said. Customized values take effect after updating, no config changes are needed.
Fishing's overfishing and spam-fishing checks now run before other plugins process the catch, so fishing plugins (for example EvenMoreFish) can tell when mcMMO denies a catch instead of having their custom catches deleted after the fact. Denied catches still pay no mcMMO rewards. No config changes are needed.

-- Placed-block tracking --
If a world's build height limits were ever reduced (for example after removing a data pack that raised them), loading that world's placed-block data could fail or mark the wrong blocks as player-placed. Markers inside the new limits are kept at their correct positions; only blocks outside the new limits are forgotten.

-- Commands --
Localized skill commands (for example /faustkampf for /unarmed on a German locale) are now visible to command whitelist and command blocking plugins exactly as the player typed them. If you use such a plugin, whitelist the localized command name.
Using /inspect on offline players now requires the 'mcmmo.commands.inspect.far' permission, the same node that gates inspecting far away players. Grant that node if non-op players on your server relied on inspecting offline players.
The /mclevelupsound toggle (alias /levelupsound) only affects the level-up sound, not level-up messages, and lasts until logout like /mcnotify.
/xprate without arguments shows the current XP rate. Players get this through the new 'mcmmo.commands.xprate.show' node, granted by default since the rate is already broadcast at event start and shown on join.

-- Skill names in messages --
Messages that mention a skill name (level up broadcasts, XP command feedback, /mcrank and /mctop, ability cooldown notices, and similar) now use the nicely capitalized names from the 'Overhaul.Name' locale entries (like Mining) instead of the all-caps 'SkillName' entries (like MINING). The stylized headers keep the all-caps names: skill command screens, guide headers, and scoreboards. If your server renames skills by overriding '<Skill>.SkillName' in a locale override file, also override the matching 'Overhaul.Name.<Skill>' entry so messages pick up the rename.
New PlaceholderAPI placeholders expose both styles for every skill: %mcmmo_skillname_<skill>% returns the message name (like Mining) and %mcmmo_skillname_header_<skill>% returns the header name (like MINING). Both follow the server locale and any overrides.

-- XP rate events --
/xprate now accepts a skill name: /xprate mining 5.3 boosts only Mining, and 'all' targets the global rate like before. Child skills (Salvage, Smelting) have no XP of their own and are rejected. The true/false event argument is optional and defaults to true.
Changes made with false never start or end an event. They are still announced, but without the event banner, and if a higher global event rate keeps applying to that skill the broadcast says so.
Per-skill rates and the global /xprate rate do not stack with each other; whichever is higher applies. Multipliers from experience.yml and XP perks still apply on top as usual.
Rates below the configured rate in experience.yml are rejected to prevent accidentally lowering XP. /xprate reset restores the configured rates and clears every per-skill rate at once.
Setting a global rate also clears any per-skill rates at or below it, since the higher rate always wins; the sender is told which rates were cleared.
/xprate with no arguments (or /xprate show) reports when no XP rate event is active, and otherwise lists the global and per-skill rates with how long each has been active.
During an event, joining players are told about active per-skill rates alongside the global rate.

-- Level up commands --
Level up commands are configured in the new level_up_commands.yml file; each entry lists the commands to run plus a trigger, either skills with levels or power_levels, and an optional run_as of CONSOLE (default) or PLAYER. The shipped example entries are disabled by default.
Level up commands support placeholders: {@player}, {@skill}, {@level}, {@power_level}, and current-level placeholders like {@mining_level}. When PlaceholderAPI is installed, its placeholders are also resolved against the player who leveled up. Commands run once per milestone reached, even when several levels are gained at once.
(API) LevelUpCommandAPI registrations return an id that can be used to unregister them later; registrations made by other plugins survive mcMMO config reloads.

-- Sounds and abilities --
Skill rank unlock notifications now stream out one at a time every 0.25 seconds per player instead of batches spaced 5 seconds apart. Every unlock is still notified; a mass change like /mmoedit all delivers all of its notifications within seconds.
Cripple now plays a single sound, the mace smash ground sound by default instead of an anvil sound; adjust or disable it with the CRIPPLE entry in sounds.yml. The mace sound only exists on Minecraft 1.21 and newer, the same versions maces exist on.
Sounds that can't be resolved (for example a typo in a CustomSoundId) now log a single warning and are skipped; on Spigot 1.21.3 and newer they previously caused an error every time the sound tried to play.
Ability durability loss now always uses the item's own maximum durability, so items with a custom max_damage component (from data packs or item plugins) no longer break super abilities or appear to restore durability.

-- Event handling --
The fishing rewards handler, the interaction handler that activates abilities and consumes items, the Berserk insta-break on block damage, and the inventory click and open handlers that strip ability buffs now run at HIGHEST priority instead of MONITOR, so plugins reading these events at MONITOR reliably see mcMMO's changes. If another plugin also modifies these events at HIGHEST priority, its ordering relative to mcMMO may have changed; please report any new conflicts with other plugins after updating.

-- Config --
Skill rank unlock messages can be shown on the action bar by setting 'Feedback.ActionBarNotifications.SubSkillUnlocked.SendToActionBar' to true in advanced.yml, with 'SendCopyOfMessageToChat' deciding whether the chat still gets a copy. Nothing changes unless you enable it. The section uses 'SendToActionBar' instead of 'Enabled' because older configs already contain a leftover 'Enabled: true'; that key is ignored so updating cannot silently change behavior. advanced.yml auto-updates on startup.
'Skills.Mining.BlastMining.RemoteDetonationDistance' in advanced.yml controls how far away Blast Mining can remotely detonate TNT. The default of 100 matches the old fixed distance; advanced.yml auto-updates on startup.
The removed 'Scoreboard.Types.Skill.LevelUp_Board' and 'LevelUp_Time' settings had been broken for years and did nothing regardless of their values. Leftover keys in existing config files are ignored and can be deleted; nothing visible changes.

-- Database --
'Database_Purging.Old_User_Cutoff' now actually removes inactive users on both FlatFile and SQL databases. If you have purging enabled, expect the first purge after updating to remove old users that should have been purged before. Users whose last login can't be determined are kept.

-- PlaceholderAPI leaderboard rank-position placeholders --
New placeholders request leaderboard positions directly:
    %mcmmo_mctop_<skill>:<position>%      -> skill level at that rank (e.g. %mcmmo_mctop_mining:1%)
    %mcmmo_mctop_name_<skill>:<position>% -> player name at that rank (e.g. %mcmmo_mctop_name_mining:34%)
For overall power level use 'overall', 'all', or 'powerlevel' as the skill name; all three map to the same data (e.g. %mcmmo_mctop_powerlevel:25%).
'General.PlaceholderAPI.Leaderboards.Max_Tracked_Rank' controls the highest supported position. Default is 100, clamped between 10 and 1000 since higher positions cost memory and database reads on every cache refresh.
Positions above that value, invalid positions (blank, non-numeric, 0, negative), and positions no player currently holds all return an empty result.
'General.Leaderboards.Refresh_Interval_Seconds.FlatFile' (default 600, matching previous behavior) controls how often FlatFile leaderboards are rebuilt and affects /mctop, /mcrank, and the placeholders.
'General.Leaderboards.Refresh_Interval_Seconds.SQL' (default 60) only governs the placeholder cache; /mctop and /mcrank on SQL always query live data.
Both intervals have a 60 second minimum. Placeholder requests are served from cache between refreshes.
Each refresh reads every leaderboard in one pass; on FlatFile that is a single scan of the user file. Refreshes pause while no leaderboard placeholder is in use and resume on the next request, so servers that never use them do no recurring cache work.

-- SQL leaderboard performance --
Leaderboard queries on SQL databases are now much faster on servers with large player tables. mcMMO automatically adds per-skill indexes to the skills table on startup when they are missing; on very large databases the first startup after updating may take longer while they build. This runs once, is safe to re-run, and mcMMO starts normally even if an index cannot be added. Fresh installs include the indexes, skill columns added by future updates get theirs automatically, and an existing idx_<skill> index that covers a different column is assumed deliberate and left alone.
Renamed players leave a database row under an internal placeholder name; on SQL these rows could appear in /mctop and the leaderboard placeholders and were counted in /mcrank positions. They are now excluded from all of them.
Players with identical levels on SQL databases are now ordered newest-registered-first in /mctop, /mcrank, and the leaderboard placeholders (previously alphabetical by name), and /mctop and /mcrank agree on tie positions. FlatFile databases still order ties alphabetically.

-- Child skill levels through the API --
Adding levels to Salvage or Smelting through the mcMMO API caused an error for online players. Child skills have no levels of their own, so added levels now split evenly across the skill's parent skills, matching how child skill XP and the offline API variants already behaved.

• Added compatibility for new blocks and items from Chaos Cubed (Minecraft 26.2) to mcMMO
• Fixed party/admin chat allowing players to use color codes without the 'mcmmo.chat.colors' permission
• Fixed reconnecting sometimes clearing a player's diminished XP returns early
• Fixed Folia thread-check errors when ranged attacks triggered Taming wolf assist targeting
• Fixed right-clicking to strip wood also readying the axe for Tree Feller
• Fixed Super Breaker not activating on deepslate bricks and deepslate tiles
• Fixed invalid or malformed treasure entries being able to disable mcMMO on startup (See notes)
• Fixed potion treasures with Extended or Upgraded potion data giving the wrong potion in treasures.yml and fishing_treasures.yml
• Fixed fishing treasures with an unrecognized Rarity being silently added to the COMMON reward pool (See notes)
• Added a Combat XP multiplier for the Sulfur Cube to experience.yml
• Added a Herbalism XP value for Golden Dandelion to experience.yml
• Added the 'Bounce' music disc as a very rare Excavation treasure to treasures.yml (See notes)
• Added Mining XP values for all new Cinnabar block variants to experience.yml (See notes)
• Added Mining XP values for all new Sulfur block variants to experience.yml (See notes)
• Added Mining XP values for Potent Sulfur and Sulfur Spike to experience.yml
• Changed treasure entries using potion types that don't exist in the server's Minecraft version to be skipped quietly like other incompatible treasures
• Improved misconfigured treasure entry logging to use warnings that name the exact problem and config key
• (Codebase) Reworked treasure config loading (TreasureConfig, FishingTreasureConfig) to classify each entry as loaded, incompatible, or invalid with a per-section load summary
• (Codebase) Consolidated duplicated treasure config loading logic from TreasureConfig and FishingTreasureConfig into a shared TreasureEntryLoader helper
• (Codebase) Added unit tests for treasure entry classification and fishing drop-rate validation

NOTES:

• experience.yml auto-updates on startup, so the new Mining, Combat, and Herbalism values are added to existing configs automatically.
• The new Mining XP values cover the full Cinnabar and Sulfur block sets: the base blocks, their polished, brick, and chiseled versions, and the stairs, slab, and wall variants of each.
• treasures.yml does not auto-update; to get the 'Bounce' Excavation treasure on an existing server, add the MUSIC_DISC_BOUNCE entry to treasures.yml manually or delete the file to regenerate it (a copy of the default is saved to defaults/treasures.yml).
• Treasure configs (treasures.yml, fishing_treasures.yml) no longer fail startup on a bad entry. Entries whose material or potion type does not exist in your Minecraft version are skipped quietly. Misconfigured entries are logged with their key so you can find and fix them, and each section reports how many treasures loaded.
• Fishing treasures with an unrecognized Rarity are now skipped with a warning naming the entry so you can fix it; previously they were silently treated as COMMON. If a custom fishing treasure stops dropping after updating, check your startup log for the warning.

• mcMMO now backs up region data on Spigot and older Paper builds to help prevent this.
• mcMMO will also migrate backed-up region data when present and when server software is using the Paper 26.1.2+ world layout (See notes)
• Added 'General.RegionDataMigrationBackups.Enabled' config option to config.yml, which can disabled region data backups for anyone who doesn't plan on updating to newer Paper builds or using Paper
• Fixed entities retaining their healthbar display name after chunk unload (Thanks Warriorrrr)
• Fixed traveling block metadata leaking on Folia servers (Thanks Warriorrrr)
• Fixed Magic Hunter (Fishing) enchantment conflict check not accounting for enchantments already accumulated during the same roll (Thanks Warriorrrr)
• Fixed KnockOnWood XP orbs never spawning on nether/warped tree cap blocks during Tree Feller
• Fixed Impale (Tridents) damage bonus formula applying one fewer rank of the multiplier than intended
• Fixed melee attack strength scale resolving to near-zero after Paper fixed a vanilla attack cooldown bug in 26.1.2 (See notes)
• Fixed server-side diminished returns state being evicted too early, allowing reconnects to bypass the DR window (See notes)
• Added option to allow Magic Hunter (Fishing) to grant items with conflicting enchantments; disabled by default (Thanks Warriorrrr)
• Added 'Skills.Fishing.Allow_Conflicting_Enchants' to config.yml (Thanks Warriorrrr)
• (Codebase) Removed 27 dead JSON.* locale keys from all locale files (See notes)
• (Codebase) Extracted per-player diminished returns tracking from PlayerProfile into DiminishedReturnsCache and DiminishedReturnsState

NOTES:

-- Read this first if you already updated to a newer Paper 26.1.2+ build --
mcMMO stores block data as '.mcm' files in each world's 'mcmmo_regions' folder.
Paper's world migration copies world_nether and world_the_end into new directories, but did not copy over mcMMO region files for those worlds, which results in data loss.
The main risk is for 'world_nether' and 'world_the_end', because Paper migration can remove old non-overworld roots before plugins load.
The Overworld (your main 'world') is safe because Paper keeps that folder and all mcMMO data in-tact (but no longer in the "right" spot), so mcMMO can still migrate existing overworld '.mcm' data and will do so when you run this update if it finds any.

Given you are reading this if you already updated Paper and got the new world migration BEFORE updating mcMMO, then you have this option which is not perfect to recover lost mcmmo_region data.
Recovery steps:

1) Stop the server fully.
2) Find mcmmo_regions data in any manual backups you make of your server/worlds
3) Copy recovered '.mcm' files for Nether/End only into these live folders (create folders if missing):
    Nether: 'world/dimensions/minecraft/the_nether/mcmmo_regions/'
    The End: 'world/dimensions/minecraft/the_end/mcmmo_regions/'
   Do NOT manually copy old overworld '.mcm' files into 'world/mcmmo_regions/' in this scenario, only do this for nether and the end.
   For your main world, mcMMO safely merges surviving overworld data on startup, and manual overworld copy/overwrite can lose some data.
4) Start the server.

This is an imperfect solution depending on how long your server has been running post updating Paper 26.1.2 before updating mcMMO, as the data will have drifted to some degree (mostly impacts data for the end and nether as stated before).

-- Read this if you have NOT updated Paper yet, or if you use Spigot instead --
Update mcMMO first, then run the server at least once with this mcMMO build before updating server software.
On a normal shutdown, mcMMO will make backups of its region files.
After that, you are safe to update to the newest Paper builds.

-- Read this if you don't know whether you already updated to the new Paper world format --
Identify the format by checking your world folders:
Old/legacy layout looks like this:
    'world/'
    'world_nether/'
    'world_the_end/'
New Paper 26.1+ layout looks like this:
    'world/'
    'world/dimensions/minecraft/the_nether/'
    'world/dimensions/minecraft/the_end/'
Quick check: if you see 'world/dimensions/minecraft/the_nether/' and 'world/dimensions/minecraft/the_end/', you are already on the new Paper format.
If you already have the new layout and only updated mcMMO now, mcMMO will safely migrate any surviving overworld '.mcm' data from 'world/mcmmo_regions/'.
This operation is safe and merges with any new data mcMMO finds.
In this scenario, only restore '.mcm' files manually for Nether/End.
Do NOT manually copy old overworld '.mcm' files into 'world/mcmmo_regions/' because that can overwrite merged data and lose some entries.
In that same scenario, old nether/end '.mcm' data is already gone, so copy those '.mcm' files from any manual backups you have and place them in:
    'world/dimensions/minecraft/the_nether/mcmmo_regions/'
    'world/dimensions/minecraft/the_end/mcmmo_regions/'
If you are already on the new format, follow the first section above for full recovery steps.
If you still have the old layout, follow the section above for Spigot/old Paper: update mcMMO first, run once, then update Paper.

-- Read this if you use Spigot and never plan to use Paper in the future --
You can disable the shutdown migration backup behavior with 'General.RegionDataMigrationBackups' in config.yml
Default is 'true'. Set it to 'false' if you are sure you will stay on Spigot and do not need mcMMO to make backups of its region files.
In simple terms: this setting controls whether mcMMO makes extra '.mcm' safety copies during shutdown for future Paper world-layout migration.
Turning it off reduces extra backup work on shutdown, but removes that Paper-migration safety net.

OTHER NOTES:

• Diminished Returns for XP is an optional feature and is disabled by default, this update includes bug fixes for servers using it.
• evictExpired() was removing freshly created DiminishedReturnsState entries before the player had registered any XP, orphaning the PlayerProfile reference and letting players bypass the DR window by reconnecting.
• State is now preserved in a server-side DiminishedReturnsCache keyed by UUID and is only evicted after being idle for the full DR window.
• Paper 26.1.2 fixed a bug where the player attack cooldown ticker was not resetting at the correct point during melee hits.
• mcMMO was reading cooldown during the damage event and relied on the old (incorrect) order, so after Paper's fix it resolved to near-zero.
• Attack strength is now back-derived from raw event damage and the player's attack damage attribute. No config changes are required.
• The removed locale keys (JSON.Rank, JSON.JWrapper.Header, JSON.JWrapper.Target.{Type,Block,Player}, JSON.Hover.{SuperAbility,Mystery2}, JSON.Notification.SuperAbility, JSON.Acrobatics.Roll.Interaction.Activated, and all JSON.<SkillName> skill-name keys) can safely be removed from any locale_override.properties — they had no effect.

• Fixed Mooshroom Shake drops not loading due to wrong entity ID in fishing_treasures.yml (see notes)
• Fixed Minecraft version detection failing on Spigot servers, causing Tricky Trials potions to be skipped
• Fixed Woodcutting bonus drops (Harvest Lumber, Clean Cuts) and Excavation treasure drops bypassing BlockDropItemEvent, making them invisible to Telekinesis-style enchant plugins (See notes)
• Skill info tooltip colors are now fully customizable via locale strings — all colors in JSON hover components are driven by locale keys and support & codes, hex colors (&#RRGGBB), and [[COLOR_NAME]] tokens
• Fixed incorrect effect durations for splash and lingering variants of Infestation, Weaving, Wind Charging, and Oozing potions in potions.yml (Thanks Warriorrrr) — existing servers are auto-migrated on first startup
• Fixed an exploit where arrows from multishot crossbows could be recovered in regions protected by WorldGuard
• Fixed an exploit where renamed seeds could trigger Green Thumb crop replanting without being consumed
• Fixed an exploit where renamed mushrooms could trigger Shroom Thumb without being consumed
• Fixed bug where Powered Shot (Crossbows) was reading MaxDamage from the Archery config section instead of its own
• Fixed bug where Smelting Vanilla XP multiplier was not using Skills.Smelting.VanillaXPMultiplier values from advanced.yml
• Fixed Fishing skill only working with main-hand fishing rod when fishing
• Fixed bug where Block Cracker (Unarmed/Berserk) had no effect on deepslate_bricks, deepslate_tiles, polished_blackstone_bricks, and nether_bricks
• Fixed Verdant Bounty (Herbalism) never triggering triple drops — the subskill was defined and displayed but was never checked during block break processing
• Fixed bug where mob custom names could be permanently corrupted after healthbar display (see notes)
• Fixed bug where vanilla mobs (null custom name) had their name incorrectly restored as an empty string instead of null after healthbar display
• Fixed bug where hitting a mob multiple times during the healthbar display window caused the name to restore too early (see notes)
• Changed mcMMO behavior around immature crop drops, no longer blocking drops from immature crops (See notes)
• Removed Patreon and language translation links from the skill command URL bar
• Added missing default value for 'Skills.Acrobatics.GracefulRoll.DamageThreshold' to advanced.yml
• Added 'Skills.Crossbows.PoweredShot.RankDamageMultiplier' to advanced.yml
• Added 'Skills.Crossbows.PoweredShot.MaxDamage' to advanced.yml
• Added 'Skills.Maces.Crush.Base_Damage' to advanced.yml
• Added 'Skills.Maces.Crush.Rank_Damage_Multiplier' to advanced.yml
• Added 'Skills.Tridents.Impale.Base_Damage' to advanced.yml
• Added 'Skills.Tridents.Impale.Rank_Damage_Multiplier' to advanced.yml
• Added 'Skills.Repair.ArcaneForging.MaxEnchantLevel' to advanced.yml (See notes)
• Added 'Skills.Salvage.ArcaneSalvage.MaxEnchantLevel' to advanced.yml (See notes)
• Updated Simplified Chinese (zh_CN) locale with new Spears and Maces translations, color-code spacing fixes, improved fishing messages, and corrected ability wear-off message formatting (Thanks GhostDC)
• Added & color codes to JSON hover tooltip keys and new JSON.URL.*.Detail, JSON.URL.Header, for consistency with locale_en_US.properties
• (Codebase) Updated deprecated durability API usage to ItemMeta Damageable API (see notes)
• (Codebase) Removed obsolete multishot arrow metadata marker system, modernized to native Spigot/Paper APIs
• (Codebase) Simplified crossbow arrow handling by eliminating unnecessary custom metadata tracking
• (Codebase) Replaced three separate healthbar metadata keys with a single HealthbarSnapshot record, eliminating duplicate restore logic spread across MobHealthDisplayUpdaterTask, CombatUtils, and TransientMetadataTools
• (Codebase) Rewrote MobHealthDisplayUpdaterTask as a self-managing repeating polling task using lastHitMs timestamps to extend the display window on re-hits, replacing the single-shot runAtEntityLater approach
• (Codebase) Removed unused Roll.printInfo(), Roll.getMechanics(), and Roll.getStats() overrides; deprecated SubSkill interface methods getStats() and getMechanics() for removal
• (Codebase) LocaleLoader.formatComponent() now supports [[NAME]] color tokens (e.g. [[RED]], [[DARK_AQUA]], [[BOLD]]) by translating them to & codes before Adventure serialization, so all three mcMMO color formats (&X, &#RRGGBB, [[NAME]]) work in JSON hover components
• (Codebase) Rewrote TextComponentFactory to use LocaleLoader.getTextComponent() throughout, eliminating all hard-coded NamedTextColor constants from JSON hover component construction — all colors and text are now fully configurable via locale strings
• (Codebase) Added locale keys JSON.Type.Passive, JSON.Type.Active, JSON.Type.SuperAbility, JSON.Locked, JSON.LevelRequirement, JSON.DescriptionHeader, JSON.URL.*.Detail, JSON.URL.Header, JSON.URL.Label.* with appropriate & color codes in locale_en_US.properties
• (Codebase) Modernized McMMOWebLinks enum with getDescriptionComponent(), getDetailComponent(), getLabelComponent() methods returning proper Adventure TextComponents
• (Codebase) Removed dead TextUtils.addChildWebComponent() method
• (Codebase) Bumped api-version in plugin.yml from 1.13 to 1.20.5, eliminating legacy bytecode field-rename shims applied by the server at load time
  
  
  NOTES:
• The Mooshroom Shake fix is auto-migrated at startup (Shake.MUSHROOM_COW → Shake.MOOSHROOM in fishing_treasures.yml).
• Regarding the telekenisis plugin compatibility fix, Tree Feller is not yet fixed, I will try to address it in the near future.
• In this update I've added two new advanced.yml settings for more granular control of the enchant level cap for both Repair and Salvage, this is an alternative to flipping on ExploitFix.UnsafeEnchantments in experience.yml which simply uncaps both skills.
• If ExploitFix.UnsafeEnchantments happens to be enabled in experience.yml, it will override both of these new settings and therefor allow basically uncapped enchant levels for Arcane Forging and Arcane Salvage.
• Allowing the old setting to override is mostly for backwards compatibility so we don't disrupt any existing server behavior.
• If you have this setting on, but you want to use the new more granular settings, simply turn off ExploitFix.UnsafeEnchantments and configure the new settings to your liking.
• Regarding immature crops, mcMMO used to block them from dropping and just replanted them instead, now they will drop and only replant if you have the relevant seed in inventory, which matches vanilla behavior better.
• The fishing hand-context changes in this update may fix reports where off-hand fishing seemed quicker than main-hand fishing.
• Durability handling now uses ItemMeta Damageable APIs instead of deprecated ItemStack durability methods.
• This may address some custom armor durability issues, but if you can still reproduce custom armor repairing when struck by axes, please report the bug with exact reproduction steps and custom-item/plugin details.
• The mob custom name corruption bug: if a mob was hit again before the healthbar display timer expired, the healthbar string was being saved as the "original" name, so the mob would permanently show healthbar text after the timer fired.

• Fixed bug which caused trickshot-bounced arrows to have much longer potion durations than intended (Thanks flyncodes)

  
  

• Fixed bug where using a stacked Chimaera Wing with warmup enabled would delete the entire stack instead of consuming only the use cost (Thanks UDPSendToFailed)

  
  

• Fixed Daze (Archery) teleport causing players to snap back to their death/teleport location when hit simultaneously with a kill or world change

  
  

• Default value for Glow_Lichen is now 1 instead of 5 (update experience.yml to get this change, or delete file and regenerate it)

  
  

• Compatible with Tiny Takeover aka Minecraft 26.1.x (see notes)
• Minimum supported Minecraft version raised to 1.20.5 (see notes)
• Improved Spears damage detection (see notes)
• Spear abilities can now trigger from off-hand attacks with the Spear
• Further improved compatibility with Excellent Enchants (fixed more errors)
• Fixed Spears command showing too many decimal places in some circumstances (Thanks Momshroom)
• (Codebase) Updated Recipe API to use alternative methods (Thanks Warriorrrr)
• (Codebase) Removed a bunch of unused code
• (Codebase) Refactored code around evaluating Minecraft server version

NOTES:
There weren't any changes needed in mcMMO for the Tiny Takeover Minecraft update, so no issues there.
From 2.2.050 onwards, mcMMO will require Minecraft versions 1.20.5 or newer.
Every now and then I raise the minimum supported Minecraft version to reduce maintenance burden of supporting older versions.
mcMMO no longer monitors PlayerAnimationEvent, it turns out Spigot has a DamageType just for Spear damage, avoiding the need to track player arm swings.
I changed how mcMMO detects the game version slightly, now if it fails to determine the game version it will make the assumption you are on the minimum supported version and print an error, this is just a failsafe in case the version detection mechanism ever fails.

• Combat abilities work with spear in off-hand again (see notes)
• Sweet berry bushes now work with Herbalism (thanks dnocturne)
• Fixed copper items not giving XP for Repair (thanks Remski01)
• Fixed rare edge case where mcMMO could drop items with stack size set outside normal bounds
• Fixed a bug where tamed wolves could cause errors on Folia (thanks Warriorrrr)
• Improved compatibility with Excellent Enchants (fixed error spam from Flame Walker)
• (Codebase) Fixed unit tests when building mcMMO with Java 25 (thanks Warriorrrr)
  
  NOTES:
  As a semi-permanent work around, mcMMO keeps track of when players swing their weapon, if they have swung it recently enough combat skills will work even if you have a spear in your off-hand.
  Prior to this patch, mcMMO disabled combat abilities when spear was in off-hand to prevent the off-hand spear charge from applying combat abilities from other skills, as mcMMO was unable to determine which item (mainhand vs offhand) caused the damage from the event information alone.

This hotfix fixes some errors that happen when running versions of Minecraft prior to Mounts of Mayhem (1.21.11) with mcMMO

• Fixed error when loading Spears skill manager on older Minecraft versions
• Fixed error when using /spears command on an older Minecraft version

• Added Spears combat skill
• Added Spears to repair.vanilla.yml and salvage.vanilla.yml (see notes)
• Added various permissions related to Spears
• Added /spears skill command
• Added Nautilus to taming XP in experience.yml
• Added Camel_Husk to taming XP in experience.yml
• Added Camel_Husk to combat XP in experience.yml
• Added Parched to combat XP in experience.yml
• Fixed bug where converting from SQL to FlatFile would not copy data for tridents, crossbows, maces, or spears
• (Codebase) Added docker-based unit tests for SQL databases (see notes)
• (Codebase) Large refactor to both SQLDatabaseManager and FlatFileDatabaseManager
• (Codebase) Database related errors are now more descriptive and have had their logging improved
  
  NOTES:
  This update had a lot of changes behind the scenes, please report any bugs you find to our GitHub issues page!
  You will need to manually update repair.vanilla.yml and salvage.vanilla.yml to get support for Spears, or...
  If you want to update salvage/repair configs the easy way, you simply can delete these config files to have mcMMO regenerate them with the new entries.
  If you don't want to delete them, you can find the default values for these config files in the defaults folder at plugins\mcMMO\defaults after running this mcMMO update at least once.
  You can use this default file to copy paste if you please.
  Docker is ONLY required for developers compiling mcMMO from source code and ONLY for running SQL-related unit tests.
  mcMMO itself does NOT require Docker to run, and servers using prebuilt releases are completely unaffected.
  New SQL database unit tests use Testcontainers to spin up temporary MySQL/MariaDB instances for testing purposes.
  These containers are created at test time and are never used at runtime.
  If you compile mcMMO locally and do not have Docker installed, SQL-related unit tests may fail.
  In this case, you can safely compile with -DskipTests to skip unit tests entirely.
  Skipping tests has no impact on mcMMO functionality when running on a server.
  Known Issues:
  I ran into an issue where having a spear in the offhand while the main hand is empty causes attacks to be incorrectly classified as unarmed. This allows unarmed abilities to apply to spear damage. As a temporary measure, I’ve disabled unarmed skills from applying to combat when a spear is equipped in the offhand while I investigate a more robust solution.

• Green Thumb now replants some crops it was failing to replant before (see notes)
• Green Thumb now replants harvested plants faster
• Fixed an error that could happen when replanting crops with Green Thumb
• Fixed a bug where salvage.vanilla.yml was readding deleted entries on server restart
• Fixed a bug where repair.vanilla.yml was readding deleted entries on server restart
• Added missing permission node 'mcmmo.ability.repair.copperrepair'
• Added missing permission node 'mcmmo.ability.salvage.coppersalvage'
  
  
  
  NOTES:
  The delay from a plant being replanted from Green Thumb is intentional, and while looking into bugs it seemd maybe a tad slow, so I sped it up a bit.
  Green Thumb still won't replant some stuff such as sugar canes, cacti, etc, those are handled a bit differently, but I could add support for it in an upcoming patch if requested.

• 
  

  Fixed copper armor and tools not working with Repair or Salvage

  
  

• Added support for the new copper tools and weapons added in Minecraft 1.21.9
• Added many missing buttons, trapdoors, doors, fence gates, etc to the ability/tool blacklists (see notes)
• Added copper tools and armor to repair.vanilla.yml (see notes)
• Added copper tools and armor to salvage.vanilla.yml (see notes)
• Added copper tools and armor to fishing_treasures.yml (see notes)
• Added Copper_Nugget to treasures.yml (see notes)
• Added Copper_Nugget to experience.yml for Smelting XP
• Added Copper_Golem to experience.yml for Combat XP
• Fixed mcMMO custom potions not having their name set correctly (see notes)
• Fixed ExploitFix.PreventArmorStandInteraction in experience.yml not being respected
• Added ExploitFix.PreventMannequinInteraction to experience.yml to prevent mannequins from granting XP or other effects
• Fixed bug where Armor Stands would get renamed to heart symbols upon breaking them (see notes)
• Tweaked potions loaded msg during mcMMO startup to not include potions requiring newer game versions from being included in the total.
  
  NOTES:
  You don't need to update your experience.yml, that one updates automatically when you run mcMMO after an update.
  You will need to manually update the following files manually repair.vanilla.yml, salvage.vanilla.yml, treasures.yml, and fishing_treasures.yml files to get support for copper tools and armor.
  You can find the default config files in the defaults folder at plugins\mcMMO\defaults after running this mcMMO update at least once.
  You can use this default file to copy paste if you please
  OR if you haven't customized these config files, simply delete them to have mcMMO regenerate them with the new entries.
  mcMMO has an internal blacklist of blocks that abilities and tools won't activate or "ready" on, pretty much anything that is interactable should go on this list, and I performed an audit and there were quite a few missing entries, so I've added them in this update, what this means is you won't click on a button and have it ready your tool anymore, as it should have been doing.
  Mannequins are treated the same way armor stands are treated, the default behavior is mcMMO won't process on them unless you turn on the setting under ExploitFix in experience.yml, in addition to this their default XP is set to 0.0
  mcMMO had a setting 'ExploitFix.PreventArmorStandInteraction' to allow mcMMO to process abilities and XP on armor stands, but it was never hooked up! I fixed that mistake in this update.
  The fix for potion names will only apply to newly created potions.
  Armor stands that had already been renamed from the heart symbol bug will keep their names, but the bug shouldn't happen anymore
•  

• mcMMO now listens to BlockDropItemEvent at LOW priority instead of HIGHEST
• Bonus drops from mcMMO now simply modify quantity in BlockDropItemEvent instead of spawning new ItemStacks.
• Added McMMOModifyBlockDropItemEvent event, this event is called when mcMMO modifies the quantity of an ItemStack during a BlockDropItemEvent, it is modifiable and cancellable.
• You can now define custom sounds to be played in sounds.yml (Thank you JeBobs, see notes)
• Added a cap to how much Blast Mining PVP damage can do to other players

Notes:
The new sounds.yml config file allows you to override the sounds played by mcMMO.
Simply define the ID of the sound you want to play for each sound.
For example, add an entry for Sounds.TOOL_READY.CustomSoundId into sounds.yml to override the sound played when a tool is "readied".
If you are on older versions (1.18, 1.19, etc), instead of registering an ID, you specify the Sound enum.
Those who are on newer versions, can define the ID of any sound registered with Paper/Spigot, this allows you to even play custom sounds so long as they are loaded on the server.
Vanilla Minecraft sounds have IDs in this format "minecraft:ui.toast.challenge_complete", you can google what these keys are.

• Fixed Berserk failing to crack blocks
• Added 'Skills.Unarmed.Block_Cracker.Allow_Block_Cracker' to config.yml
• Removed 'SmoothBrick_To_CrackedBrick', it has been replaced by `Allow_Block_Cracker`
• Block Cracker can now crack deepslate bricks, deepslate tiles, polished blackstone bricks, and netherbricks
• Optimizations for Hoppers & Alchemy (thanks Warriorrrr)
• Fixed buckets being consumed by furnaces (thanks RunqRun)
• Fixed Repair stripping unsafe enchantments from items (thanks Techirion)
• Fixed IronGolem causing cast exceptions in rare cases (thanks Techirion)