`simvx.core.physics._bodies`¶

Physics body nodes: rigid, static, and kinematic bodies.

Private leaf module: import via the simvx.core.physics facade.

Module Contents¶

Classes¶

`RigidBody3D`	3D rigid body with full physics simulation.
`RigidBody2D`	2D rigid body with full physics simulation.
`StaticBody3D`	Immovable 3D physics body. Used for floors, walls, and obstacles.
`StaticBody2D`	Immovable 2D physics body. Used for platforms and walls.
`KinematicBody3D`	3D body moved by code that participates in collisions.
`KinematicBody2D`	2D body moved by code that participates in collisions.

Data¶

__all__

API¶

simvx.core.physics._bodies.__all__¶: [‘RigidBody2D’, ‘RigidBody3D’, ‘StaticBody2D’, ‘StaticBody3D’, ‘KinematicBody2D’, ‘KinematicBody3D’]

class simvx.core.physics._bodies.RigidBody3D(**kwargs)[source]¶

Bases: simvx.core.physics._bodies._PhysicsBodyMixin, simvx.core.nodes_3d.node3d.Node3D

3D rigid body with full physics simulation.

Supports dynamic, kinematic, and static modes. Collision shapes are set via the collision_shape property or auto-detected from child nodes.

Signals: body_entered: Emitted when another body starts overlapping. body_exited: Emitted when a previously overlapping body separates.

Example: class Ball(RigidBody3D): mass = Property(2.0) physics_material = PhysicsMaterial(restitution=0.8)

    def on_ready(self):
        self.collision_shape = SphereShape(radius=0.5)

Initialization

mass¶: ‘Property(…)’

gravity_scale¶: ‘Property(…)’

linear_damp¶: ‘Property(…)’

angular_damp¶: ‘Property(…)’

collision_layer¶: ‘Bitmask(…)’

collision_mask¶: ‘Bitmask(…)’

on_enter_tree() → None[source]¶

on_exit_tree() → None[source]¶

on_physics_process(dt: float) → None[source]¶

Called each physics tick. Override for custom behavior.

The PhysicsServer handles integration; this hook runs after forces are accumulated but before the server step.

apply_force(force, position=None) → None¶

apply_impulse(impulse, position=None) → None¶

apply_torque(torque) → None¶

property collision_shape: simvx.core.collision.CollisionShape | None¶

position¶: ‘_SpatialVecProperty(…)’

rotation¶: ‘Property(…)’

scale¶: ‘_SpatialVecProperty(…)’

render_layer¶: ‘Property(…)’

property rotation_degrees: simvx.core.math.types.Vec3¶

property world_position: simvx.core.math.types.Vec3¶

property world_rotation: simvx.core.math.types.Quat¶

property world_scale: simvx.core.math.types.Vec3¶

property forward: simvx.core.math.types.Vec3¶

property right: simvx.core.math.types.Vec3¶

property up: simvx.core.math.types.Vec3¶

translate(offset: tuple[float, float, float] | numpy.ndarray)¶

translate_global(offset: tuple[float, float, float] | numpy.ndarray)¶

rotate(axis: tuple[float, float, float] | numpy.ndarray, angle: float)¶

rotate_x(angle: float)¶

rotate_y(angle: float)¶

rotate_z(angle: float)¶

look_at(target: tuple[float, float, float] | numpy.ndarray, up=None)¶

face_along(forward: tuple[float, float, float] | numpy.ndarray, up: tuple[float, float, float] | numpy.ndarray | None = None) → None¶

set_render_layer(index: int, enabled: bool = True) → None¶

is_on_render_layer(index: int) → bool¶

wrap_bounds(bounds: tuple[float, float, float] | numpy.ndarray, margin: float = 1.0)¶

strict_errors: ClassVar[bool]¶: True

script_error_raised¶: ‘Signal(…)’

classmethod __init_subclass__(**kwargs)¶

property name: str¶

property process_mode: simvx.core.descriptors.ProcessMode¶

property visible: bool¶

reset_error() → None¶

add_child(node: simvx.core.node.Node) → simvx.core.node.Node¶

remove_child(node: simvx.core.node.Node)¶

reparent(new_parent: simvx.core.node.Node)¶

get_node(path: str) → simvx.core.node.Node¶

find_child(name: str, recursive: bool = False) → simvx.core.node.Node | None¶

find(target: type | str, recursive: bool = True) → simvx.core.node.Node | None¶

