Class BeamNgVehicleCatalog

Namespace

LibreRally.Vehicle.Content

Assembly

LibreRally.dll

Discovers bundled BeamNG vehicle content and resolves files from folders or archives.

public sealed class BeamNgVehicleCatalog

Inheritance

object

BeamNgVehicleCatalog

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Constructors

BeamNgVehicleCatalog(string, string?, string?)

Initializes a new vehicle catalog rooted at the given bundled and BeamNG content directories.

public BeamNgVehicleCatalog(string bundledVehiclesRoot, string? beamNgContentVehiclesRoot = null, string? cacheRoot = null)

Parameters

bundledVehiclesRoot string

Root directory that contains bundled vehicle folders or archives.

beamNgContentVehiclesRoot string

Optional BeamNG installation content directory.

cacheRoot string

Optional cache directory used for extracted archive content.

Methods

DetectBeamNgContentVehiclesRoot()

Attempts to locate BeamNG's installed content/vehicles directory on Windows.

public static string? DetectBeamNgContentVehiclesRoot()

Returns

string

The detected vehicles directory when present; otherwise null.

DiscoverBundledVehicleVariants()

Discovers every selectable bundled vehicle variant, including per-configuration metadata and thumbnails.

public IReadOnlyList<BeamNgVehicleVariantDescriptor> DiscoverBundledVehicleVariants()

Returns

IReadOnlyList<BeamNgVehicleVariantDescriptor>

Cached descriptors for every discovered variant across bundled folders and archives.

DiscoverBundledVehicles()

Discovers all bundled vehicles that can be loaded by LibreRally.

public IReadOnlyList<BeamNgVehicleDescriptor> DiscoverBundledVehicles()

Returns

IReadOnlyList<BeamNgVehicleDescriptor>

Cached descriptors for every discovered folder or archive vehicle.

ResolveVehicle(string)

Resolves a requested vehicle identifier or path into a loadable BeamNG vehicle source.

public BeamNgResolvedVehicle ResolveVehicle(string requestedPathOrId)

Parameters

requestedPathOrId string

Vehicle id, folder path, or zip path supplied by the caller.

Returns

BeamNgResolvedVehicle

A resolved vehicle source that can be consumed by the loader.

Exceptions

ArgumentException

Thrown when requestedPathOrId is empty or whitespace.

FileNotFoundException

Thrown when the requested vehicle cannot be resolved from the configured sources.