PetCore

Cozy, persistent companion pets — the comfort feature your server has been missing, done cleanly and safely.

PetCore gives every player a companion animal that walks behind them, can be told to stay or to live in a little home they build, and grows a bond over time. There are no runtime dependencies at all: no database, no economy plugin, no WorldGuard, no Bedrock form toolkit. Everything is YAML you can read, and every word a player sees ships in English and Dutch.

🐾 Cozy, never combat. Pets are invulnerable, never deal or take damage, and never target players or mobs. No stat buffs, no combat perks — ever.

---

🐾 Adopt from a catalogue

A YAML catalogue of adoptable animals — cats, dogs, foxes, allays, sniffers and more — each with a display name, permission gate, locomotion profile, biome affinity and lore. Players hold several up to a permission-driven slot limit and switch between them. Optional per-pet cost runs a console command first, so adoption can charge coins through any economy plugin.

/pet adopt | switch | release | info.

🚶 Three cozy behaviours

• Follow — walks just behind the owner, using the real Paper pathfinder, and teleports to catch up past a distance.
• Stay — sits where it was left.
• Home — lives inside a region the owner outlines, gently wandering within it.

/pet behind | stay | cage | tphere | tpcage.

🏡 A pet home you build yourself

Two corners, /pet savecage, and a particle outline confirms it. Validated by self-contained size rules (a hard 3×3×2 minimum and configurable max width/length/height/chunks/area), an optional allowed-worlds list, and an optional distance-from-owner limit — no land-claim or WorldGuard dependency.

💛 Bonding with tiers

Bond grows from cozy moments — being near you, resting by a campfire, travelling together, a first rename — each on its own cooldown so it can't be farmed. Crossing a tier unlocks titles, emotes and cosmetics, and can grant a one-time reward (items, XP, console commands, chat lines — never a direct economy call). A calm bond bar and action-bar notices keep it gentle.

🎀 Cozy cosmetics

Random personalities, unlockable titles and emotes, cosmetic home styles, seasonal particle cosmetics (that appear only in their months), a live mood, favourite-biome discovery, and keepsakes. All decorative, all in config.

🎁 Gifts

Send another player a cozy pet gift they redeem with a token — applying a small bond bonus and optionally a cosmetic, title or keepsake. An optional module that builds on pets through the service registry.

/petgift <player> <gift> [note] | list | claim <token>.

---

Entity hygiene is the headline

This plugin spawns and persists mobs, so it's built to be tidy:

• Every pet is tagged with its owner and id and spawned non-persistent, so the server never writes it to region files — a crash or restart leaves no loose pets.
• Orphan/duplicate sweeps run on enable, on chunk load, and on a timer; /pet cleanup and /pet debug are there when you want them.
• Pets despawn when their owner logs off and re-spawn on join; caged pets only materialise when a player is near.
• No plugin chunk tickets by default — pets never keep chunks loaded unless you opt in.
• Movement uses the public Mob#getPathfinder() API and Bukkit teleport — no NMS, no reflection, nothing version-locked.

Modular & standalone

Every feature is a module you can switch on or off. pets is the foundation; the optional gifts module depends on it and, if pets are off, logs one line and stays off rather than half-starting. No database, no external plugin dependencies, all data in plain YAML.

Built for Paper 26.2

Adventure components everywhere, registry-based type lookups, pre-spawn entity configuration, the modern pathfinder API. Ships with JUnit tests for the parts that matter: home-bounds containment and the size-validation matrix, PetMode / PetSupportProfile parsing, bond cap-and-cooldown bookkeeping, permission-driven slot resolution, pet-id normalisation, and cosmetic/season parsing.

Languages

English and Dutch out of the box. Every player-facing string is in a language file — add your own by copying one.