Kit `nav`

207 herramientas. Generado a partir del código fuente del plugin; no lo edites a mano.

Las descripciones de las herramientas y de los argumentos se muestran en inglés porque reflejan el schema de las herramientas (el mismo texto que el agente recibe en tools/list).

Guía

The nav kit manages editor-world navigation: configured agents, Recast generation settings, bounds and modifier volumes, areas and query filters, links and smart links, invokers, build state, synchronous path/polygon/tile queries, and PIE movement, crowd and avoidance tests. Coordinates and extents are centimetres; extents are half sizes. Actor references are the exact label or object name.

nav.add_bounds_volume {name, location, extent} around the walkable geometry (or nav.fit_bounds_to_actors {boundsActor, actors}).
nav.build: flushes pending bounds/geometry updates and runs the engine "Build Paths", which blocks until the tiles exist. nav.get_build_status, nav.get_nav_data and nav.get_stats confirm it.
nav.project_point {point} on each endpoint (a found point means the location is on the mesh).
nav.find_path {start, end}: valid, partial, length, cost, navData, the waypoints and, when there is no path, the cause (start off mesh, end off mesh, or not connected).
nav.diagnose_build when something is empty: it reports missing bounds/nav data, invoker-only generation without invokers, bounds without collidable geometry, unregistered bounds, auto-update off, dirty areas and static runtime generation, each with the tool that fixes it.

For quick experiments nav.create_test_floor {name, location, extent} spawns a flat static floor (engine Cube, 10 cm thick) and nav.create_test_character a Character. Both are tagged UeaNavTest; nav.remove_test_actors {actors:[...]} deletes them and refuses any other actor.

Path and projection tools (find_path, test_path, get_path_*, get_path_corridor, reachability_matrix, project_point, raycast, runtime_* equivalents) accept:

navData: a navigation data label from nav.list_nav_data, or
agent: a supported agent name from nav.list_agents (its navigation data is used), and
filterClass: a NavigationQueryFilter class or Blueprint path (area costs/exclusions),
allowPartial (paths only, default true).

With neither navData nor agent the world's default navigation data is used. Tools that edit one RecastNavMesh take navData/actor; empty means "the only RecastNavMesh" and fails with E_INVALID_ARG when there are several.

Generation settings

nav.get_navmesh / nav.set_navmesh: tile size, agent radius/height/slope, cell size/height (the Default resolution on UE 5.2+), region/layer partitioning (Monotone, Watershed, ChunkyMonotone), min region area, merge size, simplification error, voxel/low-span filtering, generateNavLinks (5.5+).
nav.get_resolution / nav.set_resolution {resolution:'Low'|'Default'|'High', cellSize, cellHeight, agentMaxStepHeight}: Low/High exist from UE 5.2, per-resolution step height from 5.3.
nav.get_tile_cache / nav.set_tile_cache: fixed pool, pool size, hard limit, simultaneous jobs, empty layers, voxel cache.
nav.get_query_settings / nav.set_query_settings: max search nodes, heuristic scale, vertical compensation, corner offsets (no rebuild needed).
nav.set_runtime_generation {mode:'Static'|'Dynamic'|'DynamicModifiersOnly'}: Static navmeshes never change in PIE; use Dynamic for moving obstacles and runtime rebuilds.
nav.set_navmesh_properties {properties:[{key,value}]} writes any other reflected Recast field.

Rebuild (nav.build, nav.rebuild_all, or nav.rebuild_nav_data {navData} for one agent) after generation changes.

Build control

nav.build, nav.rebuild_all and nav.rebuild_nav_data block until the tiles exist.
nav.rebuild_area {center, extent} only dirties a box; the navigation tick regenerates it, so poll nav.wait_build (off-thread) afterwards. It needs auto-update (nav.set_auto_update {enabled:true}).
nav.add_build_lock {flags:16} / nav.remove_build_lock bracket multi-step edits; nav.cancel_build drops queued tile work.
nav.get_build_history lists the builds run through nav tools in this session (duration, tiles before/after); nav.list_registered_bounds shows what the generator really uses.
Debug drawing: nav.get_draw_flags / nav.set_draw_flags {enable:[...], disable:[...], enableDrawing, drawOffset} (flag names vary by engine; the getter lists them). The viewport "Navigation" show flag itself is a UI setting and is not exposed.

Areas, filters and modifiers

Areas: nav.create_area_blueprint {folder, name, parentClass}, nav.duplicate_area, nav.get_area, nav.set_area_defaults {area, defaultCost, fixedAreaEnteringCost, drawColor, supportedAgents}, nav.find_actors_by_area {area} (who uses it).
Query filters (per-agent area costs): nav.create_query_filter_blueprint, nav.set_query_filter_area {filter, areaClass, travelCost, enteringCost, excluded} (none clears an override), nav.get_query_filter, nav.remove_query_filter_area, nav.list_query_filters. Pass the filter as filterClass to the path tools or as the AI controller's default filter.
Modifiers: nav.add_modifier_volume, nav.set_modifier_volume, nav.add_modifier_component, nav.set_modifier_component {areaClass, extent (failsafe), includeAgentHeight}, nav.remove_modifier_component, nav.list_modifiers (volumes + components with bounds). Replacement areas (nav.set_modifier_volume_replacement, nav.set_modifier_replacement, None clears) need UE 5.5; nav.set_modifier_resolution needs 5.2 for volumes and 5.3 for components.
Actor relevance: nav.set_actor_nav {actor, canAffect, dynamicObstacle, areaClass} (text true/false; empty keeps the value), nav.batch_set_actor_nav (all actors must exist), nav.refresh_actor_nav, nav.list_nav_relevant_actors, nav.find_nav_blockers.

Links

Simple links on a proxy (world points): nav.add_link_proxy {name, start, end}, nav.add_simple_link, nav.set_link_proxy {index, start, end}, nav.snap_links_to_navmesh, nav.set_link_properties {index, direction, areaClass, snapRadius, snapHeight, leftProjectHeight, maxFallDownLength, snapToCheapestArea, description, supportedAgents}. nav.list_simple_links and nav.get_simple_link return every field and whether each endpoint projects to the navmesh.
Link components on any actor (points relative to the actor): nav.add_link_component {componentName}, nav.add_link_component_link, nav.set_link_component_link, nav.remove_link_component_link, nav.get_link_component, nav.list_link_components, nav.remove_link_component; nav.set_link_properties {componentName} edits their fields.
Smart links (doors, ladders): nav.set_smart_link {enabled}, nav.set_smart_link_points, nav.copy_simple_to_smart_link, nav.set_smart_link_areas {enabledArea, disabledArea}, nav.set_smart_link_broadcast {radius, interval, notifyWhenEnabled, notifyWhenDisabled}, nav.set_smart_link_obstacle / nav.clear_smart_link_obstacle, nav.get_smart_link, nav.list_smart_links. Blueprint "smart link reached" logic is authored with the bp kit.
Checks: nav.validate_link_proxy {actor} (coincident/off-mesh endpoints, drops beyond maxFallDownLength, enabled-but-irrelevant smart links), nav.audit_links for the whole level.

Queries

Reachability: nav.test_path, nav.batch_test_paths, nav.reachability_matrix {points} (all ordered pairs), nav.find_path_to_actor.
Corridor: nav.get_path_corridor returns the polygons crossed (ref, centre, area, tile, cost), the distinct areas and the segments that use links.
Points: nav.batch_project_points, nav.sample_navmesh {center, extent, spacing} (coverage fraction), nav.random_points {count, reachable}, nav.find_distance_to_wall.
Polygons and tiles: nav.get_poly_at, nav.get_poly_info {polyRef | point}, nav.get_polys_in_box, nav.get_tile_at {point}, nav.list_polys_in_tile, nav.list_tiles, nav.list_tile_refs (5.5+), nav.get_area_id_map, nav.has_complete_data.
nav.raycast_detailed (5.5+) adds whether a clear ray's end lies in the explored corridor.

Agents, crowd and avoidance

Project settings: nav.get_settings, nav.list_agents, nav.get_crowd_settings (typed profiles) are read-only. nav.set_settings, nav.add_agent, nav.set_agent, nav.remove_agent, nav.set_crowd_settings and nav.set_crowd_avoidance_profile write DefaultEngine.ini (risk 4, confirm first).
Agent Blueprints: nav.create_agent_blueprint {folder, name, controllerClass} makes a Character Blueprint possessed by an AIController when placed or spawned; nav.get_agent_blueprint / nav.set_agent_blueprint edit RVO, nav agent radius/height/step, crouch/jump/walk/swim/fly and path-following flags. Compile and save the Blueprint afterwards.
Placed Characters: nav.get_rvo_avoidance / nav.set_rvo_avoidance. Invokers: nav.add_invoker, nav.set_invoker, nav.list_invokers, nav.remove_invoker.

PIE movement test

Start PIE (play.start).
nav.spawn_test_agent {name, controllerName, location, crowd} spawns a Character possessed by an AIController (a DetourCrowdAIController with crowd:true); with ensureNavData (default) the PIE world also gets its default nav data actor.
nav.runtime_move_to {controller, goal} or nav.runtime_move_to_actor {controller, goalActor}; watch nav.runtime_get_controller_state (status, path progress, velocity, goal, nav data, filter); nav.runtime_pause_move, nav.runtime_resume_move, nav.runtime_stop_movement.
nav.runtime_find_path_for_agent {controller, goal} shows the path MoveTo would use (pawn agent properties + controller filter); nav.runtime_batch_reachability tests many pairs.
Crowd and RVO: nav.runtime_get/set_crowd_agent (quality, separation, groups, simulation), nav.runtime_get/set_crowd_profile (session only), nav.runtime_get/set_rvo.
Dynamic worlds: nav.runtime_spawn_link_proxy, nav.runtime_set_smart_link_enabled (open/close a door link), nav.runtime_set_obstacle, nav.runtime_update_actor_nav, nav.runtime_rebuild_area (needs Dynamic runtime generation), nav.runtime_get_invoker_locations.
nav.runtime_despawn_agent removes the pawn and its controller.

Gotchas

nav.build needs at least one NavMeshBoundsVolume; without one the engine does nothing.
A navmesh with the default "Static" runtime generation is not rebuilt in PIE; build in the editor before starting PIE, or switch to Dynamic.
Query tools return found:false / valid:false (not an error) when the point or path is off the mesh; they fail only when there is no navigation system or no navigation data at all.
Polygon references change when tiles are rebuilt; fetch fresh ones after a build.
nav.fit_bounds_to_level includes every actor with bounds (landscapes too); prefer nav.fit_bounds_to_actors with explicit actors.
Tools/nav_integration_smoke.py --project <dir> covers the asynchronous path (bounds, floor, build, nav.wait_build from an off-thread request, projections, path, cleanup) as separate MCP calls.
Not available: the viewport navigation show flag, OBJ export and segment-link editing.

Herramientas

Leyenda. riesgo 0 = solo lectura, 1 = operación inofensiva del editor, 2 = modifica un asset, 3 = elimina/reemplaza un asset, 4 = proyecto/configuración/build, 5 = potencialmente destructivo (las llamadas por encima de MaxAutoRisk requieren "_confirm": true). modifica = se ejecuta en una transacción (edit.undo la revierte). requiere PIE / requiere mundo = se rechaza sin una sesión PIE / sin un nivel abierto. requiere el plugin = no disponible cuando el plugin está desactivado. dryRun = acepta el argumento dryRun. smoke = cubierto por edit.self_test.

`nav.add_agent` (riesgo 4)

Adds a supported agent to project navigation settings.

Argumento	Tipo	Descripción
`name`	string	obligatorio. Unique supported-agent name.
`radius`	string	Agent radius; empty preserves it.
`height`	string	Agent height; empty preserves it.
`stepHeight`	string	Agent step height; empty preserves it.
`navDataClass`	string	Optional navigation-data class.

Devuelve: items, count, values, message.

`nav.add_bounds_volume` (riesgo 2, modifica, requiere mundo, smoke)

Adds a NavMeshBoundsVolume with a box brush using the requested half extents.

Argumento	Tipo	Descripción
`name`	string	Editor label for the new actor. Valor predeterminado `TEXT("NavBounds")`.
`location`	{x,y,z}	Centre in centimetres.
`extent`	{x,y,z}	Box half extents in centimetres, each greater than zero. Valor predeterminado `FUeaVec3(1000.0,1000.0,500.0)`.

Devuelve: items, count, values, message.

`nav.add_build_lock` (riesgo 4, modifica, requiere mundo, smoke)

Prevents automatic navigation rebuild work until a matching release call.

