bevy_fairy 0.12.0

An agentic debugger for Bevy games: a Bevy plugin that exposes the game's state over BRP, and an MCP server that lets a coding agent read and drive it
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

//! The MCP server half of `bevy_fairy`.
//!
//! This is the half an agent talks to: it speaks the Model Context Protocol over stdio, and
//! talks to a running Bevy game over the Bevy Remote Protocol. It is a separate process from
//! the game, and it does not link the plugin -- a game can be inspected by Bevy's own BRP
//! methods without this crate's plugin, and this server can drive any game that exposes BRP.
//!
//! Everything here is behind the `server` feature. A game that only wants the plugin compiles
//! none of it.

// Re-export commonly used types
pub mod prelude {
    //! Common imports for typical usage
    pub use crate::server::brp_client::BrpClient;
    pub use crate::server::brp_messages::{BrpRequest, BrpResponse};
    pub use crate::server::error::{Error, Result};
    pub use crate::server::query_parser::{QueryParser, RegexQueryParser};
    pub use crate::server::experiment_system::{Action, ActionExecutor, ActionResult};
    pub use crate::server::hypothesis_system::{Hypothesis, TestResult, TestRunner};
    pub use crate::server::timeline_branching::{BranchId, TimelineBranchManager};
    pub use crate::server::recording_system::{Recording, RecordingState};
    pub use crate::server::playback_system::PlaybackState;
}


// Core functionality
pub mod error;
pub mod config;
pub mod circuit_breaker;
pub mod contact_sheet;
mod watch_fields;

// Communication
pub mod brp;
pub mod brp_client;
pub mod brp_command_handler;
pub mod brp_validation;
pub mod debug_command_processor;
pub mod entity_inspector;
pub mod mcp_server_v2;
pub mod mcp_tools;

// Performance profiling and visual debugging

// Issue detection

// Performance budget monitoring


// Query and observation
pub mod query_parser;
pub mod semantic_analyzer;

// Experimentation and testing
pub mod experiment_system;
pub mod hypothesis_system;

// State management
pub mod recording_system;
pub mod playback_system;
pub mod timeline_branching;
pub mod state_diff;

// Analysis and monitoring
pub mod anomaly_detector;

// Infrastructure
pub mod tools;

// Panic prevention and reliability testing

// Machine learning and pattern recognition (Epic BEVDBG-013)

// Bevy reflection integration (Epic BEVDBG-012)
pub mod bevy_reflection;

// Production features

// Epic 6: Production features - Observability stack

// Legacy name for the `brp` module, removed hand-rolled `brp_messages` module.
pub use brp as brp_messages;