Class BaseAiCastSpellConfigurator<T, TBuilder>

Implements common fields and components for blueprints inheriting from Kingmaker.AI.Blueprints.BlueprintAiCastSpell.

Inheritance
System.Object
Configurator
RootConfigurator<T, TBuilder>
BaseBlueprintConfigurator<T, TBuilder>
BaseAiActionConfigurator<T, TBuilder>
BaseAiCastSpellConfigurator<T, TBuilder>
AiCastSpellConfigurator
Inherited Members
BaseBlueprintConfigurator<T, TBuilder>.AdditionalDiceOnAttack(Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<AdditionalDiceOnAttack.WeaponOptions>, Nullable<WeaponCategory>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, List<AdditionalDiceOnAttack.DamageEntry>, DamageTypeDescription, Nullable<Feet>, Nullable<Boolean>, Nullable<WeaponFighterGroup>, ConditionsBuilder, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<WeaponRangeType>, Nullable<Boolean>, ConditionsBuilder, Nullable<Boolean>, ContextDiceValue, Blueprint<BlueprintWeaponTypeReference>)
BaseBlueprintConfigurator<T, TBuilder>.AddRuleCalculateDamageWithWeaponTrigger(ActionsBuilder, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<WeaponCategory>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<PhysicalDamageForm>, Nullable<Boolean>, Nullable<Feet>, Nullable<Boolean>, Nullable<WeaponFighterGroup>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<Boolean>, Nullable<WeaponRangeType>, Nullable<Boolean>, Nullable<Boolean>, Blueprint<BlueprintItemWeaponReference>, Blueprint<BlueprintWeaponTypeReference>)
Namespace: BlueprintCore.Blueprints.Configurators.AI
Assembly: BlueprintCore.dll
Syntax
public abstract class BaseAiCastSpellConfigurator<T, TBuilder> : BaseAiActionConfigurator<T, TBuilder> where T : BlueprintAiCastSpell where TBuilder : BaseAiCastSpellConfigurator<T, TBuilder>
Type Parameters
Name Description
T
TBuilder
Remarks

Each supported blueprint type has a corresponding Configurator class to create and modify blueprints of that type, e.g. FeatureConfigurator supports BlueprintFeature. Configurators exist for all blueprint types inheriting from Kingmaker.Blueprints.BlueprintScriptableObject, excluding any that are not used in the base game.

Creating a Blueprint

Use New(string, string) to create a blueprint:

FeatureConfigurator.New(MyBlueprintName, MyBlueprintGuid)

Once New() is called the blueprint is added to the game library and can be referenced.

Using the Configurator

New() returns a configurator with methods to set or modify blueprint fields and add or modify Kingmaker.Blueprints.BlueprintComponent:

FeatureConfigurator.New(MyBlueprintName, MyBlueprintGuid).AddToGroups(FeatureGroup.Feat).AddPrerequisiteAlignment(AlignmentMaskType.LawfulGood).Configure();

Each method call returns the configurator allowing you to chain calls. Nothing is modified on the blueprint until Configure() is called, at which point the changes are applied and validated. Potential problems with the blueprint are logged as warnings.

Modifying an Existing Blueprint

Use For(Blueprint) to modify existing blueprints:

CharacterClassConfigurator.For(WizardClassGuid)

Usage is otherwise identical to creating a new blueprint.

For more information see Using BlueprintCore.

Constructors

| Improve this Doc View Source

BaseAiCastSpellConfigurator(Blueprint<BlueprintReference<T>>)

Declaration
protected BaseAiCastSpellConfigurator(Blueprint<BlueprintReference<T>> blueprint)
Parameters
Type Name Description
Blueprint<Kingmaker.Blueprints.BlueprintReference<T>> blueprint

Methods

| Improve this Doc View Source

AddToLocators(EntityReference[])

Adds to the contents of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.Locators

Declaration
public TBuilder AddToLocators(params EntityReference[] locators)
Parameters
Type Name Description
Kingmaker.Blueprints.EntityReference[] locators

InfoBox: To use locators make sure you selected CheckCasterDistance or CheckPartyDistance.

Returns
Type Description
TBuilder
| Improve this Doc View Source

AddToVariantsSet(Blueprint<BlueprintAbilityReference>[])

Adds to the contents of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_VariantsSet

Declaration
public TBuilder AddToVariantsSet(params Blueprint<BlueprintAbilityReference>[] variantsSet)
Parameters
Type Name Description
Blueprint<Kingmaker.Blueprints.BlueprintAbilityReference>[] variantsSet

InfoBox: In case of empty list, variant will be picked from all variants for specified ability

Blueprint of type BlueprintAbility. You can pass in the blueprint using:

  • A blueprint instance
  • A blueprint reference
  • A blueprint id as a string, Guid, or BlueprintGuid
  • A blueprint name registered with BlueprintTool
