Repository navigation
EasyNPCs v1.0.7
Commit: 65ee6ee
Date: 2026-01-28
What's Changed
Add chunk-safe NPC spawning, auto-recovery, and deduplication
Ensure NPCs spawn reliably after server restarts by verifying chunks
are loaded before entity operations. Add multiple redundant recovery
paths and prevent NPC duplication.
- Add ensureChunkAndRun() to verify/async-load chunks before spawn
- Add ChunkPreLoadProcessEvent handler to spawn NPCs when players approach
- Add StartWorldEvent handler to restore NPCs when world starts ticking
- Add Universe.getUniverseReady() handler for startup recovery
- Add periodic validation (2min) to re-apply non-persistent Interactions
- Add restoreNPCsInChunk() for chunk-level NPC restoration
- Add world filter to restoreNPCs() to avoid restoring all worlds
- Fix onPlayerJoinWorld() removing npcStorage.load() that wiped entityUuid state
- Fix reapplyInteractions() to trigger full restore if entity is missing
- Reduce per-interaction debug logging from INFO to FINE level
Co-Authored-By: Claude Opus 4.5 noreply@anthropic.com
Installation
- Download
EasyNPCs-v1.0.7.jar - Place in your Hytale server's
mods/folder - Restart the server