Remove Vehicle

Overview

• Node Name: Remove Vehicle
• Category: repeat_instant
• File: extensions/flowgraph/nodes/vehicle/removeVehicle.lua

Removes a vehicle from the scene by deleting its scene object. Notifies the editor if present.

Pin Schema

Input Pins

Internals

Key Methods

How It Works

1. Looks up the vehicle by vehId using scenetree.findObjectById().
2. If vehId is nil or 0, sets outflow to true but does nothing else (player vehicle fallback is commented out).
3. If the editor is active, calls editor.onRemoveSceneTreeObjects({id}) to notify it.
4. Calls source:delete() to permanently remove the vehicle from the scene.

Usage Example

-- In a flowgraph - remove a specific vehicle:
-- [Vehicle ID Source] → (vehId) → [Remove Vehicle]

-- Direct Lua equivalent:
local veh = scenetree.findObjectById(vehId)
if veh then
  if editor and editor.onRemoveSceneTreeObjects then
    editor.onRemoveSceneTreeObjects({veh:getId()})
  end
  veh:delete()
end

Key Dependencies

• scenetree.findObjectById() - resolves vehicle ID to scene object
• editor.onRemoveSceneTreeObjects() - editor notification for scene tree cleanup
• obj:delete() - permanently removes the object from the scene

See Also

• Align for Coupling (Flowgraph Node) - Related reference
• Apply Velocity to Vehicle (Flowgraph Node) - Related reference
• Boost Vehicle (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide