Buff & Status Effect Manager

v1.0.0

Visual Scripting

Complete reference for all GC2 Visual Scripting integrations.

Overview

BSM fully integrates with Game Creator 2's Visual Scripting system. All functionality is available through Instructions, Conditions, and Events - no coding required.

18
Instructions
15
Conditions
9
Events
All BSM Visual Scripting components are found under the category:Buff Status Effect Manager

Instructions

Instructions are actions that modify game state. Use them in Triggers, Actions, and Sequences.

InstructionDescriptionCategory
Apply Status EffectApplies a status effect to the targetCore
Remove Status EffectRemoves a specific effect from the targetCore
Remove All EffectsRemoves all active effects from the targetCore
Dispel CategoryRemoves all effects of a specific categoryDispel
Dispel Category TypeRemoves all Buffs, Debuffs, or CC effectsDispel
Dispel by TagRemoves all effects with a specific tagDispel
Dispel by Cleanse TypeRemoves effects matching the cleanse type (Magic, Physical, etc.)Dispel
Add StacksAdds stacks to an existing effectStacking
Remove StacksRemoves stacks from an effect (may dispel if 0)Stacking
Add Immunity (Effect)Grants temporary immunity to a specific effectImmunity
Add Immunity (Category)Grants temporary immunity to a categoryImmunity
Add Immunity (Tag)Grants temporary immunity to effects with a tagImmunity
Clear ImmunitiesRemoves all temporary immunitiesImmunity
Clear CooldownClears cooldown for a specific effectCooldown
Clear All CooldownsClears all effect cooldownsCooldown
Toggle AuraActivates, deactivates, or toggles an auraAura
Set Aura RadiusChanges the aura radius at runtimeAura
Set Aura EffectChanges which effect the aura appliesAura

Conditions

Conditions check game state and return true/false. Use them in Branches and conditional logic.

ConditionDescription
Has EffectReturns true if target has a specific effect active
Has Any EffectReturns true if target has any active effects
Has Effect CategoryReturns true if target has any effect of a category
Has Effect Category TypeReturns true if target has any Buff/Debuff/CC
Has Effect TagReturns true if target has any effect with a tag
Is Immune to EffectReturns true if target is immune to an effect
Is Immune to CategoryReturns true if target is immune to a category
Effect Stack CountCompares the stack count of an effect
Active Effect CountCompares total number of active effects
Effect Remaining DurationCompares remaining time of an effect
Can Apply EffectReturns true if effect could be applied (not blocked)
Is On CooldownReturns true if an effect is on cooldown
Cooldown RemainingCompares remaining cooldown time
Aura Is ActiveReturns true if an aura is currently active
Aura Target CountCompares number of targets affected by an aura

Events

Events trigger when something happens. Add them to Trigger components to react to effect changes.

EventDescription
On Any Effect AppliedFires when any effect is applied to the target
On Any Effect ExpiredFires when any effect expires naturally
On Any Effect DispelledFires when any effect is manually removed
On Any Effect TickedFires on each tick of any effect
On Any Effect StackedFires when any effect gains or loses stacks
On Specific Effect AppliedFires when a specific effect is applied
On Specific Effect ExpiredFires when a specific effect expires
On Effect BlockedFires when an effect application is blocked (immunity)
On Category Type AppliedFires when any Buff/Debuff/CC is applied

Common Patterns

Poison Damage on Tick

Deal damage to the player every time a poison effect ticks.

  1. Add Trigger to Player with Event: On Specific Effect Applied
  2. Set Effect to your Poison definition
  3. Add another Trigger with Event: On Any Effect Ticked
  4. Add Condition: Has Effect (check for Poison)
  5. Add Action: Change Attribute (reduce Health)

Stun with Immunity After

After being stunned, grant brief immunity to prevent chain-stunning.

  1. Add Trigger with Event: On Specific Effect Expired
  2. Set Effect to your Stun definition
  3. Add Action: Add Immunity (Effect)
  4. Set Effect to Stun, Duration to 3 seconds

Healing Aura Zone

Create a zone that heals allies who stand in it.

  1. Create a HealOverTime effect (category: Buff, HasTick: true)
  2. Create empty GameObject with StatusEffectAura component
  3. Assign HealOverTime effect, set Radius to 5
  4. Set Target Mode to AlliesOnly
  5. Enable Remove On Exit

Boss Immune to CC

Make boss enemies immune to all crowd control effects.

  1. Create an ImmunityProfile asset
  2. Add your CrowdControl category to Immune Categories
  3. Assign this profile to the Boss's StatusEffectManager
  4. (Optional) Add Trigger with Event: On Effect Blocked to show "Immune!" text