Skip to content

Effect ​

An effect that can be applied to a game.

Kind: Class

Namespace: CrowdControl.Common

Inheritance: IEquatable\<Effect\>

Public Constructors

Effect(string name, string id)

Creates a new instance of the CrowdControl.Common.Effect class.

Effect(string name, string id, EffectKind kind)

Creates a new instance of the CrowdControl.Common.Effect class.

Public Member Functions

virtual override

string

ToString()

string

ResolveName(IEnumerable parameters)

bool

Equals(Effect other)

virtual override

bool

Equals(object obj)

virtual override

int

GetHashCode()

Public Static Functions

string

GetDisplayName(string name, SITimeSpan? duration)

Gets the display name of the effect. This is the name as it will appear to viewers.

string

SanitizeID(string input)

Sanitizes the ID of the effect.

Public Attributes

string

ID

The safe name of the effect. Not displayed. Must be unique per-effect.

string

Name

The display name of the effect.

string

SortName

The sorting name of the effect.

QuantityRange

Quantity

The effect code for use in commands.

uint

DefaultQuantity

The default quantity to use for testing. This value is only used by the SDK.

SITimeSpan?

Duration

The default duration of the associated effect.

bool

IsDurationEditable

true if the streamer is permitted to change the default duration; otherwise, false.

string

Description

A long description of the effect.

string

Note

A small context note for the effect.

string

StartMessage

A text template displayed to the player when the effect starts.

string

EndMessage

A text template displayed to the player when the effect ends (timed effects only).

EffectGrouping

Category

List of categories that the effect belongs to.

EffectGrouping

Group

List of effect groups that the effect belongs to.

List

Tags

Tags searchable by the UI.

List

Metadata

A list of metadata fields to attach to successful effect responses.

List

IncompatibleConnectors

A list of connectors that are incompatible with this effect.

List

AllowedGameStates

The list of game states in which the effect is allowed.

string

Image

The icon to represent the associated effect.

uint?

QueueWarning

The per-effect number of concurrent queued requests before the viewer is served a warning.

uint?

QueueMax

The per-effect maximum number of concurrent queued requests.

SITimeSpan?

ViewerCooldown

The per-viewer per-effect cooldown for requests.

SITimeSpan?

SessionCooldown

The per-effect cooldown for requests.

uint

Price

The cost of the item, in coins.

EffectKind

Kind

The kind of effect.

ParameterList

Parameters

The parameters to the effect or bid war.

SITimeSpan?

ResponseTimeout

The maximum time to wait for a response from the game for asynchronous connector types (TCP/WebSocket/etc).

uint?

RetryMaxAttempts

The maximum number of times to attempt a failed effect.

SITimeSpan?

RetryMaxTime

The maximum amount of time to retry a failed effect.

NonNumericRange?

RetryInterval

The minimum and maximum intervals to wait between retries of a failed effect.

string

ErrorOverride

An error message to display in place of standard messages in case of failures.

bool

Inactive

true if the item is currently marked as inactive and optional; otherwise, false.

bool

Disabled

true if the item is currently marked as hidden to all non-staff users; otherwise, false.

bool

Admin

true if the item is currently marked as a helper/repair utility effect; otherwise, false.

Alignment?

Alignment

The alignment of the effect.

bool?

NoPooling

true if pooling is disabled for this effect; otherwise, false.

EffectGrouping

ScaleGroups

The scaling groups to which the referenced effect belongs.

EffectType

EffectType

The type of the effect.

Regex

DURATION

Regex to match common language patterns for durations.

Properties

bool

HasQuantity

[get, ]

true if the effect has a definable quantity; otherwise, false.

bool

HasDuration

[get, ]

EnumWrapper

Morality

[get, set]

The morality of the effect.

float

ScaleFactor

[get, set]

The factor to scale up by.

SITimeSpan

ScaleDecayTime

[get, set]

Duration until next scaling decay event.

string

DisplayName

[get, ]

The display name of the effect. This is the name as it will appear to viewers.