Skip to content

Commit

Permalink
Document performance issue with Added/Changed filters (#218)
Browse files Browse the repository at this point in the history
  • Loading branch information
UkoeHB authored Mar 15, 2024
1 parent 4d554de commit eb25bbd
Showing 1 changed file with 6 additions and 0 deletions.
6 changes: 6 additions & 0 deletions src/lib.rs
Original file line number Diff line number Diff line change
Expand Up @@ -246,6 +246,12 @@ This pairs nicely with server state serialization and keeps saves clean.
You can use [`replicate_into`](scene::replicate_into) to
fill [`DynamicScene`] with replicated entities and their components.
**Performance note**: The blueprint pattern makes heavy use of [`Added`] and
[`Changed`] filters, which are not true archetype-level filters like [`With`]
or [`Without`]. See [the Bevy docs](https://docs.rs/bevy/latest/bevy/ecs/prelude/struct.Added.html#time-complexity)
for more details. There is also an [open Bevy ticket](https://github.com/bevyengine/bevy/issues/5097)
for improving the performance of `Added`/`Changed`.
### Component relations
Sometimes components depend on each other. For example, [`Parent`] and
Expand Down

0 comments on commit eb25bbd

Please sign in to comment.