GlymeraFakePlayers - Changelog

v2.0.0 (2026-04-11)

Bug Fixes

• Chunk Load Crash (Scale Bug): Fixed a Hytale engine bug where Model.ModelReference.DEFAULT_PLAYER_MODEL has scale = -1.0f, causing "Scale must be greater than 0" errors when chunks containing NPC entities were loaded. Fix: Reflection override sets DEFAULT_PLAYER_MODEL.scale = 1.0f at plugin startup.
• NPC Duplication: Fixed an issue where 100+ fake player NPCs would accumulate in the world after multiple player joins or world changes. Root cause: onPlayerJoin() spawned new NPCs without removing existing ones, and transient spawned flags reset on server restart. Fix: Added forEachChunk scan that removes all stale GlymeraFakePlayer NPCs before spawning a new batch.
• Shutdown Cleanup: NPCs are now properly despawned during plugin shutdown to prevent them from being persisted into chunk data.

Technical Details

• setup() now patches DEFAULT_PLAYER_MODEL.scale via reflection before any NPC spawning occurs
• onPlayerJoin() iterates all chunks with NPCEntity components, identifies stale NPCs by role name "GlymeraFakePlayer", and removes them via store.removeEntity(ref, RemoveReason.REMOVE) before calling spawnAllFakePlayers()
• shutdown() iterates all fake players and removes their entities from all worlds
• onPlayerDisconnect() marks all NPCs as unspawned when the last real player leaves

v1.0.0 (2026-04-08)

• Initial release
• Fake player NPCs with configurable names and skins
• Dynamic player count with day/night curve
• Tab list integration
• Query protocol support (Minecraft-compatible)
• Chat simulation with configurable messages