find_all(node_type: type, recursive: bool = True) → list¶

walk(*, include_self: bool = True) → collections.abc.Iterator[simvx.core.node.Node]¶

property path: str¶

add_to_group(group: str)¶

remove_from_group(group: str)¶

is_in_group(group: str) → bool¶

on_ready() → None¶

on_process(dt: float) → None¶

on_draw(renderer) → None¶

on_picked(event: simvx.core.events.InputEvent) → None¶

on_unhandled_input(event: simvx.core.events.TreeInputEvent) → None¶

start_coroutine(gen: simvx.core.descriptors.Coroutine) → simvx.core.descriptors.CoroutineHandle¶

stop_coroutine(gen_or_handle)¶

clear_children()¶

destroy()¶

property app¶

property tree: simvx.core.scene_tree.SceneTree¶

__getitem__(key: str)¶

classmethod get_properties() → dict[str, simvx.core.descriptors.Property]¶

__repr__()¶

class simvx.core.physics._bodies.RigidBody2D(**kwargs)[source]¶

Bases: simvx.core.physics._bodies._PhysicsBodyMixin, simvx.core.nodes_2d.node2d.Node2D

2D rigid body with full physics simulation.

Same API as RigidBody3D but works in 2D space (x, y). Angular velocity is a scalar (rotation around the z-axis).

Example: class Ball2D(RigidBody2D): mass = Property(1.0)

    def on_ready(self):
        self.collision_shape = SphereShape(radius=10)

Initialization

mass¶: ‘Property(…)’

gravity_scale¶: ‘Property(…)’

linear_damp¶: ‘Property(…)’

angular_damp¶: ‘Property(…)’

collision_layer¶: ‘Bitmask(…)’

collision_mask¶: ‘Bitmask(…)’

on_enter_tree() → None[source]¶

on_exit_tree() → None[source]¶

on_physics_process(dt: float) → None[source]¶

apply_force(force, position=None) → None¶

apply_impulse(impulse, position=None) → None¶

apply_torque(torque) → None¶

property collision_shape: simvx.core.collision.CollisionShape | None¶

position¶: ‘_SpatialVecProperty(…)’

rotation¶: ‘Property(…)’

scale¶: ‘_SpatialVecProperty(…)’

z_index¶: ‘Property(…)’

z_as_relative¶: ‘Property(…)’

render_layer¶: ‘Property(…)’

set_render_layer(index: int, enabled: bool = True) → None¶

is_on_render_layer(index: int) → bool¶

property absolute_z_index: int¶

property rotation_degrees: float¶

property world_position: simvx.core.math.types.Vec2¶

property world_rotation: float¶

property world_scale: simvx.core.math.types.Vec2¶

property world_transform: tuple[simvx.core.math.types.Vec2, simvx.core.math.types.Vec2, float]¶

property forward: simvx.core.math.types.Vec2¶

property right: simvx.core.math.types.Vec2¶

translate(offset: tuple[float, float] | numpy.ndarray)¶

rotate(radians: float)¶

rotate_deg(degrees: float)¶

look_at(target: tuple[float, float] | numpy.ndarray)¶

transform_points(points: list[simvx.core.math.types.Vec2]) → list[simvx.core.math.types.Vec2]¶

draw_polygon(renderer, points: list[simvx.core.math.types.Vec2], closed=True, colour=None)¶

wrap_screen(margin: float = 20)¶

strict_errors: ClassVar[bool]¶: True

script_error_raised¶: ‘Signal(…)’

classmethod __init_subclass__(**kwargs)¶

property name: str¶

property process_mode: simvx.core.descriptors.ProcessMode¶

property visible: bool¶

reset_error() → None¶

add_child(node: simvx.core.node.Node) → simvx.core.node.Node¶

remove_child(node: simvx.core.node.Node)¶

reparent(new_parent: simvx.core.node.Node)¶

get_node(path: str) → simvx.core.node.Node¶

find_child(name: str, recursive: bool = False) → simvx.core.node.Node | None¶

find(target: type | str, recursive: bool = True) → simvx.core.node.Node | None¶

find_all(node_type: type, recursive: bool = True) → list¶

walk(*, include_self: bool = True) → collections.abc.Iterator[simvx.core.node.Node]¶

property path: str¶

add_to_group(group: str)¶

remove_from_group(group: str)¶

is_in_group(group: str) → bool¶

