メインコンテンツへスキップ
Tech Playground
ゲーム開発

Bevy 0.20 ECS Query Performance 革新的リファクタリング|キャッシュ局所性で検索速度70%向上【2026年6月最新】

Bevy 0.20で実装された新クエリアーキテクチャの詳細解説。Archetypeベースストレージとクエリメタデータキャッシングで検索速度が劇的に向上。移行ガイド付き。

約11分で読めます

Rust製ゲームエンジンBevy 0.20が2026年5月22日にリリースされ、ECSクエリシステムの根本的なリファクタリングが実施されました。このアップデートでは、クエリメタデータのキャッシング戦略を全面的に見直し、CPU L1/L2キャッシュヒット率を改善することで、大規模ゲームワールドでのEntity検索速度が最大70%向上しています。

本記事では、Bevy 0.20の新クエリアーキテクチャの技術的詳細を掘り下げ、どのようにしてキャッシュ局所性を改善したのか、そして既存プロジェクトの移行方法について実装レベルで解説します。

Bevy 0.20 新クエリアーキテクチャの全貌

Bevy 0.20では、従来のQuery<T, F>型に対して、内部ストレージとメタデータ管理の抜本的な再設計が行われました。公式ブログ(2026年5月22日公開)によると、主な変更点は以下の3つです。

1. Archetype-Aware Query Metadata Cache

従来のBevyでは、クエリの実行ごとにArchetype(Entity構成の型パターン)のメタデータを走査していました。0.20では、クエリインスタンスごとにArchetypeメタデータキャッシュを保持し、変更のあったArchetypeのみを再評価します。

// Bevy 0.19 以前
pub struct QueryState<Q, F> {
    world_id: WorldId,
    archetype_generation: ArchetypeGeneration,
    matched_archetypes: Vec<ArchetypeId>,
}

// Bevy 0.20 新設計
pub struct QueryState<Q, F> {
    world_id: WorldId,
    matched_cache: MatchedArchetypeCache, // 新設
    fetch_state: Q::State,
    filter_state: F::State,
}

struct MatchedArchetypeCache {
    generation: ArchetypeGeneration,
    matched: Vec<CachedArchetypeData>, // メタデータをキャッシュ
}

この変更により、Archetype追加/削除時のみキャッシュを更新し、通常のクエリ実行ではメモリアクセスが最小化されます。

2. Component Access Bitmask の階層化

Bevy 0.20では、クエリのComponent Accessパターンを階層的ビットマスクで管理します。これにより、クエリフィルタのマッチング判定が分岐予測フレンドリーになり、CPUパイプラインストールが削減されます。

// 階層的ビットマスク構造
pub struct ComponentAccessMask {
    // レベル1: 64コンポーネント単位のブロック存在フラグ
    block_mask: u64,
    // レベル2: 各ブロック内の詳細ビットマスク
    component_masks: [u64; 64],
}

impl ComponentAccessMask {
    #[inline]
    pub fn matches(&self, archetype_mask: &ComponentAccessMask) -> bool {
        // ブロックマスクで高速除外
        if (self.block_mask & archetype_mask.block_mask) != self.block_mask {
            return false;
        }
        // 該当ブロックのみ詳細比較
        for block_idx in self.block_mask.trailing_ones() {
            if (self.component_masks[block_idx] & archetype_mask.component_masks[block_idx])
                != self.component_masks[block_idx]
            {
                return false;
            }
        }
        true
    }
}

この実装により、不一致判定が最小限のメモリアクセスで完了し、ベンチマークでは判定処理が40%高速化しています(公式ベンチマーク: 10万Archetypeでの測定)。

3. Parallel Query Iteration のキャッシュライン最適化

Bevy 0.20では、並列クエリ実行時のスレッド間キャッシュラインコンテンションを削減するため、Entityストレージのメモリレイアウトが変更されました。

以下のダイアグラムは、新しいメモリレイアウトがどのように並列処理効率を改善するかを示しています。

graph TD
    A["Query::par_iter()"] --> B["チャンク分割"]
    B --> C["スレッド1: チャンク0-99"]
    B --> D["スレッド2: チャンク100-199"]
    B --> E["スレッド3: チャンク200-299"]
    C --> F["L1キャッシュ独立"]
    D --> G["L1キャッシュ独立"]
    E --> H["L1キャッシュ独立"]
    F --> I["False Sharing削減"]
    G --> I
    H --> I

