flecs

Highlights

• New Data Oriented Hierarchies blog!
• Lots of code hardening with 130 bugfixes and more than 500 new test cases
• New entity range API that correctly handles recycling
• New script features:

// NEW: include statements
include assets.flecs

// NEW: functions
fn color(x: i32, z: i32) -> Rgba {
    {x, 0, z, 1.0}
}

for x in 0..10 {
    for z in 0..10 {
        "e_{x}_{z}" {
            // NEW: assign expressions to components directly
            Rgb: color(x, z).rgb // NEW: swizzle operators
        }
    }
}

• Multiple inspector panels in the explorer:

• New entities can now be created from the explorer:

• New dialog for adding components:

Release notes

This version includes the following improvements:

• [core] Add optimized function for moving small component values across tables
• [core] Improve performance of reparenting for non-fragmenting hierarchies
• [core] Throw error when changing children of already instantiated prefab
• [core] Create default range for already created entities when calling ecs_entity_range_new()
• [core] Throw INVALID_OPERATION assert when parenting to not-alive parent
• [core] Allow for overriding component hooks to support hot reloading
• [core] Reduce the size of ecs_ref_t
• [core] Introduce new update() API for modifying existing systems/observers
• [core] Do not assert when entities have non-unique names
• [core] Always run exclusive access checks when feature is enabled
• [core] Implement new range API that correctly handles recycling
• [core] Allow for specifying offset for ecs_delete_empty_tables() function
• [core] Improve error message when using ecs_field for sparse component
• [cpp] Replace usage of NULL with nullptr in C++ API headers
• [cpp] Replace deprecated std::is_trivial
• [cpp] Implement query group iterator for C++ API
• [[cpp](https://github.com

Highlights

• New non-fragmenting hierarchy storage which significantly boosts asset hierarchy performance.
• Reduced binary footprint of C++ component registration
• Lots of hardening bugfixes for issues detected by the AFL fuzzer (1500 new tests since the last release!).
• New math and Perlin noise functions for Flecs Script.
• Added support for vector type operations in Flecs script:

const a = Position: {10, 20}
const b = Position: {1, 2}
const c: a + b // {a.x + b.x, a.y + b.y}

• C++ API improvements:

New function to iterate all entities in the world:

world.each([](flecs::entity e) {
  // ...
});

System components can now be deduced from each() arguments:

world.system("Move")
  .each([](Position& p, const Velocity& v) {
    // ...
  });

Improved APIs for creating hierarchies:

flecs::entity p = world.entity(world, "p");

// Create child for ChildOf (fragmenting) hierarchy
flecs::entity child_a = world.entity(world, p, "a");

// Create child for Parent (non-fragmenting) hierarchy
flecs::entity child_b = world.entity(world, flecs::Parent{p}, "b");

Release notes

This version includes the following bugfixes:

• [core] Fix issue where ref could return wrong value during recursive entity cleanup.
• [core] Fix issue with deferred calls to modified() for DontFragment components.
• [core] Fix issue where it wasn't possible to inherit from entity with Relationship trait.
• [core] Fix issue with cloning entity symbols.
• [core] Fix issue with removing sparse pair with recycled target.
• [core] Fix issue with overriding existing exclusive relationships.
• [core] Fix issue with combining relationship constraints with component disabling.
• [core] Return 0 for negative indices in ecs_get_target().
• [core] Fix ecs_table_get_target() bounds check to reject negative and >=count indices.
• [core] Fix issue with deleting sparse component while deferring is suspended.
• [core] Fix issue with using has()/get() from hooks.
• [core] Fix issue where deferred setting after removing on a prefab instance could fail.
• [core] Fix issues with sparse components and overriding.
• [core] Fix race condition in component registration code.
• [core] Fix assert when toggling component before adding it to any entity.
• [[core]](https://

Highlights

• Small release to fix a few bugs that got identified shortly after releasing 4.1.3

Release notes

This version includes the following bugfixes:

• [core] Revert change for supporting types with destructive move semantics (caused crash)
• [core] Fix issues with ordered children trait and nested prefabs
• [core] Fix issues with ordered children trait and prefab slots
• [core] Fix assert when reclaiming component record (using world.shrink()) for large component id

This version includes the following improvements:

• [core] Add ecs_get_version() function (thanks @tabdroid-1!)
• [docs] Correct bazel test example in building flecs manual
• [docs] Fix documentation for ECS_QUERY, ECS_QUERY_DEFINE and ecs_query macros

New Contributors

• @tabdroid-1 made their first contribution in https://github.com/SanderMertens/flecs/pull/1891

Full Changelog: https://github.com/SanderMertens/flecs/compare/v4.1.3...v4.1.4

Highlights

• Improved RAM utilization (create fewer component records, reclaim more data from component vectors, smaller entity administration)
• A new Building Flecs manual!

Release notes

This version includes the following bugfixes:

• [core] Fix issue with reparenting named ordered children
• [core] Fix issue with ecs_ref_get and ecs_shrink
• [core] Fix issue where order or instantiated prefab children could be wrong
• [core] Fix assert for DontFragment relationship during world cleanup
• [core] Fix issue with how dtors get called for types that don't support non-destructive moves (thanks @Watermelon914!)
• [os_api] Add missing WIN32_LEAN_AND_MEAN before new windows.h include
• [queries] Fix assert when using set_varfor query with one cascad term
• [meta] Fix corruption with deserializing into enum with non-32 bits underlying type

This version includes the following improvements:

• [cpp] Allow set_ptr to be used for pairs (thanks @Reddy-dev!)
• [cpp] Add owns_second() and auto_override_second() methods (thanks @Reddy-dev!)
• [core] Don't always create (T, *), (*, T) component records (only create when used)
• [core] Don't create component record when registering trait
• [core] Don't create component record for ChildOf
• [core] Prevent creation of (*, 0) component record
• [core] Reclaim component vectors to actual count instead of power of 2
• [core] Reclaim memory from map data structures on world.shrink()
• [core] Reclaim memory from empty component records during world.shrink()
• [core] Remove redundant component record lookup in observable code
• [core] Add convenience macro's for iterating component records and queries
• [core] Remve redundant ecs_map_params_t type and functions
• [core] Remove redundant if (table) check in table cache
• [core] Remove redundant check on cache initialized in ecs_table_cache_get
• [core] Remove ecs_record_t::cr field
• [core] Increase the maximum size of error strings
• [core] Prevent modifications to map while iterating
• [core] Don't call flecs_notify_on_add when creating entity in root table
• [core] Add ecs_is_defer_suspended() function
• [observers] Remove redundant check in flecs_emit
• [queries] Add traversal tests for (ChildOf, _)
• [queries] Add performance tracing to ecs_query_init
• [os_api] Use ecs_os_free() instead of free() in flecs_dump_backtrace()
• [stats] Track memory of new locked components map
• [docs] Add Rescue Ops: Wildfire to README
• [docs] Rename custom_runner examples to run_callback
• [docs] Remove outdated references to .singleton() API
• [docs] Add new "Building Flecs" manual (previously on quickstart)

Breaking changes:

• None

New Contributors

• @Watermelon914 made their first contribution in https://github.com/SanderMertens/flecs/pull/1874

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