KX_CharacterWrapper(EXP_PyObjectPlus)#

base class — EXP_PyObjectPlus

class KX_CharacterWrapper(EXP_PyObjectPlus)#

A wrapper to expose character physics options.

onGround#

Whether or not the character is on the ground. (read-only)

Type:

boolean

gravity#

The gravity value used for the character.

Type:

float

fallSpeed#

The character falling speed.

Type:

float

maxJumps#

The maximum number of jumps a character can perform before having to touch the ground. By default this is set to 1. 2 allows for a double jump, etc.

Type:

int in [0, 255], default 1

jumpCount#

The current jump count. This can be used to have different logic for a single jump versus a double jump. For example, a different animation for the second jump.

Type:

int

jumpSpeed#

The character jumping speed.

Type:

float

maxSlope#

The maximum slope which the character can climb.

Type:

float

walkDirection#

The speed and direction the character is traveling in using world coordinates. This should be used instead of applyMovement() to properly move the character.

Type:

Vector((x, y, z))

jump()#

The character jumps based on it’s jump speed.

setVelocity(velocity, time, local=False)#

Sets the character’s linear velocity for a given period.

This method sets character’s velocity through it’s center of mass during a period.

Parameters:
  • velocity (3D Vector) – Linear velocity vector.

  • time (float) – Period while applying linear velocity.

  • local (boolean) –

    • False: you get the “global” velocity ie: relative to world orientation.

    • True: you get the “local” velocity ie: relative to object orientation.

jumpDirection#

The direction the character is jumping.

Type:

Vector((x, y, z))

smoothMovement#

Smooth movement caused by walking direction.

Type:

float (0.0 to 1.0)

reset()#

Resets the character velocity and walk direction.