mcMMO 2.2.052

Other versions

• 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)

• Support for new additions from Minecraft 1.21.5
• Fixed bug where Blast Mining would not drop deep slate
• Swords subskill Stab is now configurable in advanced.yml
• Added 'Skills.Swords.Stab.Base_Damage' to advanced.yml
  
   
• Added 'Skills.Swords.Stab.Per_Rank_Multiplier' to advanced.yml
• Added 'Bush' to experience.yml for Herbalism
• Added 'Bush' to config.yml Bonus Drops for Herbalism
• Added 'Cactus_Flower' to experience.yml for Herbalism
• Added 'Cactus_Flower' to config.yml Bonus Drops for Herbalism
• Added 'Firefly_Bush' to experience.yml for Herbalism
• Added 'Firefly_Bush' to config.yml Bonus Drops for Herbalism
• Added 'Leaf_Litter' to experience.yml for Herbalism
• Added 'Leaf_Litter' to config.yml Bonus Drops for Herbalism
• Added 'Short_Dry_Grass' to experience.yml for Herbalism
• Added 'Short_Dry_Grass' to config.yml Bonus Drops for Herbalism
• Added 'Tall_Dry_Grass' to experience.yml for Herbalism
• Added 'Tall_Dry_Grass' to config.yml Bonus Drops for Herbalism
• Added 'Wildflowers' to experience.yml for Herbalism
• Added 'Wildflowers' to config.yml Bonus Drops for Herbalism

• Added Breeze_Rod entries to potions.yml for Awkward potion (see notes)
• Added missing TURTLE_HELMET entry to potions.yml for Tier 1 ingredients
• Added missing Wind Charging potion entries to potions.yml (see notes)
• Fixed bug where mcMMO would attempt to load potions that required ingredients or effects from newer versions of Minecraft
• mcMMO is a little more specific during start up of how many potions it loaded, it will now report on incompatible potions from being on an older game version.

NOTES:
You will have to update your potions.yml manually to receive these changes, it is highly recommended that if you haven't customized this file that you simply just delete it, mcMMO will generate a new one on the next start up and it will contain all the missing entries.
If you have customized this file, you can find the "default" version of this file here on the mcMMO github repo: https://github.com/mcMMO-Dev/mcMMO/blob/master/src/main/resources/potions.yml
You can use this file to compare it to your own and make the manual changes needed to get the new entries.
After making the changes to potions.yml (either via deleting it or not...) mcMMO should now recognize the Wind Charging potion and the Awkward potion created from Breeze Rods