FixedJump¶
Purpose¶
Performs one ballistic jump toward a configured point or object. It can solve a direct landing or request one planned jump step from navigation.
Key inputs / outputs¶
- Inputs:
target(VariableFieldcontaining aVector2,Vector3, or Unity object),jumpHeight,jumpLength, and optionaloffset. - Options:
targetMode(DirectorPlannedStep),targetMeasurementfor planned object targets,goal,distanceMetric,reachDistance, andskipReached. - Independent options:
allowAirborneLaunchandallowAirborneEndpoint, both false by default, including for existing assets without these fields. Enabling them permits an airborne impulse and an airborne endpoint respectively; endpoint completion still requires observing the descending body reach that endpoint. - Outputs: none.
Success / Failure semantics¶
- Success when the jump executor completes, or immediately when
skipReachedis enabled and the target already satisfies the configured goal. - Failure when the target or jump parameters are invalid, navigation cannot provide a usable jump, or execution fails.
Important limitations¶
- Requires the navigation runtime, a published world, a
Rigidbody2D, and enabled navigation colliders even when both airborne options are enabled. Direct object targets need target colliders; PlannedStep falls back to the transform position when no target colliders exist, matching Jump Trace. PlannedStepuses the same single-step planner asJumpwithpath = Simple. Equivalent body, target geometry, goal, support policies, and physical inputs select the same step; FixedJump finishes after that step, while Jump continues toward its goal. The default collider measurement and zero offset match Jump Trace; explicit transform measurement or offset intentionally changes the goal geometry.Directvalidates a trajectory to the supplied lower-center endpoint without searching candidate landings. Both modes retain world/region checks, collision validation, jump limits, and one-way platform handling.- With
allowAirborneEndpointenabled, planning also tries the target's lower center as an airborne goal endpoint. Existing supported candidates remain available; this does not add a free-flight search lattice or guarantee a route to every airborne goal.