Skip to content

Movement, wandering, and gaze

Wandering is centered on the NPC's Home Position, not on the player. Configure the movement in the NPC editor, save it, and test in a clear, walkable area.

Configure a wandering character

A useful starting setup is:

Editor field Example
Wander On
Wander Radius 5
Wander Interval 5-15
Return Home Interval 60
Walking Speed 0.5
Can Be Pushed Off

The interval accepts seconds or a range of seconds, such as 10 or 5-15. A range chooses varying delays. Walking Speed is a multiplier; 1 is normal and 0.3 is a slower example. Zero is not a reliable way to immobilize the NPC: switch Wander off instead.

The server periodically chooses nearby destinations. It looks for solid ground, clear feet/head space, and no fluid in the destination cell. Obstacles, cliffs, water, and insufficient headroom can prevent a destination from being selected or reached. Wander does not force an NPC through an invalid path.

The radius is measured horizontally. If the NPC moves beyond the radius plus its recovery margin, it attempts to walk home. Return Home Interval also requests a return periodically; 0 disables those periodic returns. A return is a navigation request, not a guaranteed teleport or exact timer for arrival.

Set and change home

Home Position uses three coordinates separated by spaces:

100.5 64 -20.5

Leaving it empty uses the NPC's current position when a home is needed. New NPCs receive a home at their spawn position. Moving the NPC with Move Wand, or saving new world coordinates in the editor, also updates its home position.

To set home to the current location of the NPC you are looking at (within 8 blocks):

/gnpc sethome

Use the Move Wand when you want to move the entity itself as well as its home.

Pause while players interact

A wandering NPC pauses and faces a player when engaged through its interaction flow. The hold initially lasts at least 30 seconds and can continue while an active dialogue remains open. Moving more than 12 blocks away, leaving the relevant world, or disconnecting releases that engagement. Battles also interrupt normal wandering updates.

This prevents the shopkeeper or dialogue character from immediately walking away during an interaction. It does not permanently disable Wander.

Gaze targets

Field Default Behavior
Look at Players On Tracks nearby players
Look at Mobs Off Tracks mobs, including Pokémon
Look at NPCs Off Tracks other NPCs separately
Look Around Off Uses random gaze directions when no eligible target is found
Look Distance 15 blocks Search distance for enabled target types

The NPC chooses an eligible visible target in range. Turn off all four gaze options for a character that should not actively look at anything. Turning on Look Around does not make the NPC walk.

Fix the body direction

Enable Lock Body Rotation and configure Facing Direction:

Direction Degrees
South 0
West 90
North 180
East -90

An empty direction keeps the current facing. With body rotation locked, Allow Head Movement decides whether the head can still track enabled gaze targets. Keep it off for a fully fixed gaze, or on for a guard whose body stays in place while the head follows players.

The Rotate Wand offers a quicker way to aim a character. The editor exposes the explicit direction for precise placement.

Gravity and pushing

Can Be Pushed controls pushing independently from wandering. An NPC can wander while being resistant to player/entity pushing.

No Gravity holds the current vertical position, useful for a decorative floating character. Fall Protection prevents fall damage and can return the NPC home after a long fall. These options do not make every terrain destination reachable; test movement on the intended map.

For Pokémon that keep walking in place after stopping, see Base poses and walking. This is a rendering/locomotion state issue, distinct from the pathfinding settings above.