This is a build on 1.21.11/feature.

We suggest that everyone on the 1.21.11/feature branch using the Instance Network feature update to this version on all Slave Servers.

Bug Fix

• Instance Network: Slave Servers not cleaning the existing data before applying new data synced from the master server
  • This issue can also trigger another issue where the string command sent to the player is too large
  • This doesn't affect builds on 1.21.11/main as they don't have the partial sync feature
• Disguising on Folia has a rare chance to fail about ... this.revealingHandler is null.

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.8.0-beta.2...2.8.0-beta.4

This is a build on 1.21.10/feature.

We suggest that everyone on the 1.21.10/feature branch using the Instance Network feature update to this version on all Slave Servers.

New Feature

• The Fake Equip skill has been extended to more mobs

Bug Fix

• Instance Network: Slave Servers not cleaning the existing data before applying new data synced from the master server
  • This issue can also trigger another issue where the string command sent to the player is too large
  • This doesn't affect builds on 1.21.10/main as they don't have the partial sync feature

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.6.0-alpha.3...2.6.0-alpha.4

New Features

• Added abilities for Nautilus and Zombie Nautilus
  • Disguising as Nautilus now gives the player the ability to breathe underwater and dryout in the air
  • Disguising as Zombie Nautilus would additionally make the player burn under the sun if not equipping a helmet.
• Added Dash skill
  • Disguising as Camel/Camel Husk now can dash on the ground or underwater
  • Disguising as Nautilus/Zombie Nautilus now can dash underwater

Bug Fix

• Potential error when checking whether the current code is on an Entity's tick thread.

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.8.0-alpha.2...2.8.0-beta.2

Bug Fix

• Potential error when checking whether the current code is on an Entity's tick thread.

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.7.0...2.7.1

Bug Fix

• Debug message Text icon for <...> is <...> spamming in console if any usage of disguise text icon is invoked

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.8.0-alpha.1...2.8.0-alpha.2

New Features

• Now an instance of DisguiseProperty can declare that it's invisible for the client mod
  • FeatherMorph doesn't have properties that require this feature yet; it's mainly made for other plugins' development.
• Added readString method for InputHandles.
• The plugin will now attempt to show the exception's message if it occurred while updating or has been forwarded to the DisguiseState.
• Bring the ability for async player data loading in Instance Network to IManagePlayerData.
  • Currently, only when the Instance Network is enabled, and the current server is a Slave Server in the network, the async loading feature is fully utilized.
  • If supported, when a player enters the configuration state, the plugin will attempt to load their data async, and wait for up to 150ms per player, then allow them to keep logging in after the timeout, and notify their client when the data finishes loading.
    • We wait for up to 150ms is to make sure that the disguise unlock data can immediately be available after the player logs in on fast machines.
    • And maybe this waiting feature would be removed in the next (edit: next or future) releases, as it literally conflicts with the async concept... 🤯

Other

• Simplified exception handling in some places.
• The message morph.error_while_disguising_user_fault in the language file has been renamed to morph.error_parsing_property.
• The interval of batching player data requests has been changed from 10 ticks to 2 ticks, to adapt to the new IManagePlayerData#loadPlayerDataAsync method

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.6.0-alpha.2...2.6.0-alpha.3

This is a release on the 1.21.11/feature branch.

New Feature

• [2.7.0] Added new debug command /debugForValue, for listing all registered SingleValue in the given value set.
• Added support for Zombie Nautilus's variant property.

Other

• [2.7.0] We are now 1.21.11
• [2.7.0] Bumped PacketEvents to 2.11.0
• [2.7.0] Added a workaround not to send the packet if we have a huge data body.
  • This prevents exceptions from being thrown when trying to send a huge amount of available disguise or a huge disguise data.
  • Currently, I have no idea how to solve the problem, so let's not sync the list for now. Players can still select the disguise using the /morph command, and other features would still work... Unless the data still exceeds the limit.

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.6.0-alpha.3...2.8.0-alpha.1

This is a release on the 1.21.11/main branch. For the upcoming new features, see https://github.com/NiFeather/FeatherMorph/pull/61

New Feature

• Added new debug command /debugForValue, for listing all registered SingleValue in the given value set.

Other

• We are now 1.21.11
• Bumped PacketEvents to 2.11.0
• Added a workaround not to send the packet if we have a huge data body.
  • This prevents exceptions from being thrown when trying to send a huge amount of available disguise or a huge disguise data.
  • Currently, I have no idea how to solve the problem, so let's not sync the list for now. Players can still select the disguise using the /morph command, and other features would still work... Unless the data still exceeds the limit.

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.5.2...2.7.0

New Features

