PocketMorph 2.2.0

PocketMorph 2.2.0 adds new ways to browse transformations, improves movement and camera handling, and includes several performance and compatibility improvements.

New ability filters

The Base Pokemon menu now includes a filter button with the following options:

• All
• Favorites
• Can Fly
• Can Swim
• Lava-Safe
• Fast Land
• Slow Land
• Ground Mine

Filters can be combined with the normal search box, making it much easier to find a transformation that fits what you want to do.

Filter results account for available forms, server settings, and installed Cobblemon addons and resource packs. Capability data is prepared progressively and cached per server so later uses of the selector are much faster.

Controlled lava swimming

Eligible fire-resistant transformations can now move through lava with proper directional control:

• Use normal movement controls to steer.
• Hold Jump to rise.
• Hold Sneak to descend.
• Eliminated the annoying drift movement that happened when no movement input is given.

The existing lava movement multiplier now controls both horizontal and vertical movement speed.

PocketMorph also hides the burning model effect and first-person fire overlay when the transformed player is protected by PocketMorph's fire-resistance ability.

Battler HUD improvements

• Added a client-side hotkey to show or hide the PocketMorph Battler HUD outside battle.
• The preference is saved between sessions.
• The Battler controls remain available during battle.
• Added automatic compatibility with newer Cobblemon Battle Extras versions that place party icons along the left side of the battle screen. When that interface is detected, PocketMorph uses a compact arrow-only tab to avoid covering it.

Camera and transformation improvements

• Greatly improved third-person camera behavior for small transformations around leaves, bushes, fences, panes, and other partial blocks.
• Removed the rapid zoom-in/zoom-out effect that could make third-person movement disorienting.
• Solid terrain still receives strict anti-x-ray protection.
• Improved camera, hitbox, and nametag synchronization when switching from a very large transformation to a very small one.
• Corrected Pokéball throw origins across very small, ordinary, and very large transformations.

Performance and stability

• Improved selector loading and capability processing for large modpacks.
• Added a persistent per-server selector cache so unchanged servers do not need to rebuild the full capability catalog every session.
• Reduced unnecessary transformed-player render lookups and idle Battler checks.
• Improved compatibility with addon forms and resource-pack overrides without relying on Pokémon-specific allow-lists.

These changes should reduce PocketMorph's performance impact on servers with higher player counts immensely (about 80% performance improvement over 2.1).

• improved compatibility with other updated Cobblemon-related mods, specifically those used in the new Cobbleverse 1.7.40 modpack.

PocketMorph 2.1.0

PocketMorph 2.1 adds server-side administrative transformation commands, multiplayer transformation cries, expanded ground-movement scaling, more accurate preview capability badges, cleaner Battler feedback, and further performance and release-stability improvements.

New: Server Administrative Transformation Commands

• Added server-authoritative commands for transforming, clearing, and checking the transformation status of online players.

• Commands can be used from the dedicated server console, command blocks, or by authorized administrators.

• Added the following primary commands:

  • /pocketmorph transform <player> <Pokémon target>
  • /pocketmorph clear <player>
  • /pocketmorph status <player>

• Added shorter compatibility aliases:

  • /disguiseplayer <player> <Pokémon target>
  • /undisguiseplayer <player>

• Transformation targets support Cobblemon species, forms, and compatible property strings.

• Administrative transformations can apply shiny state, gender, form, size, scale, and other supported Pokémon properties.

• Commands validate species names, properties, and configured scale limits before applying a transformation.

• Administrative transformations bypass the targeted player’s normal Pokédex unlock requirement, allowing server events, scripted encounters, minigames, and moderation tools to assign specific transformations.

• Transformations remain server-authoritative and are synchronized to the targeted player and nearby clients.

• Clearing a transformation also cleans up associated movement, Battler, persistence, and synchronized client state.

• Active Self-Battler battle protections remain enforced.

• Command access requires operator level 2 or the permission node:

  • pocketmorph.admin.disguise.others

New: Transformation Cry Hotkey

• Added a configurable keybind for manually playing the cry of your current Pokémon transformation.
• Cries are validated and synchronized by the server so nearby players can hear them, and play positional audio.
• Supported idle cry animations can play while stationary.
• Added a server configuration option for enabling or disabling manual transformation cries.

New: Ground Movement Scaling Modes

• Added a configurable ground-movement system with three modes:

  • OFF
  • LEGACY_FAST_ONLY
  • ALL_BY_BASE_STAT

• LEGACY_FAST_ONLY preserves PocketMorph’s existing Speed-effect behavior for qualifying fast Pokémon.

• Added an option allowing otherwise eligible flying, aquatic, and other transformations to receive the legacy grounded land-speed boost.

• ALL_BY_BASE_STAT adjusts every transformation’s grounded movement speed using the resolved form’s base Speed stat.

• Faster Pokémon can receive increased ground movement, while slower Pokémon can receive reduced movement.

• Added configurable neutral Speed, minimum multiplier, and maximum multiplier values.

• Ground-speed adjustments apply only while appropriate grounded movement conditions are met.

• Added separate status icons and tooltips for increased and reduced movement speed.

Fixed

• Fixed supported flying Pokémon and forms sometimes missing their Flight badge in the transformation preview.
• Fixed normal held-item and cosmetic interactions producing overly verbose technical chat output.
• Fixed failed item interactions potentially being accompanied by a misleading early success message.
• Fixed avoidable PocketMorph mixin warnings appearing during startup.

Preview Capability Improvements

• Preview capability badges are now resolved authoritatively by the server.
• Capability results are form- and property-aware rather than relying only on the selected base species.
• Improved badge accuracy for Pokémon and addon forms whose capabilities are defined through behavior data.
• Fixed Flight badges being absent from previews for supported floating, levitating, or behavior-defined flyers, like Mew and Aegislash.
• Preview capability results are cached and refreshed efficiently when the selected Pokémon, form, or properties change.

Battler and Item Feedback

• Simplified normal player-facing messages for Self-Battler actions.

• Held-item and cosmetic actions now provide clear confirmations such as:

  • held item equipped or removed;
  • cosmetic equipped or removed;
  • item rejected because the current Pokémon cannot use it.

• Removed internal UUIDs, save paths, component data, persistence details, and other implementation information from ordinary chat.

• Unsupported or failed item actions no longer display a premature success confirmation.

• Detailed technical reports remain available when enableDetailedLifecycleLogging is enabled.

• Applied the same concise-message treatment to Battler add, sync, remove, rescue, status, permission, and party-capacity responses.

• Completed Use Item actions retain their existing action-bar feedback without unnecessarily filling chat.

Performance and Diagnostics

• Reduced normal gameplay overhead from PocketMorph’s internal performance profiler.

• Performance profiling is now disabled by default and avoids timestamp/counter work while inactive.

• Added explicit profiler controls:

  • /disguise debugperf enable
  • /disguise debugperf disable
  • /disguise debugperf reset

• Retained detailed diagnostic tools for troubleshooting without exposing them during ordinary play.

• Removed obsolete development-stage and internal build identifiers from runtime interaction messages and diagnostics.

Stability and Release Cleanup

• Removed an unused mixin reference-map declaration that produced an avoidable startup warning.
• Resolved a helper-method naming conflict between transformed camera-position and eye-position mixins.
• Improved release metadata and centralized PocketMorph’s build identity.
• Cleaned up startup and runtime diagnostics for clearer server logs.

Configuration Notes

Existing configurations are preserved where possible.

New movement and cry settings are added automatically to the PocketMorph server configuration. The default movement mode preserves the legacy fast-Pokémon behavior unless the server owner explicitly selects ALL_BY_BASE_STAT.

Detailed lifecycle logging remains disabled by default and should generally be enabled only while troubleshooting.

Compatibility

• Minecraft Java Edition 1.21.1
• Fabric
• Java 21 or newer
• Fabric API
• Cobblemon 1.7.x
• PocketMorph must be installed on both the server and participating clients for multiplayer use.

Upgrade Notes

• Replace the previous PocketMorph JAR on both the server and clients.
• Do not leave multiple PocketMorph versions in the mods folder.
• Existing transformations, Favorites, Self-Battler records, and server configuration should continue to load normally.
• Server owners using custom movement settings should review the new ground-movement options after the first startup.

PocketMorph 2.0.1

Fixed

• Fixed the main transformation GUI appearing blurred or unfocused in Fabric setups with no/few visual mods/shaders.
• The GUI now suppresses vanilla screen blur for PocketMorph’s transformation screen only, while keeping PocketMorph’s custom background and shell intact.