Argumento	Tipo	Descripción
`flags`	integer	Bitmask accepted by UNavigationSystemV1 build-lock APIs. Valor predeterminado `1`.
`rebuildOnRelease`	boolean	Rebuild navigation when releasing the lock. Valor predeterminado `true`.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.add_invoker` (riesgo 2, modifica, requiere mundo, smoke)

Adds a navigation invoker component (tiles generated around the actor when invoker-only generation is on).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`generationRadius`	number	obligatorio. Positive tile generation radius in centimetres.
`removalRadius`	number	obligatorio. Removal radius in centimetres, at least generation radius.

Devuelve: items, count, values, message.

`nav.add_link_component` (riesgo 2, modifica, requiere mundo, smoke)

Adds a NavLinkComponent with one link (points relative to the actor) to any actor.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Link component name; empty selects the actor's only NavLinkComponent (add: name of the new component).
`index`	integer	Link index inside the component. Valor predeterminado `0`.
`start`	{x,y,z}	Left point relative to the owner actor in centimetres.
`end`	{x,y,z}	Right point relative to the owner actor in centimetres. Valor predeterminado `FUeaVec3(100.0, 0.0, 0.0)`.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.

Devuelve: actor, component, links, count, message.

`nav.add_link_component_link` (riesgo 2, modifica, requiere mundo, smoke)

Appends a link (points relative to the actor) to a NavLinkComponent.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Link component name; empty selects the actor's only NavLinkComponent (add: name of the new component).
`index`	integer	Link index inside the component. Valor predeterminado `0`.
`start`	{x,y,z}	Left point relative to the owner actor in centimetres.
`end`	{x,y,z}	Right point relative to the owner actor in centimetres. Valor predeterminado `FUeaVec3(100.0, 0.0, 0.0)`.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.

Devuelve: actor, component, links, count, message.

`nav.add_link_proxy` (riesgo 2, modifica, requiere mundo, smoke)

Adds a NavLinkProxy with one simple link between two world points.

Argumento	Tipo	Descripción
`name`	string	Editor label for the link proxy. Valor predeterminado `TEXT("NavLink")`.
`start`	{x,y,z}	obligatorio. Left endpoint in world centimetres.
`end`	{x,y,z}	obligatorio. Right endpoint in world centimetres.
`bidirectional`	boolean	Whether traversal is allowed in both directions. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class path or short name.

Devuelve: items, count, values, message.

`nav.add_modifier_component` (riesgo 2, modifica, requiere mundo, smoke)

Adds a NavModifierComponent to an actor.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Component name; empty selects the actor's only modifier component.
`areaClass`	string	NavArea class path/name; empty preserves it ("None" clears a replacement area).
`extent`	{x,y,z}	Failsafe box half extent in centimetres (used when the owner has no collision); zero keeps it.
`includeAgentHeight`	string	Expand the modifier bottom by the agent height (true/false); empty keeps it.

Devuelve: items, count, values, message.

`nav.add_modifier_volume` (riesgo 2, modifica, requiere mundo, smoke)

Adds a NavModifierVolume applying an area over a box.

Argumento	Tipo	Descripción
`name`	string	Actor label/name for a new volume.
`areaClass`	string	obligatorio. NavArea class path/name ("None" clears a replacement area).
`location`	{x,y,z}	Centre in centimetres.
`extent`	{x,y,z}	Positive brush half extents. Valor predeterminado `FUeaVec3(500,500,250)`.
`actor`	string	Existing actor reference for setters/components.

Devuelve: items, count, values, message.

`nav.add_simple_link` (riesgo 2, modifica, requiere mundo, smoke)

Appends a simple link (world points) to a NavLinkProxy and returns its index.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy actor label/name.
`index`	integer	Simple-link index. Valor predeterminado `0`.
`start`	{x,y,z}	Link start in world centimetres.
`end`	{x,y,z}	Link end in world centimetres.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.
`enabled`	boolean	Smart link enabled state. Valor predeterminado `true`.

Devuelve: items, count, values, message.

`nav.audit` (riesgo 0, requiere mundo, smoke)

Counts navigation actors, links, invokers and tiles.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.audit_bounds_coverage` (riesgo 0, requiere mundo, smoke)

Audits whether each generated Recast mesh intersects any registered bounds volume.

Sin argumentos.

Devuelve: issues, count.

`nav.audit_links` (riesgo 0, requiere mundo, smoke)

Audits every link proxy in the level for endpoints that are off the navmesh.

Sin argumentos.

Devuelve: issues, count.

`nav.audit_modifiers` (riesgo 0, requiere mundo, smoke)

Audits modifier volumes for empty bounds.

Sin argumentos.

Devuelve: issues, count.

`nav.batch_project_points` (riesgo 0, requiere mundo, smoke)

Projects up to 1000 points in one call.

Argumento	Tipo	Descripción
`points`	array of {x,y,z}	obligatorio. 1..1000 world points in centimetres.
`extent`	{x,y,z}	Projection half extent in centimetres. Valor predeterminado `FUeaVec3(100.0,100.0,200.0)`.
`navData`	string	Navigation data label/name.
`agent`	string	Supported agent name.

Devuelve: samples, count, navigable, fraction, navData.

`nav.batch_set_actor_nav` (riesgo 2, modifica, requiere mundo, smoke)

Applies navigation relevance settings to several named actors.

Argumento	Tipo	Descripción
`actors`	array of string	obligatorio. Actor references to update; every one must exist or nothing changes.
`canAffect`	string	Optional can-affect-navigation value as true or false.
`dynamicObstacle`	string	Optional dynamic-obstacle value as true or false.
`areaClass`	string	Optional NavArea class path or name.

Devuelve: items, count, values, message.

`nav.batch_set_smart_links` (riesgo 2, modifica, requiere mundo, smoke)

Sets the smart link enabled state on several proxies.

Argumento	Tipo	Descripción
`actors`	array of string	obligatorio. NavLinkProxy actor labels or names.
`enabled`	boolean	obligatorio. Desired smart-link enabled state.

Devuelve: items, count, values, message.

`nav.batch_test_paths` (riesgo 0, requiere mundo, smoke)

Tests a batch of independent start/end pairs and returns aggregate results.

Argumento	Tipo	Descripción
`paths`	array of UeaNavPathArgs	obligatorio. Start/end pairs in centimetres (each may carry its own selectors).

Devuelve: items, count, values, message.

`nav.build` (riesgo 4, requiere mundo, smoke)

Builds navigation for the editor world and blocks until the tiles are generated (engine Build Paths); pending bounds and octree updates are flushed first.

Sin argumentos.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.cancel_build` (riesgo 4, requiere mundo, smoke)

Cancels a navigation build if one is running.

Sin argumentos.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.clear_build_history` (riesgo 1, smoke)

Clears the session build history kept by the nav tools.

Sin argumentos.

Devuelve: records, count, total.

`nav.clear_smart_link_obstacle` (riesgo 2, modifica, requiere mundo, smoke)

Removes the smart-link box obstacle.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: links, count, message.

`nav.copy_simple_to_smart_link` (riesgo 2, modifica, requiere mundo, smoke)

Copies the first simple link's endpoints into the smart link (editor helper of NavLinkProxy).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: links, count, message.

`nav.create_agent_blueprint` (riesgo 2, modifica, smoke)

Creates a Character Blueprint ready for AI navigation: AIController class, auto-possess placed/spawned, navigation walking capabilities.

Argumento	Tipo	Descripción
`folder`	string	obligatorio. Destination content folder.
`name`	string	obligatorio. New Blueprint asset name.
`controllerClass`	string	AIController class path or name; empty uses AIController.

Devuelve: blueprint, controllerClass, autoPossessAI, useRvo, rvoRadius, rvoWeight, agentRadius, agentHeight, agentStepHeight, canCrouch, canJump, canWalk, canSwim, canFly, useAccelerationForPaths, updateNavAgentWithOwnersCollision, message.

`nav.create_area_blueprint` (riesgo 2, modifica, smoke)

Creates a NavArea Blueprint asset (optionally child of another NavArea class).

Argumento	Tipo	Descripción
`folder`	string	obligatorio. Destination content folder.
`name`	string	obligatorio. New NavArea asset name.
`parentClass`	string	Parent NavArea class path or name; empty uses NavArea.

Devuelve: items, count, values, message.

`nav.create_query_filter_blueprint` (riesgo 2, modifica, smoke)

Creates a NavigationQueryFilter Blueprint (per-area cost overrides and exclusions for path queries and AI moves).

Argumento	Tipo	Descripción
`folder`	string	obligatorio. Destination content folder.
`name`	string	obligatorio. New asset name.

Devuelve: filter, areas, includeFlags, excludeFlags, count, message.

`nav.create_test_character` (riesgo 2, modifica, requiere mundo, smoke)

Spawns a Character in the editor world (tagged UeaNavTest) as a fixture for RVO, path-to-actor and projection tests; remove it with nav.remove_test_actors.

Argumento	Tipo	Descripción
`name`	string	Editor label for the new actor. Valor predeterminado `TEXT("NavBounds")`.
`location`	{x,y,z}	Centre in centimetres.
`extent`	{x,y,z}	Box half extents in centimetres, each greater than zero. Valor predeterminado `FUeaVec3(1000.0,1000.0,500.0)`.

Devuelve: items, count, values, message.

`nav.create_test_floor` (riesgo 2, modifica, requiere mundo, smoke)

Creates a flat static floor (engine Cube scaled to extent.x/extent.y, 10 cm thick, tagged UeaNavTest) for navigation tests.

Argumento	Tipo	Descripción
`name`	string	Editor label for the new actor. Valor predeterminado `TEXT("NavBounds")`.
`location`	{x,y,z}	Centre in centimetres.
`extent`	{x,y,z}	Box half extents in centimetres, each greater than zero. Valor predeterminado `FUeaVec3(1000.0,1000.0,500.0)`.

Devuelve: items, count, values, message.

`nav.diagnose_build` (riesgo 0, requiere mundo, smoke)

Explains why navigation is empty or stale: missing system/bounds/nav data, invoker-only mode without invokers, disabled auto-update, empty tiles, dirty areas.

Sin argumentos.

Devuelve: ready, issues, count.

`nav.duplicate_area` (riesgo 2, modifica, smoke)

Duplicates a NavArea Blueprint asset (costs, colour and agents included).

Argumento	Tipo	Descripción
`source`	string	obligatorio. Source NavArea Blueprint asset path or unique name.
`folder`	string	obligatorio. Destination content folder.
`name`	string	obligatorio. New asset name.

Devuelve: items, count, values, message.

`nav.find_actors_by_area` (riesgo 0, requiere mundo, smoke)

Finds every level element that uses a NavArea: modifier volumes/components, obstacles, simple links, link components, smart links, replacements.

Argumento	Tipo	Descripción
`area`	string	obligatorio. NavArea class path or name.

Devuelve: areaClass, users, count.

`nav.find_distance_to_wall` (riesgo 0, requiere mundo, smoke)

Distance from a navmesh point to the nearest navmesh wall (edge) and the wall point.

Argumento	Tipo	Descripción
`point`	{x,y,z}	obligatorio. Point on the navmesh in centimetres.
`maxDistance`	number	Search limit in centimetres. Valor predeterminado `5000.0`.
`navData`	string	RecastNavMesh label/name.
`filterClass`	string	NavigationQueryFilter class; empty uses the default filter.

Devuelve: found, distance, wallPoint, navData.

`nav.find_nav_blockers` (riesgo 0, requiere mundo, smoke)

Lists navigation-relevant components whose collision is disabled.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.find_path` (riesgo 0, requiere mundo, smoke)

Finds a synchronous path (points, length, cost, failure cause); navData/agent/filterClass select the data and filter.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.find_path_to_actor` (riesgo 0, requiere mundo, smoke)

Finds a path to a moving actor and preserves its goal tether metadata.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`goalActor`	string	obligatorio. Goal actor label or name.
`tetherDistance`	number	Moving-goal tether distance in centimetres. Valor predeterminado `50.0`.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.fit_bounds_to_actors` (riesgo 2, modifica, requiere mundo, smoke)

Fits a bounds volume around explicitly supplied actor bounds.

Argumento	Tipo	Descripción
`boundsActor`	string	obligatorio. NavMeshBoundsVolume actor label or name.
`actors`	array of string	Actors whose combined bounds are fitted, when nonempty.
`padding`	{x,y,z}	Padding added to each fitted box dimension in centimetres. Valor predeterminado `FUeaVec3(100.0,100.0,100.0)`.

Devuelve: items, count, values, message.

`nav.fit_bounds_to_level` (riesgo 2, modifica, requiere mundo, smoke)

Fits a bounds volume around all navigationally relevant level actors.

Argumento	Tipo	Descripción
`boundsActor`	string	obligatorio. NavMeshBoundsVolume actor label or name.
`actors`	array of string	Actors whose combined bounds are fitted, when nonempty.
`padding`	{x,y,z}	Padding added to each fitted box dimension in centimetres. Valor predeterminado `FUeaVec3(100.0,100.0,100.0)`.

Devuelve: items, count, values, message.

`nav.get_actor_nav` (riesgo 0, requiere mundo, smoke)

Reads navigation relevance and obstacle settings from an actor's primitive components.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.get_agent_blueprint` (riesgo 0, smoke)

