中文
Node Documentation

Move character to

AutomationConfigured target requirednavigation.move-to

Read a live position variable, hold forward at a distance and slow near the target along a clear straight path.

Example use

Read a position variable and approach target X/Y where a traversable straight path exists.

Node preview

Right-drag to pan and scroll to zoom. Expand inputs and edit parameters to see how ports change. This preview does not run the node; reopening the page restores the example.

Loading node preview…

This node has dynamic parameters or ports. The reference below describes the initial example; after editing, inspect the preview for the current ports.

Data inputs 6

Target Xtarget-xNumber

Use the same world units as the source.

Default availableDefault: 0
Target Ytarget-yNumber

Second ground-plane axis, matching the field mapping.

Default availableDefault: 0
Arrival radiustoleranceNumber

Stop radius in the same units as the coordinates.

Default availableDefault: 20
TimeouttimeoutDuration (milliseconds) · ms

Total operation time limit in milliseconds.

Default availableDefault: 30000
  • Minimum: 0
  • Maximum: 86400000
Value format examples
1000
Position check intervalintervalDuration (milliseconds) · ms

Check position every 20–500 milliseconds while holding forward.

Default availableDefault: 100
  • Minimum: 0
  • Maximum: 86400000
Value format examples
1000
Slowdown distanceslow-distanceNumber

Switch to short steps within this distance, in coordinate units.

Default availableDefault: 100

Configuration 4

Forward keyforwardKeyText

The forward-movement key used by navigation.

OptionalDefault: "W"
Live position variableposition-variablestate-variable

The state-variable name containing position text, continuously updated by a sampling branch.

RequiredDefault: None
  • Minimum characters: 1
  • Maximum characters: 128
Window target slotslotText

The configured workflow target name, providing the application, device, HTTP or AI settings for this node.

RequiredDefault: None
  • Minimum characters: 1
  • Maximum characters: 128
  • Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$
Camera turn direction (1 or -1)turnSignChoice

The sign relating mouse movement to turning, based on target calibration.

OptionalDefault: 1
  • Options: -1, 1

Data outputs 3

Current XxNumber

First axis from the last valid pose.

Current YyNumber

Second axis from the last valid pose.

Remaining distancedistanceNumber

Distance from the last valid pose to the target.

Control and error ports

InputinInput · Control
An incoming control signal enters this operation.
ArrivedarrivedOutput · Control
Continue from this result or stage; see the node description for branch conditions.
TimeouttimeoutOutput · Control
Continue from this result or stage; see the node description for branch conditions.
Unable to advancestuckOutput · Control
Continue from this result or stage; see the node description for branch conditions.
Position unavailableunavailableOutput · Control
Continue from this result or stage; see the node description for branch conditions.
FailedfailedOutput · Error
Emitted when the operation fails; connect error handling here.
Version and node identity

Version 2.0.0

sha256:9adf11b187855e00063cb2c190fc7b7312186431453d81cc8875ba1f0d1bb58e