Skip to content

Move

Instruct the game to start a forcemove on an Entity to a specific position with a configurable speed, start and stop state.

Syntax

(1)

|move,entity,x,y,z|

(2)

|move,entity,x,y,z,multiplier|

(3)

|move,entity,x,y,z,multiplier,state|

(4)

|move,entity,x,y,z,multiplier,state,stopstate|

Parameters

entity: int | string

The Entity that this command refers to. The int form is a regular Entity id and its restriction for valid values applies. The string is only applicable if caller isn't null and it will be interpreted as the int form otherwise. This form can be one of the following:

  • this: Refers to the tailtarget. This must not be null or an exception will be thrown.
  • caller: Refers to the caller. This must not be null or an exception will be thrown.
  • Anything else: if the string is in the define list, it will refer to it. Otherwise, the value will be interpreted as the int form.

x: float

The x position to move the Entity to. This must be a valid float or an exception will be thrown.

y: float | null

The y position to move the entity to. The float form must be a valid float or an exception will be thrown. If the value is null, this will default to 0.0.

It presumably was intended to be used to ignore the y value during the forcemove, but this logic gets overridden before the forcemove starts which negates this feature.

z: float

The z position to move the Entity to. This must be a valid float or an exception will be thrown.

multiplier: float

The multiplier to apply to the regular speed at which the Entity will be moved. This must be a valid float or an exception will be thrown. If no value is specified, 1.0 is the default value.

state: int

The animation state to set the Entity when the forcemove will start. This must be a valid int or an exception will be thrown. If no value is specified, 1 is the default value.

stopstate: int

The animation state to set the Entity when the forcemove is completed. This must be a valid int or an exception will be thrown. If no value is specified, 0 is the default value.

Remarks

This command moves the Entity to a specific position. If moving the entity relative to its current position is more desired, use moveahead instead.

If for whatever reason, the entity cannot complete its forcemove after a while, a failsafe will trigger after it times out. This failsafe will instantly teleport the entity to its destination with smokes particles and end the forcemove. The specific time for a player entity is 250 frames or 375 frames during an event and if it is not a player entity, it's 500 frames when not in battle (or during a battle, but a checking dead is running) and 225 frames otherwise. The amount is doubled if extratimer is enabled on the entity.

It should be noted however that due to a regression, this failsafe does not work in 1.1.1 and any situations that would have triggered it may results in a softlock instead. This issue was fixed in 1.1.2.