pub enum PlayerMode {
FreeFlightSixDof {
roll_mode: RollMode,
},
FreeFlightAnchored,
Grounded {
gravity: f32,
jump_speed: f32,
},
}Expand description
Selects the movement model used by PlayerPlugin and the player systems.
Set this inside PlayerConfig::mode before adding PlayerPlugin (or
before the Startup schedule runs). Changing the mode at runtime is
not supported — the value is copied into the Player component once
on spawn and used from there.
§Variants
PlayerMode::FreeFlightSixDof— classic 6DOF, no gravity. Default.PlayerMode::FreeFlightAnchored— free flight with a world-axis-anchored horizon.PlayerMode::Grounded— gravity + jump, WASD on the XZ plane, pitch clamped to ±89°. Suitable for Minetest / Minecraft–style games.
Variants§
FreeFlightSixDof
Six-degrees-of-freedom flight. No gravity, no pitch clamp, Q/E roll.
This is the default mode and matches the original behaviour of the player controller. All six movement axes (forward, back, left, right, up, down) are relative to the camera’s current orientation.
FreeFlightAnchored
Six-degrees-of-freedom flight with an FPS-style, world-axis-anchored horizon. Q/E switch the anchor axis instead of rolling.
Grounded
Gravity-based grounded movement.
- WASD moves on the world XZ plane relative to the camera’s current yaw, ignoring pitch tilt.
Spacejumps whenPlayer::on_groundistrue.- Gravity accumulates in
Player::vertical_velocityeach frame. - Mouse yaw rotates the entity around the world Y axis (player stays upright); pitch rotates the view up/down and is clamped to ±89°.
- Q/E roll is disabled.
Fields
gravity: f32Downward acceleration in world units per second squared.
Applied every frame as vertical_velocity -= gravity * dt.
Typical value: 20.0.
jump_speed: f32Upward velocity impulse applied when the player jumps.
Assigned to Player::vertical_velocity on the frame Space is
pressed while Player::on_ground is true. Typical value: 8.0.
Trait Implementations§
Source§impl Clone for PlayerMode
impl Clone for PlayerMode
Source§impl Debug for PlayerMode
impl Debug for PlayerMode
Auto Trait Implementations§
impl Freeze for PlayerMode
impl RefUnwindSafe for PlayerMode
impl Send for PlayerMode
impl Sync for PlayerMode
impl Unpin for PlayerMode
impl UnsafeUnpin for PlayerMode
impl UnwindSafe for PlayerMode
Blanket Implementations§
Source§impl<T, U> AsBindGroupShaderType<U> for T
impl<T, U> AsBindGroupShaderType<U> for T
Source§fn as_bind_group_shader_type(&self, _images: &RenderAssets<GpuImage>) -> U
fn as_bind_group_shader_type(&self, _images: &RenderAssets<GpuImage>) -> U
T ShaderType for self. When used in AsBindGroup
derives, it is safe to assume that all images in self exist.Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> ConditionalSend for Twhere
T: Send,
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>, which can then be
downcast into Box<dyn ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait> (where Trait: Downcast) to Rc<Any>, which can then be further
downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.Source§impl<T> DowncastSend for T
impl<T> DowncastSend for T
impl<S, T> Duplex<S> for Twhere
T: FromSample<S> + ToSample<S>,
Source§impl<S> FromSample<S> for S
impl<S> FromSample<S> for S
fn from_sample_(s: S) -> S
Source§impl<T> FromWorld for Twhere
T: Default,
impl<T> FromWorld for Twhere
T: Default,
Source§fn from_world(_world: &mut World) -> T
fn from_world(_world: &mut World) -> T
Creates Self using default().
Source§impl<T, W> HasTypeWitness<W> for Twhere
W: MakeTypeWitness<Arg = T>,
T: ?Sized,
impl<T, W> HasTypeWitness<W> for Twhere
W: MakeTypeWitness<Arg = T>,
T: ?Sized,
Source§impl<T> Identity for Twhere
T: ?Sized,
impl<T> Identity for Twhere
T: ?Sized,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more