See Blueprint for more details.

Returns
Type Description
TBuilder
| Improve this Doc View Source

ClearLocators()

Removes all elements from Kingmaker.AI.Blueprints.BlueprintAiCastSpell.Locators

Declaration
public TBuilder ClearLocators()
Returns
Type Description
TBuilder
| Improve this Doc View Source

ClearVariantsSet()

Removes all elements from Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_VariantsSet

Declaration
public TBuilder ClearVariantsSet()
Returns
Type Description
TBuilder
| Improve this Doc View Source

CopyFrom(Blueprint<BlueprintReference<BlueprintAiCastSpell>>, Predicate<BlueprintComponent>)

Copies fields and components of the specified types from the blueprint.

Declaration
public TBuilder CopyFrom(Blueprint<BlueprintReference<BlueprintAiCastSpell>> blueprint, Predicate<BlueprintComponent> componentMatcher)
Parameters
Type Name Description
Blueprint<Kingmaker.Blueprints.BlueprintReference<Kingmaker.AI.Blueprints.BlueprintAiCastSpell>> blueprint
System.Predicate<Kingmaker.Blueprints.BlueprintComponent> componentMatcher

Any components in blueprint matching the predicate are copied. These are shallow copies that are shared by both blueprints.
Returns
Type Description
TBuilder
Remarks

NOT A DEEP COPY. This means objects copied are shared between blueprints. Changes to copied objects affect both blueprints.

Recommended when you need to create a nearly identical ability but change some parts such as a ContextRankConfig. 

// Copy the Undead Bloodline's Incorporeal Form ability, replacing the duration w/ Character Level rounds
AbilityConfigurator.New(NewIncorporealForm, Guids.NewIncorporealForm)
  .CopyFrom(
    AbilityRefs.BloodlineUndeadIncorporealFormAbility,
    typeof(AbilityEffectRunAction),
    typeof(AbilityResourceLogic),
    typeof(SpellComponent))
  .AddContextRankConfig(ContextRankConfigs.CharacterLevel())
  .Configure();
| Improve this Doc View Source

CopyFrom(Blueprint<BlueprintReference<BlueprintAiCastSpell>>, Type[])

Copies fields and components of the specified types from the blueprint.

Declaration
public TBuilder CopyFrom(Blueprint<BlueprintReference<BlueprintAiCastSpell>> blueprint, params Type[] componentTypes)
Parameters
Type Name Description
Blueprint<Kingmaker.Blueprints.BlueprintReference<Kingmaker.AI.Blueprints.BlueprintAiCastSpell>> blueprint
System.Type[] componentTypes

Any components in blueprint of the listed types are copied. These are shallow copies that are shared by both blueprints.
Returns
Type Description
TBuilder
Remarks

NOT A DEEP COPY. This means objects copied are shared between blueprints. Changes to copied objects affect both blueprints.

Recommended when you need to create a nearly identical ability but change some parts such as a ContextRankConfig. 

// Copy the Undead Bloodline's Incorporeal Form ability, replacing the duration w/ Character Level rounds
AbilityConfigurator.New(NewIncorporealForm, Guids.NewIncorporealForm)
  .CopyFrom(
    AbilityRefs.BloodlineUndeadIncorporealFormAbility,
    typeof(AbilityEffectRunAction),
    typeof(AbilityResourceLogic),
    typeof(SpellComponent))
  .AddContextRankConfig(ContextRankConfigs.CharacterLevel())
  .Configure();
| Improve this Doc View Source

ModifyAbility(Action<BlueprintAbilityReference>)

Modifies Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_Ability by invoking the provided action.

Declaration
public TBuilder ModifyAbility(Action<BlueprintAbilityReference> action)
Parameters
Type Name Description
System.Action<Kingmaker.Blueprints.BlueprintAbilityReference> action
Returns
Type Description
TBuilder
| Improve this Doc View Source

ModifyLocators(Action<EntityReference>)

Modifies Kingmaker.AI.Blueprints.BlueprintAiCastSpell.Locators by invoking the provided action on each element.

Declaration
public TBuilder ModifyLocators(Action<EntityReference> action)
Parameters
Type Name Description
System.Action<Kingmaker.Blueprints.EntityReference> action
Returns
Type Description
TBuilder
| Improve this Doc View Source

ModifyVariant(Action<BlueprintAbilityReference>)

Modifies Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_Variant by invoking the provided action.

Declaration
public TBuilder ModifyVariant(Action<BlueprintAbilityReference> action)
Parameters
Type Name Description
System.Action<Kingmaker.Blueprints.BlueprintAbilityReference> action
Returns
Type Description
TBuilder
| Improve this Doc View Source

