Observable that, whenever a specified position is entered on optionally provided layers, will notify with the target characters position change
Turns the character towards the given direction without moving it.
true if the character is able to collide with the tilemap. Don't confuse this with an actual collision check. You should use isBlocked or isTileBlocked for this.
Observable that will notify about every change of direction that is not part of a movement. This is the case if the character tries to walk towards a blocked tile. The character will turn but not move. It also emits when you call turnTowards.
This obsersable never emits more than one time in a row for the same direction. So for instance, if turnTowards is called multiple times in a row (without any facing direction change occurring inbetween) with the same direction, this observable would only emit once.
Returns the character layer of the given character. You can read more about character layers and transitions here
Returns all collision groups of the given character. Collision Groups Example
All collision groups of the given character.
Information about the current automatic movement (including random movement, follow movement and target movement)
Observable that will notify about every change of tile position. It will notify at the end of the movement.
Observable that will notify about every change of tile position. It will notify at the beginning of the movement.
Places the character with the given id to the provided tile position. If that character is moving, the movement is stopped. The positionChangeStarted and positionChangeFinished observables will emit. If the character was moving, the movementStopped observable will also emit.
Optional layer: stringStops any automated movement such as random movement (moveRandomly), following (follow), moving to a specified position (moveTo) or queued movements (addQueueMovements).
Observable that emits when a new character is added or an existing is removed.
Refresh the tile collision cache. For performance reasons, you should provide an area that needs to be rebuilt, if possible. You need to have cacheTileCollisions enabled.
For more information on pathfinding performance check out pathfinding performance.
Optional options: CharacterFilteringOptionsAll character IDs that are registered in the plugin, satisfying the provided filtering options.
Alpha
Returns the shortest path from source to destination.
Source position
Destination position
Optional options: PathfindingOptionsPathfinding options
Shortest path. In case that no path could be found,
closestToTarget is a position with a minimum distance to the target.
Character charId will start to walk towards charIdToFollow on a
shortest path until it reaches the specified distance.
ID of character that should follow
ID of character that should be followed
Optional options: FollowOptionsID of character that should follow
ID of character that should be followed
Optional distance: numberMinimum distance to keep to charIdToFollow in
manhattan distance
in case of 4 direction mode and with and
Chebyshev distance
in case of 8 direction mode.
Optional closestPointIfBlocked: booleancharId will move to the closest point
(manhattan distance
in case of 4 direction mode and with and
Chebyshev distance
in case of 8 direction mode)
to charIdToFollow that is reachable from charId in case that there
does not exist a path between charId and charIdToFollow.
Use follow(charId: string, charIdToFollow: string, options: FollowOptions): void; instead.
Character charId will start to walk towards charIdToFollow on a
shortest path until it reaches the specified distance.
Optional distance: number | FollowOptionsOptional closestPointIfBlocked: booleanReturns the tile cost for a position.
Initiates movement toward the specified targetPos. The movement will
happen along one shortest path. Check out MoveToConfig for
pathfinding configurations.
Optional config: MoveToConfigan observable that will fire whenever the moveTo movement is finished or aborted. It will provide a result code as well as a description and a character layer.
Adds new positions to the movement queue. Any other automatic movement of the character will be stopped.
Positions to enqueue
Optional options: QueueMovementConfigOptions for the queue movement. These options take effect immediately (also for previously enqueued but not yet executed movements).
Clears the complete movement queue for the character, that was filled by using addQueueMovements.
Returns all enqueued movements for the given character.
Emits whenever queued movements for a character finish (with success or failure).
Initiates random movement of the character with the given id. The
character will randomly pick one of the non-blocking directions.
Optionally a delay in milliseconds can be provided. This represents the
waiting time after a finished movement, before the next is being initiated.
If a radius other than -1 is provided, the character will not move
further than that radius from its initial position (the position it has
been, when moveRandomly was called). The distance is calculated with the
manhattan distance
in case of 4 direction mode and with and
Chebyshev distance
in case of 8 direction mode. Additionally, if a radius other than -1 was
given, the character might move more than one tile into a random direction
in one run (as long as the route is neither blocked nor outside of the
radius).
Finds the identifiers of all characters at the provided tile position.
Optional layer: stringThe identifiers of all characters on this tile.
Gets the tile position and character layer adjacent to the given position in the given direction.
Beta
The character layer that the transition on the given position and character layer leads to.
Checks whether the given position is blocked by either the tilemap or a blocking character. If you provide no layer, be sure not to use character layers in your tilemap.
Optional layer: stringOptional collisionGroups: string[]True if position on given layer is blocked by the tilemap or a character
Checks whether the given position is blocked by the tilemap. If you provide no layer, be sure not to use character layers in your tilemap.
Optional layer: stringTrue if position on given layer is blocked by the tilemap.
Beta
Sets the character layer toLayer that the transition on position
position from character layer fromLayer should lead to.
You can read more about character layers and transitions
here
Position of the new transition
Character layer the new transition should start at
Character layer the new transition should lead to
Generated using TypeDoc
Initiates movement of the character with the given id. If the character is already moving nothing happens. If the movement direction is currently blocked, the character will only turn towards that direction. Movement commands are not queued.