Returns the navigation defaults of a Character Blueprint: controller, auto-possess, RVO, nav agent size/capabilities and path following flags.

Argumento	Tipo	Descripción
`blueprint`	string	obligatorio. Character Blueprint asset path or unique name.
`controllerClass`	string	AIController class path or name.
`autoPossessAI`	string	Disabled, PlacedInWorld, Spawned or PlacedInWorldOrSpawned.
`useRvo`	string	RVO avoidance (true/false).
`rvoRadius`	string	RVO consideration radius in centimetres.
`rvoWeight`	string	RVO avoidance weight 0..1.
`agentRadius`	string	Navigation agent radius in centimetres.
`agentHeight`	string	Navigation agent height in centimetres.
`agentStepHeight`	string	Navigation agent step height in centimetres (negative = navmesh default).
`canCrouch`	string	Can crouch (true/false).
`canJump`	string	Can jump (true/false).
`canWalk`	string	Can walk (true/false).
`canSwim`	string	Can swim (true/false).
`canFly`	string	Can fly (true/false).
`useAccelerationForPaths`	string	Path following drives acceleration instead of velocity (true/false).
`updateNavAgentWithOwnersCollision`	string	Update agent radius/height from the collision capsule (true/false).

`nav.get_area` (riesgo 0, smoke)

Reads NavArea defaults: costs, flags, draw colour and supported agents.

Argumento	Tipo	Descripción
`area`	string	obligatorio. NavArea class path or name.

Devuelve: items, count, values, message.

`nav.get_area_id_map` (riesgo 0, requiere mundo, smoke)

Returns the Recast area id to NavArea class map of a navigation data actor.

Argumento	Tipo	Descripción
`navData`	string	Navigation data actor label/name; empty selects the only navigation data in the world.

Devuelve: areas, count, navData.

`nav.get_bounds_coverage` (riesgo 0, requiere mundo, smoke)

Returns the combined world bounds of all NavMeshBoundsVolume actors.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.get_build_history` (riesgo 0, smoke)

Returns the builds run through nav tools in this editor session (tool, duration, tiles before/after), newest first.

Argumento	Tipo	Descripción
`limit`	integer	Maximum records returned, newest first (1..500). Valor predeterminado `20`.

Devuelve: records, count, total.

`nav.get_build_status` (riesgo 0, requiere mundo, smoke)

Returns navigation build state, task count and actor counts.

Sin argumentos.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.get_crowd_settings` (riesgo 0, smoke)

Returns project crowd manager settings and every avoidance profile, typed.

Sin argumentos.

Devuelve: maxAgents, maxAgentRadius, maxAvoidedAgents, maxAvoidedWalls, profiles, message.

`nav.get_draw_flags` (riesgo 0, requiere mundo, smoke)

Returns every RecastNavMesh debug-draw flag supported by this engine version, the master drawing switch and the draw offset.

Argumento	Tipo	Descripción
`navData`	string	Navigation data actor label/name; empty selects the only navigation data in the world.

Devuelve: navData, enableDrawing, flags, drawOffset, message.

`nav.get_link_component` (riesgo 0, requiere mundo, smoke)

Returns every link of one NavLinkComponent with all fields and endpoint projection status.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Link component name; empty selects the actor's only NavLinkComponent (add: name of the new component).
`index`	integer	Link index inside the component. Valor predeterminado `0`.
`start`	{x,y,z}	Left point relative to the owner actor in centimetres.
`end`	{x,y,z}	Right point relative to the owner actor in centimetres. Valor predeterminado `FUeaVec3(100.0, 0.0, 0.0)`.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.

Devuelve: actor, component, links, count, message.

`nav.get_link_proxy` (riesgo 0, requiere mundo, smoke)

Returns the proxy summary: simple/segment link counts and smart link state.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.get_modifier_component` (riesgo 0, requiere mundo, smoke)

Returns one NavModifierComponent's areas.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Component name; empty selects the actor's only modifier component.
`areaClass`	string	NavArea class path/name; empty preserves it ("None" clears a replacement area).
`extent`	{x,y,z}	Failsafe box half extent in centimetres (used when the owner has no collision); zero keeps it.
`includeAgentHeight`	string	Expand the modifier bottom by the agent height (true/false); empty keeps it.

Devuelve: items, count, values, message.

`nav.get_modifier_volume` (riesgo 0, requiere mundo, smoke)

Returns a NavModifierVolume's bounds and areas.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.get_nav_data` (riesgo 0, requiere mundo, smoke)

Returns one navigation data actor typed: agent, runtime generation, registration, default flag, drawing, tile count and bounds.

Argumento	Tipo	Descripción
`navData`	string	Navigation data actor label/name; empty selects the only navigation data in the world.

Devuelve: navData, count, message.

`nav.get_navmesh` (riesgo 0, requiere mundo, smoke)

Returns the main RecastNavMesh generation settings of the only RecastNavMesh in the level.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.get_navmesh_bounds` (riesgo 0, requiere mundo, smoke)

Returns the aggregate bounds occupied by the generated Recast mesh.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.get_navmesh_properties` (riesgo 0, requiere mundo, smoke)

Reads named reflected Recast fields without changing the navmesh.

Argumento	Tipo	Descripción
`properties`	array of UeaKeyValue	obligatorio. Property/value pairs on the navigation settings object.

Devuelve: items, count, values, message.

`nav.get_path_corridor` (riesgo 0, requiere mundo, smoke)

Finds a path and returns its polygon corridor (poly refs, centres, areas, tiles, costs) and link segments.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: valid, partial, navData, points, linkSegments, polys, areas, length, cost, message.

`nav.get_path_cost` (riesgo 0, requiere mundo, smoke)

Returns the path cost with the selected navigation data and filter.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.get_path_length` (riesgo 0, requiere mundo, smoke)

Returns the path length with the selected navigation data and filter.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.get_path_metrics` (riesgo 0, requiere mundo, smoke)

Returns path length and cost in one request.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.get_poly_at` (riesgo 0, requiere mundo, smoke)

Returns the nearest polygon reference and projected point for a location.

Argumento	Tipo	Descripción
`point`	{x,y,z}	obligatorio. World point in centimetres.
`extent`	{x,y,z}	Half extent of the projection search box in centimetres. Valor predeterminado `FUeaVec3(100.0,100.0,200.0)`.
`navData`	string	Navigation data label/name; empty uses the agent's data or the default navigation data.
`agent`	string	Supported agent name; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class; empty uses the default filter.

Devuelve: found, point, distance, polyRef, message.

`nav.get_poly_info` (riesgo 0, requiere mundo, smoke)

Returns a polygon's centre, vertices, area id/class, flags, tile and neighbours (polyRef, or empty polyRef + point to use the nearest polygon).

Argumento	Tipo	Descripción
`polyRef`	string	Polygon reference (decimal, from nav.get_poly_at / nav.project_point); empty uses point.
`point`	{x,y,z}	Point in centimetres whose nearest polygon is described when polyRef is empty.
`extent`	{x,y,z}	Search half extent around point in centimetres. Valor predeterminado `FUeaVec3(100.0,100.0,200.0)`.
`navData`	string	RecastNavMesh label/name; empty selects the only one.

Devuelve: polyRef, center, verts, areaId, areaClass, polyFlags, areaFlags, tileIndex, polyIndex, neighbors, navData.

`nav.get_polys_in_box` (riesgo 0, requiere mundo, smoke)

Lists polygons overlapping a box (filtered by a query filter).

Argumento	Tipo	Descripción
`center`	{x,y,z}	obligatorio. Box centre in centimetres.
`extent`	{x,y,z}	obligatorio. Positive half extents in centimetres.
`limit`	integer	Maximum polygons returned (1..5000). Valor predeterminado `200`.
`navData`	string	RecastNavMesh label/name.
`filterClass`	string	NavigationQueryFilter class; empty uses the default filter.

Devuelve: polys, count, total, truncated, navData.

`nav.get_query_filter` (riesgo 0, smoke)

Returns the area overrides and include/exclude flags of a query filter.

Argumento	Tipo	Descripción
`filter`	string	obligatorio. NavigationQueryFilter Blueprint asset path, class path or name.

Devuelve: filter, areas, includeFlags, excludeFlags, count, message.

`nav.get_query_settings` (riesgo 0, requiere mundo, smoke)

Returns the path query tuning of a RecastNavMesh: search node limits, heuristic scale, vertical compensation, corner offsets.

Argumento	Tipo	Descripción
`navData`	string	Navigation data actor label/name; empty selects the only navigation data in the world.

Devuelve: navData, maxSearchNodes, maxHierarchicalSearchNodes, heuristicScale, verticalDeviationFromGroundCompensation, useBetterOffsetsFromCorners, allowNavLinkAsPathEnd, useVirtualFilters, message.

`nav.get_resolution` (riesgo 0, requiere mundo, smoke)

Returns cell size, cell height and step height per navmesh resolution (Low/Default/High on UE 5.2+, one row before).

Argumento	Tipo	Descripción
`navData`	string	Navigation data actor label/name; empty selects the only navigation data in the world.

Devuelve: navData, perResolution, rows, message.

`nav.get_rvo_avoidance` (riesgo 0, requiere mundo, smoke)

Reads RVO avoidance of a placed Character.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.get_settings` (riesgo 0, smoke)

Returns navigation-system settings exposed safely on both supported engines.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.get_simple_link` (riesgo 0, requiere mundo, smoke)

Returns one simple link with all fields and endpoint projection status.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy actor label/name.
`index`	integer	Simple-link index. Valor predeterminado `0`.
`start`	{x,y,z}	Link start in world centimetres.
`end`	{x,y,z}	Link end in world centimetres.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.
`enabled`	boolean	Smart link enabled state. Valor predeterminado `true`.

Devuelve: actor, component, links, count, message.

`nav.get_smart_link` (riesgo 0, requiere mundo, smoke)

Returns the full smart-link state of a proxy: points, direction, areas, broadcast, obstacle, endpoint projection.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: links, count, message.

`nav.get_stats` (riesgo 0, requiere mundo, smoke)

Returns nav mesh tile count and generation settings.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.get_tile_at` (riesgo 0, requiere mundo, smoke)

Returns the tile grid coordinates under a point and the populated tile slots (layers) at those coordinates.

Argumento	Tipo	Descripción
`point`	{x,y,z}	obligatorio. World point in centimetres.
`navData`	string	RecastNavMesh label/name; empty selects the only one.

Devuelve: tiles, count, truncated, navData, message.

`nav.get_tile_bounds` (riesgo 0, requiere mundo, smoke)

Returns one populated Recast tile's bounds.

Argumento	Tipo	Descripción
`tileIndex`	integer	obligatorio. Zero-based tile index returned by list_tiles.
`navData`	string	RecastNavMesh label/name; empty selects the only one.
`limit`	integer	Maximum polygons returned by list_polys_in_tile (1..5000). Valor predeterminado `200`.

Devuelve: items, count, values, message.

`nav.get_tile_cache` (riesgo 0, requiere mundo, smoke)

Returns tile pool and generation job settings of a RecastNavMesh.

Argumento	Tipo	Descripción
`navData`	string	Navigation data actor label/name; empty selects the only navigation data in the world.

Devuelve: navData, fixedTilePoolSize, tilePoolSize, tileNumberHardLimit, maxSimultaneousJobs, storeEmptyTileLayers, useVoxelCache, tileSetUpdateInterval, tileSizeUU, tileCount, message.

`nav.get_tile_count` (riesgo 0, requiere mundo, smoke)

Returns the Recast tile slot count, including currently empty slots.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.has_complete_data` (riesgo 0, requiere mundo, smoke)

Tells whether every tile around a point has generated data (invoker/streaming readiness).

Argumento	Tipo	Descripción
`point`	{x,y,z}	obligatorio. Point in centimetres.
`radius`	number	Radius in centimetres. Valor predeterminado `1000.0`.
`navData`	string	RecastNavMesh label/name.

Devuelve: complete, navData, message.

`nav.is_navigable` (riesgo 0, requiere mundo, smoke)

Tests whether a point projects to navigation.

Argumento	Tipo	Descripción
`point`	{x,y,z}	obligatorio. World point in centimetres.
`extent`	{x,y,z}	Half extent of the projection search box in centimetres. Valor predeterminado `FUeaVec3(100.0,100.0,200.0)`.
`navData`	string	Navigation data label/name; empty uses the agent's data or the default navigation data.
`agent`	string	Supported agent name; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class; empty uses the default filter.

Devuelve: found, point, distance, polyRef, message.

`nav.list_agents` (riesgo 0, smoke)

Lists configured navigation agents.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.list_area_classes` (riesgo 0, smoke)