ModifyVariantsSet(Action<BlueprintAbilityReference>)

Modifies Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_VariantsSet by invoking the provided action on each element.

Declaration
public TBuilder ModifyVariantsSet(Action<BlueprintAbilityReference> action)
Parameters
Type Name Description
System.Action<Kingmaker.Blueprints.BlueprintAbilityReference> action
Returns
Type Description
TBuilder
| Improve this Doc View Source

OnConfigureCompleted()

Declaration
protected override void OnConfigureCompleted()
Overrides
BlueprintCore.Blueprints.Configurators.AI.BaseAiActionConfigurator<T, TBuilder>.OnConfigureCompleted()
| Improve this Doc View Source

RemoveFromLocators(EntityReference[])

Removes elements from Kingmaker.AI.Blueprints.BlueprintAiCastSpell.Locators

Declaration
public TBuilder RemoveFromLocators(params EntityReference[] locators)
Parameters
Type Name Description
Kingmaker.Blueprints.EntityReference[] locators

InfoBox: To use locators make sure you selected CheckCasterDistance or CheckPartyDistance.

Returns
Type Description
TBuilder
| Improve this Doc View Source

RemoveFromLocators(Func<EntityReference, Boolean>)

Removes elements from Kingmaker.AI.Blueprints.BlueprintAiCastSpell.Locators that match the provided predicate.

Declaration
public TBuilder RemoveFromLocators(Func<EntityReference, bool> predicate)
Parameters
Type Name Description
System.Func<Kingmaker.Blueprints.EntityReference, System.Boolean> predicate
Returns
Type Description
TBuilder
| Improve this Doc View Source

RemoveFromVariantsSet(Blueprint<BlueprintAbilityReference>[])

Removes elements from Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_VariantsSet

Declaration
public TBuilder RemoveFromVariantsSet(params Blueprint<BlueprintAbilityReference>[] variantsSet)
Parameters
Type Name Description
Blueprint<Kingmaker.Blueprints.BlueprintAbilityReference>[] variantsSet

InfoBox: In case of empty list, variant will be picked from all variants for specified ability

Blueprint of type BlueprintAbility. You can pass in the blueprint using:

  • A blueprint instance
  • A blueprint reference
  • A blueprint id as a string, Guid, or BlueprintGuid
  • A blueprint name registered with BlueprintTool
See Blueprint for more details.

Returns
Type Description
TBuilder
| Improve this Doc View Source

RemoveFromVariantsSet(Func<BlueprintAbilityReference, Boolean>)

Removes elements from Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_VariantsSet that match the provided predicate.

Declaration
public TBuilder RemoveFromVariantsSet(Func<BlueprintAbilityReference, bool> predicate)
Parameters
Type Name Description
System.Func<Kingmaker.Blueprints.BlueprintAbilityReference, System.Boolean> predicate
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetAbility(Blueprint<BlueprintAbilityReference>)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_Ability

Declaration
public TBuilder SetAbility(Blueprint<BlueprintAbilityReference> ability)
Parameters
Type Name Description
Blueprint<Kingmaker.Blueprints.BlueprintAbilityReference> ability

Blueprint of type BlueprintAbility. You can pass in the blueprint using:

  • A blueprint instance
  • A blueprint reference
  • A blueprint id as a string, Guid, or BlueprintGuid
  • A blueprint name registered with BlueprintTool
See Blueprint for more details.

Returns
Type Description
TBuilder
| Improve this Doc View Source

SetAffectedByImpatience(Boolean)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_AffectedByImpatience

Declaration
public TBuilder SetAffectedByImpatience(bool affectedByImpatience = true)
Parameters
Type Name Description
System.Boolean affectedByImpatience
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetCheckCasterDistance(Boolean)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.CheckCasterDistance

Declaration
public TBuilder SetCheckCasterDistance(bool checkCasterDistance = true)
Parameters
Type Name Description
System.Boolean checkCasterDistance
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetCheckPartyDistance(Boolean)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.CheckPartyDistance

Declaration
public TBuilder SetCheckPartyDistance(bool checkPartyDistance = true)
Parameters
Type Name Description
System.Boolean checkPartyDistance
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetDeadTargetType(DeadTargetType)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_DeadTargetType

Declaration
public TBuilder SetDeadTargetType(DeadTargetType deadTargetType)
Parameters
Type Name Description
Kingmaker.AI.Blueprints.DeadTargetType deadTargetType
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetForceTargetEnemy(Boolean)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_ForceTargetEnemy

Declaration
public TBuilder SetForceTargetEnemy(bool forceTargetEnemy = true)
Parameters
Type Name Description
System.Boolean forceTargetEnemy
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetForceTargetSelf(Boolean)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_ForceTargetSelf