on_ready() → None¶

on_process(dt: float) → None¶

on_draw(renderer) → None¶

on_picked(event: simvx.core.events.InputEvent) → None¶

on_unhandled_input(event: simvx.core.events.TreeInputEvent) → None¶

start_coroutine(gen: simvx.core.descriptors.Coroutine) → simvx.core.descriptors.CoroutineHandle¶

stop_coroutine(gen_or_handle)¶

clear_children()¶

destroy()¶

property app¶

property tree: simvx.core.scene_tree.SceneTree¶

__getitem__(key: str)¶

classmethod get_properties() → dict[str, simvx.core.descriptors.Property]¶

__repr__()¶

class simvx.core.physics._bodies.StaticBody3D(**kwargs)[source]¶

Bases: simvx.core.physics._bodies._PhysicsBodyMixin, simvx.core.nodes_3d.node3d.Node3D

Immovable 3D physics body. Used for floors, walls, and obstacles.

Has infinite effective mass: never moved by forces or collisions, but other bodies collide against it normally.

Example: ground = StaticBody3D(position=Vec3(0, -1, 0)) ground.collision_shape = BoxShape(half_extents=(50, 1, 50))

Initialization

collision_layer¶: ‘Bitmask(…)’

collision_mask¶: ‘Bitmask(…)’

on_enter_tree() → None[source]¶

on_exit_tree() → None[source]¶

apply_force(force, position=None) → None¶

apply_impulse(impulse, position=None) → None¶

apply_torque(torque) → None¶

property collision_shape: simvx.core.collision.CollisionShape | None¶

position¶: ‘_SpatialVecProperty(…)’

rotation¶: ‘Property(…)’

scale¶: ‘_SpatialVecProperty(…)’

render_layer¶: ‘Property(…)’

property rotation_degrees: simvx.core.math.types.Vec3¶

property world_position: simvx.core.math.types.Vec3¶

property world_rotation: simvx.core.math.types.Quat¶

property world_scale: simvx.core.math.types.Vec3¶

property forward: simvx.core.math.types.Vec3¶

property right: simvx.core.math.types.Vec3¶

property up: simvx.core.math.types.Vec3¶

translate(offset: tuple[float, float, float] | numpy.ndarray)¶

translate_global(offset: tuple[float, float, float] | numpy.ndarray)¶

rotate(axis: tuple[float, float, float] | numpy.ndarray, angle: float)¶

rotate_x(angle: float)¶

rotate_y(angle: float)¶

rotate_z(angle: float)¶

look_at(target: tuple[float, float, float] | numpy.ndarray, up=None)¶

face_along(forward: tuple[float, float, float] | numpy.ndarray, up: tuple[float, float, float] | numpy.ndarray | None = None) → None¶

set_render_layer(index: int, enabled: bool = True) → None¶

is_on_render_layer(index: int) → bool¶

wrap_bounds(bounds: tuple[float, float, float] | numpy.ndarray, margin: float = 1.0)¶

strict_errors: ClassVar[bool]¶: True

script_error_raised¶: ‘Signal(…)’

classmethod __init_subclass__(**kwargs)¶

property name: str¶

property process_mode: simvx.core.descriptors.ProcessMode¶

property visible: bool¶

reset_error() → None¶

add_child(node: simvx.core.node.Node) → simvx.core.node.Node¶

remove_child(node: simvx.core.node.Node)¶

reparent(new_parent: simvx.core.node.Node)¶

get_node(path: str) → simvx.core.node.Node¶

find_child(name: str, recursive: bool = False) → simvx.core.node.Node | None¶

find(target: type | str, recursive: bool = True) → simvx.core.node.Node | None¶

find_all(node_type: type, recursive: bool = True) → list¶

walk(*, include_self: bool = True) → collections.abc.Iterator[simvx.core.node.Node]¶

property path: str¶

add_to_group(group: str)¶

remove_from_group(group: str)¶

is_in_group(group: str) → bool¶

on_ready() → None¶

on_process(dt: float) → None¶

on_physics_process(dt: float) → None¶

on_draw(renderer) → None¶

on_picked(event: simvx.core.events.InputEvent) → None¶

on_unhandled_input(event: simvx.core.events.TreeInputEvent) → None¶

start_coroutine(gen: simvx.core.descriptors.Coroutine) → simvx.core.descriptors.CoroutineHandle¶

stop_coroutine(gen_or_handle)¶

