Huck,Clemens

Welcome to BSM! This documentation covers everything you need to implement a professional buff and status effect system in your Game Creator 2 project.

Key Features

ScriptableObject Architecture

Define effects and categories as reusable assets. Configure once, use everywhere.

Flexible Stacking

Stack, Refresh, Replace, Extend, or None - choose how effects combine.

Tick System

Built-in tick scheduler for DoT effects, HoT, and periodic triggers.

Immunity System

Permanent profiles and temporary immunity via API. Block by effect, category, or tag.

GC2 Visual Scripting

12 Instructions, 8 Conditions, 5 Events - no coding required for common tasks.

Stats Integration

Optional bridge to GC2 Stats for automatic modifier application.

Complete UI System

Effect bars, icons, tooltips, and immunity feedback. Ready-to-use prefabs included.

Save/Load Support

StatusEffectRemember component integrates with GC2 persistence.

Quick Overview

Buff & Status Effect Manager (BSM) provides a complete solution for managing temporary and permanent effects on characters in your game. Whether you need poison damage over time, speed boosts, stun effects, or complex immunity systems - BSM has you covered.

The system is built around ScriptableObject assets, making it easy to create, configure, and reuse effect definitions across your project. With full integration into Game Creator 2's Visual Scripting, you can implement complex effect logic without writing any code.

System Architecture

┌─────────────────────────────────────────────────────────────┐
│                    StatusEffectManager                       │
│  (Component on Player/NPC - manages all active effects)     │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ Definition   │  │  Category    │  │  Immunity    │      │
│  │ (SO Asset)   │  │  (SO Asset)  │  │  Profile(SO) │      │
│  │              │  │              │  │              │      │
│  │ • Duration   │  │ • Type       │  │ • By Effect  │      │
│  │ • Stacking   │  │ • Color      │  │ • By Category│      │
│  │ • Tick Rate  │  │ • Max Active │  │ • By Tag     │      │
│  │ • Tags       │  │              │  │              │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
│                                                              │
│  ┌──────────────────────────────────────────────────────┐  │
│  │              StatusEffectInstance (Runtime)           │  │
│  │  • Current Stacks  • Remaining Duration  • Tick Count │  │
│  └──────────────────────────────────────────────────────┘  │
│                                                              │
├─────────────────────────────────────────────────────────────┤
│  Events: OnApplied, OnRemoved, OnStacked, OnTick, OnBlocked │
└─────────────────────────────────────────────────────────────┘