Lists loaded NavArea classes.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.list_bounds_volumes` (riesgo 0, requiere mundo, smoke)

Lists NavMeshBoundsVolume actors.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.list_invokers` (riesgo 0, requiere mundo, smoke)

Lists navigation invoker components in the editor level.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.list_link_components` (riesgo 0, requiere mundo, smoke)

Lists the NavLinkComponents of an actor with their link counts.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: actor, components, count.

`nav.list_link_proxies` (riesgo 0, requiere mundo, smoke)

Lists NavLinkProxy actors and their simple-link counts.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.list_modifier_components` (riesgo 0, requiere mundo, smoke)

Lists the NavModifierComponents of an actor.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.list_modifier_volumes` (riesgo 0, requiere mundo, smoke)

Lists NavModifierVolume actors.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.list_modifiers` (riesgo 0, requiere mundo, smoke)

Lists every modifier volume and component of the level with area, replacement, resolution and bounds.

Sin argumentos.

Devuelve: modifiers, count.

`nav.list_nav_data` (riesgo 0, requiere mundo, smoke)

Lists navigation data actors in the editor world, typed (agent, runtime generation, default flag, tiles, bounds).

Sin argumentos.

Devuelve: navData, count, message.

`nav.list_nav_relevant_actors` (riesgo 0, requiere mundo, smoke)

Lists actors whose components can affect navigation, with their dynamic-obstacle components.

Argumento	Tipo	Descripción
`limit`	integer	Maximum entries returned (1..10000). Valor predeterminado `200`.

Devuelve: actors, count, truncated.

`nav.list_polys_in_tile` (riesgo 0, requiere mundo, smoke)

Lists the polygons of one tile slot.

Argumento	Tipo	Descripción
`tileIndex`	integer	obligatorio. Zero-based tile index returned by list_tiles.
`navData`	string	RecastNavMesh label/name; empty selects the only one.
`limit`	integer	Maximum polygons returned by list_polys_in_tile (1..5000). Valor predeterminado `200`.

Devuelve: polys, count, total, truncated, navData.

`nav.list_query_filters` (riesgo 0, smoke)

Lists loaded NavigationQueryFilter classes (Blueprint filters appear once loaded or created).

Sin argumentos.

Devuelve: items, count, values, message.

`nav.list_registered_bounds` (riesgo 0, requiere mundo, smoke)

Lists the bounds registered with the navigation system (what the generator really uses) with their supported agents.

Sin argumentos.

Devuelve: bounds, count, worldMin, worldMax.

`nav.list_simple_links` (riesgo 0, requiere mundo, smoke)

Lists every simple link of a proxy with all fields and whether each endpoint projects to generated navigation.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: actor, component, links, count, message.

`nav.list_smart_links` (riesgo 0, requiere mundo, smoke)

Lists the smart-link state of every NavLinkProxy in the level.

Sin argumentos.

Devuelve: links, count, message.

`nav.list_tile_refs` (riesgo 0, UE 5.5+, requiere mundo, smoke)

Lists populated tiles by tile ref with grid coordinates, layer, bounds, polygon count and resolution. UE 5.5+.

Argumento	Tipo	Descripción
`navData`	string	RecastNavMesh label/name; empty selects the only one.
`limit`	integer	Maximum tiles returned (1..5000). Valor predeterminado `200`.

Devuelve: tiles, count, truncated, navData, message.

`nav.list_tiles` (riesgo 0, requiere mundo, smoke)

Lists tile bounds for the only Recast navmesh.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.project_actor` (riesgo 0, requiere mundo, smoke)

Projects an editor actor origin onto the navigation mesh.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or name.
`extent`	{x,y,z}	Half extent of the projection search box in centimetres (x is also the random radius). Valor predeterminado `FUeaVec3(100.0,100.0,200.0)`.

Devuelve: found, point, distance, polyRef, message.

`nav.project_point` (riesgo 0, requiere mundo, smoke)

Projects a point onto the navmesh.

Argumento	Tipo	Descripción
`point`	{x,y,z}	obligatorio. World point in centimetres.
`extent`	{x,y,z}	Half extent of the projection search box in centimetres. Valor predeterminado `FUeaVec3(100.0,100.0,200.0)`.
`navData`	string	Navigation data label/name; empty uses the agent's data or the default navigation data.
`agent`	string	Supported agent name; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class; empty uses the default filter.

Devuelve: found, point, distance, polyRef, message.

`nav.random_navigable_from_actor` (riesgo 0, requiere mundo, smoke)

Samples a navigable point around an editor actor origin.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or name.
`extent`	{x,y,z}	Half extent of the projection search box in centimetres (x is also the random radius). Valor predeterminado `FUeaVec3(100.0,100.0,200.0)`.

Devuelve: found, point, distance, polyRef, message.

`nav.random_navigable_point` (riesgo 0, requiere mundo, smoke)

Finds a random navigable point within a radius.

Argumento	Tipo	Descripción
`origin`	{x,y,z}	obligatorio. Search origin in centimetres.
`radius`	number	obligatorio. Positive radius in centimetres.

Devuelve: found, point, distance, polyRef, message.

`nav.random_points` (riesgo 0, requiere mundo, smoke)

Returns up to 100 random points (reachable from the origin or merely navigable) in one call.

Argumento	Tipo	Descripción
`origin`	{x,y,z}	obligatorio. Origin in centimetres.
`radius`	number	obligatorio. Positive radius in centimetres.
`count`	integer	Points requested (1..100). Valor predeterminado `10`.
`reachable`	boolean	Only points reachable from the origin. Valor predeterminado `true`.
`navData`	string	Navigation data label/name.
`agent`	string	Supported agent name.

Devuelve: points, count, navData.

`nav.random_reachable_from_actor` (riesgo 0, requiere mundo, smoke)

Samples a reachable point around an editor actor origin.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or name.
`extent`	{x,y,z}	Half extent of the projection search box in centimetres (x is also the random radius). Valor predeterminado `FUeaVec3(100.0,100.0,200.0)`.

Devuelve: found, point, distance, polyRef, message.

`nav.random_reachable_point` (riesgo 0, requiere mundo, smoke)

Finds a random reachable navigation point within a radius.

Argumento	Tipo	Descripción
`origin`	{x,y,z}	obligatorio. Search origin in centimetres.
`radius`	number	obligatorio. Positive radius in centimetres.

Devuelve: found, point, distance, polyRef, message.

`nav.raycast` (riesgo 0, requiere mundo, smoke)

Performs a navigation raycast between two points.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: found, point, distance, polyRef, message.

`nav.raycast_actors` (riesgo 0, requiere mundo, smoke)

Raycasts between an editor point and an actor origin.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`goalActor`	string	obligatorio. Goal actor label or name.
`tetherDistance`	number	Moving-goal tether distance in centimetres. Valor predeterminado `50.0`.

Devuelve: found, point, distance, polyRef, message.

`nav.raycast_detailed` (riesgo 0, UE 5.5+, requiere mundo, smoke)

Navigation raycast on a RecastNavMesh with the additional corridor result (whether a clear ray's end lies in the explored corridor). UE 5.5+.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: hit, hitLocation, distance, rayEndInCorridor, navData, message.

`nav.reachability_matrix` (riesgo 0, requiere mundo, smoke)

All-pairs reachability between 2..16 points (length and cost per ordered pair).

Argumento	Tipo	Descripción
`points`	array of {x,y,z}	obligatorio. 2..16 world points in centimetres.
`navData`	string	Navigation data label/name.
`agent`	string	Supported agent name.
`filterClass`	string	NavigationQueryFilter class.

Devuelve: cells, size, reachablePairs, navData, message.

`nav.rebuild_all` (riesgo 4, modifica, requiere mundo, smoke)

Runs the same blocking full build as nav.build (use after changing RecastNavMesh generation settings).

Sin argumentos.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.rebuild_area` (riesgo 4, requiere mundo, smoke)

Marks a box dirty so only its tiles are regenerated on the next navigation tick; poll nav.wait_build afterwards.

Argumento	Tipo	Descripción
`center`	{x,y,z}	obligatorio. Box centre in centimetres.
`extent`	{x,y,z}	obligatorio. Positive box half extents in centimetres.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.rebuild_nav_data` (riesgo 4, requiere mundo, smoke)

Rebuilds one navigation data actor synchronously (RebuildAll + wait), leaving the other agents' data untouched.

Argumento	Tipo	Descripción
`navData`	string	Navigation data actor label/name; empty selects the only navigation data in the world.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.refresh_actor_nav` (riesgo 1, requiere mundo, smoke)

Re-registers actors in the navigation octree after collision or relevance edits (marks their areas dirty).

Argumento	Tipo	Descripción
`actors`	array of string	obligatorio. Actor labels or object names; each must match exactly one actor.

Devuelve: items, count, values, message.

`nav.refresh_all_bounds` (riesgo 2, modifica, requiere mundo, smoke)

Re-registers every NavMeshBoundsVolume in the editor level.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.refresh_bounds_volume` (riesgo 2, modifica, requiere mundo, smoke)

Re-registers one edited bounds volume with the navigation system.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.remove_agent` (riesgo 4)

Removes a named supported agent from project navigation settings.

Argumento	Tipo	Descripción
`name`	string	obligatorio. Unique supported-agent name.
`radius`	string	Agent radius; empty preserves it.
`height`	string	Agent height; empty preserves it.
`stepHeight`	string	Agent step height; empty preserves it.
`navDataClass`	string	Optional navigation-data class.

Devuelve: items, count, values, message.

`nav.remove_bounds_volume` (riesgo 3, modifica, destructivo, requiere mundo, smoke)

Removes one NavMeshBoundsVolume actor.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.remove_build_lock` (riesgo 4, modifica, requiere mundo, smoke)

Releases a navigation build lock and optionally requests its deferred rebuild.

Argumento	Tipo	Descripción
`flags`	integer	Bitmask accepted by UNavigationSystemV1 build-lock APIs. Valor predeterminado `1`.
`rebuildOnRelease`	boolean	Rebuild navigation when releasing the lock. Valor predeterminado `true`.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.remove_invoker` (riesgo 3, modifica, destructivo, requiere mundo, smoke)

Removes the navigation invoker component of an actor.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.remove_link_component` (riesgo 3, modifica, destructivo, requiere mundo, smoke)

Removes a NavLinkComponent that was added to the actor instance.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Link component name; empty selects the actor's only NavLinkComponent (add: name of the new component).
`index`	integer	Link index inside the component. Valor predeterminado `0`.
`start`	{x,y,z}	Left point relative to the owner actor in centimetres.
`end`	{x,y,z}	Right point relative to the owner actor in centimetres. Valor predeterminado `FUeaVec3(100.0, 0.0, 0.0)`.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.

Devuelve: actor, components, count.

`nav.remove_link_component_link` (riesgo 2, modifica, requiere mundo, smoke)

Removes one link from a NavLinkComponent.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Link component name; empty selects the actor's only NavLinkComponent (add: name of the new component).
`index`	integer	Link index inside the component. Valor predeterminado `0`.
`start`	{x,y,z}	Left point relative to the owner actor in centimetres.
`end`	{x,y,z}	Right point relative to the owner actor in centimetres. Valor predeterminado `FUeaVec3(100.0, 0.0, 0.0)`.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.

Devuelve: actor, component, links, count, message.

`nav.remove_link_proxy` (riesgo 3, modifica, destructivo, requiere mundo, smoke)

Removes a NavLinkProxy.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.remove_modifier_component` (riesgo 3, modifica, destructivo, requiere mundo, smoke)

Removes a NavModifierComponent that was added to the actor instance.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Component name; empty selects the actor's only modifier component.
`areaClass`	string	NavArea class path/name; empty preserves it ("None" clears a replacement area).
`extent`	{x,y,z}	Failsafe box half extent in centimetres (used when the owner has no collision); zero keeps it.
`includeAgentHeight`	string	Expand the modifier bottom by the agent height (true/false); empty keeps it.

Devuelve: items, count, values, message.

`nav.remove_modifier_volume` (riesgo 3, modifica, destructivo, requiere mundo, smoke)

