ActionMoveToLocation(location, int)

Moves an NPC to a location before executing further actions in the action queue.

void ActionMoveToLocation(
    location locDestination,
    int bRun = FALSE
);

Parameters

locDestination

The object will move to this location. If the location is invalid or a path cannot be found to it, the command does nothing.

bRun

If this is TRUE, the action subject will run rather than walk (Default: FALSE)

Description

The action subject will move to locDestination. The function call waits for the subject to reach locDestination before executing further actions in the action queue.
If an error occurs the log file will contain "MoveToPoint failed."

Remarks

This function is designed for creatures (NPCs and PCs). You cannot move placeable objects in NWN. To cause a PC or NPC who is not the calling object to execute this command, use AssignCommand().

Move to location functions (ActionForceMoveToLocation, ActionMoveToLocation) seem to try to move to their destination in a straight line, unlike move to object functions (ActionForceMoveToObject, ActionMoveToObject) which actually do path finding. Furthermore, the move to location functions get interrupted very easily. If anything bumps or obstructs the moving object then the command is finished.

Known Bugs

This function ignores the commandable state of the creature given the action. Thus, the ActionMoveToLocation action is added to the end of non-commandable creatures' action queues.

Version

1.61

Example

// make the calling subject walk to a waypoint
void main()
{
     object oWP = GetObjectByTag("my_waypoint");
     location lDestination = GetLocation(oWP);
     ActionMoveToLocation(lDestination,FALSE);
}

functions:	ActionForceMoveToLocation \| ActionJumpToLocation \| ActionMoveAwayFromLocation \| ActionMoveToObject \| MoveToNewLocation
categories:	Action on Object Functions \| Core AI Functions \| Movement Functions