• Now applying the Interaction Mirror for mannequins also requires the player to have the normal Interaction Mirror permission
• On new installations, the Icon for the current disguise is now shown in the actionbar by default
• Killing mobs with feathermorph_nogrant tag will now not unlock the relevant disguise for the player
• Refactored how the plugin sends messages to players
• It's now possible to extract the built-in language file using the /fm extract language <lang> command
  • Permission for this command is feathermorph.admin.
  • If there's already a matching file on the disk, the extracted file will install to messages/<lang>.fmnew.json by default
  • You can overwrite it by using /fm extract language <lang> true, this operation requires you to confirm by executing again
• Slaves in the Instance Network now request data for the player when they join, instead of the master server loading and syncing all data to slaves upon startup.
• It's now possible to get the relevant DisguiseState instance in PlayerUnMorphEvent.
• Third-party plugins are now able to add their SingleProperty instances to DisguiseProperties on bootstrap, which would allow automatic assignment from player inputs.

Other

• Mannequins would now be normally selected by Interaction Mirror Executors, instead of being treated as specials.
• by_sight mirror mode now respects the maximum affect distance set in the config
• Gradle task runFolia is now available
• The actionbar message for disguise is now handled by DisguiseState.
• readRotations from InputHandles now throws an error when the player gives more than 3 elements
  • This means that giving more than 3 elements for various rotation properties for the Armor Stand disguise will now result in an error message.
• Migrated configuration definition from plugin's own ConfigOption enum to ConfigOption class from PluginBase

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.5.2...2.6.0-alpha.2

This is a maintenance release for the 2.5 series. For the upcoming new features, see 2.6 alpha at: https://github.com/NiFeather/FeatherMorph/pull/59

Bug Fixes

• The Extra Knockback ability always adds 0.345584025 for Y Motion changes, and does not apply knockback resistance for X and Z Motion changes.
• Disguise waypoint not getting removed when the binding player quits.
• Make MorphBasicAvoidPlayerGoal ignore when the player to avoid is in a different world
  • This fixes the AI throwing error under some weird situations.

Other

• Handle invalid protocol level in MIC2SLoginCommand

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.5.1...2.5.2

Starting from 2025/11/3 (YYYY/MM/DD), we have split the 1.21.10 branch to 1.21.10/main and 1.21.10/feature.

If you cloned the repo before, you might want to delete the locally stored 1.21.10 branch before pulling any updates!

Changes in 2.5.1

Bug Fix

• Empty input for entity/equipment would cause unhandled exceptions

Changes in 2.5.0

New Features

• It's now possible for players to save their disguise and apply their locally stored disguises
  • This requires players to use 0.16.0-beta.5 or higher version of the client mod!
• Added permission feathermorph.custom_text for entity/custom_name, mannequin/description, and mannequin/hide_description property, and it's available for players by default
• Added permission for using disguise properties: feathermorph.disguise_properties.use
• Added permission for setting a custom skin profile for items in entity/equipment property, restricted to ops by default: feathermorph.disguise_properties.custom_skin_on_items
• Added support for Mannequin disguise
  • Mannequin disguise is not collectable using the Magic Bottle by default
  • Mannequin disguises have the Fake Equip skill, like Armor Stand and Player disguise
  • mannequin/skin property is restricted to ops by default. You can set feathermorph.custom_skin permission for players so they can use this property.
• Added support for Copper Golem disguise
  • Copper Golem disguise is collectable using the Magic Bottle by default
  • Added Weather State property for Copper Golem disguise
• Initial compatibility(?) for Ping Wheel
  • Using the official Ping Wheel plugin will work, but pinging while disguising doesn't mask the pinger
  • ...So I made a custom plugin to temporarily solve the problem, which can be found at https://github.com/MATRIX-feather/pingwheel-plugin-forked
• Initial support for players with permission feathermorph.mirror.mannequin to mirror their sneaking actions to mannequins that have the same name and description as their disguise
  • For BY_NAME executor, mannequins within a range are selected, while setting the affect distance to -1 would disable the range limit
  • For BY_SIGHT and BY_RANGE, the targeting mannequin within 5 blocks of sight will be selected

Bug Fixes

• Several bugs with Player Disguises when feathermorph.disguise_use_real_uuid permission is given
  • Players got removed from their TAB view when undisguising
  • Disguise not presenting when teleported from far away, or switching gamemode from spectator
• slime_magma/size property has a wrong random range
• Nobody is calling BaseLivingEntityProperties#setupPropertiesFromEntity in the override methods
  • This makes disguises that have extra properties not copy the target entity's custom name.

Other

• We are planning to remove the BY_RANGE mirror executor in the future, as it's causing chaos when we have players with bad networking
• Some exceptions thrown will now be forwarded to DisguiseState and will undisguise the player
• Tweaked how Server Renderer rebuilds entity metadata packets sent from the server
• Removed disguise NBT blacklist configuration
  • As they are not being used anymore
