Common issues
This guide tries to help you with different issues that you might encounter. If you are unable to solve your issue by yourself don't hesitate and get in contact with me or create a Github Issue.
Bad performance
This might be one of the most common issues that you might encounter.
To debug performance it might be a good idea to enable fps logging by adding the LogFpsSystem to your Environment.
There can be a lot of reasons for bad performance:
-
Usage of suboptimal rendering API The rendering API might not be detected correctly for your software / hardware setting. To fix this, try to set the rendering API explicitly in this guide.
-
Constant adding and removing of entities Adding and removing entities and / or components can reduce performance of the entity component system dramatically by invalidating caches. Try to avoid adding and removing entities whenever you can.
-
Preparing shaders during run time Rendering of shaders can be very slow. Good news is, that shaders use caches to reduce load on the system. To make best use of the shader caches, reuse same sprite whenever you can and prepare shaders on scene load. Learn more in this guide.
Error messages in console
Some users might experience similar error messages like the ones below. Simply ignore these. Sadly these cannot be avoided on MacOs. see
2025-01-25 09:47:35.498 java[2300:79574] +[IMKClient subclass]: chose IMKClient_Modern
2025-01-25 09:47:35.498 java[2300:79574] +[IMKInputSession subclass]: chose IMKInputSession_Modern