clear_children()¶

destroy()¶

property app¶

property tree: simvx.core.scene_tree.SceneTree¶

__getitem__(key: str)¶

classmethod get_properties() → dict[str, simvx.core.descriptors.Property]¶

__repr__()¶

class simvx.core.physics._bodies.StaticBody2D(**kwargs)[source]¶

Bases: simvx.core.physics._bodies._PhysicsBodyMixin, simvx.core.nodes_2d.node2d.Node2D

Immovable 2D physics body. Used for platforms and walls.

Same behavior as StaticBody3D but in 2D space.

Initialization

collision_layer¶: ‘Bitmask(…)’

collision_mask¶: ‘Bitmask(…)’

on_enter_tree() → None[source]¶

on_exit_tree() → None[source]¶

apply_force(force, position=None) → None¶

apply_impulse(impulse, position=None) → None¶

apply_torque(torque) → None¶

property collision_shape: simvx.core.collision.CollisionShape | None¶

position¶: ‘_SpatialVecProperty(…)’

rotation¶: ‘Property(…)’

scale¶: ‘_SpatialVecProperty(…)’

z_index¶: ‘Property(…)’

z_as_relative¶: ‘Property(…)’

render_layer¶: ‘Property(…)’

set_render_layer(index: int, enabled: bool = True) → None¶

is_on_render_layer(index: int) → bool¶

property absolute_z_index: int¶

property rotation_degrees: float¶

property world_position: simvx.core.math.types.Vec2¶

property world_rotation: float¶

property world_scale: simvx.core.math.types.Vec2¶

property world_transform: tuple[simvx.core.math.types.Vec2, simvx.core.math.types.Vec2, float]¶

property forward: simvx.core.math.types.Vec2¶

property right: simvx.core.math.types.Vec2¶

translate(offset: tuple[float, float] | numpy.ndarray)¶

rotate(radians: float)¶

rotate_deg(degrees: float)¶

look_at(target: tuple[float, float] | numpy.ndarray)¶

transform_points(points: list[simvx.core.math.types.Vec2]) → list[simvx.core.math.types.Vec2]¶

draw_polygon(renderer, points: list[simvx.core.math.types.Vec2], closed=True, colour=None)¶

wrap_screen(margin: float = 20)¶

strict_errors: ClassVar[bool]¶: True

script_error_raised¶: ‘Signal(…)’

classmethod __init_subclass__(**kwargs)¶

property name: str¶

property process_mode: simvx.core.descriptors.ProcessMode¶

property visible: bool¶

reset_error() → None¶

add_child(node: simvx.core.node.Node) → simvx.core.node.Node¶

remove_child(node: simvx.core.node.Node)¶

reparent(new_parent: simvx.core.node.Node)¶

get_node(path: str) → simvx.core.node.Node¶

find_child(name: str, recursive: bool = False) → simvx.core.node.Node | None¶

find(target: type | str, recursive: bool = True) → simvx.core.node.Node | None¶

find_all(node_type: type, recursive: bool = True) → list¶

walk(*, include_self: bool = True) → collections.abc.Iterator[simvx.core.node.Node]¶

property path: str¶

add_to_group(group: str)¶

remove_from_group(group: str)¶

is_in_group(group: str) → bool¶

on_ready() → None¶

on_process(dt: float) → None¶

on_physics_process(dt: float) → None¶

on_draw(renderer) → None¶

on_picked(event: simvx.core.events.InputEvent) → None¶

on_unhandled_input(event: simvx.core.events.TreeInputEvent) → None¶

start_coroutine(gen: simvx.core.descriptors.Coroutine) → simvx.core.descriptors.CoroutineHandle¶

stop_coroutine(gen_or_handle)¶

clear_children()¶

destroy()¶

property app¶

property tree: simvx.core.scene_tree.SceneTree¶

__getitem__(key: str)¶

classmethod get_properties() → dict[str, simvx.core.descriptors.Property]¶

__repr__()¶

class simvx.core.physics._bodies.KinematicBody3D(**kwargs)[source]¶

Bases: simvx.core.physics._bodies._PhysicsBodyMixin, simvx.core.nodes_3d.node3d.Node3D

3D body moved by code that participates in collisions.

Not affected by gravity or forces, but pushes dynamic bodies. Use move_and_collide() for movement with collision detection.