• entity/custom_name and mannequin/description now accept JSON text component starting with {
• Moved some disguise validation to early disguise preparation

Starting from 2025/11/3 (YYYY/MM/DD), we have split the 1.21.10 branch to 1.21.10/main and 1.21.10/feature.

If you cloned the repo before, you might want to delete the locally stored 1.21.10 branch before pulling any updates!

Bug Fixes

• Added SkinPatch support for ResolvableProfile, which fixes some skin setups not presenting properly on the client.
• Explicitly declare whether a MorphResolvableProfileStruct is presenting a dynamic ResolvableProfile, which fixes some skin not displaying on the client side.
  • These two fixes above require players to update their client mod to 0.16.0-beta.6!
• entity/custom_name always copies from the target entity, ignoring the entity's type
• Nobody is calling BaseLivingEntityProperties#setupPropertiesFromEntity in the override methods
  • This makes disguises that have extra properties not copy the target entity's custom name.

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.5.0-rc.4...2.5.0-rc.5

Starting from 2025/11/3 (YYYY/MM/DD), we have split the 1.21.10 branch to 1.21.10/main and 1.21.10/feature.

If you cloned the repo before, you might want to delete the locally stored 1.21.10 branch before pulling any updates!

Bug Fix

• StackOverflow when a player has a locale that is "en_US" rather than "en_us"

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.4.5...2.4.6

Starting from 2025/11/3 (YYYY/MM/DD), we have split the 1.21.10 branch to 1.21.10/main and 1.21.10/feature.

If you cloned the repo before, you might want to delete the locally stored 1.21.10 branch before pulling any updates!

Bug Fixes

• Player disguise always copies the target player's skin, not checking conditions
• StackOverflow when a player has a locale that is "en_US" rather than "en_us"

Other

• Allow bukkitEntity is null for FoliaThreadUtils#isTickThreadFor
• Make ServerBackend#disguise and SpawnPacketHandler#onEntityAddPacket fail softly if timed out waiting for the player's thread.
  • In beta.6, some exceptions are forwarded to the player's DisguiseState, including waiting timeouts when building virtual entity packets
  • Once timed out, the player will get unmorphed once ticked, even if it only affects the virtual entity displaying
  • This may improve player experience when the server is lagging

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.5.0-rc.3...2.5.0-rc.4

Bug Fix

• In previous 2.5.0 beta releases, sometimes the disguise reporting it fails to update and (may) cause nearby players to disconnect with a protocol error

Other

• Catch JSON error when parsing client entity/equipment input and wrap it as a ParseErrorException, to tell players that the data is malformed

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.5.0-rc.2...2.5.0-rc.3

Bug Fix

• Skill execution event not triggering

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.4.4...2.4.5

We are now slowly migrating our wiki to the docs/ directory under the repository. You can have a look if interested!

New Feature

• [rc.1] Added permission for using disguise properties: feathermorph.disguise_properties.use
• [rc.1] Added permission for setting a custom skin profile for items in entity/equipment property: feathermorph.disguise_properties.custom_skin_on_items

Bug Fix

• [rc.2] Disguising as other entities can also trigger the Interaction Mirror for mannequins
• [rc.2] The Interaction Mirror for mannequins triggers ignoring the difference in NPC description

Other

• [rc.1] Moved some disguise validation to early disguise preparation
• [rc.1] Bump PacketEvents to 2.10.0

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.5.0-beta.6...2.5.0-rc.2

New Feature

• Players with permission feathermorph.mirror.mannequin are now able to apply the sneaking mirror to mannequins that have the same name as their disguise
  • For BY_NAME executor, mannequins within a range are selected, while setting the affect distance to -1 would disable the range limit
  • For BY_SIGHT and BY_RANGE, the targeting mannequin within 5 blocks of sight will be selected
• Bump API to 17
  • It's now possible for client mods to include property inputs in the C2S Morph command
• Setting the Interaction Mirror Affect Distance (Control distance) in-game is now possible with /fm option mirror_control_distance

Bug Fix

• Skill execution event not triggering
• slime_magma/size property has a wrong random range

Other

• We are planning to remove the BY_RANGE mirror executor in the future, as it's causing chaos when we have players with bad networking
• Some exceptions thrown will now be forwarded to DisguiseState and will undisguise the player
• Tweaked how Server Renderer rebuilds entity metadata packets sent from the server

Full Changelog: https://github.com/NiFeather/FeatherMorph/compare/2.5.0-beta.5...2.5.0-beta.6

New Features

• Initial compatibility for Ping Wheel
  • Currently requires a custom plugin, which can be found at https://github.com/MATRIX-feather/pingwheel-plugin-forked

Bug Fixes

• Disguise status synced from slave servers doesn't really apply to the master server
• Players got removed from their TAB view when undisguising, when feathermorph.disguise_use_real_uuid is set to true

Bug Fix

• Disguise status synced from slave servers doesn't really apply to the master server

Other

• We are now 1.21.10
• We now compile against PacketEvents 2.10.0-SNAPSHOT dev build
  • So that CI is working again!