PyBevy is in an early and experimental stage. The API is incomplete, subject to breaking changes without notice, and you should expect bugs. Many features are still under development.
Clear Color
Set the window background color and change it at runtime.
Introduction
The clear color is the background color of the window — pixels not drawn to remain this color. Press Space to change it.
from pybevy.prelude import *Setup and Color Change
def setup(commands: Commands) -> None:
commands.spawn(Camera2d())
def change_color(input: Res[ButtonInput], clear_color: ResMut[ClearColor]) -> None:
if input.just_pressed(KeyCode.Space):
clear_color.color = Color.srgb(0.5, 0.0, 0.5)
print("Background changed to purple!")Running the App
@entrypoint
def main(app: App) -> App:
return (
app
.insert_resource(ClearColor(Color.srgb(0.5, 0.5, 0.9)))
.add_plugins(DefaultPlugins)
.add_systems(Startup, setup)
.add_systems(Update, change_color)
)
if __name__ == "__main__":
main().run()Running this example
Use PyBevy's hot reload feature to run and develop this example. If you don't have PyBevy installed, check out the Quick Start guide.
The code will reload automatically when you make changes to the file.
From Python to Rust
Notice how the core concepts in the code—Commands, Assets, App, and Systems—are identical to the original Bevy example?
This is the power of pybevy! It lets you learn Bevy's powerful, data-driven architecture in friendly Python.
When your project grows and you're ready for maximum, native performance, you'll already know the concepts to start writing systems in Bevy Engine with Rust.