An event that is fired associated with a specific note.

Constructor

@:value({ cancelable : false, comboCount : 0 })new(type:ScriptEventType, note:NoteSprite, healthChange:Float, comboCount:Int = 0, cancelable:Bool = false)

Variables

read onlycomboCount:Int

The combo count as it is with this event. Will be (combo) on miss events and (combo + 1) on hit events (the stored combo count won't update if the event is cancelled).

healthChange:Float

The health gained or lost from this note. This affects both hits and misses. Remember that max health is 2.00.

read onlynote:NoteSprite

The note associated with this event. You cannot replace it, but you can edit it.

playSound:Bool

Whether to play the record scratch sound (if this event type is NOTE_MISS).

Methods

Inherited Variables

Defined by ScriptEvent

read onlycancelable:Bool

If true, the behavior associated with this event can be prevented. For example, cancelling COUNTDOWN_START should prevent the countdown from starting, until another script restarts it, or cancelling NOTE_HIT should cause the note to be missed.

read onlyeventCanceled:Bool

Whether the event has been canceled by one of the scripts that received it.

read onlyshouldPropagate:Bool

Whether the event should continue to be triggered on additional targets.

read onlytype:ScriptEventType

The type associated with the event.

Inherited Methods

Defined by ScriptEvent

cancel():Void

Cancel this event. This is an alias for cancelEvent() but I make this typo all the time.

cancelEvent():Void

Call this function on a cancelable event to cancel the associated behavior. For example, cancelling COUNTDOWN_START will prevent the countdown from starting.

stopPropagation():Void

Call this function to stop any other Scripteds from receiving the event.