Notes

• No gameplay, configuration, transformation, or any other behavior was changed in this update.
• This is a small visual hot-fix recommended for all 2.0.0 users.

PocketMorph 2.0.0 Changelog

PocketMorph 2.0.0 is a major release focused on turning PocketMorph from a command-first transformation mod into a polished transformation and self-battler experience for Cobblemon.

New: Full PocketMorph Transformation GUI

• Added a dedicated PocketMorph GUI for browsing, previewing, and applying transformations.
• Added a searchable Base Pokémon browser with scrollable visual cards.
• Added a form browser with visual form cards, locked-form handling, pinned Default form support, and clearer selected-form highlighting.
• Added a large Live Preview panel for the selected Pokémon/form.
• Added support for opening the GUI through /disguise gui and the Open PocketMorph GUI keybind.

New: Live Preview

• Added a live Pokémon preview in the main GUI.
• Added preview controls:
  • left-drag to rotate;
  • right-drag to pan;
  • scroll to zoom;
  • middle-click to reset view.
• Added type icons, ability indicators, stat summaries, form information, shiny/gender indicators, and availability hints.
• Added deterministic preview handling for shiny, gender, forms, and properties.
• Improved preview performance and reduced FPS impact from rapid GUI changes.

New: Properties, Favorites, and Random

• Added GUI controls for common transformation properties, including shiny, gender, scale, nickname, and displayed level.
• Added a Favorites tab for saving completed transformations.
• Added favorite badges on saved Base/Form cards.
• Added a Live Preview favorite button for saving/removing the last successful transformation.
• Added a Random tab with toggles for randomizing forms, shiny, gender, and scale.
• Favorites and Random were optimized to avoid major GUI FPS drops.

New: Self-Pokémon Battler System

• Added the self-battler system, allowing a player’s current transformation to be used as a party-slot Pokémon for Cobblemon battles.
• Self-battlers are now enabled by default in new server configs.
• Added protections so self-battlers cannot be accidentally released, traded, transferred, or moved into storage in unsafe ways.
• Added rescue/remove tools for recovering self-battlers if something goes wrong.
• Added battle-state guards so players cannot transform or clear transformations at unsafe times during battle.
• Added evolution synchronization so self-battler evolution can update the saved transformation cleanly.
• Added handling for battle-only forms and gimmick transformations where supported.
• Added model hide/restore behavior so the player model and self-battler model do not visually overlap during battle.

New: Battler Panel and Use Item Support

• Added the PocketMorph Battler side panel. Default keybind is right-arrow, editable in controls.
• Added battler portrait/status display.
• Added battler actions for adding, syncing, removing, rescuing, held items, cosmetics, battle camera, and Use Item.
• Added support for using right-click-style items on self-battlers through the Battler panel, including TMCraft TM disks.

Transformation and Visual Improvements

• Improved Pokémon/form selection and validation.
• Improved support for shiny, gender, scale, nickname, level, form, aspect, and cosmetic-related properties.
• Improved compatibility with addon forms and resource-pack-driven visual forms.
• Added support for Pokédex shiny restrictions through server config.
• Improved local and remote multiplayer transformation synchronization.
• Improved persistent transformation saves

Held Item and Cosmetic Improvements

• Improved transformed-player held-item rendering across many normal, Mega, and addon forms.
• Fixed held-item orientation for several common hand-held species/forms.
• Added special handling for tricky cases such as Mega forms and other models with unusual item locators.
• Improved cosmetic compatibility groundwork, including alias/diagnostic handling for addon cosmetic items.
• Fixed Lucario/Riolu scarf cosmetic visual handling for supported addon cosmetics.

Camera, Hitbox, Raycast, and Scale Improvements

• Improved first-person and third-person transformed camera behavior for small, large, long-bodied, flying, and human-like Pokémon.
• Improved large-form camera zoom/distance tuning.
• Improved transformed-player hitbox matching and config controls.
• Improved block reach, raycast, fluid placement, and item-use alignment for transformed bodies.
• Improved Poké Ball throw origins across scale and body-shape changes.
• Improved camera safety in tight spaces and near walls.
• Improved scale controls and config descriptions.

Movement, Riding, and Utility Improvements