Declaration
public TBuilder SetForceTargetSelf(bool forceTargetSelf = true)
Parameters
Type Name Description
System.Boolean forceTargetSelf
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetLocators(EntityReference[])

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.Locators

Declaration
public TBuilder SetLocators(params EntityReference[] locators)
Parameters
Type Name Description
Kingmaker.Blueprints.EntityReference[] locators

InfoBox: To use locators make sure you selected CheckCasterDistance or CheckPartyDistance.

Returns
Type Description
TBuilder
| Improve this Doc View Source

SetMaxPartyDistanceToLocator(Single)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.MaxPartyDistanceToLocator

Declaration
public TBuilder SetMaxPartyDistanceToLocator(float maxPartyDistanceToLocator)
Parameters
Type Name Description
System.Single maxPartyDistanceToLocator

InfoBox: Selects target point from locators which is distant from at least one party member less than MaxPartyDistanceToLocator meters (0 or less means no limit)

Returns
Type Description
TBuilder
| Improve this Doc View Source

SetMaxPartySqrDistanceToLocator(Single)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_MaxPartySqrDistanceToLocator

Declaration
public TBuilder SetMaxPartySqrDistanceToLocator(float maxPartySqrDistanceToLocator)
Parameters
Type Name Description
System.Single maxPartySqrDistanceToLocator
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetMinCasterDistanceToLocator(Single)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.MinCasterDistanceToLocator

Declaration
public TBuilder SetMinCasterDistanceToLocator(float minCasterDistanceToLocator)
Parameters
Type Name Description
System.Single minCasterDistanceToLocator

InfoBox: Selects target point from locators which is distant from caster by at least MinCasterDistanceToLocator meters (0 means no limit)

Returns
Type Description
TBuilder
| Improve this Doc View Source

SetMinCasterSqrDistanceToLocator(Single)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_MinCasterSqrDistanceToLocator

Declaration
public TBuilder SetMinCasterSqrDistanceToLocator(float minCasterSqrDistanceToLocator)
Parameters
Type Name Description
System.Single minCasterSqrDistanceToLocator
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetMinPartyDistanceToLocator(Single)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.MinPartyDistanceToLocator

Declaration
public TBuilder SetMinPartyDistanceToLocator(float minPartyDistanceToLocator)
Parameters
Type Name Description
System.Single minPartyDistanceToLocator

InfoBox: Selects target point from locators which is distant from all party members by at least MinPartyDistanceToLocator meters (0 or less means no limit)

Returns
Type Description
TBuilder
| Improve this Doc View Source

SetMinPartySqrDistanceToLocator(Single)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_MinPartySqrDistanceToLocator

Declaration
public TBuilder SetMinPartySqrDistanceToLocator(float minPartySqrDistanceToLocator)
Parameters
Type Name Description
System.Single minPartySqrDistanceToLocator
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetRandomVariant(Boolean)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_RandomVariant

Declaration
public TBuilder SetRandomVariant(bool randomVariant = true)
Parameters
Type Name Description
System.Boolean randomVariant
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetTargetPointUnderTarget(Boolean)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_TargetPointUnderTarget

Declaration
public TBuilder SetTargetPointUnderTarget(bool targetPointUnderTarget = true)
Parameters
Type Name Description
System.Boolean targetPointUnderTarget
Returns
Type Description
TBuilder
| Improve this Doc View Source

SetVariant(Blueprint<BlueprintAbilityReference>)

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_Variant

Declaration
public TBuilder SetVariant(Blueprint<BlueprintAbilityReference> variant)
Parameters
Type Name Description
Blueprint<Kingmaker.Blueprints.BlueprintAbilityReference> variant

Blueprint of type BlueprintAbility. You can pass in the blueprint using:

  • A blueprint instance
  • A blueprint reference
  • A blueprint id as a string, Guid, or BlueprintGuid
  • A blueprint name registered with BlueprintTool
See Blueprint for more details.

Returns
Type Description
TBuilder
| Improve this Doc View Source

SetVariantsSet(Blueprint<BlueprintAbilityReference>[])

Sets the value of Kingmaker.AI.Blueprints.BlueprintAiCastSpell.m_VariantsSet

Declaration
public TBuilder SetVariantsSet(params Blueprint<BlueprintAbilityReference>[] variantsSet)
Parameters
Type Name Description
Blueprint<Kingmaker.Blueprints.BlueprintAbilityReference>[] variantsSet

InfoBox: In case of empty list, variant will be picked from all variants for specified ability

Blueprint of type BlueprintAbility. You can pass in the blueprint using:

  • A blueprint instance
  • A blueprint reference
  • A blueprint id as a string, Guid, or BlueprintGuid
  • A blueprint name registered with BlueprintTool
See Blueprint for more details.

Returns
Type Description
TBuilder