⚠️ Beta State

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.

Mouse Input Events

Print all mouse events including button, motion, cursor, and scroll.

Introduction

This example prints every mouse event for debugging. Useful when building custom input handling.

from pybevy.prelude import *
from pybevy.input import MouseButtonInput, MouseMotion, MouseWheel
from pybevy.window import CursorMoved

Event Readers

Read button, motion, cursor position, and scroll events separately.

def mouse_events(
    buttons: MessageReader[MouseButtonInput],
    motion: MessageReader[MouseMotion],
    cursor: MessageReader[CursorMoved],
    scroll: MessageReader[MouseWheel],
) -> None:
    for event in buttons.read():
        print(f"Button: {event.button}, State: {event.state}")
 
    for event in motion.read():
        print(f"Motion delta: ({event.delta.x:.1f}, {event.delta.y:.1f})")
 
    for event in cursor.read():
        print(f"Cursor at: ({event.position.x:.0f}, {event.position.y:.0f})")
 
    for event in scroll.read():
        print(f"Scroll: ({event.x:.1f}, {event.y:.1f})")

Running the App

@entrypoint
def main(app: App) -> App:
    return app.add_plugins(DefaultPlugins).add_systems(Update, mouse_events)
 
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.

$pybevy watch mouse_input_events.py

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.