Skip to content

Event Types

The Events module exports TypeScript definitions for 56 ADOFAI event types, covering all events including gameplay, track, camera, decoration, and more. They are categorized by function below.

Gameplay and Judgment

EventDescription
SetSpeedChange note speed (BPM scaling)
TwirlPath reversal (reverse direction)
CheckpointCheckpoint
HoldLong press
SetHoldSoundSet hold sound effect
SetHitsoundSet hit sound effect
KillPlayerKill the player
PausePause
MultitapMulti-tap
SetInputEventSubscribe/unsubscribe to input events
AutoPlayTilesAuto-play tiles
MultiPlanetMulti-planet
FreeRoam / FreeRoamTwirl / FreeRoamRemoveFree roam / turn / remove
RepeatEventsRepeat events
SetConditionalEventsConditional events (pass/fail)
SetFrameRateSet frame rate
TileDimensionsTile dimensions
ScalePlanetsScale planets
ScaleRadiusScale radius
ScaleMarginScale margin

Track

EventDescription
MoveTrackMove track
PositionTrackPosition track
ColorTrackColor track
RecolorTrackRecolor track
AnimateTrackAnimate track
ChangeTrackChange track
SetPlanetRotationSet planet rotation
HideHide (track/player, etc.)
MoveDecorationsMove decorations

Camera and Screen

EventDescription
MoveCameraMove camera
ScreenScrollScreen scroll
ScreenTileScreen tile
ShakeScreenScreen shake
FlashScreen flash

Filters and Post-Processing

EventDescription
SetFilterSet filter
SetFilterAdvancedAdvanced filter
HallOfMirrorsHall of mirrors
BloomBloom

Decoration, Objects, and Text

EventDescription
AddDecorationAdd decoration
AddTextAdd text
AddObjectAdd object
SetObjectSet object
SetTextSet text
SetDefaultTextSet default text
AddComponentAdd component
SetFloorIconSet floor icon
CustomBackgroundCustom background

Particles

EventDescription
AddParticleAdd particle
SetParticleSet particle
EmitParticleEmit particle

Others

EventDescription
PlaySoundPlay sound
EditorCommentEditor comment
BookmarkBookmark
CallMethodCall method

Usage

ts
import { Events } from 'adofai'
import type { SetSpeed } from 'adofai'

const ev: Events.SetSpeed = {
  floor: 0,
  eventType: 'SetSpeed',
  speedType: 'Bpm',
  beatsPerMinute: 180
}

The specific fields for each event are defined in the type definitions under src/events/ in the repository.

An organization that researches and expands the functions of ADOFAI