GlymeraPets - Changelog

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.