Multi Spawn

Spawns groups of vehicles in configurable formations (road, grid, line). Handles vehicle selection from installed data with population-weighted randomization, paint assignment, and formation placement.

Public Functions

Module Settings

Spawn Modes

Usage Example

-- Create a random group of 10 cars/trucks
local group = core_multiSpawn.createGroup(10, {
  filters = {Type = {car = 1, truck = 0.5}},
  country = "germany"
})

-- Spawn with road formation, 20m spacing
local groupId = core_multiSpawn.spawnGroup(group, 10, {
  name = "myGroup",
  mode = "roadAhead",
  gap = 20,
  shuffle = true,
  randomPaints = true
})

-- Teleport existing vehicles into race grid
local vehIds = {101, 102, 103, 104}
core_multiSpawn.placeGroup(vehIds, {mode = "raceGrid", gap = 12})

-- Delete all spawned vehicles
core_multiSpawn.deleteVehicles()

Filter Parameters

Notes

• Population-weighted selection uses power-law distribution (popPower parameter).
• Selected vehicles have their population reduced to avoid repetition.
• Spawning uses the job system for non-blocking operation (unless options.instant).
• Fires onVehicleGroupSpawned(vehIds, groupId, name) on completion.
• Queues additional groups if spawning is busy.

See Also

• jobsystem - Background spawning via coroutines
• globals - spawn.spawnVehicle, core_vehicles