• Improved land Speed boost rules for eligible ground-based Pokémon.
• Added/cleaned Fire-type lava movement support and rider Fire Resistance sharing.
• Improved transformed-player riding behavior while respecting Cobblemon/addon ride data.
• Improved rider camera and pose handling.
• Preserved held items and armor while mounted; mounted accessories/backpacks remain hidden for compatibility.

Animation Fixes

• Fixed or improved several sparse-pose and unusual-animation cases.
• Improved Gmax and large-form animation handling.
• Improved floating/small-form movement animation fallbacks.
• Improved airborne movement behavior for certain sparse flying/floating Pokémon.
• Preserved accepted sand animation fixes for Garchomp and other tested cases.

Permissions and Server Controls

• Improved LuckPerms/fabric-permissions-api enforcement.
• Fixed denied-transform visual reset issues.
• Reduced permission-denial chat details while preserving admin/debug detail in logs.
• Expanded server config options with clearer descriptions, defaults, and warnings.
• Cleaned config descriptions to remove internal development wording.
• Added concise warnings for high-impact settings such as large scale, lava boost strength, camera offsets, hitbox size, damage boosts, mining Haste, and step assist.

Performance Improvements

• Optimized Favorites/Random tab rendering and favorite-badge lookups.
• Reduced persistent transform save/log spam.
• Improved render refresh behavior for transformed players.

Debug and Message Cleanup

• Shortened normal player-facing chat messages.
• Kept debug details available through debug commands instead of routine chat.
• Removed internal build/stage language from player-facing config descriptions and debug headers where practical.

Requirements

• Minecraft Java Edition 1.21.1
• Fabric Loader
• Java 21+
• Fabric API
• Cobblemon 1.7.3+ recommended
• Install on both client and server for multiplayer use.

Notes

• Existing server configs are preserved where possible. New config defaults may differ from older releases.
• Self-battlers are enabled by default for new configs in 2.0.0.
• Very large scale values and high movement/camera multipliers can affect performance or gameplay feel; review server configs before opening public servers.

PocketMorph 1.2.0 Changelog

Fixes

• Fixed transformed player eye height/reference positioning so it more accurately matches the corresponding Pokémon model.
• Fixed oversized transformed forms respecting the configured maximum vertical hitbox cap more consistently.
• Fixed an issue where a multiplayer transformation could carry over into single-player after disconnecting without restarting Minecraft.
• Fixed severe lag/freezing that could occur after exiting to title while transformed and rejoining a single-player world without restarting Minecraft.
• Improved first-person transformed rendering performance after relogs/resource reloads.
• Added cleanup and stability improvements around client session state when disconnecting or changing worlds.

Notes

• This update focuses on important stability, session, hitbox, and relog fixes.
• No major gameplay feature changes are included in this release.

PocketMorph 1.1.0

Bug Fix + Small Feature Additions

This release focuses on held-item display implementation, viewer-side sleep animation implementation, dependency clarity, and a few smaller stability/compatibility improvements.

New Features and Improvements

• Added transformed-player held item rendering support, allowing held items to appear correctly on compatible Pokémon models.
• Improved held item positioning and orientation across tested Pokémon forms.
• Added first-person held item support for transformed Pokémon where appropriate.
• Added first-person held-item hiding for mouth-held item Pokémon where the item would obstruct the camera, such as Arcanine and Eevee-style cases.
• Added proper viewer-side support for transformed sleep animations, so other players can now see transformed players sleeping correctly.
• Added a formal Cobblemon dependency requirement:
  • PocketMorph now requires Cobblemon 1.7.0 or newer.
  • Missing or outdated Cobblemon installs should now produce a clear Fabric Loader dependency error.

Bug Fixes

• Fixed issues with very-large Pokémon model transformations and block breaking.
• Fixed animation issues with a small list of Pokémon with sand-related animations.

Optimization and Stability

• Cleaned up and optimized the new sleep animation sync logic to reduce unnecessary packet and heartbeat behavior.
• Added safer state handling for late-joining viewers so sleeping transformed players can still sync correctly.
• Preserved existing camera, riding, raycast, hitbox, animation, lava, and held-item behavior from the previous stable release.
• Added clearer startup logging for detected Cobblemon version compatibility.

Compatibility

• Requires Minecraft/Fabric environment compatible with the existing PocketMorph release target.
• Requires Cobblemon 1.7.0 or newer.
• Tested with Cobblemon 1.7.3+1.21.1.