MyPet 4 4.0.4

MyPet 4.0.4 brings a number of important potential dupe exploit path patches. It is recommended to upgrade immediately.

MyPet 4.0.4 supports Paper 1.20.5 through 26.3, unchanged from 4.0.3. Upgrading is a drop-in jar swap.

If MyPet is useful to you or your players, please consider buying me a coffee: https://ko-fi.com/UserDerezzed

Full changelog:

Added

Changed

• Moved MyPet's default addresses to mypet-plugin.com, updating `MyPet.Info.Wiki-URL` and `MyPet.WebEditor.*` in configs still on the old .de defaults
• Hid startup warnings about the Capybara and Chameleon pets on servers that have decided to not use them

Fixed

• Fixed MythicMobs pets created while MythicMobs was offline being stuck as their host mob forever
• Fixed MythicMobs pets spawning as their host mob when created with options like `baby` or `skilltree:`
• Fixed /petshop <shopname> <player> no longer opening a shop from the console
• Fixed pets staying stuck floating forever after another plugin turned their gravity off
• Fixed pets despawned while being steered with the Control skill leaving a dead task in the scheduler for the server's uptime
• Fixed an error when a Citizens pet-storage NPC was used while the player's pet was stored, traded or despawned at the same moment
• Fixed /petadmin purge reading the live pet list from the database thread
• Fixed every pet spawn forcing a chunk load before checking whether the owner's chunk is loaded
• Fixed errors in the console when a pet entity without a live pet record was targeted, killed something, or died to another pet
• Fixed pet and player saves on MySQL occasionally persisting an older state when two saves for the same pet were issued in quick succession
• Fixed the Heal skill's green potion particles never showing when a pet regenerates
• Fixed memory growing with every arrow, trident, snowball, egg, ender pearl and fishing bobber a player launched while MyPet.Leash.AllowRanged was enabled
• Fixed the hunger system silently stopping (no hunger messages, no starvation damage) when MyPet.HungerSystem.SaturationPerFeed is not a whole number
• Fixed pet taming, Shield damage redirection and ride fall-damage protection running at the wrong event priority, so other plugins could see damage that MyPet then reversed
• Fixed the final pet save on server shutdown overlapping still-running database writes on SQLite
• Fixed players being unable to tame anything after disconnecting during a leash capture until the server restarted
• Fixed pets with the Mining or Lumberjack skill refusing to follow their owner after a relog, /petswitch or world change that happened mid-job
• Fixed a traded pet being lost forever if the buyer disconnected while /pettrade accept was completing
• Fixed menu icons being duplicated by double-clicking a matching item in your own inventory while a MyPet GUI is open
• Fixed hostile pets like the Bogged attacking and damaging themselves in Farm behavior mode
• Fixed a villager pet struck by lightning leaving a second villager standing next to the witch
• Fixed a villager pet's held item being destroyed when you released it to the wild
• Fixed a pet's armor duplicating when it converted to another mob, such as a zombie drowning
• Fixed a pet's armor duplicating when it died on a server with `ReleaseOnDeath` enabled for that pet type
• Fixed all but one item being destroyed when you tamed a mob holding a stack
• Fixed a pet's held item duplicating when you equipped it while a toolbox station was open
• Fixed pets eating for free while their backpack was open
• Fixed a pet's backpack contents duplicating when its owner died with the backpack open
• Fixed a pet's backpack contents duplicating when an admin opened it while its owner had it open
• Fixed items moving out of a pet's backpack duplicating when you opened another menu without closing it
• Fixed cycling pet behavior with /petbehavior or the pet menu skipping every mode except Normal when extended permissions are off
• Fixed the Menus editor in /mypet editor opening empty, and menu changes saved there never taking effect
• Fixed Ender Dragon pets never coming when called, reporting "not enough space"

Thanks again for choosing MyPet!

MyPet 4.0.3 brings multiple fixes and a new config option. Fish, guardians, axolotls and frogs finally swim, chase and fight instead of freezing or bobbing at the surface, Pets stop suffocating inside walls when you call them, and MyPet on a shared MySQL server stops reading another install's tables.

MyPet 4.0.3 supports Minecraft 1.20.5 through the upcoming 26.3 update, unchanged from 4.0.2. Upgrading is a drop-in jar swap, but this one changes how your database stores Pet data, so there is not a downgrade path.