Removes a NavModifierVolume.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.remove_nav_data` (riesgo 3, modifica, destructivo, requiere mundo)

Destroys one navigation data actor (its generated tiles go with it; nav.build recreates it).

Argumento	Tipo	Descripción
`navData`	string	Navigation data actor label/name; empty selects the only navigation data in the world.

Devuelve: navData, count, message.

`nav.remove_query_filter_area` (riesgo 2, modifica, smoke)

Removes one area override from a Blueprint query filter.

Argumento	Tipo	Descripción
`filter`	string	obligatorio. NavigationQueryFilter Blueprint asset path or unique name.
`areaClass`	string	obligatorio. NavArea class path or name.
`travelCost`	string	Travel cost override (> 0); "none" clears the override.
`enteringCost`	string	Entering cost override (>= 0); "none" clears the override.
`excluded`	string	Exclude the area from paths (true/false).

Devuelve: filter, areas, includeFlags, excludeFlags, count, message.

`nav.remove_simple_link` (riesgo 2, modifica, requiere mundo, smoke)

Removes one simple link by index.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy actor label/name.
`index`	integer	Simple-link index. Valor predeterminado `0`.
`start`	{x,y,z}	Link start in world centimetres.
`end`	{x,y,z}	Link end in world centimetres.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.
`enabled`	boolean	Smart link enabled state. Valor predeterminado `true`.

Devuelve: items, count, values, message.

`nav.remove_test_actors` (riesgo 3, modifica, destructivo, requiere mundo, smoke)

Destroys fixture actors created by nav.create_test_floor / nav.create_test_character (only actors tagged UeaNavTest are accepted).

Argumento	Tipo	Descripción
`actors`	array of string	obligatorio. Actor labels or names; each must carry the UeaNavTest tag set by the nav test-fixture tools.

Devuelve: items, count, values, message.

`nav.runtime_batch_reachability` (riesgo 0, requiere PIE, smoke)

Tests independent start/end pairs in the PIE world.

Argumento	Tipo	Descripción
`paths`	array of UeaNavPathArgs	obligatorio. Start/end pairs in centimetres (each may carry its own selectors).

Devuelve: results, count, reachable.

`nav.runtime_cancel_build` (riesgo 4, modifica, requiere PIE, smoke)

Cancels the PIE navigation build.

Sin argumentos.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.runtime_despawn_agent` (riesgo 1, requiere PIE, smoke)

Destroys a PIE pawn and its controller (pass either).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.runtime_find_path` (riesgo 0, requiere PIE, smoke)

Finds a path in the PIE world (same selectors as nav.find_path).

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.runtime_find_path_for_agent` (riesgo 0, requiere PIE, smoke)

Finds a path from a controller's pawn to a goal with the pawn's agent properties and the controller's default filter (what MoveTo would use).

Argumento	Tipo	Descripción
`controller`	string	obligatorio. PIE AIController label or name.
`goal`	{x,y,z}	obligatorio. Goal location in centimetres.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.runtime_get_bounds` (riesgo 0, requiere PIE, smoke)

Returns the PIE RecastNavMesh bounds.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.runtime_get_build_status` (riesgo 0, requiere PIE, smoke)

Returns PIE navigation build status.

Sin argumentos.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.runtime_get_controller_state` (riesgo 0, requiere PIE, smoke)

Returns the full live state of a PIE AIController: pawn, velocity, move status, path progress, goal, focus, agent size, nav data, filter.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: controller, controllerClass, pawn, location, velocity, moveStatus, hasPath, pathLength, remainingCost, currentPathIndex, destination, currentTarget, acceptanceRadius, lastMoveReachedGoal, goalActor, focusActor, agentRadius, agentHeight, navData, filterClass, crowdAgent.

`nav.runtime_get_crowd_agent` (riesgo 0, requiere PIE, smoke)

Returns the crowd following settings of a PIE DetourCrowdAIController.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: controller, registered, simulation, quality, anticipateTurns, obstacleAvoidance, separation, optimizeVisibility, optimizeTopology, pathOffset, slowdownAtGoal, separationWeight, collisionQueryRange, pathOptimizationRange, avoidanceRangeMultiplier, avoidanceGroup, groupsToAvoid, groupsToIgnore.

`nav.runtime_get_crowd_profiles` (riesgo 0, requiere PIE, smoke)

Returns the PIE crowd manager's avoidance profiles.

Sin argumentos.

Devuelve: maxAgents, maxAgentRadius, maxAvoidedAgents, maxAvoidedWalls, profiles, message.

`nav.runtime_get_invoker_locations` (riesgo 0, requiere PIE, smoke)

Returns the invoker locations and radii the PIE navigation system gathered last.

Sin argumentos.

Devuelve: invokers, count, invokerOnly.

`nav.runtime_get_move_status` (riesgo 0, requiere PIE, smoke)

Returns path-following status and request result of a PIE AIController.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.runtime_get_navmesh` (riesgo 0, requiere PIE, smoke)

Returns the PIE RecastNavMesh summary.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.runtime_get_obstacle` (riesgo 0, requiere PIE, smoke)

Reads navigation relevance of a PIE actor's primitive components.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.runtime_get_path` (riesgo 0, requiere PIE, smoke)

Returns the active path of a PIE AIController.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.runtime_get_rvo` (riesgo 0, requiere PIE, smoke)

Returns RVO avoidance of a PIE Character.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: actor, enabled, radius, weight, avoidanceGroup, groupsToAvoid, groupsToIgnore, avoidanceUID.

`nav.runtime_get_smart_link` (riesgo 0, requiere PIE, smoke)

Returns the smart-link state of a PIE NavLinkProxy (points, areas, broadcast, obstacle).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: links, count, message.

`nav.runtime_get_tile_count` (riesgo 0, requiere PIE, smoke)

Returns the PIE RecastNavMesh tile slot count.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.runtime_list_invokers` (riesgo 0, requiere PIE, smoke)

Lists PIE navigation invoker components.

Sin argumentos.

Devuelve: items, count, values, message.

`nav.runtime_move_to` (riesgo 2, modifica, requiere PIE, smoke)

Sends a PIE AIController to a location.

Argumento	Tipo	Descripción
`controller`	string	obligatorio. PIE AIController actor label or name.
`goal`	{x,y,z}	obligatorio. Goal location in centimetres.
`acceptanceRadius`	number	Acceptance radius in centimetres. Valor predeterminado `50.0`.
`stopOnOverlap`	boolean	Stop on overlap with the goal. Valor predeterminado `true`.

Devuelve: items, count, values, message.

`nav.runtime_move_to_actor` (riesgo 2, modifica, requiere PIE, smoke)

Sends a PIE AIController to an actor (the path follows the moving goal).

Argumento	Tipo	Descripción
`controller`	string	obligatorio. PIE AIController actor label or name.
`goalActor`	string	obligatorio. Goal actor label or name (PIE world).
`acceptanceRadius`	number	Acceptance radius in centimetres. Valor predeterminado `50.0`.
`stopOnOverlap`	boolean	Stop on overlap with the goal. Valor predeterminado `true`.

Devuelve: items, count, values, message.

`nav.runtime_pause_move` (riesgo 0, requiere PIE, smoke)

Pauses the active move of a PIE AIController (keeps the path).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

`nav.runtime_project_point` (riesgo 0, requiere PIE, smoke)

Projects a point onto the PIE navigation data.

Argumento	Tipo	Descripción
`point`	{x,y,z}	obligatorio. World point in centimetres.
`extent`	{x,y,z}	Half extent of the projection search box in centimetres. Valor predeterminado `FUeaVec3(100.0,100.0,200.0)`.
`navData`	string	Navigation data label/name; empty uses the agent's data or the default navigation data.
`agent`	string	Supported agent name; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class; empty uses the default filter.

Devuelve: found, point, distance, polyRef, message.

`nav.runtime_random_navigable` (riesgo 0, requiere PIE, smoke)

Returns a random navigable PIE point.

Argumento	Tipo	Descripción
`origin`	{x,y,z}	obligatorio. PIE-world origin.
`radius`	number	obligatorio. Positive radius in centimetres.
`reachable`	boolean	Require reachability from origin. Valor predeterminado `true`.

Devuelve: found, point, distance, polyRef, message.

`nav.runtime_random_point` (riesgo 0, requiere PIE, smoke)

Returns a random PIE navigation point (reachable or navigable).

Argumento	Tipo	Descripción
`origin`	{x,y,z}	obligatorio. PIE-world origin.
`radius`	number	obligatorio. Positive radius in centimetres.
`reachable`	boolean	Require reachability from origin. Valor predeterminado `true`.

Devuelve: found, point, distance, polyRef, message.

`nav.runtime_random_reachable` (riesgo 0, requiere PIE, smoke)

Returns a random PIE point reachable from origin.

Argumento	Tipo	Descripción
`origin`	{x,y,z}	obligatorio. PIE-world origin.
`radius`	number	obligatorio. Positive radius in centimetres.
`reachable`	boolean	Require reachability from origin. Valor predeterminado `true`.

Devuelve: found, point, distance, polyRef, message.

`nav.runtime_raycast` (riesgo 0, requiere PIE, smoke)

Navigation raycast in the PIE world.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: found, point, distance, polyRef, message.

`nav.runtime_rebuild` (riesgo 4, requiere PIE, smoke)

Requests a full navigation build in the PIE world.

Sin argumentos.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.runtime_rebuild_area` (riesgo 0, requiere PIE, smoke)

Marks a PIE box dirty so dynamic navigation regenerates its tiles.

Argumento	Tipo	Descripción
`center`	{x,y,z}	obligatorio. Box centre in centimetres.
`extent`	{x,y,z}	obligatorio. Positive box half extents in centimetres.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.runtime_register_invoker` (riesgo 0, requiere PIE, smoke)

Registers a PIE actor as navigation invoker.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`generationRadius`	number	obligatorio. Positive tile generation radius in centimetres.
`removalRadius`	number	obligatorio. Removal radius in centimetres, at least generation radius.

Devuelve: items, count, values, message.

`nav.runtime_resume_move` (riesgo 0, requiere PIE, smoke)

Resumes a paused move of a PIE AIController.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

`nav.runtime_set_crowd_agent` (riesgo 0, requiere PIE, smoke)

Changes crowd following settings of a PIE DetourCrowdAIController (quality, separation, groups, ranges, simulation state).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. PIE AIController label or name (DetourCrowdAIController).
`simulation`	string	Enabled, ObstacleOnly or Disabled.
`quality`	string	Low, Medium, Good or High (selects the avoidance profile).
`anticipateTurns`	string	true/false.
`obstacleAvoidance`	string	true/false.
`separation`	string	true/false.
`optimizeVisibility`	string	true/false.
`optimizeTopology`	string	true/false.
`pathOffset`	string	true/false.
`slowdownAtGoal`	string	true/false.
`separationWeight`	string	Separation weight (>= 0).
`collisionQueryRange`	string	Collision query range in centimetres.
`pathOptimizationRange`	string	Path optimization range in centimetres.
`avoidanceRangeMultiplier`	string	Avoidance range multiplier.
`avoidanceGroup`	string	Avoidance group bitmask.
`groupsToAvoid`	string	Groups to avoid bitmask.
`groupsToIgnore`	string	Groups to ignore bitmask.

`nav.runtime_set_crowd_profile` (riesgo 0, requiere PIE, smoke)

Changes one avoidance profile of the PIE crowd manager (session only; nav.set_crowd_avoidance_profile writes the project default).

Argumento	Tipo	Descripción
`index`	integer	obligatorio. Profile index (0..3 by default).
`velocityBias`	string	Velocity bias.
`desiredVelocityWeight`	string	Desired velocity weight.
`currentVelocityWeight`	string	Current velocity weight.
`sideBiasWeight`	string	Side bias weight.
`impactTimeWeight`	string	Impact time weight.
`impactTimeRange`	string	Impact time range in seconds.
`adaptiveDivisions`	string	Adaptive divisions (1..32).
`adaptiveRings`	string	Adaptive rings (1..4).
`adaptiveDepth`	string	Adaptive depth (1..10).

Devuelve: maxAgents, maxAgentRadius, maxAvoidedAgents, maxAvoidedWalls, profiles, message.

`nav.runtime_set_obstacle` (riesgo 2, modifica, requiere PIE, smoke)

Turns navigation relevance of a PIE actor's primitive components on/off.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. PIE actor label or name.
`enabled`	boolean	obligatorio. Whether primitive components affect navigation.

Devuelve: items, count, values, message.

`nav.runtime_set_rvo` (riesgo 0, requiere PIE, smoke)

