Spawn Vehicle

Overview

• Node Name: Spawn Vehicle
• Category: (default)
• File: extensions/flowgraph/nodes/vehicle/spawnVehicle.lua

Spawns a vehicle in the world with full configuration support including model, config, position, rotation, color, license plate, and various behavioral options. Uses a multi-frame state machine to handle async spawning.

Pin Schema

Input Pins

Output Pins

Legacy Pin Mapping

• out.objectId → vehId
• in.replaceCurrent → replacePlayer
• in.keepCurrent → keepCamera
• in.dontDelete → keepVehicle

Internals

State Machine

Key Methods

Spawning Logic (State 1)

1. Generates a name if none provided.
2. Loads model and parses config key (strips .pc extension).
3. Resolves paint color:
   • If randomColor is true: picks from model's available paints (skips Police/Service vehicles).
   • If color is a string: looks up named paint from model data.
   • If color is a table with baseColor or [4]: uses as raw paint data.
4. Creates options table with config, paint, license text, name, position, rotation.
5. Calls sanitizeVehicleSpawnOptions() to validate.
6. Either core_vehicles.replaceVehicle() or core_vehicles.spawnNewVehicle().
7. Registers with mgr.modules.vehicle:addVehicle().

Usage Example

-- In a flowgraph - spawn a pickup at a specific location:
-- [Vec3 Position] → [Spawn Vehicle].pos
-- [String: "pickup"] → [Spawn Vehicle].model
-- [String: "vehicles/pickup/d15_4wd_A.pc"] → [Spawn Vehicle].config
-- [Trigger] → [Spawn Vehicle].flow
-- [Spawn Vehicle] → (loaded) → [Configure Vehicle]
--                 → (vehId)  → [Set AI Mode]

-- Direct Lua equivalent:
local options = {
  config = 'vehicles/pickup/d15_4wd_A.pc',
  licenseText = 'FLOW',
  vehicleName = 'myVehicle',
  pos = vec3(0, 0, 100),
}
options = sanitizeVehicleSpawnOptions('pickup', options)
local veh = core_vehicles.spawnNewVehicle('pickup', options)

Key Dependencies

• core_vehicles.spawnNewVehicle(model, options) - spawns a new vehicle
• core_vehicles.replaceVehicle(model, options) - replaces the player vehicle
• sanitizeVehicleSpawnOptions(model, options) - validates spawn options
• core_vehicles.getModel() / core_vehicles.getConfig() - vehicle metadata
• mgr.modules.vehicle:addVehicle() - registers vehicle with flowgraph manager
• createVehiclePaint() - creates paint data from color values

Previously Undocumented (Added by Audit)

• C:getCmd(action) - Function handling getCmd logic

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