If MyPet is useful to you or your players, please consider buying me a coffee: https://ko-fi.com/UserDerezzed

Water Pets can swim, chase and fight

Aquatic Pets were badly broken and it took four separate fixes to sort out.

Fish, Guardians, Squid and the rest could hit whatever swam into reach but could never chase anything - they simply had no way to close the distance. A Pet stranded on land stopped dead the moment it picked a target instead of walking to it. Axolotls, Drowned, Frogs and Turtles did the same thing on land. And every Pet in water was quietly pushed toward the surface each tick, so anything that tried to swim down bobbed back up to the waterline.

All four are fixed. Water and amphibious Pets now follow you, chase what they're fighting on land and in water, and stay at the depth they swim to.

Pets stop suffocating in walls

Since 4.0, calling a Pet only checked whether the block at its feet was clear. In a one-block-high gap, that passed, so the Pet appeared with its head in whatever block was above, started suffocating, and got despawned and re-summoned into the exact same block over and over, spamming despawn messages.

MyPet now checks the Pet actually fits before spawning it, and before teleporting it to you. If there's genuinely no room you get a "no space" message instead of a loop, and /petsendaway always cancels an auto-recall.

MySQL: the right database, finally

If your MySQL server hosts more than one MyPet database (a MyPet 3 install, another server's tables, etc) MyPet could check the wrong one. A working 4.x install could spot MyPet 3 tables in someone else's database, decide it needed upgrading, and shut itself down partway through migrating a database that was already fine.

MyPet now only ever looks at the database it's connected to. SQLite servers were never affected.

Full changelog:

Added

• Added AllowMetamorphosis to pet-config.yml, off by default - turn it on and a Tadpole Pet grows into a Frog Pet, keeping its name, experience, skilltree, health and inventory
• Added a fresh-install signal to the /mypet editor session data, so the Configurator can tell a brand-new server from one you've already set up

Changed

• Prepared the plugin's codebase for having several Pets out at once
• World group data is stored in a new format; migrated automatically from the old version

Fixed

• Fixed water-breathing Pets never attacking and never swimming to a target they had picked
• Fixed water-breathing Pets floating to the surface instead of staying at the depth they swim to
• Fixed stranded water-breathing Pets freezing in place the moment they picked a target
• Fixed Axolotl, Drowned, Frog and Turtle Pets freezing in place instead of walking to their target
• Fixed Pets suffocating in walls and looping through respawn when called, and /petsendaway failing to stop it
• Fixed MyPet reading its tables from another MyPet database on the same MySQL server
• Fixed some ridden Pets never coming back down, and saddled horse Pets losing their jump
• Fixed released baby Pets never growing up
• Fixed Tadpole Pets turning into an unowned frog when they grow up

Thanks again for choosing MyPet!

MyPet 4.0.2 is here! Equipping armor and weapons onto Pets is back after being lost in the 4.0 rewrite, Piglins and Hoglins stop hunting the player who tamed them, and stranded fish finally follow you instead of flopping in place.

MyPet 4.0.2 supports Minecraft 1.20.5 through 26.2, unchanged from 4.0.1. Upgrading is a drop-in jar swap.

If MyPet is useful to you or your players, please consider buying me a coffee: https://ko-fi.com/UserDerezzed

Equipping your Pet with armor/tools by hand is back

Sneak and right-click a Pet with armor or a weapon to put it on, and use shears to strip its gear back off. The interaction was lost when the old NMS modules were removed in 4.0 and is now reimplemented.

Gear the Pet was already wearing is dropped rather than destroyed, in every game mode including creative, and shears take durability damage properly so Unbreaking and the Unbreakable flag are honoured. A slot the species cannot use leaves the click alone instead of swallowing it, so gestures like opening a horse Pet's inventory still work.

New AI Brain Disabling options

Piglin, Piglin Brute, Hoglin and Zoglin Pets kept hunting their own owner. These four run their AI from the newer vanilla "brain" system which previously wasn't configurable and I had to account for aggressive behavior across every individual mob.

Now, it is now a per-pet-type Brain.Disabled list in pet-config.yml, declared for all 21 brain-driven Pet types, so you can choose which vanilla AI MyPet leaves alone or switch back on what it removes. Entries are activity:<name> to empty a whole brain activity, or behavior:<ClassName> for a single behaviour. Emptying the list for the four Pets above gives you the vanilla behaviour back, owner-hunting included.

Full changelog:

Added

• Added a per-pet-type Brain.Disabled list to pet-config.yml for switching a Pet's vanilla brain AI on or off, declared for all 21 brain-driven Pet types; entries are activity:<name> or behavior:<ClassName>, and unmatched or malformed entries are reported instead of ignored
• Re-added equipping armor and weapons onto a Pet by sneaking and right-clicking it, and stripping its gear with shears, behind MyPet.extended.equip
• Added a Copy with NBT button to /petadmin info for when a config needs to match one exact item rather than any item of that type

Changed

• /petadmin info's Copy button now gives you a plain item name that config.yml, pet-config.yml and skilltree drop pools all accept
• Voxel.Shop downloads now arrive correctly named, and update posts there render properly instead of showing raw formatting codes

Fixed

• Fixed Piglin, Piglin Brute, Hoglin and Zoglin Pets attacking their own owner
• Fixed sneaking and right-clicking a Pet doing nothing on modern clients, which had broken the sit toggle and every other sneak-gated interaction
• Fixed fish and other water-breathing Pets flopping in place on land instead of following their owner
• Fixed aquatic Pets sinking instead of holding position when told to stay in water
• Fixed Warden Pets' roar-target removal silently doing nothing for an entire release line
• Fixed a Pet restored from the database losing track of the gear it was wearing, so nothing dropped on death or release and shears stripped only recently equipped items
• On Folia: fixed the Mining, Lumberjack and Fishing skills erroring and leaving the Pet stuck when it follows its owner to another world
• Fixed auto-respawn never paying out for players without op, even with the MyPet.command.respawn permission
• Fixed skilltrees deleted in the web editor coming back after Review & Save
• Fixed /petadmin info's Copy button producing a value configs reject with "is not a valid item ID!"

Removed

• Removed the MiniaturePets, PvPArena, UltimateSurvivalGames and SurvivalGames hooks; all four plugins are abandoned

Thanks for choosing MyPet!

MyPet 4.0 is here - the biggest update in MyPet's history. MyPet has been rewritten from the ground up: Pets are now real vanilla mobs, the version-specific compatibility code that powered MyPet for over a decade is gone entirely, and just about every part of the plugin - GUIs, commands, skills, skilltrees, configuration - has been rebuilt or expanded.

MyPet 4.0.0 supports Minecraft 1.20.5 through 26.2. And, because MyPet no longer contains any version-specific code, future Minecraft versions are supported automatically - usually with no plugin update required.

As previously announced, MyPet 4.0 requires Paper (or a Paper derivative such as Purpur or Folia) and Minecraft 1.20.5 or newer. If you're still on Spigot, switching is as easy as swapping your server jar: https://papermc.io. Yes, Folia is now supported.

Upgrading from MyPet 3 is automatic: your configs, Pets, skilltrees, locale files, and database are all migrated if necessary on first startup. Take a backup first anyway - you should always have one.

Currently, MyPet is primarily developed by one person! All of these updates are produced for free in my spare time. If you or your players appreciate MyPet, please consider buying me a coffee or lunch (it means a lot): https://ko-fi.com/UserDerezzed

This update was made possible by Keyle, MaksyKun, Jakllp, Haeherfeder, Gullysdad, Mercurialmusic, the Altitude team (Teriuihi and Destro174 for using MyPet 4 months before anyone else; cultistclam for our amazing new MyPet artwork, akaemilyyy for dupe finding), the HeavenCreations team (LoupSavage who made our great new custom models that are included with MyPet 4,) those who have tipped me on Ko-Fi (seriously, huge thanks!) and the MyPet 4 Alpha Testers. Thank you!

Now, onto the changes!

A complete rewrite

Since 2012, MyPet has shipped a compatibility module for every supported Minecraft version. By 3.14, that meant 20 of them. MyPet 4.0 has zero. Pets are now real vanilla mobs driven through Paper's official APIs, which means:

• New Minecraft versions work automatically. No more waiting for a MyPet update after every Minecraft release.
• Folia support. MyPet now runs on Folia's regionized threading.
• Better performance. The plugin has been heavily optimized across the board.
• More vanilla behaviors. Some Pets now benefit from their unique vanilla actions.

Pets also now save their exact entity state when captured, stored, or released. Armor, stats, variants, everything - which stamps out a whole family of long-standing data-loss bugs.

Text formatting has moved from legacy & color codes to MiniMessage (<green>, <gradient>, hover/click events, and more). Your existing pet names, configs, locales, and skilltrees are converted automatically.

New GUIs and a browser-based live editor

Every menu in MyPet has been rebuilt on a brand-new GUI system, headlined by /pet, a single-screen pet management menu with 17 buttons covering everything your Pet can do: rename, call, info, stay, auto-respawn, send-away, store, switch, trade, release, skilltree selection and info, backpack, behavior, pickup, stop-attacking, and volume. Menu layouts are defined in JSON, so you can customize them.

For server owners, MyPet now ships a browser-based live editor: run /mypet editor and edit your config.yml, pet-config.yml, exp-config.yml, pet shops, skilltrees, and locale files in your browser. Changes apply live to the running server. Skills are provided to the editor by your server, so third-party and newly added skills appear in the skilltree editor automatically.

There's also a new volume slider for Pet sounds, opened from /petsettings volume or the volume button in /pet, with presets at 0/25/50/75/100%.

Skills and skilltrees

MyPet 4.0 adds ten new skills, bringing the total to 31: Mining, Lumberjack, Fishing, Sniff, Potion, Toolbox, Taunt, Armor, Climb, and Camouflage. The Ride skill also gains a new climb upgrade.

To put them to work, MyPet now ships 124 built-in skilltrees (up from 5), and introduces skilltree ascension: skilltrees can form ascension paths, ascending is free, it bypasses MyPet.Skilltree.ChooseOnce, and skilltree Weight can now be set per pet type.

Third-party plugins can now register their own custom skills through the API, and they'll show up in the web editor's skilltree editor automatically.

New Pets, custom models, and ride sharing

Five new species can now be tamed: Nautilus, Zombie Nautilus, Happy Ghast, Camel Husk, and Parched.

Beyond vanilla mobs, MyPet 4.0 supports custom-model Pets through BetterModel (recommended), ModelEngine, ItemsAdder, and MythicMobs, plus custom model overlays on top of regular Pets. Your server's custom bosses and creatures can now be Pets.

MyPet 4 includes two custom model Pets - the Capybara and the Chameleon! These are provided by HeavenCreations, huge thanks to them.

Riding got a major upgrade: the new /petride command mounts your active Pet, and owners can use /petride driver|passengers allow|disallow to let other players ride along, with new per-pet config options (RequireRideSkill, RequireRideItem, RequireSaddle, non-owner mount permissions) so server owners control exactly who can ride what. Flying Pets get tuned, configurable flight speeds (OverrideFlySpeed/FlySpeed).

Per-pet creation options now use readable string names (variant:lucy, profession:armorer, collar:red instead of numeric IDs), Pets spawn with their species' vanilla health by default, and the per-pet config surface has grown massively - from Creeper explosion controls to Ender Dragon block-damage gates to PreventDryOut for Axolotls.

Full changelog:

Added

• Added /pet - a single-screen pet management menu with 17 buttons (rename, call, info, stay, auto-respawn, send-away, store, switch, trade, release, choose-skilltree, skilltree-info, backpack, behavior, pickup, stop-attacking, volume)
• Added a completely new GUI system - every menu has been rebuilt, and menu layouts are customizable via JSON definitions
• Added /mypet editor - a browser-based live editor for config.yml, pet-config.yml, exp-config.yml, pet shops, skilltrees, and locale files; skills are provided by the server so third-party skills appear automatically
• Added a Pet volume slider GUI - opens from /petsettings volume or the volume button in /pet, with five presets at 0/25/50/75/100%
• Added Volume-Control and Volume-Mode (per-owner or per-player) flags to hooks-config.yml under each packet adapter's section
• Added support for Nautilus, Zombie Nautilus, Happy Ghast, Camel Husk, and Parched Pets
• Added support for custom Pet types through BetterModel (recommended), ModelEngine, ItemsAdder, and MythicMobs
• Added support for custom model overlays for Pets through BetterModel (recommended), ModelEngine, and ItemsAdder
• Added ten new skills: Mining, Lumberjack, Fishing, Sniff, Potion, Toolbox, Taunt, Armor, Climb, and Camouflage
• Added a "climb" upgrade to the Ride skill
• Added 124 new default skilltrees with an ascension play style
• Added skilltree ascension - ascending is free, bypasses MyPet.Skilltree.ChooseOnce, and skilltree Weight can be set per pet type
• Added /petride - mounts your active Pet (requires the Ride skill unless RequireRideSkill is disabled)
• Added /petride driver|passengers allow|disallow - lets Pet owners opt in to other players riding their Pet
• Added /petinv as an alias for /petinventory
• Added /petadmin switch (user) GUI for switching another player's active Pet
• Added per-command admin permissions
• Added support for Folia servers
• Added support for WorldGuard-Folia
• Added automatic migration from MyPet 3 - configs, Pets and their inventories, skilltrees, locale files, pet shops, and the database schema are all converted on first startup (including legacy color codes → MiniMessage)
• Added an auto-updater for users downloading releases from BuiltByBit and dev builds from Discord
• Added the %mypet_exp_current% and %mypet_exp_max% placeholders for a Pet's level progress
• Added the %mypet_owns_pet% placeholder for whether a player owns any Pet, active or stored
• Added support for the golden dandelion freezing a Pet's aging (Minecraft 26.1+)
• Added OverrideFlySpeed (default false) and FlySpeed config options per Pet type
• Added riding config options for naturally rideable Pets: RequireRideSkill (default true), RequireRideItem (default true), AllowNonOwnerPrimaryMount (default false), AllowNonOwnerSecondaryMount for multi-passenger Pets (default true), RequireSaddle (default false), and AllowNonOwnerSaddle (default false)
• Added AllowFlintAndSteelExplode, AllowNonOwnerFlintAndSteel, AllowExplosionBlockDamage, AllowExplosionEntityDamage, and AllowLightningPower config options for Creeper Pets (all default false)
• Added GrantEndAdvancementOnKill, AllowBlockDamage, AllowPlayerContactDamage, and AllowEntityContactDamage config options for Ender Dragon Pets (all default false)
• Added CanSwim, PreventSuffocation, and PreventDaylightBurn config options for Pets that swim, suffocate on land, or burn in daylight
• Added PreventDryOut config option for Axolotl Pets (default true)
• Added PreventSuffocation config option for Nautilus Pets (default true)
• Added PreventNaturalGrowup config option for baby Pets (default true)
• Added PreventProfessionChange config option for Villager Pets (default true)
• Added AllowLeafDestruction config option for Ravager Pets (default false)
• Added AllowLightningVariantFlip config option for Mooshroom Pets (default false)
• Added AllowLightningConversion config options for Pig and Villager Pets (default false)
• Added CanGiveMilk config option for Goat Pets
• Added CanDropScute config option for Turtle Pets
• Added Can-Shed-Scute config option for Armadillo Pets
• Added Can-Drop-Slimeball config option for sneezing baby Panda Pets
• Added Can-Drop-Horn config option for Goat Pets
• Added Can-Dig-Seeds config option for Sniffer Pets
• Added CanHurtPlayersOnContact config option for Slime and Magma Cube Pets (default false)
• Added harness:<color> creation option for Happy Ghast Pets
• Added variant creation option for Salmon Pets
• Added oxidation and waxed creation options for Copper Golem Pets

Changed

• Pets are now real vanilla mobs - the NMS entity system was replaced with Bukkit spawning and Paper's Mob Goal API
• MyPet now requires Paper (or a derivative), Minecraft 1.20.5+, and Java 21
• Replaced the command system with Paper's Brigadier Commands API
• Replaced legacy & color codes with MiniMessage (<green>, <gradient>, hover/click events, …) everywhere - existing files are migrated automatically
• Replaced all messaging with Adventure Components and the Keyle NBT library with Adventure NBT
• Pets now save their exact entity state (armor, stats, variants, and more) on capture, store, and release, preventing Pet data loss
• Each Pet now spawns with its species' vanilla health unless overridden by a config value or skill
• Per-pet creation options now take string names - variant:lucy for Axolotl, profession:armorer for Villager, collar:red for Cat/Wolf, etc.
• Horse Pet variant: creation option split into color: and style:
• Tropical Fish Pet variant: creation option split into pattern:, body-color:, and pattern-color:
• Cat Pet creation option renamed from type: to variant:
• Snow Golem Pet sheared creation option renamed to derp
• /petadmin create now aborts with a clear error when an option value isn't recognized for the chosen Pet type
• A Pet now receives a default name when the name: argument is given with no value
• Default Pet names are now resolved from Mojang's vanilla entity translations in the creator's language
• Renamed the CanGlide config option for flying Pets to CanFly (old configs are migrated)
• Replaced the WillShake config option with AllowZombification for Hoglin, Piglin, and Piglin Brute Pets (default false)
• Replaced the dead Snow Golem FixSnowTrack config option with DisableSnowTrack (default true)
• Renamed /petsettings idle-volume to /petsettings volume and broadened its scope from ambient-only sounds to every sound a Pet emits
• Removed the Javascript experience calculator in favor of new experience modes (linear, power, exponential)
• The MyPet.experience.multiplier permission now accepts any integer instead of 6 hardcoded tiers (e.g. .183 for 1.83x)
• Ender Dragon Pets no longer require ProtocolLib
• Required libraries are now downloaded on startup through the server's library downloader
• Updated all hook dependencies to their latest versions; replaced the Factions hook with FactionsUUID and the Kingdoms hook with KingdomsX
• Miscellaneous performance improvements across the plugin

Fixed (from MyPet 3)

• Fixed Ender Dragon Pets being unable to follow their owner
• Fixed Ender Dragon Pets being unrideable
• Fixed Armadillo Pets moving while scared on 1.21.5+
• Fixed the Angry leash flag only working for Wolves
• Fixed the Zone-Messages config option for the Beacon skill
• Fixed Pets stepping on pressure plates being checked against WorldGuard's INTERACT region flag at the owner's location instead of the Pet's own
• Starvation damage from the hunger system is now reported as its own named damage source instead of an unnamed generic one

Removed

• Removed support for Bukkit/Spigot servers (Paper and derivatives only)
• Removed support for server versions below 1.20.5
• Removed support for MongoDB databases
• Removed support for no-permissions mode (aka OP-only mode)
• Removed the legacy permission system
• Removed support for legacy item IDs
• Removed the 5 classic skilltrees (replaced by the 124 new built-in skilltrees)
• Removed the Skip-Target-AI-Ticks config option
• Removed the Copper Golem OxidationTime config option (vanilla now controls oxidation cadence)
• Removed the Update.ReplaceOld config option
• Removed the noshake creation option for Hoglin, Piglin, and Piglin Brute Pets - zombification immunity is controlled by the AllowZombification config option
• Removed the has-stung creation option for Bee Pets
• Removed hooks for discontinued or outdated plugins: AncientRPG, BossShopPro, FabledSkyblock, GangsPlus, GriefPreventionPlus, MagicSpells, Minigames, MobStacker (both versions), NoCheatPlus, PreciousStones, PvPDiffTimer, SkillAPI, WorldGuardCustomFlags, mcMMO v1, MythicMobs v4, WorldGuard v6, and pre-v6 PlotSquared

For developers

MyPet 4.0 is a breaking API release. The highlights:

• Pet-related API classes and events were renamed from MyPet____ to Pet____ (e.g. MyPetInfo → PetInfo, MyPetManager → PetManager, MyPet*Event → Pet*Event)
• The global Configuration class is gone - plugin-wide config values are ConfigKey<?> fields on MyPetGlobal, and per-pet config flags are ConfigKey<?> fields on each PetXxx class
• Third-party plugins can register custom skills, and per-pet event handlers/lifecycle hooks via PetBehavior and PetLifecycleHook
• Registration methods (registerSkill/Requirement/LeashFlag/Hook) now throw IllegalArgumentException on invalid input instead of failing silently
• The public API surface was reduced and javadocs were added to most API methods; API builds are published as 4.0.0 on the UserDerezzed repository

The full migration guide is on the wiki: Developer Guide → Migrating from MyPet 3

Thanks for choosing MyPet!