Changes RVO avoidance of a PIE Character (enable, radius, weight, groups).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. PIE Character label or name.
`enabled`	string	Enable RVO avoidance (true/false).
`radius`	string	Consideration radius in centimetres.
`weight`	string	Avoidance weight 0..1.
`avoidanceGroup`	string	Avoidance group bitmask.
`groupsToAvoid`	string	Groups to avoid bitmask.
`groupsToIgnore`	string	Groups to ignore bitmask.

Devuelve: actor, enabled, radius, weight, avoidanceGroup, groupsToAvoid, groupsToIgnore, avoidanceUID.

`nav.runtime_set_smart_link_enabled` (riesgo 0, requiere PIE, smoke)

Enables/disables a PIE smart link (door open/closed) and notifies agents per its broadcast settings.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. PIE NavLinkProxy label or name.
`enabled`	boolean	obligatorio. Enable the smart link.

Devuelve: links, count, message.

`nav.runtime_spawn_link_proxy` (riesgo 1, requiere PIE, smoke)

Spawns a NavLinkProxy in the PIE world (runtime jump/door links); its smart link starts disabled.

Argumento	Tipo	Descripción
`name`	string	Editor label for the link proxy. Valor predeterminado `TEXT("NavLink")`.
`start`	{x,y,z}	obligatorio. Left endpoint in world centimetres.
`end`	{x,y,z}	obligatorio. Right endpoint in world centimetres.
`bidirectional`	boolean	Whether traversal is allowed in both directions. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class path or short name.

Devuelve: items, count, values, message.

`nav.runtime_stop_movement` (riesgo 0, requiere PIE, smoke)

Stops the movement of a PIE AIController.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.runtime_test_path` (riesgo 0, requiere PIE, smoke)

Tests whether a complete PIE path exists.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.runtime_unregister_invoker` (riesgo 0, requiere PIE, smoke)

