Variant

Data variant and override subsystem for the Scriptable Factory system. Provides a mechanism for creating variations of FactorableData by selectively overriding fields marked with the [Overridable] attribute, without modifying the original source data.

Architecture

Data Flow

Key Concepts

Concept	Description
Source data	The base FactorableData record that all variants derive from
DataOverride	A collection of field overrides that, when applied, produce one variant
DataFieldOverride	A single field name + value pair that modifies one field via reflection
[Overridable]	Attribute marking which FactorableData fields can be overridden
Baking	Pre-computing variant data by applying all overrides to copies of source data
Custom overrider	Optional Type parameter on [Overridable] for specialized override logic

Quick Start

Marking fields as overridable

[Serializable]
public record EnemyData : FactorableData
{
    [Overridable]
    public float health = 100f;

    [Overridable]
    public float speed = 3f;

    // Not overridable — no attribute
    public string internalId = "enemy_base";
}

Using a custom overrider type

[Serializable]
public record BuildingData : FactorableData
{
    [Overridable(typeof(MaterialListOverride))]
    public List<Material> materials;
}

Classes

Class	Description
OverridableAttribute	Field attribute marking data fields as override-eligible
DataFieldOverride	Single field override — name + value, applied via reflection
DataOverride	Collection of field overrides that produces one data variant
DataVariantSystem<TData>	Manages source data + list of overrides, bakes variant instances

See Also

• Scriptable Factory — system overview

• FactorableData — base record class for data

• FactorableDataUtility — copy utilities used during override application

• FactorableSpawner — spawner that uses DataOverride for per-spawn customization