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:
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):
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.