KX_CharacterWrapper(EXP_PyObjectPlus)

base class — EXP_PyObjectPlus

class bge.types.KX_CharacterWrapper

A wrapper to expose character physics options.

onGround

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

Type:

boolean

gravity

The gravity vector used for the character.

Type:

Vector((x, y, z))

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.