Example: class Platform(KinematicBody3D): def on_physics_process(self, dt): self.linear_velocity = Vec3(0, math.sin(time) * 2, 0)

Initialization

collision_layer¶: ‘Bitmask(…)’

collision_mask¶: ‘Bitmask(…)’

on_enter_tree() → None[source]¶

on_exit_tree() → None[source]¶

move_and_collide(velocity, dt: float = 1.0) → simvx.core.physics._material.Contact | None[source]¶: Move by velocity*dt and return the first contact, or None.

on_physics_process(dt: float) → None[source]¶

apply_force(force, position=None) → None¶

apply_impulse(impulse, position=None) → None¶

apply_torque(torque) → None¶

property collision_shape: simvx.core.collision.CollisionShape | None¶

position¶: ‘_SpatialVecProperty(…)’

rotation¶: ‘Property(…)’

scale¶: ‘_SpatialVecProperty(…)’

render_layer¶: ‘Property(…)’

property rotation_degrees: simvx.core.math.types.Vec3¶

property world_position: simvx.core.math.types.Vec3¶

property world_rotation: simvx.core.math.types.Quat¶

property world_scale: simvx.core.math.types.Vec3¶

property forward: simvx.core.math.types.Vec3¶

property right: simvx.core.math.types.Vec3¶

property up: simvx.core.math.types.Vec3¶

translate(offset: tuple[float, float, float] | numpy.ndarray)¶

translate_global(offset: tuple[float, float, float] | numpy.ndarray)¶

rotate(axis: tuple[float, float, float] | numpy.ndarray, angle: float)¶

rotate_x(angle: float)¶

rotate_y(angle: float)¶

rotate_z(angle: float)¶

look_at(target: tuple[float, float, float] | numpy.ndarray, up=None)¶

face_along(forward: tuple[float, float, float] | numpy.ndarray, up: tuple[float, float, float] | numpy.ndarray | None = None) → None¶

set_render_layer(index: int, enabled: bool = True) → None¶

is_on_render_layer(index: int) → bool¶

wrap_bounds(bounds: tuple[float, float, float] | numpy.ndarray, margin: float = 1.0)¶

strict_errors: ClassVar[bool]¶: True

script_error_raised¶: ‘Signal(…)’

classmethod __init_subclass__(**kwargs)¶

property name: str¶

property process_mode: simvx.core.descriptors.ProcessMode¶

property visible: bool¶

reset_error() → None¶

add_child(node: simvx.core.node.Node) → simvx.core.node.Node¶

remove_child(node: simvx.core.node.Node)¶

reparent(new_parent: simvx.core.node.Node)¶

get_node(path: str) → simvx.core.node.Node¶

find_child(name: str, recursive: bool = False) → simvx.core.node.Node | None¶

find(target: type | str, recursive: bool = True) → simvx.core.node.Node | None¶

find_all(node_type: type, recursive: bool = True) → list¶

walk(*, include_self: bool = True) → collections.abc.Iterator[simvx.core.node.Node]¶

property path: str¶

add_to_group(group: str)¶

remove_from_group(group: str)¶

is_in_group(group: str) → bool¶

on_ready() → None¶

on_process(dt: float) → None¶

on_draw(renderer) → None¶

on_picked(event: simvx.core.events.InputEvent) → None¶

on_unhandled_input(event: simvx.core.events.TreeInputEvent) → None¶

start_coroutine(gen: simvx.core.descriptors.Coroutine) → simvx.core.descriptors.CoroutineHandle¶

stop_coroutine(gen_or_handle)¶

clear_children()¶

destroy()¶

property app¶

property tree: simvx.core.scene_tree.SceneTree¶

__getitem__(key: str)¶

classmethod get_properties() → dict[str, simvx.core.descriptors.Property]¶

__repr__()¶

class simvx.core.physics._bodies.KinematicBody2D(**kwargs)[source]¶

Bases: simvx.core.physics._bodies._PhysicsBodyMixin, simvx.core.nodes_2d.node2d.Node2D

2D body moved by code that participates in collisions.

Same behavior as KinematicBody3D but in 2D space.

Initialization

collision_layer¶: ‘Bitmask(…)’

collision_mask¶: ‘Bitmask(…)’

on_enter_tree() → None[source]¶

on_exit_tree() → None[source]¶

move_and_collide(velocity, dt: float = 1.0) → simvx.core.physics._material.Contact | None[source]¶: Move by velocity*dt and return the first contact, or None.