Class PhysicsUtils

java.lang.Object
net.minestom.server.collision.PhysicsUtils
public final class PhysicsUtils extends Object

  • Method Details

    • simulateMovement

      public static PhysicsResult simulateMovement(Pos entityPosition, Vec entityVelocityPerTick, BoundingBox entityBoundingBox, WorldBorder worldBorder, Block.Getter blockGetter, Aerodynamics aerodynamics, boolean entityNoGravity, boolean entityHasPhysics, boolean entityOnGround, boolean entityFlying, @Nullable @Nullable PhysicsResult previousPhysicsResult)
      Simulate the entity's movement physics

      This is done by first attempting to move the entity forward with the current velocity passed in. Then adjusting the velocity by applying air resistance and friction.

      Parameters:
      entityPosition - the current entity position
      entityVelocityPerTick - the current entity velocity in blocks/tick
      entityBoundingBox - the current entity bounding box
      worldBorder - the world border to test bounds against
      blockGetter - the block getter to test block collisions against
      aerodynamics - the current entity aerodynamics
      entityNoGravity - whether the entity has gravity
      entityHasPhysics - whether the entity has physics
      entityOnGround - whether the entity is on the ground
      entityFlying - whether the entity is flying
      previousPhysicsResult - the physics result from the previous simulation or null
      Returns:
      a PhysicsResult containing the resulting physics state of this simulation

    • updateVelocity

      public static Vec updateVelocity(Pos entityPosition, Vec currentVelocity, Block.Getter blockGetter, Aerodynamics aerodynamics, boolean positionChanged, boolean entityFlying, boolean entityOnGround, boolean entityNoGravity)
      Calculates an updated velocity for an entity

      If the position has not changed then the x and z values will not be touched, and only gravity will be accounted for if the entity is not flying. Otherwise, the velocity will be adjusted by applying air resistance, gravity, and friction (only if the entity is on the ground).

      Parameters:
      entityPosition - the current entity position
      currentVelocity - the current entity velocity in blocks/tick
      blockGetter - the block getter to test block collisions against
      aerodynamics - the current entity aerodynamics
      positionChanged - whether the position changed for the entity
      entityFlying - whether the entity is flying
      entityOnGround - whether the entity is on the ground
      entityNoGravity - whether the entity has gravity
      Returns:
      the updated velocity or Vec.ZERO if the entity is flying