Unregisters a PIE navigation invoker.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.runtime_update_actor_nav` (riesgo 0, requiere PIE, smoke)

Re-registers a PIE actor in the navigation octree after it moved or changed collision (dirties its area).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: items, count, values, message.

`nav.runtime_validate` (riesgo 0, requiere PIE, smoke)

Validates the PIE navigation data.

Sin argumentos.

Devuelve: issues, count.

`nav.sample_navmesh` (riesgo 0, requiere mundo, smoke)

Samples a box on a grid and reports which points are navigable (coverage fraction).

Argumento	Tipo	Descripción
`center`	{x,y,z}	obligatorio. Box centre in centimetres.
`extent`	{x,y,z}	obligatorio. Positive box half extents in centimetres (z is the vertical projection range).
`spacing`	number	Grid spacing in centimetres (>= 10). Valor predeterminado `100.0`.
`maxSamples`	integer	Maximum samples (1..2500). Valor predeterminado `400`.
`navData`	string	Navigation data label/name.
`agent`	string	Supported agent name.

Devuelve: samples, count, navigable, fraction, navData.

`nav.set_actor_nav` (riesgo 2, modifica, requiere mundo, smoke)

Sets navigation relevance and dynamic-obstacle properties on an actor's primitive components.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or name.
`canAffect`	string	Optional can-affect-navigation value as true or false.
`dynamicObstacle`	string	Optional dynamic-obstacle value as true or false.
`areaClass`	string	Optional NavArea class path or name for shape components.

Devuelve: items, count, values, message.

`nav.set_agent` (riesgo 4)

Updates a named supported agent in project navigation settings.

Argumento	Tipo	Descripción
`name`	string	obligatorio. Unique supported-agent name.
`radius`	string	Agent radius; empty preserves it.
`height`	string	Agent height; empty preserves it.
`stepHeight`	string	Agent step height; empty preserves it.
`navDataClass`	string	Optional navigation-data class.

Devuelve: items, count, values, message.

`nav.set_agent_blueprint` (riesgo 2, modifica, smoke)

Sets navigation defaults of a Character Blueprint (controller, auto-possess, RVO, nav agent size/capabilities, path following flags).

Argumento	Tipo	Descripción
`blueprint`	string	obligatorio. Character Blueprint asset path or unique name.
`controllerClass`	string	AIController class path or name.
`autoPossessAI`	string	Disabled, PlacedInWorld, Spawned or PlacedInWorldOrSpawned.
`useRvo`	string	RVO avoidance (true/false).
`rvoRadius`	string	RVO consideration radius in centimetres.
`rvoWeight`	string	RVO avoidance weight 0..1.
`agentRadius`	string	Navigation agent radius in centimetres.
`agentHeight`	string	Navigation agent height in centimetres.
`agentStepHeight`	string	Navigation agent step height in centimetres (negative = navmesh default).
`canCrouch`	string	Can crouch (true/false).
`canJump`	string	Can jump (true/false).
`canWalk`	string	Can walk (true/false).
`canSwim`	string	Can swim (true/false).
`canFly`	string	Can fly (true/false).
`useAccelerationForPaths`	string	Path following drives acceleration instead of velocity (true/false).
`updateNavAgentWithOwnersCollision`	string	Update agent radius/height from the collision capsule (true/false).

`nav.set_area_defaults` (riesgo 2, modifica, smoke)

Sets NavArea defaults: traversal cost, entering cost, flags, draw colour and supported agents.

Argumento	Tipo	Descripción
`area`	string	obligatorio. NavArea class path or name.
`defaultCost`	string	Default traversal cost; empty preserves it.
`fixedAreaEnteringCost`	string	Fixed entering cost; empty preserves it.
`drawColor`	string	Debug draw colour as (R=,G=,B=,A=) text; empty preserves it.
`supportedAgents`	array of string	Supported agent names; empty preserves the current agents.

Devuelve: items, count, values, message.

`nav.set_auto_update` (riesgo 1, requiere mundo, smoke)

Turns automatic navigation rebuilds after edits on/off for this editor session.

Argumento	Tipo	Descripción
`enabled`	boolean	obligatorio. Rebuild navigation automatically after edits in this editor session.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

`nav.set_bounds_agents` (riesgo 2, modifica, requiere mundo, smoke)

Restricts a NavMeshBoundsVolume to some supported agents (empty list = all agents).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavMeshBoundsVolume label or name.
`agents`	array of string	Supported agent names; empty means every agent.

Devuelve: bounds, count, worldMin, worldMax.

`nav.set_bounds_volume` (riesgo 2, modifica, requiere mundo, smoke)

Resizes and moves a NavMeshBoundsVolume, then notifies navigation.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Bounds-volume actor label or name.
`location`	{x,y,z}	New centre in centimetres.
`extent`	{x,y,z}	obligatorio. New positive box half extents in centimetres.

Devuelve: items, count, values, message.

`nav.set_crowd_avoidance_profile` (riesgo 4)

Writes one crowd avoidance profile to project config (DefaultEngine.ini CrowdManager).

Argumento	Tipo	Descripción
`index`	integer	obligatorio. Profile index (0..3 by default).
`velocityBias`	string	Velocity bias.
`desiredVelocityWeight`	string	Desired velocity weight.
`currentVelocityWeight`	string	Current velocity weight.
`sideBiasWeight`	string	Side bias weight.
`impactTimeWeight`	string	Impact time weight.
`impactTimeRange`	string	Impact time range in seconds.
`adaptiveDivisions`	string	Adaptive divisions (1..32).
`adaptiveRings`	string	Adaptive rings (1..4).
`adaptiveDepth`	string	Adaptive depth (1..10).

Devuelve: maxAgents, maxAgentRadius, maxAvoidedAgents, maxAvoidedWalls, profiles, message.

`nav.set_crowd_settings` (riesgo 4)

Writes the crowd MaxAgents to project config.

Argumento	Tipo	Descripción
`maxAgents`	integer	obligatorio. Maximum crowd agents, from 1 to 100000.

Devuelve: maxAgents, maxAgentRadius, maxAvoidedAgents, maxAvoidedWalls, profiles, message.

`nav.set_draw_flags` (riesgo 2, modifica, requiere mundo, smoke)

Turns RecastNavMesh debug-draw flags on/off (names from nav.get_draw_flags), plus the master drawing switch and draw offset.

Argumento	Tipo	Descripción
`navData`	string	RecastNavMesh actor label/name; empty selects the only one.
`enable`	array of string	Flag names to turn on (see nav.get_draw_flags for the supported list).
`disable`	array of string	Flag names to turn off.
`enableDrawing`	string	Optional master drawing switch as true/false; empty keeps it.
`drawOffset`	string	Optional draw offset in centimetres; empty keeps it.

Devuelve: navData, enableDrawing, flags, drawOffset, message.

`nav.set_invoker` (riesgo 2, modifica, requiere mundo, smoke)

Changes the radii of the actor's only navigation invoker component.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`generationRadius`	number	obligatorio. Positive tile generation radius in centimetres.
`removalRadius`	number	obligatorio. Removal radius in centimetres, at least generation radius.

Devuelve: items, count, values, message.

`nav.set_link_component_link` (riesgo 2, modifica, requiere mundo, smoke)

Moves one NavLinkComponent link (points relative to the actor), its direction and optional area.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Link component name; empty selects the actor's only NavLinkComponent (add: name of the new component).
`index`	integer	Link index inside the component. Valor predeterminado `0`.
`start`	{x,y,z}	Left point relative to the owner actor in centimetres.
`end`	{x,y,z}	Right point relative to the owner actor in centimetres. Valor predeterminado `FUeaVec3(100.0, 0.0, 0.0)`.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.

Devuelve: actor, component, links, count, message.

`nav.set_link_properties` (riesgo 2, modifica, requiere mundo, smoke)

Sets direction, area, snap, projection heights, description and supported agents of a proxy simple link or a NavLinkComponent link.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	NavLinkComponent name; empty edits the NavLinkProxy simple links (PointLinks).
`index`	integer	Link index. Valor predeterminado `0`.
`direction`	string	BothWays, LeftToRight or RightToLeft.
`areaClass`	string	NavArea class path/name.
`snapRadius`	string	Endpoint snap radius in centimetres (>= 1).
`snapHeight`	string	Endpoint snap height in centimetres (>= 1; enables useSnapHeight).
`useSnapHeight`	string	Use snapHeight (true/false).
`leftProjectHeight`	string	Left endpoint projection height in centimetres.
`maxFallDownLength`	string	Right endpoint maximum fall-down length in centimetres.
`snapToCheapestArea`	string	Snap to the cheapest area under the endpoint (true/false).
`description`	string	Free-form description.
`supportedAgents`	array of string	Supported agent names; empty preserves them.

Devuelve: actor, component, links, count, message.

`nav.set_link_proxy` (riesgo 2, modifica, requiere mundo, smoke)

Moves one simple link (world points), its direction and optional area.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy actor label/name.
`index`	integer	Simple-link index. Valor predeterminado `0`.
`start`	{x,y,z}	Link start in world centimetres.
`end`	{x,y,z}	Link end in world centimetres.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.
`enabled`	boolean	Smart link enabled state. Valor predeterminado `true`.

Devuelve: items, count, values, message.

`nav.set_modifier_component` (riesgo 2, modifica, requiere mundo, smoke)

Changes a NavModifierComponent's area, failsafe extent and agent-height expansion.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Component name; empty selects the actor's only modifier component.
`areaClass`	string	NavArea class path/name; empty preserves it ("None" clears a replacement area).
`extent`	{x,y,z}	Failsafe box half extent in centimetres (used when the owner has no collision); zero keeps it.
`includeAgentHeight`	string	Expand the modifier bottom by the agent height (true/false); empty keeps it.

Devuelve: items, count, values, message.

`nav.set_modifier_replacement` (riesgo 2, modifica, UE 5.5+, requiere mundo, smoke)

Sets the area a NavModifierComponent replaces (UE 5.5+; areaClass None clears it).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Owner actor label/name.
`componentName`	string	Component name; empty selects the actor's only modifier component.
`areaClass`	string	NavArea class path/name; empty preserves it ("None" clears a replacement area).
`extent`	{x,y,z}	Failsafe box half extent in centimetres (used when the owner has no collision); zero keeps it.
`includeAgentHeight`	string	Expand the modifier bottom by the agent height (true/false); empty keeps it.

Devuelve: items, count, values, message.

`nav.set_modifier_resolution` (riesgo 2, modifica, UE 5.2+, requiere mundo, smoke)

Sets the tile resolution a modifier forces (Low/Default/High/None): volumes need UE 5.2, components UE 5.3.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavModifierVolume label, or the owner of a NavModifierComponent.
`componentName`	string	Component name; empty edits a NavModifierVolume actor.
`resolution`	string	obligatorio. Low, Default, High or None.

Devuelve: modifiers, count.

`nav.set_modifier_volume` (riesgo 2, modifica, requiere mundo, smoke)

Moves/resizes a NavModifierVolume and optionally changes its area.

Argumento	Tipo	Descripción
`name`	string	Actor label/name for a new volume.
`areaClass`	string	obligatorio. NavArea class path/name ("None" clears a replacement area).
`location`	{x,y,z}	Centre in centimetres.
`extent`	{x,y,z}	Positive brush half extents. Valor predeterminado `FUeaVec3(500,500,250)`.
`actor`	string	Existing actor reference for setters/components.

Devuelve: items, count, values, message.

`nav.set_modifier_volume_replacement` (riesgo 2, modifica, UE 5.5+, requiere mundo, smoke)

Sets the area a NavModifierVolume replaces (UE 5.5+; areaClass None clears it).

Argumento	Tipo	Descripción
`name`	string	Actor label/name for a new volume.
`areaClass`	string	obligatorio. NavArea class path/name ("None" clears a replacement area).
`location`	{x,y,z}	Centre in centimetres.
`extent`	{x,y,z}	Positive brush half extents. Valor predeterminado `FUeaVec3(500,500,250)`.
`actor`	string	Existing actor reference for setters/components.

Devuelve: items, count, values, message.

`nav.set_navmesh` (riesgo 2, modifica, requiere mundo, smoke)

Sets typed RecastNavMesh generation fields: tile, agent, cell (Default resolution), region/layer partitioning, filtering, simplification (text values; empty keeps the value). Rebuild afterwards.

Argumento	Tipo	Descripción
`actor`	string	RecastNavMesh actor label/name; empty selects the only one in the level.
`cellSize`	string	Cell size in centimetres (UE 5.2+: the Default resolution; use nav.set_resolution for Low/High).
`cellHeight`	string	Cell height in centimetres (UE 5.2+: the Default resolution).
`tileSizeUU`	string	Tile size in Unreal units.
`agentRadius`	string	Agent radius in centimetres.
`agentHeight`	string	Agent height in centimetres.
`agentMaxSlope`	string	Maximum walkable slope in degrees.
`drawDebug`	string	Whether the nav mesh debug drawing is enabled.
`minRegionArea`	string	Minimum region area in square centimetres.
`mergeRegionSize`	string	Regions smaller than this are merged (square centimetres).
`maxSimplificationError`	string	Maximum contour simplification error in cells.
`regionPartitioning`	string	Region partitioning: Monotone, Watershed or ChunkyMonotone.
`layerPartitioning`	string	Layer partitioning: Monotone, Watershed or ChunkyMonotone.
`regionChunkSplits`	string	Region chunk splits for ChunkyMonotone.
`layerChunkSplits`	string	Layer chunk splits for ChunkyMonotone.
`performVoxelFiltering`	string	Voxel filtering (true/false).
`markLowHeightAreas`	string	Mark low-height areas (true/false).
`filterLowSpanSequences`	string	Filter low span sequences (true/false).
`filterLowSpanFromTileCache`	string	Filter low spans from the tile cache (true/false).
`sortNavigationAreasByCost`	string	Sort navigation areas by cost (true/false).
`generateNavLinks`	string	Experimental automatic nav link generation (true/false, UE 5.5+).

Devuelve: items, count, values, message.

`nav.set_navmesh_properties` (riesgo 2, modifica, requiere mundo, smoke)

Writes a batch of reflected Recast fields as one transactional navmesh edit.

Argumento	Tipo	Descripción
`properties`	array of UeaKeyValue	obligatorio. Property/value pairs on the navigation settings object.

Devuelve: items, count, values, message.

`nav.set_query_filter_area` (riesgo 2, modifica, smoke)

Adds or edits one area override of a Blueprint query filter (travel cost, entering cost, exclusion).

Argumento	Tipo	Descripción
`filter`	string	obligatorio. NavigationQueryFilter Blueprint asset path or unique name.
`areaClass`	string	obligatorio. NavArea class path or name.
`travelCost`	string	Travel cost override (> 0); "none" clears the override.
`enteringCost`	string	Entering cost override (>= 0); "none" clears the override.
`excluded`	string	Exclude the area from paths (true/false).

Devuelve: filter, areas, includeFlags, excludeFlags, count, message.

`nav.set_query_settings` (riesgo 2, modifica, requiere mundo, smoke)

Sets path query tuning of a RecastNavMesh (applies to the next queries, no rebuild needed).

Argumento	Tipo	Descripción
`navData`	string	RecastNavMesh label/name; empty selects the only one.
`maxSearchNodes`	string	Default maximum A* search nodes (>= 1).
`maxHierarchicalSearchNodes`	string	Default maximum hierarchical search nodes (>= 1).
`heuristicScale`	string	A* heuristic scale (>= 0; 0.999 keeps paths optimal).
`verticalDeviationFromGroundCompensation`	string	Vertical offset added to projected path points in centimetres.
`useBetterOffsetsFromCorners`	string	Offset string-pulled corners away from walls (true/false).
`allowNavLinkAsPathEnd`	string	Allow a nav link as the path end (true/false).
`useVirtualFilters`	string	Use virtual query filters (true/false).

`nav.set_resolution` (riesgo 2, modifica, requiere mundo, smoke)

Sets cell size, cell height and step height of one resolution (Low/High need UE 5.2; per-resolution step height needs UE 5.3). Rebuild afterwards.

Argumento	Tipo	Descripción
`navData`	string	RecastNavMesh actor label/name; empty selects the only one.
`resolution`	string	Low, Default or High (UE 5.2+); before 5.2 only Default exists. Valor predeterminado `TEXT("Default")`.
`cellSize`	string	Cell size in centimetres.
`cellHeight`	string	Cell height in centimetres.
`agentMaxStepHeight`	string	Maximum step height in centimetres (per resolution from UE 5.3).

Devuelve: navData, perResolution, rows, message.

`nav.set_runtime_generation` (riesgo 2, modifica, requiere mundo, smoke)

Sets the runtime generation mode (Static, Dynamic, DynamicModifiersOnly) of one navigation data actor; rebuild afterwards.

Argumento	Tipo	Descripción
`navData`	string	Navigation data actor label/name; empty selects the only one.
`mode`	string	obligatorio. Static, Dynamic or DynamicModifiersOnly.

Devuelve: navData, count, message.

`nav.set_rvo_avoidance` (riesgo 2, modifica, requiere mundo, smoke)

Sets RVO avoidance of a placed Character (use nav.set_agent_blueprint for Blueprint defaults).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Character actor label/name.
`enabled`	boolean	obligatorio. Enable RVO avoidance.
`radius`	string	Optional non-negative consideration radius.
`weight`	string	Optional avoidance weight from zero through one.

Devuelve: items, count, values, message.

`nav.set_settings` (riesgo 4)

Changes reflected project navigation settings and writes DefaultEngine.ini.

Argumento	Tipo	Descripción
`properties`	array of UeaKeyValue	obligatorio. Property/value pairs on the navigation settings object.

Devuelve: items, count, values, message.

`nav.set_smart_link` (riesgo 2, modifica, requiere mundo, smoke)

Enables/disables the smart link of a proxy (and its navigation relevance).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy actor label/name.
`index`	integer	Simple-link index. Valor predeterminado `0`.
`start`	{x,y,z}	Link start in world centimetres.
`end`	{x,y,z}	Link end in world centimetres.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.
`enabled`	boolean	Smart link enabled state. Valor predeterminado `true`.

Devuelve: items, count, values, message.

`nav.set_smart_link_areas` (riesgo 2, modifica, requiere mundo, smoke)

Sets the NavArea used while the smart link is enabled and while it is disabled.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy label/name.
`enabledArea`	string	NavArea used while the smart link is enabled.
`disabledArea`	string	NavArea used while the smart link is disabled.

Devuelve: links, count, message.

`nav.set_smart_link_broadcast` (riesgo 2, modifica, requiere mundo, smoke)

Configures the smart-link state broadcast that notifies nearby agents (radius, interval, on enable/disable).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy label/name.
`radius`	string	Broadcast radius in centimetres (> 0 enables the broadcast).
`interval`	string	Broadcast interval in seconds (0 = only on state change).
`notifyWhenEnabled`	string	Notify nearby agents when the link becomes enabled (true/false).
`notifyWhenDisabled`	string	Notify nearby agents when the link becomes disabled (true/false).

Devuelve: links, count, message.

`nav.set_smart_link_obstacle` (riesgo 2, modifica, requiere mundo, smoke)

Adds a box obstacle (NavArea over a box) that the smart link applies while it is disabled.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy label/name.
`areaClass`	string	obligatorio. NavArea applied by the obstacle.
`extent`	{x,y,z}	Positive box half extent in centimetres. Valor predeterminado `FUeaVec3(50.0, 50.0, 50.0)`.
`offset`	{x,y,z}	Box offset relative to the link in centimetres.

Devuelve: links, count, message.

`nav.set_smart_link_points` (riesgo 2, modifica, requiere mundo, smoke)

Sets the smart-link endpoints (world points) and direction.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy label/name.
`start`	{x,y,z}	obligatorio. Start in world centimetres.
`end`	{x,y,z}	obligatorio. End in world centimetres.
`direction`	string	BothWays, LeftToRight or RightToLeft. Valor predeterminado `TEXT("BothWays")`.

Devuelve: links, count, message.

`nav.set_tile_cache` (riesgo 2, modifica, requiere mundo, smoke)

Sets tile pool and generation job settings (fixed pool, pool size, hard limit, simultaneous jobs, empty layers, voxel cache, update interval).

Argumento	Tipo	Descripción
`navData`	string	RecastNavMesh actor label/name; empty selects the only one.
`fixedTilePoolSize`	string	Use a fixed-size tile pool (true/false).
`tilePoolSize`	string	Tile pool size when the pool is fixed.
`tileNumberHardLimit`	string	Absolute tile limit (power of two).
`maxSimultaneousJobs`	string	Maximum simultaneous tile generation jobs (at least 1).
`storeEmptyTileLayers`	string	Keep empty tile layers in the tile cache (true/false).
`useVoxelCache`	string	Cache voxel data between rebuilds (true/false).
`tileSetUpdateInterval`	string	Seconds between tile set updates for invoker-driven generation.

`nav.snap_links_to_navmesh` (riesgo 2, modifica, requiere mundo, smoke)

Projects simple-link endpoints onto the navmesh (index -1 = every link).

Argumento	Tipo	Descripción
`actor`	string	obligatorio. NavLinkProxy actor label/name.
`index`	integer	Simple-link index. Valor predeterminado `0`.
`start`	{x,y,z}	Link start in world centimetres.
`end`	{x,y,z}	Link end in world centimetres.
`bidirectional`	boolean	Both-way traversal. Valor predeterminado `true`.
`areaClass`	string	Optional NavArea class.
`enabled`	boolean	Smart link enabled state. Valor predeterminado `true`.

Devuelve: items, count, values, message.

`nav.spawn_test_agent` (riesgo 1, requiere PIE, smoke)

Spawns a pawn (default Character) possessed by an AIController (DetourCrowdAIController with crowd) in the PIE world. With ensureNavData the PIE navigation system also gets its default navigation data actor.

Argumento	Tipo	Descripción
`name`	string	Label for the spawned pawn. Valor predeterminado `TEXT("NavTestAgent")`.
`controllerName`	string	Label for its AIController; empty uses name + "Controller".
`location`	{x,y,z}	Spawn location in centimetres (PIE world).
`pawnClass`	string	Pawn class path or name; empty spawns a plain Character.
`controllerClass`	string	AIController class path or name; empty uses the pawn's own AIControllerClass (AIController for Character), or DetourCrowdAIController with crowd.
`crowd`	boolean	Use a DetourCrowdAIController so the agent takes part in crowd avoidance (ignored when controllerClass is set). Valor predeterminado `false`.
`ensureNavData`	boolean	When the PIE world has no navigation data, create the default one so runtime queries have a target. Valor predeterminado `true`.

Devuelve: items, count, values, message.

`nav.test_path` (riesgo 0, requiere mundo, smoke)

Tests whether a complete path exists (same selectors as nav.find_path).

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.test_path_to_actor` (riesgo 0, requiere mundo, smoke)

Tests whether a path can be found to an actor's current location.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`goalActor`	string	obligatorio. Goal actor label or name.
`tetherDistance`	number	Moving-goal tether distance in centimetres. Valor predeterminado `50.0`.

Devuelve: valid, partial, points, length, cost, navData, result, message.

`nav.validate` (riesgo 0, requiere mundo, smoke)

Validates bounds, navigation data and simple links.

Sin argumentos.

Devuelve: issues, count.

`nav.validate_link_proxy` (riesgo 0, requiere mundo, smoke)