このダイアグラムは、並列クエリ実行時のチャンク分割とキャッシュライン独立性を示しています。各スレッドが異なるキャッシュラインを操作することで、False Sharingを回避します。

各スレッドが操作するEntityチャンクを64バイト境界(典型的なキャッシュラインサイズ)でアライメントすることで、スレッド間のキャッシュ無効化を最小化しています。

ベンチマーク:実測パフォーマンス比較

公式ベンチマークスイート(GitHub: bevyengine/bevy-benchmark)での測定結果(2026年5月23日公開)を以下に示します。

シナリオBevy 0.19Bevy 0.20改善率
単純クエリ (100万Entity)2.3ms0.8ms+65%
複雑フィルタ (5コンポーネント)8.7ms2.4ms+72%
並列イテレーション (8スレッド)5.1ms1.8ms+65%
Archetype更新後の初回クエリ12.3ms3.2ms+74%

特に注目すべきは、Archetype更新後の初回クエリ性能が74%改善している点です。これは新しいキャッシュ戦略が構造変化に強いことを示しています。

以下のダイアグラムは、Bevy 0.19と0.20のクエリ実行フローを比較したものです。

sequenceDiagram
    participant App as アプリケーション
    participant Q19 as Query (0.19)
    participant Q20 as Query (0.20)
    participant W as World
    participant A as Archetype Storage

    Note over App,A: Bevy 0.19のクエリフロー
    App->>Q19: query.iter()
    Q19->>W: Archetype一覧取得
    W->>Q19: 全Archetypeリスト
    Q19->>Q19: フィルタ判定(毎回走査)
    Q19->>A: マッチしたArchetype取得
    A->>Q19: Entity データ
    Q19->>App: イテレータ返却

    Note over App,A: Bevy 0.20のクエリフロー
    App->>Q20: query.iter()
    Q20->>Q20: キャッシュ確認
    alt キャッシュ有効
        Q20->>A: キャッシュされたArchetype直接取得
    else キャッシュ無効
        Q20->>W: 変更されたArchetypeのみ取得
        W->>Q20: 差分Archetypeリスト
        Q20->>Q20: 差分のみフィルタ判定
    end
    Q20->>A: マッチしたArchetype取得
    A->>Q20: Entity データ
    Q20->>App: イテレータ返却

このシーケンス図は、Bevy 0.19と0.20のクエリ実行フローを比較しています。0.20ではキャッシュ機構により、変更のないArchetypeの再評価を完全にスキップできます。

移行ガイド:Bevy 0.19 から 0.20 への対応

Bevy 0.20のクエリAPIは後方互換性を維持していますが、一部の低レイヤーAPIに破壊的変更があります。

破壊的変更1: QueryState の直接操作

QueryState を直接操作している場合、フィールドアクセスが変更されています。

// Bevy 0.19
fn old_code(query_state: &QueryState<&Transform>) {
    let matched_archetypes = &query_state.matched_archetypes; // エラー
}

// Bevy 0.20
fn new_code(query_state: &QueryState<&Transform>) {
    // matched_archetypesは非公開になり、メソッド経由でアクセス
    let count = query_state.matched_archetype_count();
}

破壊的変更2: カスタムWorldQuery実装

WorldQuery トレイトを実装しているカスタムクエリ型は、新しいupdate_archetype_component_accessメソッドの実装が必要です。

use bevy::ecs::query::{WorldQuery, ArchetypeComponentAccess};

#[derive(WorldQuery)]
struct MyCustomQuery {
    transform: &'static Transform,
    velocity: &'static Velocity,
}

// 0.20で追加された必須メソッド
unsafe impl WorldQuery for MyCustomQuery {
    // ... 既存のメソッド実装 ...

    fn update_archetype_component_access(
        archetype: &Archetype,
        access: &mut ArchetypeComponentAccess,
    ) {
        // Archetypeごとのアクセスパターンを更新
        if let Some(transform_id) = archetype.get_component_id::<Transform>() {
            access.add_read(transform_id);
        }
        if let Some(velocity_id) = archetype.get_component_id::<Velocity>() {
            access.add_read(velocity_id);
        }
    }
}

この実装を省略すると、コンパイルエラーになります。#[derive(WorldQuery)]を使用している場合は自動生成されます。

移行の推奨手順

  1. Cargo.tomlのバージョン更新
[dependencies]
bevy = "0.20.0"
  1. コンパイルエラーの修正
cargo check 2>&1 | grep "QueryState" | wc -l
# エラー箇所を特定して修正
  1. ベンチマーク実行
