zay-es-debug

What problem does it solve?

This Skill addresses common pain points for Java developers using the Zay-ES Entity-Component-System library in JMonkeyEngine projects, including EntitySets that fail to update, memory leaks from unreleased entity resources, component query mismatches, and concurrent modification crashes during entity processing.

Core Features & Use Cases

• EntitySet Troubleshooting: Step-by-step checks to resolve issues where added entities do not appear in EntitySet results, including verifying applyChanges() calls and correct component queries.
• Memory Leak Prevention: Identifies unreleased EntitySets as the root cause of growing memory usage and out-of-memory errors in long-running ECS applications.
• Official Pattern Guidance: Provides vetted Zay-ES best practices including the visualization pattern for syncing entities to visual objects, the decay pattern for time-based entity removal, and correct component mutation workflows to avoid conflicting writes.
• Use Case: If you are developing a Subspace Infinity server or JMonkeyEngine game and your ship entities are not rendering, or your server crashes with ConcurrentModificationException when processing entity updates, this Skill walks you through the root cause and verified fix.

Quick Start

Use the zay-es-debug skill to diagnose why your Zay-ES EntitySet is not reflecting newly added entities and get the correct fix for your ECS workflow.