[makspll]

Stacked on #650. Fourth of the script system PRs.

Queries

• :optional(C) / :optional_read(C) retrieve C from entities that have it; for entities that don't, it is nil in result:components(). ScriptQueryResult::components is now Vec<Option<ReflectReference>>.
• :added(C) / :changed(C) are filters like with.
  • Bevy's QueryBuilder can't express change filters dynamically. So the query declares a read of C (ref_id, which also requires C, the same as Changed<T>), and ScriptQueryBuilder::result_for checks the ticks of each matched entity.
  • Inside systems they're relative to the system's last run. Outside, in world.query():build(), they're relative to the world's last change tick, like World::query.
• world.query() and script systems now build results through the same result_for.

Disjoint queries

• The old rule rejected any component shared between params ("Non-disjoint query"). It's replaced by Bevy's get_conflicts_single, so component(A):with(B) + component(A):without(B) is allowed. Conflicting params are reported once, and the system doesn't run.
• Soundness: queries can now write C on some archetypes and only read it on others, so ArchetypeFilter keeps separate read and write bitsets per component. Without that, the write permission (per component) would let the script write C on entities that Bevy thinks this system only reads. The Lua test checks that the write through the read-only query fails.

Fix

DynamicScriptSystem::run_unsafe incremented the change tick but never stored last_run, so "since last run" meant "ever". last_run is now updated whenever the callback runs.

Tests

• Rust: changed relative to last_change_tick (only the modified entity matches), and absent optionals are None.
• Lua:
  • optional nils
  • a disjoint pair of queries runs, and a conflicting pair doesn't
  • the read/write split rejects the bad write
• cargo check --workspace --all-targets is clean. The ecs bindings' Name lookup used components, and is adapted.

🤖 Generated with Claude Code

[semanticdiff-com]

Review changes with  

Changed Files

File	Status
crates/bindings/bevy_mod_scripting_bevy_ecs_bindings/src/lib.rs	83% smaller
crates/bevy_mod_scripting_world/src/archetype_filter.rs	64% smaller
crates/bevy_mod_scripting_core/src/script_system.rs	14% smaller
crates/bevy_mod_scripting_bindings/src/world_extensions.rs	11% smaller
crates/bevy_mod_scripting_bindings/src/query.rs	10% smaller
crates/bevy_mod_scripting_functions/src/core.rs	1% smaller
assets/tests/add_system/optional_components_and_disjoint_queries.lua	0% smaller
crates/bevy_mod_scripting_bindings/src/reference.rs	0% smaller
crates/bevy_mod_scripting_world/src/world.rs	0% smaller
docs/src/ReleaseNotes/0.23-to-0.24.md	Unsupported file format
docs/src/ScriptSystems/introduction.md	Unsupported file format

[github-actions]

Bencher Report

Project	Bevy Scripting
Branch	agent/script-systems-queries
Testbed	linux-gha

⚠️ WARNING: Truncated view!

The full continuous benchmarking report exceeds the maximum length allowed on this platform.

🐰 View full continuous benchmarking report in Bencher