GlymeraPets - Changelog

v6.0.0 (2026-10-16) — pets keep their look and follow again (Hytale 0.7)

• Fix for Hytale 0.7: entity handles go stale within a tick. Since Update 7 the engine replaces the internal handle of an entity (NPC or player) continuously; a handle kept for a moment and used later points at nothing, and the old code then silently skipped its work. All delayed and deferred actions now look the entity up again by its id right before acting.
• Pet and pet-shop appearance: applied right after the spawn and again half a second later by id, so pets no longer show the default creature.
• Despawn and shop removal remove the NPC reliably.
• Upgrade: replace the jar in mods/, keep the plugin's data folder and restart the server.

v5.0.0 (2026-10-12) — Hytale 0.7.0 (Update 7)

• Rebuilt for Hytale 0.7.0 (Update 7 / Chapter 1). Requires server 0.7.0 or newer; this version does not run on 0.6.x, and the previous version does not run on 0.7.0 (the server removed the old block and chunk API).
• Migrated to the 0.7.0 world API: block reads and writes now go through the chunk store and block sections (BlockOperations), chunk ticking through the engine's new marker component, spawn points through the asynchronous spawn provider.
• Mod icon added (icon-256.png in the jar) so the plugin shows its picture in the world's mod list instead of a question mark.
• Upgrade: delete the old jar from mods/, drop in the new one and keep the plugin's data folder — configs and saved data carry over unchanged. Restart the server.
• Fix (0.7.0 asset renames): Hytale renamed the vanilla NPC roles Spawn_Void → Void_Spawn and Spectre_Void → Void_Spectre; the plugin now uses the new names in the pet catalog.

v4.0.0 (2026-08-30) — Shop NPC vanishing on Hytale 0.6 fixed

Fixed

• The pet-shop NPC no longer disappears when nobody is near it or after a server restart.
  Hytale 0.6 loads and ticks the world in 32-block cubes (sections), each on its own. When no
  player is near, a section stops ticking and the engine drops every non-persistent entity in
  it - which is exactly what the shop NPC is since v2 (so it can never duplicate). Nothing tells the plugin when that section wakes up again, so the old
  "re-create on chunk load" path never ran and the NPC stayed gone. Saved data was never lost;
  only the visible NPC was missing.

Changed

• New presence keeper: every 2 seconds the plugin checks each saved shop whose NPC is missing
  and re-creates it as soon as a player is within 64 blocks and its section is loaded and
  ticking.
• The shop NPC is no longer spawned while nobody is near it (on chunk load or at server start);
  that only made the engine park it and log Entity has moved into a chunk that isn't currently loaded! every few seconds. Cost is negligible (a few distance checks per shop every 2 s).

Notes

• shops.json is untouched; pets, shop GUI, prices and commands are unchanged.
• v2's ghost cleanup (duplicate shop NPC removal) still runs.

v3.0.0 (2026-08-28) — Hytale 0.6.0 (Update 6)

• Rebuilt for Hytale 0.6.0 (Update 6). Requires server 0.6.0 or newer; this version does not run on 0.5.x, and older versions of this plugin do not run on 0.6.0.
• Migrated to the 0.6.0 APIs (network protocol hytale/3, new command-permission API, block/chunk/entity API changes). Everything that was open to players before is open to players again.
• Upgrade: delete the old jar from mods/, drop in the new one and keep the plugin's data folder — configs and saved data carry over unchanged. Restart the server.

v2.0.0 (2026-06-04)

Fixed

• Shop NPCs no longer duplicate. Previously the engine persisted each spawned shop
  NPC to the world, so on every restart a saved "ghost" copy was rehydrated and a fresh
  one was spawned from shops.json - the shop keeper multiplied over time. The old
  cleanup ran on the first player join with fixed delays, which often missed ghosts whose
  chunk had not loaded yet.

Changed

• Shop NPCs are now spawned non-persistent, so the engine never saves them to disk and
  no ghost copy can ever be rehydrated. Because of this, a shop NPC is (re)spawned on the
  load of the chunk it lives in rather than on player join - exactly one keeper per
  saved shop, every time.
• On chunk load, any leftover shop NPC from older versions is cleaned up automatically, so
  existing duplicate keepers are removed the first time you visit them.
• Removed the old first-join sweep/respawn logic entirely.

Notes

• No changes to pets, the shop GUI, payments, the creature roster, commands or config -
  this release is purely the duplication fix. Existing shops.json and player data are
  fully compatible.

v1.0.0 (2026-06-04)

Initial release.

Pets

• Peaceful, controllable companion creatures. Every creature uses a single peaceful,
  invulnerable follow-role; the bought creature's look is applied on top via appearance
  swap, so pets are always friendly regardless of which creature they imitate.
• Pets follow their owner (LockedTarget) and are teleported to the owner when they get
  too far away (followTeleportDistance, default 20 blocks).
• Pets are immortal (cannot be killed).
• 1 pet active at a time (hard-coded), up to 10 owned (maxOwnedPets, default 10).
• Pets persist per player and the active pet is re-summoned on login.
• Right-clicking a pet shows a hearts particle (affection), like GlymeraCats/GlymeraDogs.

Creature roster

• 154 configurable creatures. 111 pet-sized land & air creatures are enabled by default;
  43 borderline-size / large creatures are included but disabled by default and can be
  switched on by an admin.
• Aquatic creatures (fish, jellyfish, eel, shark, whale, lobster) are intentionally not
  included - they do not work as land-following pets.

Shop

• Placeable shop NPC: a creature-appearance keeper (Klops Gentleman by default,
  configurable via shopAppearance). Right-click it to open the buy GUI; click a creature
  to buy it. Each pet's price shows the payment item as an icon (or the money amount).
• Admins get the shop block with /gpets giveshop and place it; /gpets shopremove
  removes the nearest shop and refunds the block. Only admins can place shops.
• Restart-safe and duplicate-safe: on the first join after a restart, stray shop NPCs of
  our role are swept and exactly one per saved shop is respawned (same approach as
  GlymeraMerchant).

Payment

• Per-creature payment, configurable individually: items or money. The settings GUI
  shows both values with the active one marked [ACTIVE], and the item as an icon.
• Defaults: 3x Greater Essence of Life (Ingredient_Life_Essence_Concentrated),
  or 1000 money.
• Money support is optional and uses GlymeraMerchant if installed, otherwise a
  VaultUnlocked economy. If neither is present, item payments still work.

GUIs & commands

• /gpets - pet management GUI (call / dismiss / release, list owned pets).
• /gpets admin - per-creature settings GUI (OP): enable/disable, switch items<->money,
  adjust amount, and "Set Item" to set the payment item to whatever you are holding.
• /gpets shop - open the buy GUI directly.
• /gpets call|dismiss|release <name>, /gpets list.
• /gpets giveshop, /gpets shopremove, /gpets reload (OP).

Notes

• Fully config-driven (mods/Glymera_GlymeraPets/config.json, /gpets reload). No logging,
  no network access.