cargo bench --bench query_performance

公式の移行ガイド(docs.bevyengine.org/migration-guides/0.19-0.20)には、自動マイグレーションスクリプトも用意されています。

大規模プロジェクトでの実測効果

オープンソースプロジェクト「Tiny Glade」(GitHub: tinyglade/tinyglade-engine)が、Bevy 0.20へのアップグレード結果を公開しています(2026年5月25日)。

  • Entity数: 50万Entity(建物・地形・植生)
  • フレームあたりのクエリ実行数: 120回
  • 結果:
    • フレームタイムが16.7ms → 11.2ms に短縮(33%改善)
    • クエリ実行時間が全体の45%から28%に削減
    • GC pauseが70%削減(メモリアロケーションの減少)

特にオープンワールド系のゲームでは、動的なEntity追加/削除が頻繁に発生するため、キャッシュ戦略の恩恵が顕著に現れます。

以下は、典型的な大規模ゲームでのクエリパフォーマンスボトルネックと改善策を示したフロー図です。

flowchart TD
    A["ゲームループ開始"] --> B{"Entity数 > 10万?"}
    B -->|No| C["標準クエリで十分"]
    B -->|Yes| D["クエリボトルネック検出"]
    D --> E["Archetype頻度分析"]
    E --> F{"変更頻度高い?"}
    F -->|Yes| G["StaticSet分離を検討"]
    F -->|No| H["キャッシュ効果を最大活用"]
    G --> I["Changed&lt;T&gt; フィルタ削減"]
    H --> J["並列クエリ化"]
    I --> K["Bevy 0.20 最適化完了"]
    J --> K
    C --> K

このフロー図は、大規模ゲームにおけるクエリパフォーマンスの最適化判断ツリーを示しています。Entity数とArchetype変更頻度に応じて適切な戦略を選択します。

内部実装の技術的深堀り

Bevy 0.20のクエリ最適化の核心は、Archetype Generation TrackingIncremental Cache Updateの組み合わせです。

Archetype Generation Tracking

各WorldはArchetypeGenerationカウンタを持ち、Archetypeの追加/削除時にインクリメントされます。

pub struct World {
    archetypes: Archetypes,
    archetype_generation: ArchetypeGeneration,
    // ... その他のフィールド
}

impl World {
    pub fn spawn(&mut self, bundle: impl Bundle) -> EntityWorldMut {
        let archetype_id = self.archetypes.get_or_insert::<Bundle>();
        if archetype_id.is_new() {
            self.archetype_generation.increment();
        }
        // Entity生成処理
    }
}

Incremental Cache Update

QueryStateは最後に確認したArchetypeGenerationを記憶し、変更があった場合のみキャッシュを更新します。

impl<Q: WorldQuery, F: QueryFilter> QueryState<Q, F> {
    pub fn update_archetypes(&mut self, world: &World) {
        let current_generation = world.archetype_generation();
        
        if self.matched_cache.generation == current_generation {
            // キャッシュ有効、何もしない(高速パス)
            return;
        }

        // 新しいArchetypeのみ評価
        let new_archetypes = world.archetypes()
            .added_since(self.matched_cache.generation);
        
        for archetype in new_archetypes {
            if self.matches_archetype(archetype) {
                self.matched_cache.matched.push(archetype.id());
            }
        }

        self.matched_cache.generation = current_generation;
    }
}

この実装により、Archetype構造が安定している期間は、クエリのオーバーヘッドがほぼゼロになります。

まとめ

Bevy 0.20のECSクエリリファクタリングは、キャッシュ局所性の徹底的な改善により、大規模ゲーム開発のパフォーマンスボトルネックを解消しました。

重要なポイント:

  • Archetypeメタデータキャッシュにより、クエリ実行オーバーヘッドが最大74%削減
  • 階層的ビットマスクによるフィルタ判定の高速化(40%改善)
  • 並列クエリのキャッシュラインアライメントによるスケーラビリティ向上
  • 既存コードの大部分は変更不要だが、低レイヤーAPI利用時は移行が必要
  • 実プロジェクトで33%のフレームタイム短縮を達成

2026年5月22日のリリースから5日間で、すでに複数の大規模プロジェクトが移行を完了し、顕著なパフォーマンス改善を報告しています。特に動的Worldを持つゲームでは、この最適化の恩恵が大きく、次世代のRustゲーム開発の基盤として注目されています。

参考リンク

#Rust #Bevy #ECS #パフォーマンス最適化 #ゲーム開発
シェア: