# 01 Nodes And Paths

## Node

A point in the world — usually an intersection or waypoint.

**Key property: Acceptance Radius.** This is the circle around the node where paths arrive. When an AI enters this circle it has "reached" the node. Default 150 units.

| Setting           | What it does                                                                   |
| ----------------- | ------------------------------------------------------------------------------ |
| Acceptance Radius | Size of the intersection. Bigger = smoother transitions, less precise arrival. |
| Enabled           | Uncheck to disable the node temporarily (AI will route around it).             |
| Conditions        | Rules that gate who can pass through.                                          |
| Events            | Callbacks that fire when AI enters/exits.                                      |

## Path

A spline curve connecting two nodes.

| Setting          | What it does                                                       |
| ---------------- | ------------------------------------------------------------------ |
| Bidirectional    | Off = one-way (start → end only).                                  |
| Speed Multiplier | Higher = AI moves faster here AND it's cheaper to take this path.  |
| Cost Multiplier  | Higher = pathfinder avoids this path.                              |
| Danger Level     | 0–1 hint for cautious AI.                                          |
| Path Width       | Lateral wander corridor. AI doesn't follow the centerline rigidly. |
| Max Occupancy    | Limit on simultaneous travelers. 0 = unlimited.                    |

## Visual cheatsheet

| Element        | Editor look                                        |
| -------------- | -------------------------------------------------- |
| Node           | Vertical pole + ground circle (acceptance radius). |
| Path           | Thick colored line + arrows showing direction.     |
| Disabled       | Red.                                               |
| Bidirectional  | Teal.                                              |
| Unidirectional | Blue.                                              |
| Selected       | Yellow highlight.                                  |

## Networks (islands)

Two nodes are on the **same network** if you can walk from one to the other along paths. Multiple disconnected groups can exist. Pathfinding fails if start and goal are on different networks — use **Merge Networks** in the editor or **Validator** to find bridge candidates.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://onesteppack.gitbook.io/openworldnavigation-doc/02-basics/01-nodes-and-paths.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.