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:mathutils.Vector

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.

reset()

Resets the character velocity and walk direction.