Buff & Status Effect Manager

v1.0.0

Installation

How to install and set up Buff & Status Effect Manager in your project.

Prerequisites: Make sure you have Game Creator 2 Core installed before proceeding. GC2 Stats is optional but recommended for stat modifier effects.

System Requirements

ComponentVersion
Unity Version2022.3 LTS or newer
Game Creator 2Core 2.x (required)
GC2 StatsOptional (for stat modifiers)
TextMeshProOptional (enhanced UI)

Installation Steps

  1. Download the Package

    Download BSM from the Unity Asset Store or via Game Creator Hub.

  2. Import into Unity

    Assets → Import Package → Custom Package → Select the downloaded .unitypackage file

  3. Wait for Compilation

    Unity will import all files and compile scripts. This may take 1-2 minutes.

  4. Generate UI Prefabs

    Menu: Tools → BSM → Generate UI Prefabs

  5. Verify Installation

    Add the StatusEffectManager component to a GameObject (see below).

Success: If you can add the StatusEffectManager component to a GameObject, installation was successful!

Project Structure

Verify that the following folder structure exists in your project:

Assets/
├── Plugins/
│   └── GameCreator/
│       └── BuffStatusEffectManager/
│           ├── Runtime/
│           │   ├── Core/
│           │   │   ├── StatusEffectManager.cs
│           │   │   ├── StatusEffectInstance.cs
│           │   │   └── EffectTickScheduler.cs
│           │   ├── Data/
│           │   │   ├── StatusEffectDefinition.cs
│           │   │   ├── StatusEffectCategory.cs
│           │   │   └── ImmunityProfile.cs
│           │   └── GameCreator/
│           │       ├── Instructions/
│           │       ├── Conditions/
│           │       ├── Events/
│           │       ├── Stats/
│           │       └── Persistence/
│           ├── UI/
│           │   ├── StatusEffectBar.cs
│           │   ├── StatusEffectIconElement.cs
│           │   ├── StatusEffectTooltip.cs
│           │   ├── StatusPanelUI.cs
│           │   ├── ImmunityPanelUI.cs
│           │   └── ImmunityFeedback.cs
│           ├── Editor/
│           │   ├── StatusEffectDefinitionEditor.cs
│           │   └── UIPrefabGenerator.cs
│           └── Prefabs/
│               └── UI/
└── (Your project files)

Verify Installation

Test that everything works correctly:

  1. Create a new empty scene
  2. Create empty GameObject → Add Component: Status Effect Manager
  3. Check Inspector - component should display with settings
  4. Create a new StatusEffectDefinition: Create → Game Creator → BSM → Status Effect Definition
  5. The asset should open with configurable fields
Next: Continue to the Getting Started guide to create your first effect!

Troubleshooting

Compilation errors after import

Ensure Game Creator 2 Core is installed and up to date. BSM requires GC2 Core as a dependency.

Stats integration not working

GC2 Stats module is optional. Install it separately via Game Creator Hub if you need stat modifiers.

UI components not appearing

Run 'Tools > BSM > Generate UI Prefabs' to create the required prefab assets.

Missing namespaces

Add 'using BuffStatusEffectManager;' to your scripts. For UI: 'using BuffStatusEffectManager.UI;'