1.10.03 - Target movement

A target movement goes towards a target point. The target point can be a fixed point of an entity of the map. If the target is a moving map entity, the movement updates its angle to continue to go towards the entity. By default, the target is the hero when a game is running.

This type of movement can be seen as a particular case of the straight movement type, where the angle is set automatically to go towards the target.

Remarks
This type of movement goes straight towards the target. If you set the smooth property to true, it will try to avoid simple obstacles by moving to a side. This is usually enough for simple enemies that target the hero. If you want a more complex technique that calculates an intelligent path to the target, see the path finding movement type.

Methods inherited from movement

Target movements are particular movement objects. Therefore, they inherit all methods from the type movement.

See Methods of all movement types to know these methods.

Methods of the type target movement

The following methods are specific to target movements.

target_movement:set_target(x, y), target_movement:set_target(entity, [x, y])

Sets the target of this movement as a fixed point or a map entity.

To target a fixed point:

To target a map entity (only during a game):

target_movement:get_speed()

Returns the speed of this movement.

target_movement:set_speed(speed)

Sets the speed of this movement.

target_movement:get_angle()

Returns the angle of the trajectory in radians.

East is 0, North is math.pi / 2, West is math.pi, South is 3 * math.pi / 2 and any intermediate value is possible.

Remarks
If you prefer a value in a 4-direction system, see movement:get_direction4().

target_movement:is_smooth()

Returns whether this movement adjusts its trajectory when an obstacle of the map is reached. This property has no effect if the movement is not attached to a map entity or if the movement ignores obstacles.

target_movement:set_smooth([smooth])

Sets whether this movement should adjust its trajectory when an obstacle of the map is reached. This property has no effect if the movement is not attached to a map entity or if the movement ignores obstacles.

Events inherited from movement

Target movements are particular movement objects. Therefore, they inherit all events from the type movement.

See Events of all movement types to know these events.