Highlights

• The C++ API now needs to be compiled as C++17!
• Lots of bugfixes for the new DontFragment storage
• New API and explorer dashboard for detailed memory statistics

• New endpoints and explorer pages for inspecting tables, components and queries

Release notes

This version includes the following bugfixes:

• [cpp] Fix assert when using ecs_query_next in system.run callback
• [cpp] Fix issue with setting term flags with flecs::term::flags() method
• [cpp] Fix compiler error when using set/assign with non-copyable type
• [core] Fix issue where ecs_ref_t could point to incorrect ecs_record_t after shrink
• [core] Fix issue with remove_all() and query rematching
• [core] Fix issue where enqueueing command in on_add hook didn't work when bulk creating
• [core] Fix memory leak for error message when FLECS_SOFT_ASSERT is defined
• [core] Fix memory corruption when overriding components with on_set hooks
• [core] Fix issue where on_set hook could be called multiple times for same component on override
• [core] Fix issue where ECS_ON_ADD, ECS_ON_SET, ECS_ON_REMOVE macros could provide bad address when bulk creating
• [core] Fix issue where get_alive() could return current generation of not-alive entity
• [core] Fix issue where on_add hooks could get incorrectly invoked during delete_empty_tables()
• [core] Fix assert when empty table is cleared with hooks registered
• [core] Fix issue with flecs_sparse_ensure and recycled entity ids
• [core] Fix issue where table edges for DontFragment relationships weren't cleaned up
• [core] Fix issue with deleting parent with DontFragment relationship to child
• [core] Fix issue with cleaning up DontFragment components during bulk deletion
• [core] Fix issue where component record for not-alive id would be created in table graph code
• [core] Fix issue where sometimes the wrong entity was removed from a DontFragment sparse set
• [core] Fix issue with instantiating component with (With, DontFragmentComponent)
• [core] Fix issue where component was removed before calling regular component observer

This version includes the following improvements:

• [cpp] Update to C++17
• [cpp] Add world() method to flecs::untyped_ref
• [cpp] Use faster compile time alternative to std::conditional (thanks @dementive!)
• [cpp] Add C++ API for singleton enum constants
• [core] Remove unused block allocators
• [core] Remove unused deser_stack allocator
• [core] Add error messages when adding traits after creating queries
• [core] Improve accuracy of frame pacing
• [core] Add compiler flags to build info type
• [core] Don't use private allocator in hashmap data structure
• [core] Add support for using children() with sparse relationships
• [core] Add Singleton trait to module entities
• [os-api] Add Windows implementation for flecs_dump_backtrace()
• [queries] Make terms with Any wildcard cacheable
• [queries] Improve performance of toggle queries
• [observers] Remove ecs_observer_desc_t::observable field
• [meta] Parent anonymous as_types to opaque type to avoid anonymous types in root scope
• [meta] Implement lax member checks when deserializing
• [meta] Add support for character literals (thanks @degustaf!)
• [meta] Add filter callback to serializer that allows for blacklisting components
• [stats] Implement new API for getting detailed memory statistics
• [stats] Store pointer to ecs_world_stats_t in EcsWorldStats to improve memory utilization
• [stats] Fix isue with setting command count in WorldSummary component
• [stats] Add more statistics to WorldSummary component
• [rest] Add action endpoint with method to shrink memory
• [rest] Add /components REST endpoint
• [rest] Add /queries REST endpoint
• [rest] Improve statistics of endpoint

Breaking changes:

• The C++ API must now be compiled as C++17 (https://github.com/SanderMertens/flecs/discussions/466#discussioncomment-14491474)

New Contributors

• @degustaf made their first contribution in https://github.com/SanderMertens/flecs/pull/1791
• @dementive made their first contribution in https://github.com/SanderMertens/flecs/pull/1788
• @thomashodgkinson1987 made their first contribution in https://github.com/SanderMertens/flecs/pull/1813
• @Real-Septicake made their first contribution in https://github.com/SanderMertens/flecs/pull/1834

Full Changelog: https://github.com/SanderMertens/flecs/compare/v4.1.1...v4.1.2