No-Move Goal

A scenario goal that fails if a vehicle moves from its starting position. Used for parking/brake scenarios where a vehicle must remain stationary.

Internal State

Public API

Goal JSON Schema

{
  "goal": {
    "nomove": {
      "msg": "scenarios.parking.youMoved",
      "triggerEndOnly": false
    }
  }
}

How It Works

1. init finds all goals with id == "nomove" and records each vehicle's position
2. On onCountdownEnded, refreshes start positions (for scenarios with countdowns)
3. Each onRaceTick and onRaceResult:
   • Calculates distance from start position
   • If distance > 0.1 units:
     • Normal mode: Sets result = "failed" and finishes scenario
     • triggerEndOnly mode: Calls scenario_scenarios.endScenario(0.25) without setting status
   • If within threshold: Sets result = "passed"

Usage Examples

-- Parking brake test: AI vehicle must not move
{
  "vehicles": {
    "parked_car": {
      "goal": {
        "nomove": {
          "msg": "scenarios.parking.carRolled"
        }
      }
    }
  }
}

-- End scenario silently if vehicle moves
{
  "nomove": {
    "triggerEndOnly": true
  }
}

Key Notes

• Movement threshold is 0.1 world units (very sensitive)
• In triggerEndOnly mode, goal status is not set - used for side-effect scenarios
• Reports to both the vehicle's own stats and the player vehicle stats
• Logs a warning if the vehicle object is missing, with a one-time flag to prevent spam
• Start position is updated on countdown end (not just init) for countdown scenarios

See Also

• Scenario Bus Driver - Bus Route Scenario Logic - Related reference
• Scenario Damage Goal - Damage-Based Win/Fail Condition - Related reference
• Scenario Demolition Derby - Last Vehicle Moving Wins - Related reference
• Scenario System Guide - Guide