Validates one link proxy in depth: coincident or off-mesh endpoints, drops longer than maxFallDownLength, smart-link consistency.

Argumento	Tipo	Descripción
`actor`	string	obligatorio. Actor label or object name (must match exactly one actor).

Devuelve: issues, count.

`nav.validate_path_endpoints` (riesgo 0, requiere mundo, smoke)

Projects both endpoints before testing a path, exposing invalid endpoints separately.

Argumento	Tipo	Descripción
`start`	{x,y,z}	obligatorio. Path start in centimetres.
`end`	{x,y,z}	obligatorio. Path end in centimetres.
`navData`	string	Navigation data actor label/name; empty uses the agent's data or the world's default navigation data.
`agent`	string	Supported agent name (project navigation settings) whose navigation data is queried; empty uses navData or the default.
`filterClass`	string	NavigationQueryFilter class path or name (e.g. a Blueprint filter); empty uses the navigation data's default filter.
`allowPartial`	boolean	Accept partial paths that end at the closest reachable point. Valor predeterminado `true`.

Devuelve: items, count, values, message.

`nav.wait_build` (riesgo 0, requiere mundo, smoke)

Waits off the game thread until the outstanding navigation build completes or times out.

Argumento	Tipo	Descripción
`maxFrames`	integer	Maximum editor frames to wait, from 1 through 100000. Valor predeterminado `600`.

Devuelve: available, building, remainingTasks, boundsVolumes, navDataCount, autoUpdate, dirty, message.

Guía
Set up navigation for a level (5 calls)
Selecting navigation data, agent and filter
Generation settings
Build control
Areas, filters and modifiers
Links
Queries
Agents, crowd and avoidance
PIE movement test
Gotchas
Herramientas

Guía​

Set up navigation for a level (5 calls)​

Selecting navigation data, agent and filter​

Generation settings​

Build control​

Areas, filters and modifiers​

Links​

Queries​

Agents, crowd and avoidance​

PIE movement test​

Gotchas​

Herramientas​

nav.add_agent (riesgo 4)​

nav.add_bounds_volume (riesgo 2, modifica, requiere mundo, smoke)​

nav.add_build_lock (riesgo 4, modifica, requiere mundo, smoke)​

nav.add_invoker (riesgo 2, modifica, requiere mundo, smoke)​

nav.add_link_component (riesgo 2, modifica, requiere mundo, smoke)​

nav.add_link_component_link (riesgo 2, modifica, requiere mundo, smoke)​

nav.add_link_proxy (riesgo 2, modifica, requiere mundo, smoke)​

nav.add_modifier_component (riesgo 2, modifica, requiere mundo, smoke)​

nav.add_modifier_volume (riesgo 2, modifica, requiere mundo, smoke)​

nav.add_simple_link (riesgo 2, modifica, requiere mundo, smoke)​

nav.audit (riesgo 0, requiere mundo, smoke)​

nav.audit_bounds_coverage (riesgo 0, requiere mundo, smoke)​

nav.audit_links (riesgo 0, requiere mundo, smoke)​

nav.audit_modifiers (riesgo 0, requiere mundo, smoke)​

nav.batch_project_points (riesgo 0, requiere mundo, smoke)​

nav.batch_set_actor_nav (riesgo 2, modifica, requiere mundo, smoke)​

nav.batch_set_smart_links (riesgo 2, modifica, requiere mundo, smoke)​

nav.batch_test_paths (riesgo 0, requiere mundo, smoke)​

nav.build (riesgo 4, requiere mundo, smoke)​

nav.cancel_build (riesgo 4, requiere mundo, smoke)​

nav.clear_build_history (riesgo 1, smoke)​

nav.clear_smart_link_obstacle (riesgo 2, modifica, requiere mundo, smoke)​

nav.copy_simple_to_smart_link (riesgo 2, modifica, requiere mundo, smoke)​

nav.create_agent_blueprint (riesgo 2, modifica, smoke)​

nav.create_area_blueprint (riesgo 2, modifica, smoke)​

nav.create_query_filter_blueprint (riesgo 2, modifica, smoke)​

nav.create_test_character (riesgo 2, modifica, requiere mundo, smoke)​

nav.create_test_floor (riesgo 2, modifica, requiere mundo, smoke)​

nav.diagnose_build (riesgo 0, requiere mundo, smoke)​

nav.duplicate_area (riesgo 2, modifica, smoke)​

nav.find_actors_by_area (riesgo 0, requiere mundo, smoke)​

nav.find_distance_to_wall (riesgo 0, requiere mundo, smoke)​

nav.find_nav_blockers (riesgo 0, requiere mundo, smoke)​

nav.find_path (riesgo 0, requiere mundo, smoke)​

nav.find_path_to_actor (riesgo 0, requiere mundo, smoke)​

nav.fit_bounds_to_actors (riesgo 2, modifica, requiere mundo, smoke)​

nav.fit_bounds_to_level (riesgo 2, modifica, requiere mundo, smoke)​

nav.get_actor_nav (riesgo 0, requiere mundo, smoke)​

nav.get_agent_blueprint (riesgo 0, smoke)​

nav.get_area (riesgo 0, smoke)​

nav.get_area_id_map (riesgo 0, requiere mundo, smoke)​

nav.get_bounds_coverage (riesgo 0, requiere mundo, smoke)​

nav.get_build_history (riesgo 0, smoke)​

nav.get_build_status (riesgo 0, requiere mundo, smoke)​

nav.get_crowd_settings (riesgo 0, smoke)​

nav.get_draw_flags (riesgo 0, requiere mundo, smoke)​

nav.get_link_component (riesgo 0, requiere mundo, smoke)​

nav.get_link_proxy (riesgo 0, requiere mundo, smoke)​

nav.get_modifier_component (riesgo 0, requiere mundo, smoke)​

nav.get_modifier_volume (riesgo 0, requiere mundo, smoke)​

nav.get_nav_data (riesgo 0, requiere mundo, smoke)​

nav.get_navmesh (riesgo 0, requiere mundo, smoke)​

nav.get_navmesh_bounds (riesgo 0, requiere mundo, smoke)​

nav.get_navmesh_properties (riesgo 0, requiere mundo, smoke)​

nav.get_path_corridor (riesgo 0, requiere mundo, smoke)​

nav.get_path_cost (riesgo 0, requiere mundo, smoke)​

nav.get_path_length (riesgo 0, requiere mundo, smoke)​

nav.get_path_metrics (riesgo 0, requiere mundo, smoke)​

nav.get_poly_at (riesgo 0, requiere mundo, smoke)​

nav.get_poly_info (riesgo 0, requiere mundo, smoke)​

nav.get_polys_in_box (riesgo 0, requiere mundo, smoke)​

nav.get_query_filter (riesgo 0, smoke)​

nav.get_query_settings (riesgo 0, requiere mundo, smoke)​

nav.get_resolution (riesgo 0, requiere mundo, smoke)​

nav.get_rvo_avoidance (riesgo 0, requiere mundo, smoke)​

nav.get_settings (riesgo 0, smoke)​

nav.get_simple_link (riesgo 0, requiere mundo, smoke)​

nav.get_smart_link (riesgo 0, requiere mundo, smoke)​

Guía

Set up navigation for a level (5 calls)

Selecting navigation data, agent and filter

Generation settings

Build control

Areas, filters and modifiers

Links

Queries

Agents, crowd and avoidance

PIE movement test

Gotchas

Herramientas

`nav.add_agent` (riesgo 4)

`nav.add_bounds_volume` (riesgo 2, modifica, requiere mundo, smoke)

`nav.add_build_lock` (riesgo 4, modifica, requiere mundo, smoke)

`nav.add_invoker` (riesgo 2, modifica, requiere mundo, smoke)

`nav.add_link_component` (riesgo 2, modifica, requiere mundo, smoke)

`nav.add_link_component_link` (riesgo 2, modifica, requiere mundo, smoke)

`nav.add_link_proxy` (riesgo 2, modifica, requiere mundo, smoke)

`nav.add_modifier_component` (riesgo 2, modifica, requiere mundo, smoke)

`nav.add_modifier_volume` (riesgo 2, modifica, requiere mundo, smoke)

`nav.add_simple_link` (riesgo 2, modifica, requiere mundo, smoke)

`nav.audit` (riesgo 0, requiere mundo, smoke)

`nav.audit_bounds_coverage` (riesgo 0, requiere mundo, smoke)

`nav.audit_links` (riesgo 0, requiere mundo, smoke)

`nav.audit_modifiers` (riesgo 0, requiere mundo, smoke)

`nav.batch_project_points` (riesgo 0, requiere mundo, smoke)

`nav.batch_set_actor_nav` (riesgo 2, modifica, requiere mundo, smoke)

`nav.batch_set_smart_links` (riesgo 2, modifica, requiere mundo, smoke)

`nav.batch_test_paths` (riesgo 0, requiere mundo, smoke)

`nav.build` (riesgo 4, requiere mundo, smoke)

`nav.cancel_build` (riesgo 4, requiere mundo, smoke)

`nav.clear_build_history` (riesgo 1, smoke)

`nav.clear_smart_link_obstacle` (riesgo 2, modifica, requiere mundo, smoke)

`nav.copy_simple_to_smart_link` (riesgo 2, modifica, requiere mundo, smoke)

`nav.create_agent_blueprint` (riesgo 2, modifica, smoke)

`nav.create_area_blueprint` (riesgo 2, modifica, smoke)

`nav.create_query_filter_blueprint` (riesgo 2, modifica, smoke)

`nav.create_test_character` (riesgo 2, modifica, requiere mundo, smoke)

`nav.create_test_floor` (riesgo 2, modifica, requiere mundo, smoke)

`nav.diagnose_build` (riesgo 0, requiere mundo, smoke)

`nav.duplicate_area` (riesgo 2, modifica, smoke)

`nav.find_actors_by_area` (riesgo 0, requiere mundo, smoke)

`nav.find_distance_to_wall` (riesgo 0, requiere mundo, smoke)

`nav.find_nav_blockers` (riesgo 0, requiere mundo, smoke)

`nav.find_path` (riesgo 0, requiere mundo, smoke)

`nav.find_path_to_actor` (riesgo 0, requiere mundo, smoke)

`nav.fit_bounds_to_actors` (riesgo 2, modifica, requiere mundo, smoke)

`nav.fit_bounds_to_level` (riesgo 2, modifica, requiere mundo, smoke)

`nav.get_actor_nav` (riesgo 0, requiere mundo, smoke)

`nav.get_agent_blueprint` (riesgo 0, smoke)

`nav.get_area` (riesgo 0, smoke)

`nav.get_area_id_map` (riesgo 0, requiere mundo, smoke)

`nav.get_bounds_coverage` (riesgo 0, requiere mundo, smoke)

`nav.get_build_history` (riesgo 0, smoke)

`nav.get_build_status` (riesgo 0, requiere mundo, smoke)

`nav.get_crowd_settings` (riesgo 0, smoke)

`nav.get_draw_flags` (riesgo 0, requiere mundo, smoke)

`nav.get_link_component` (riesgo 0, requiere mundo, smoke)

`nav.get_link_proxy` (riesgo 0, requiere mundo, smoke)

`nav.get_modifier_component` (riesgo 0, requiere mundo, smoke)

`nav.get_modifier_volume` (riesgo 0, requiere mundo, smoke)

`nav.get_nav_data` (riesgo 0, requiere mundo, smoke)

`nav.get_navmesh` (riesgo 0, requiere mundo, smoke)

`nav.get_navmesh_bounds` (riesgo 0, requiere mundo, smoke)

`nav.get_navmesh_properties` (riesgo 0, requiere mundo, smoke)

`nav.get_path_corridor` (riesgo 0, requiere mundo, smoke)

`nav.get_path_cost` (riesgo 0, requiere mundo, smoke)

`nav.get_path_length` (riesgo 0, requiere mundo, smoke)

`nav.get_path_metrics` (riesgo 0, requiere mundo, smoke)

`nav.get_poly_at` (riesgo 0, requiere mundo, smoke)

`nav.get_poly_info` (riesgo 0, requiere mundo, smoke)

`nav.get_polys_in_box` (riesgo 0, requiere mundo, smoke)

`nav.get_query_filter` (riesgo 0, smoke)

`nav.get_query_settings` (riesgo 0, requiere mundo, smoke)

`nav.get_resolution` (riesgo 0, requiere mundo, smoke)

`nav.get_rvo_avoidance` (riesgo 0, requiere mundo, smoke)

`nav.get_settings` (riesgo 0, smoke)

`nav.get_simple_link` (riesgo 0, requiere mundo, smoke)

`nav.get_smart_link` (riesgo 0, requiere mundo, smoke)