Skip to content

API Reference

Complete reference for all classes, functions, interfaces, and types exported by flixel-pixi.

Core & Lifecycle

Game container, states, loop execution, context, and basic entities.

SymbolKindDescription
FixedStepAccumulatorClassConverts variable display-frame durations into deterministic simulation updates. Rendering may consume alpha, but simulation must not.
FixedStepAccumulatorOptionsInterfaceConfiguration for a deterministic fixed-step accumulator.
FLX_ASSETS_SERVICEVariableContext service token for a FlxAssets instance.
FLX_ATLAS_SERVICEVariableService token for the atlas registry.
FLX_AUDIO_SERVICEVariableService token for the audio manager.
FLX_CAMERA_HOST_SERVICEVariableService token for the active camera renderer adapter.
FLX_INPUT_SERVICEVariableService token for deterministic keyboard and pointer input.
FLX_LOG_SERVICEVariableService token for the log service in FlxContext.
FLX_STORAGE_SERVICEVariableService token for the storage backend.
FLX_VIRTUAL_INPUT_SERVICEVariableService token for controls that expose deterministic virtual input.
FLX_WATCH_SERVICEVariableService token for the watch service in FlxContext.
FlxBasicClassBase lifecycle object shared by gameplay objects, groups, and plugins.
FlxContainerClassExclusive logical group. A member can belong to only one FlxContainer; adding it elsewhere reparents it synchronously.
FlxContextClassExplicit owner of mutable engine state and replaceable services.
FlxGameClassHeadless game controller and atomic state boundary.
FlxSignalClassSmall mutation-safe signal used by state lifecycle events.
FlxStateClassBase game state; initialize state-owned objects in create.
FlxSubStateClassA state that can be layered over another state, including another substate.
libraryNameVariableCurrent library name.
upstreamBaselineVariableThe immutable upstream source baseline for compatibility work.
UpstreamBaselineInterfaceMetadata for the ActionScript 3 source baseline used by this port.

Game Objects & Sprites

Visual entities, sprites, groups, graphics, and emitters.

SymbolKindDescription
FlxBackdropClassInfinitely repeating, independently scrolling texture region.

The authoritative state stays renderer-neutral while the Pixi adapter uses one TilingSprite, avoiding duplicate gameplay objects and wrap seams.
FlxBackdropRenderHandleClassPixi tiling-sprite projection for one link.
FlxEmitterClassDeterministic burst/stream emitter backed by FlxGroup recycling.
FlxEmitterRenderHandleClassPixi projection of an authoritative, group-backed emitter pool.
FlxEmitterRenderOptionsInterfaceSelects the renderer-only projection used by an emitter.
FlxGradientClassImmutable renderer-neutral local gradient descriptor.
FlxGradientStopInterfaceOne RGBA color stop in a local gradient.
FlxGraphicsClassStable renderer-neutral vector drawing object.

Commands are tessellated per camera only when the revision changes. Use a mesh for shapes whose geometry changes every frame.
FlxGraphicsFillTypeAliasSolid RGBA color or gradient fill.
FlxGraphicsRenderHandleClassCamera-local Pixi materialization of stable vector commands.
FlxGraphicsStrokeInterfaceRenderer-neutral vector stroke style.
FlxGraphicsStyleInterfaceFill/stroke pair applied to one vector primitive.
FlxObjectClassAuthoritative world-space motion and collision object.
FlxObjectInspectorClassOptional debugger adapter for CPU-authoritative pointer selection. It never relies on Pixi hit testing and only intercepts matching debug clicks.
FlxObjectInspectorModifierTypeAliasPointer modifier required to activate debugger picking.
FlxObjectInspectorOptionsInterfaceConfiguration for the optional pointer object inspector.
FlxParticleClassSprite with lifespan and gravity-contact behavior for emitters.
FlxParticleConstructorTypeAliasConstructor for custom particles created and recycled by an emitter.
FlxParticleEmitterClassRenders a validated particle preset through Flixel-Pixi's existing emitter and camera pipeline while delegating simulation to the deterministic runtime.
FlxParticleEmitterAssetOptionsInterfaceOptions for resolving a preset's preloaded asset through link.
FlxParticleEmitterSourceTypeAliasA preloaded image or named frame collection used by a particle preset.
FlxSpriteClassRenderer-neutral Flixel sprite state with adapter-owned Pixi views.
FlxSpriteContainerClassSprite composite whose backing group enforces exclusive ownership.
FlxSpriteGroupClassA transformable sprite composite backed by a logical FlxGroup.

Members use world-space x/y while owned. add() interprets an incoming member position as local to the composite and translates it into world space; remove() converts it back to local space. Collision expands to the member AABBs rather than treating the composite as one rectangle.
FlxSpriteGroupRenderHandleClassAdapter-owned Pixi container branch for one logical sprite composite.
FlxSpriteRenderHandleClassPixi container/sprite pair synchronized from one FlxSprite.
FlxSpriteTransformTypeAliasFunction applied to one direct sprite-group member.
FlxStripClassTextured triangle geometry with Flixel object/camera semantics.

Geometry inputs are cloned. Prefer link / link for animation. If you mutate a typed-array view directly, call link once after the edits.
FlxStripGeometryInterfaceGeometry accepted by link.
FlxStripRenderHandleClassCamera-local Pixi materialization of renderer-neutral strip geometry.
FlxStripTopologyTypeAliasSupported renderer-neutral triangle connectivity.
FlxTileblockClassGenerated, immovable block filled from random sprite-sheet frames.

Animation & Atlases

Texture atlases, frame animations, and sprite controllers.

SymbolKindDescription
FlxAnimClassNamed frame sequence used by FlxSprite.
FlxAnimationCallbackTypeAliasCalled whenever a sprite materializes a new animation frame.
FlxAnimationControllerClassHaxeFlixel-style animation API backed by a deterministic FlxSprite clock.
FlxAnimationFrameEventInterfacePayload dispatched whenever an animation materializes a new frame.
FlxAnimationPlayOptionsInterfaceOptions for FlxSprite.play when using the object-form overload.
FlxAtlasClassA loaded texture atlas with named frame lookup and ordered pickers.

Obtain instances via FlxG.atlas.load(...) / FlxG.atlas.get(...).
FlxAtlasAnimationOptionsInterfaceOptions when registering an animation from link.
FlxAtlasAssetSourceInterfaceAlready-loaded asset aliases used to construct a non-owning atlas.
FlxAtlasFrameInterfaceA named region inside a shared atlas texture. index is the stable 0-based insertion order within this atlas.
FlxAtlasFrameListTypeAliasAn ordered, immutable list of atlas frames.
FlxAtlasFrameRectInterfaceRaw axis-aligned bounding rect for one atlas sub-image. Produced by the three parsers; consumed by FlxAtlas to build textures.
FlxAtlasGridMetaInterfaceGrid-based atlas descriptor. Frames are named "0", "1", … in row-major (left-to-right, top-to-bottom) order.
FlxAtlasMetaTypeAliasThird argument to link. - A string ending in .json (or whose content parses as JSON) → TexturePacker/Pixi JSON. - A string ending in .xml (or any other string) → TextureAtlas XML. - A FlxAtlasGridMeta object → uniform fixed-size grid.
FlxAtlasPrefixOptionsInterfaceOptions for link.
FlxAtlasRegistryClassRegistry that loads and stores named FlxAtlas instances. Access the singleton via FlxG.atlas.
FlxFrameClassOne named animation frame backed by a lazily resolved Pixi texture view.
FlxFramesCollectionClassOrdered frame views shared by sprite animation and atlas workflows.

Input & Controls

Keyboard, mouse, touch gestures, gamepads, virtual pads, and actions.

SymbolKindDescription
FlxActionsClassMaps logical actions to keyboard, pointer, and gamepad sources.

The legacy bind(action, ...keys) helper remains a keyboard-only shorthand.
FlxGamepadClassOne stable logical controller, retained across disconnect/reconnect.
FlxGamepadButtonEnumStandard Web Gamepad button indices.
FlxGamepadButtonLikeInterfaceMinimal browser gamepad button shape used by the injectable provider.
FlxGamepadFrameRecordInterfaceSerializable authoritative gamepad state for one replay frame.
FlxGamepadLikeInterfaceBrowser-neutral gamepad snapshot accepted by the manager.
FlxGamepadManagerClassFixed-step Web Gamepad poller with reconnect-stable logical IDs.
FlxGamepadProviderTypeAliasFunction polled exactly once at each authoritative simulation step.
FlxInputManagerClassOwns DOM listeners and publishes their events only on simulation steps.
FlxInputManagerOptionsInterfaceBrowser event targets used by link.
FlxInputServiceInterfaceInput service consumed by the fixed-step game loop.
FlxInputTextClassFlixel text field backed by a native browser input for selection, IME, and mobile keyboard behavior. DOM changes become authoritative on fixed updates.
FlxInputTextChangeCallbackTypeAliasCallback published after a DOM edit is consumed by a fixed update.
FlxInputTextOptionsInterfaceOptional construction settings for link.
FlxInputTextSubmitCallbackTypeAliasCallback published after a single-line Enter submission on a fixed update.
FlxInputTextTypeTypeAliasBrowser text-entry types supported by link.
FlxKeyRecordInterfaceA recorded key transition compatible with the AS3 replay shape.
FlxMouseRecordInterfaceA recorded pointer snapshot compatible with deterministic replay.
FlxSwipeInterfaceA swipe published for the simulation step in which its touch ends.
FlxSwipeDirectionTypeAliasCardinal direction of a recognized swipe.
FlxTouchClassState of one browser touch pointer.
FlxTouchEventLikeInterfaceMinimal touch-pointer event accepted by the deterministic input queue.
FlxTouchFrameRecordInterfaceSerializable touch state for one simulation frame.
FlxTouchManagerClassDeterministic multi-touch tracker with step-based swipe recognition.
FlxTouchOptionsInterfaceSwipe recognition thresholds measured in logical pixels and simulation steps.
FlxVirtualActionModeTypeAliasAction-button layouts for a virtual pad.
FlxVirtualButtonClassDeterministic touch/pointer button that can be bound through link.
FlxVirtualButtonOptionsInterfaceOptions for one texture-free virtual action or direction button.
FlxVirtualButtonRenderHandleClassTexture-free Pixi projection for one link.
FlxVirtualButtonStateInterfaceRead-only digital state published by one virtual control.
FlxVirtualDPadModeTypeAliasDirection layouts compatible with the common HaxeFlixel virtual-pad modes.
FlxVirtualInputClassRegistry used by link to resolve serializable virtual sources.
FlxVirtualPadClassHUD-aligned collection of deterministic direction and action buttons.
FlxVirtualPadActionMapInterfaceOptional logical action names bound by link.
FlxVirtualPadAxisMapInterfaceOptional scalar action names bound from the pad's directional pairs.
FlxVirtualPadOptionsInterfaceLayout and naming options for link.
FlxVirtualStickClassTexture-free HUD analog stick derived from authoritative fixed-step pointer state.
FlxVirtualStickAxisMapInterfaceMaps the stick's normalized axes to scalar action names.
FlxVirtualStickOptionsInterfaceVisual and response configuration for link.
FlxVirtualStickRenderHandleClassPixi projection for a texture-free virtual analog stick.
FlxVirtualStickStateInterfaceRead-only two-axis state published by one virtual stick.
InputClassDeterministic named digital-input state machine.
KeyboardClassAS3-compatible keyboard names backed by physical DOM code mappings.
MouseClassDeterministic pointer/mouse state with camera-aware coordinates.
MouseRecordClassRepresents a mouse input snapshot within a single replay frame.

Collision & Math

Spatial quadtree, collision separation, vectors, rects, and RNG.

SymbolKindDescription
clampFunctionRestricts a number to an inclusive, ordered range.
clamp01FunctionRestricts a number to the inclusive unit range from 0 to 1.
FlxPointClassStores a two-dimensional floating-point coordinate.
FlxPointerEventLikeInterfaceMinimal browser pointer event shape accepted by the deterministic queue.
FlxQuadTreeClassFlixel-compatible broad-phase quadtree with single/dual-list operation.
FlxRandomClassMutable deterministic random source compatible with FlxG.globalSeed.
FlxRectClassStores a mutable axis-aligned rectangle.
FlxUClassMath, color, formatting, and motion helpers from the AS3 FlxU surface.
nextFlixelSeedFunctionAdvances the original Flixel seeded-random recurrence.
PointLikeInterfaceA mutable point shape accepted by Flash-compatibility copy helpers.
RectangleLikeInterfaceA mutable rectangle shape accepted by Flash-compatibility helpers.

Audio System

WebAudio backend, spatial audio, sound groups, and volume control.

SymbolKindDescription
FlxAudioBackendInterfaceReplaceable audio backend. The browser implementation wraps Web Audio API; the null implementation enables headless testing.
FlxAudioControlsClassAccessible, dependency-free DOM controls for master game audio.
FlxAudioControlsOptionsInterfaceOptions for link.
FlxAudioControlsPositionTypeAliasCorner used by the optional browser audio controls.
FlxAudioManagerClassOwns the audio backend, the music singleton, and the sound-effects group.

Registered on the FlxContext service map via FLX_AUDIO_SERVICE. FlxG resolves it to expose FlxG.music, FlxG.sounds, FlxG.play(), FlxG.playMusic(), FlxG.stream(), FlxG.volume, FlxG.mute, FlxG.pauseSounds(), and FlxG.resumeSounds().
FlxAudioServiceInterfaceAudio service interface consumed by FlxG and FlxGame.
FlxAudioStateInterfaceSerializable master audio preferences.
FlxSoundClassPort of org.flixel.FlxSound.

Extends FlxBasic and drives playback through a FlxSoundHandle obtained from the active FlxAudioBackend. All authoritative state (volume, fade, proximity, loop, alive/exists) lives on this object; the handle is a platform-specific playback delegate.
FlxSoundAttachmentOptionsInterfaceConfiguration for link.
FlxSoundGroupClassA hierarchical volume and mute bus for link instances.
FlxSoundHandleInterfaceLow-level handle to a single playing sound, owned by a backend. FlxSound drives playback through this interface.
FlxSoundOffscreenBehaviorTypeAliasBehavior used by an attached sound after its source leaves the viewport.
NullAudioBackendClassNo-op audio backend for headless unit tests. Always unlocked, never suspended, all methods are inert.
WebAudioBackendClassBrowser AudioContext implementation of FlxAudioBackend.

Creates the AudioContext lazily on first play or unlockAudio(). Handles autoplay policy via a queue: sounds played before unlock are recorded and replayed on the first user gesture. By default, hiding the document suspends the context and returning resumes it.
WebAudioBackendOptionsInterfaceOptions for link.
WebAudioVisibilityPolicyTypeAliasPolicy used by link when document visibility changes.

Tweens & Motion

Interpolation, easing formulas, motion curves, and tween management.

SymbolKindDescription
FlxAngleTweenClassTweens a numeric angle and optionally writes it to an object.
FlxCircularMotionClassMotion around one complete circle. Angles are supplied in degrees.
FlxColorTweenClassInterpolates packed ARGB colors and optionally updates a sprite-like target.
FlxColorTweenTargetInterfaceMinimal sprite-like target accepted by color tweens.
FlxCubicMotionClassMotion along a cubic Bézier curve.
FlxEaseClassHaxeFlixel-compatible easing functions.
FlxEaseFunctionTypeAliasFunction used to transform normalized tween progress.
FlxFlickerTweenClassFlickers a lifecycle object's visibility using deterministic game time.
FlxFlickerTweenOptionsInterfaceFlicker-specific options layered onto normal tween options.
FlxLinearMotionClassMotion along a straight line.
FlxLinearPathClassConstant-speed motion through a polyline.
FlxMotionClassBase tween for moving an optional physics object through world space.
FlxNumTweenClassStandalone numeric tween created by FlxTween.num.
FlxPathClassMutable path data followed by a FlxObject.
FlxQuadMotionClassMotion along a quadratic Bézier curve.
FlxQuadPathClassConstant-speed traversal of connected quadratic Bézier segments.
FlxShakeTweenClassApplies deterministic random offset shake to a sprite.
FlxTweenClassBase deterministic tween. Use the static factories for common tweens.
FlxTweenAxesTypeAliasAxes accepted by sprite shake tweens.
FlxTweenCallbackTypeAliasCallback invoked with its owning tween.
FlxTweenColorInterfaceA Pixi-compatible RGB color with an explicit normalized alpha channel.
FlxTweenColorValueTypeAliasNumeric RGB/ARGB color or an explicit RGB-and-alpha value.
FlxTweenManagerClassOwns and advances deterministic game-time tweens.
FlxTweenOptionsInterfaceCommon tween configuration.
FlxTweenTypeTypeAliasTween completion behavior.
FlxVarTweenClassNumeric property tween created by FlxTween.tween.

UI & Typography

Buttons, 9-slice sprites, progress bars, and high-performance text.

SymbolKindDescription
FlxBarClassDeterministic value bar with renderer-owned fill geometry.

The optional parent/property binding is read once per fixed update. Rendering never regenerates textures when the value changes.
FlxBarCallbackTypeAliasCallback invoked when a bar first reaches one of its range limits.
FlxBarFillDirectionTypeAliasSupported FlxBar fill directions.
FlxBarParentLikeInterfaceParent object followed for position and optional scroll factor.
FlxBarRenderHandleClassPixi projection for a texture-free link.
FlxBarValueProviderTypeAliasNumeric value provider used by a bound bar.
FlxBitmapFontClassBitmap glyph font backed by a Pixi BitmapFont and registered for BitmapText.
FlxBitmapFontPageSourceTypeAliasTexture or engine graphic supplying one AngelCode bitmap-font page.
FlxBitmapTextClassBitmap-font text rendered through Pixi BitmapText.
FlxBitmapTextRenderHandleClassPixi BitmapText projection for one link.
FlxBmFontDataInterfaceParsed AngelCode / BMFont XML payload for Pixi BitmapFont.
FlxButtonClassDeterministic Flixel button with optional toggle and native accessibility hooks.
FlxButtonCallbackTypeAliasCallback invoked by a button transition.
FlxButtonRenderHandleClassComposite Pixi view for a button background and its optional label.
FlxButtonSoundInterfaceSound-like hook accepted without coupling the button to an audio backend.
FlxNineSliceBorderInputInterfacePartial border insets accepted by link.
FlxNineSliceBordersInterfaceInsets for one 9-slice texture region.
FlxNineSliceButtonClasslink with a renderer-owned Pixi NineSliceSprite background.
FlxNineSliceButtonRenderHandleClassComposite Pixi view for a 9-slice button background and optional label.
FlxNineSliceRenderHandleClassPixi 9-slice projection for one link.
FlxNineSliceSpriteClassResizable sprite with fixed corner and edge art via Pixi 9-slice scaling.

Use link or link instead of link so border insets are tracked for rendering.
FlxTextClassFlixel-compatible text state rendered by Pixi Text or BitmapText.
FlxTextRenderHandleClassPixi text leaf wrapped by a transform-owning container.
FlxTextRenderModeTypeAliasPixi text implementation chosen for a FlxText render handle.
parseBmFontXmlFunctionParse AngelCode BMFont XML into the structure expected by Pixi BitmapFont.

Tilemaps

2D grid rendering, collision indexing, and map buffers.

SymbolKindDescription
FlxTileClassReusable collision proxy for one tile type.
FlxTileCallbackTypeAliasCallback registered for a tile type.
FlxTileFilterTypeAliasRuntime constructor used to filter tile callbacks.
FlxTilemapClassRenderer-neutral tile data, collision, ray, and pathfinding object.
FlxTilemapBufferClassCompatibility metadata for the classic camera-sized bitmap tile buffer. Pixi rendering uses link chunks instead.
FlxTilemapLoadOptionsInterfaceOptions for loading a numeric tile array.
FlxTilemapOverlapCallbackTypeAliasCallback used while testing a tile proxy against an object.
FlxTilemapRenderHandleClassPixi sprite chunks synchronized from one authoritative tilemap.

Assets & Loading

Asset bundles, asynchronous loading sessions, and graphics cache.

SymbolKindDescription
FlxAssetBackendInterfaceInjectable subset of Pixi Assets used by the engine service.
FlxAssetBundleInterfaceA named group of assets with state/scene lifetime.
FlxAssetDescriptorInterfaceBrowser asset descriptor accepted by FlxAssets.
FlxAssetInitOptionsInterfaceInitialization options for the Pixi asset resolver.
FlxAssetLoadErrorClassFailure enriched with the alias or URL requested by the game.
FlxAssetLoadOptionsInterfaceRetry, progress, and failure policy for a foreground asset load.
FlxAssetManifestInterfaceDeclarative bundle manifest.
FlxAssetsClassTyped, explicitly asynchronous facade over PixiJS v8 Assets.
FlxGraphicClassA loaded or generated Pixi texture plus optional CPU-side pixel data.
FlxLoadingBundleOptionsInterfaceOptions for loading an asset bundle through a shared loading session.
FlxLoadingErrorClassA loading failure enriched with the stage that failed.
FlxLoadingSessionClassRenderer-independent loading state for both browser boot and in-game screens. Progress is monotonic within one run and can be reset explicitly for retry.
FlxLoadingSnapshotInterfaceImmutable loading state delivered to DOM or Pixi/Flixel loading views.
FlxLoadingStageTypeAliasLifecycle stage reported by a loading operation.
FlxLoadingStateTypeAliasHigh-level state shared by boot and in-game loading presentations.
FlxLoadingTaskContextInterfaceContext provided to a custom loading task.
FlxLoadingTaskOptionsInterfaceMaps a task into a section of the session's overall progress.
FlxLoadingUpdateInterfacePartial update accepted by link.
throwIfAbortedFunctionThrows a browser-standard abort error when a loading signal is cancelled.

Browser DX & Viewport

Browser application bootstrap, auto-scaling viewports, and safe areas.

SymbolKindDescription
BrowserGameApplicationInterfaceRunning browser game application handle returned by link.
BrowserGameAssetOptionsInterfaceDeclarative asset configuration for browser startup.
BrowserGameFrameInterfaceTiming information for one completed browser render frame.
BrowserGamePreloadContextInterfaceLoading helpers supplied to a game's custom startup preparation.
BrowserGamePreloaderOptionsInterfaceConfiguration for the default or a custom bootstrap-preloader view.
BrowserGameRendererBackendTypeAliasGPU renderer backends supported by the browser game host.
BrowserGameRendererFallbackInterfaceDetails of an automatic renderer recovery completed during startup.
BrowserGameRendererOptionsInterfaceRenderer selection and recovery policy for browser startup.
createBrowserGameFunctionBoot Pixi + FlxGame + FlxCameraRenderer for a browser game. Asset preparation, retry, cancellation, and first-frame readiness share one loading model that can also drive later in-game loading screens.
FlxBrowserSafePaddingTypeAliasDeveloper-defined logical padding inside the visible viewport.
FlxBrowserScaleModeTypeAliasBrowser presentation modes that preserve a fixed logical game size.
FlxBrowserScaleOptionsInterfaceConfiguration for the browser canvas presentation policy.
FlxBrowserViewportClassOwns CSS-space canvas sizing while the renderer keeps a stable logical size. Pointer and accessibility projection use the resulting canvas bounds.
FlxBrowserViewportInsetsInterfacePer-edge spacing used by browser-safe layout.
FlxBrowserViewportRectInterfaceImmutable rectangle expressed in logical game coordinates.
FlxBrowserViewportSnapshotInterfaceResolved CSS-space placement of a logical game canvas.

Debugger & Diagnostics

Interactive console, variable watch, FPS meter, and object inspector.

SymbolKindDescription
DebugChannelClassTyped pub/sub channel that connects the game loop to optional debug consumers.
DebugPathDisplayClassPlugin that owns path-debug registration and Pixi geometry projection.
FlxConsoleClassHeadless, allow-listed debugger command registry with bounded history. It never evaluates arbitrary JavaScript; consumers decide which operations are safe by explicitly registering commands.
FlxConsoleCommandInterfaceA command explicitly exposed to the debugger console.
FlxConsoleCommandContextInterfaceContext passed to a registered debugger console command.
FlxConsoleOptionsInterfaceConfiguration for the headless debugger console.
FlxConsoleResultInterfaceNormalized result returned by every debugger console execution.
FlxDebuggerClassDOM overlay debugger with Console, Log, Watch, Perf, VCR, and Vis panels. Mounts as a fixed bottom bar. Fully keyboard/screen-reader accessible.
FlxDebuggerDiagnosticSnapshotInterfaceVersioned JSON-safe debugger export.
FlxDebuggerOptionsInterface
FlxDebuggerVCRCallbacksInterfaceCallbacks the debugger needs to invoke VCR actions on the game.
FlxDiagnosticsClassBounded, renderer-neutral runtime diagnostics collector.
FlxDiagnosticsOptionsInterfaceBounded diagnostics collector configuration.
FlxFpsDisplayClassSmall dependency-free DOM display for render FPS and frame pacing.
FlxFpsDisplayOptionsInterfaceOptions for link.
FlxFpsDisplayPositionTypeAliasScreen corner used by the lightweight FPS overlay.
FlxFpsDisplayThemeInterfaceTheme tokens for the lightweight FPS overlay.
FlxLogClassRing-buffer log that keeps the last MAX_ENTRIES messages. Mirrors AS3 FlxG.log.
FlxPreloaderClassAccessible, customizable HTML loading view. Dismissed automatically when a ready snapshot is received.
FlxPreloaderOptionsInterfaceOptions for the default DOM preloader.
FlxPreloaderThemeInterfaceTheme tokens used by the default DOM preloader.
FlxPreloaderViewInterfaceReplaceable presentation driven by a shared loading session.
FlxPreloaderViewContextInterfaceContext passed to a custom bootstrap-preloader factory.
FlxPreloaderViewFactoryTypeAliasCreates a custom DOM-first bootstrap preloader.
FlxWatchClassLive field watcher. Mirrors AS3 FlxG.watch.
FlxWatchDefinitionInterfaceGetter-backed tracked value definition.
FlxWatchEditorInterfaceExplicit mutation contract for an editable tracked value.
FlxWatchMutationGuardTypeAliasGuard result: true permits mutation; false or a message rejects it.
FlxWatchMutationResultInterfaceResult of an attempted debugger watch mutation.
LogEntryInterfaceA single log entry stored in the ring buffer.
PreloaderStateTypeAliasState of the preloader.
TimerManagerClassPlugin that advances deterministic game-time timers.
WatchEntryInterfaceA single watched field entry.
WatchSnapshotInterfaceA resolved snapshot value.

Storage & Replay

Persistent save data, deterministic recording, and AS3 replay compatibility.

SymbolKindDescription
CodePairInterfaceSerializable key input state for a single replay frame.
convertAS3ReplayToFlxReplayFunctionConverts legacy AS3 Flixel text replay data into a modern FlxReplay instance.
convertFlxReplayToAS3TextFunctionConverts a modern FlxReplay instance into legacy AS3 Flixel plain-text format.
FlxReplayClassManages deterministic input recording, playback, and checksum verification.
FlxSaveClassPort of org.flixel.FlxSave.

Provides namespaced, versioned save slots backed by a replaceable FlxStorageBackend. The default backend is provided by the FlxContext service map (typically LocalStorageBackend).
FlxSaveBindOptionsInterfaceOptions for FlxSave.bind().
FlxSaveMigrationTypeAliasCallback for migrating save data between schema versions.
FlxSaveResultTypeAliasResult of a FlxSave.flush() operation. On failure, includes an error category and human-readable message.
FlxStorageBackendInterfaceReplaceable storage backend.

The default implementation uses localStorage; an optional IndexedDB adapter is available for larger data. A NullStorageBackend enables headless testing.
FlxVCRInterfaceVCR control interface for recording, playback, and step controls.
FrameRecordClassRepresents recorded inputs and state checksum for a single simulation frame.
FrameRecordDataInterfaceRaw JSON representation of a FrameRecord.
IndexedDBBackendClassOptional IndexedDB-backed storage adapter.

Reads from a cache populated while opening. Writes and erases must use the async FlxSave methods so their results represent transaction completion.

Usage:


ts<br>const db = await IndexedDBBackend.open('my-game-saves');<br>const save = new FlxSave();<br>save.bind('slot1', { backend: db });<br>await save.flushAsync();<br><br>
LocalStorageBackendClasslocalStorage-backed storage implementation.

Keys are namespaced as flixel:{name} to avoid collisions with other web applications. Quota failures are detected via DOMException and surfaced through the FlxSaveResult type. Malformed stored JSON returns null and logs a console warning rather than throwing.
NullStorageBackendClassIn-memory storage backend for headless unit tests. Data lives only for the lifetime of this instance.

Rendering & Filters

PixiJS render handles, post-processing filters, shaders, and camera views.

SymbolKindDescription
collectRenderablesFunctionCollect displayables under a Flixel basic (state/group tree).
FlxBlurFilterClassRenderer-neutral blur effect descriptor.
FlxBlurFilterOptionsInterfaceOptions for link.
FlxCameraClassRenderer-neutral Flixel camera state.

Pixi render targets and display objects are owned by FlxCameraRenderer; this class owns only deterministic simulation and coordinate transforms.
FlxCameraEffectCallbackTypeAliasCallback invoked after a deterministic camera effect completes.
FlxCameraFollowStyleTypeAliasCamera follow presets retained from the AS3 API.
FlxCameraHostInterfaceAdapter hook used to mirror logical camera lifecycle into a renderer.
FlxCameraLikeInterfaceCamera fields needed by headless screen-coordinate helpers.
FlxCameraObjectPickInterfaceCPU-authoritative result of debugger object picking.
FlxCameraRendererClassPixi render-texture adapter for one logical world and any number of cameras.
FlxCameraShakeDirectionTypeAliasCamera shake direction presets retained from the AS3 API.
FlxCameraViewInterfacePixi resources owned for one logical camera.
FlxColorMatrixFilterClassRenderer-neutral 4×5 color-matrix effect descriptor.
FlxDisplacementFilterClassTexture-backed displacement effect with revisioned runtime parameters.
FlxDisplacementFilterOptionsInterfaceOptions for link.
FlxFilterTypeAliasBuilt-in renderer-neutral sprite effects.
FlxRenderableTypeAliasSprite, tilemap, or emitter that can be registered with link.
FlxRenderHandleInterfaceAdapter-owned Pixi view synchronized from an authoritative Flixel object.
FlxShaderFilterClassRenderer-neutral custom filter descriptor with typed runtime uniforms.
FlxShaderFilterOptionsInterfaceOptions for link.
FlxShaderUniformDefinitionInterfaceInitial type and value for one shader uniform.
FlxShaderUniformsClassMutable, type-checked values shared by every projection of a shader filter.
FlxShaderUniformSchemaTypeAliasNamed shader-uniform schema inferred by link.
FlxShaderUniformTypeTypeAliasUniform data types supported by link.
FlxShaderUniformValueTypeAliasType-safe JavaScript value for a shader uniform type.
makeGraphicPixelsFunctionCreates a packed 0xRRGGBBAA buffer filled with one color.
PixelBufferInterfaceA CPU-side packed RGBA pixel buffer used by generated graphics.
syncWorldToRendererFunctionSynchronize renderer entries with the active state's renderables. Adds missing objects; removes entries for objects no longer in the tree. Does not clear and rebuild all handles. Clears link when a context is attached.

Types & Utilities

Data types, helper interfaces, and utility declarations.

SymbolKindDescription
CreateBrowserGameOptionsInterfaceOptions for link.
DebugEventsInterfacePayload shapes for each debug event type.
DebugEventTypeTypeAlias
FixedStepAdvanceResultInterfaceResult of advancing a link.
FlxActionBindingsDataInterfaceVersioned binding schema returned by link.
FlxActionGamepadAxisSourceInterfaceOne gamepad axis exposed as a scalar analog source.
FlxActionGamepadButtonAxisSourceInterfacePair of gamepad buttons exposed as a scalar analog source.
FlxActionGamepadButtonSourceInterfaceGamepad button used as a digital action source.
FlxActionGamepadTargetTypeAliasSelects one logical gamepad, the first active pad, or every connected pad.
FlxActionKeyboardAxisSourceInterfacePair of keyboard keys exposed as a scalar analog source.
FlxActionKeyboardSourceInterfaceKeyboard key used as a digital action source.
FlxActionMouseSourceInterfacePointer button used as a digital action source.
FlxActionRebindOptionsInterfaceControls whether a newly assigned source is removed from other actions.
FlxActionSourceTypeAliasSerializable digital or scalar-analog source for one named action.
FlxActionVirtualButtonAxisSourceInterfacePair of virtual buttons exposed as a scalar analog source.
FlxActionVirtualButtonSourceInterfaceOne registered virtual control exposed as a digital action source.
FlxActionVirtualStickAxisSourceInterfaceOne normalized axis from a registered virtual stick.
FlxActionWheelSourceInterfaceMouse-wheel direction used as a one-step digital action source.
FlxAsyncStorageBackendInterfaceStorage backend whose durable writes must be awaited.
FlxBasicConstructorTypeAliasConstructor accepted by link.
FlxDiagnosticSampleInterfaceOne bounded runtime diagnostic sample.
FlxDiagnosticSnapshotInterfaceVersioned, serializable performance snapshot.
FlxDiagnosticSummaryInterfaceAggregate metrics included with diagnostic exports.
FlxDisplacementPointInterfacePoint-like input used by displacement scale and texture offset.
FlxFpsMetricsInterfaceMetrics from the most recently completed FPS sampling window.
FlxGClassStatic compatibility facade delegating to one active link.
FlxGridFramesOptionsInterfaceOptions for creating a uniform grid frame collection.
FlxGroupClassMutation-safe collection that owns member lifecycle traversal.
FlxKeyboardEventLikeInterfaceMinimal browser keyboard event shape accepted by the deterministic queue.
FlxLinearGradientOptionsInterfaceLocal normalized options for a linear gradient.
FlxOverlapCallbackTypeAliasCalled after an accepted overlap pair is found.
FlxPixiTextNodeTypeAliasPixi leaf used by a FlxTextRenderHandle.
FlxPluginConstructorTypeAliasConstructor used by the plugin compatibility facade.
FlxProcessCallbackTypeAliasDecides whether an overlap pair is accepted.
FlxRadialGradientOptionsInterfaceLocal normalized options for a radial gradient.
FlxShaderWebGLProgramInterfaceWebGL fragment program for a custom filter.
FlxShaderWebGPUProgramInterfaceCombined WebGPU program for a custom filter.
FlxSignalListenerTypeAliasListener registered with link.
FlxStateConstructorTypeAliasZero-argument state constructor used by reset and startup.
FlxStateRuntimeInterfaceRuntime bridge installed by a FlxGame into its context.
FlxSubStateCallbackTypeAliasLifecycle callback invoked when a substate opens or closes.
FlxTimerClassDeterministic timer advanced by the context's TimerManager.
FlxTimerCallbackTypeAliasCallback fired for each completed timer loop.
isParticlePresetValidationErrorFunctionReturn whether an error came from particle preset parsing.
JsonObjectInterface
JsonPrimitiveTypeAlias
JsonValueTypeAlias
parseParticlePresetFunctionParse an unknown value or throw a link.
ParticleAppearanceDefinitionInterface
ParticleBlendModeTypeAliasPortable blend modes supported by particle presets.
ParticleColorStopInterface
ParticleCurveInterface
ParticleCurveInterpolationTypeAlias
ParticleCurveStopInterface
ParticleEmissionDefinitionTypeAlias
ParticleEmitterDiagnosticsInterface
ParticleEmitterStateTypeAlias
ParticleFrameSelectionTypeAlias
ParticleMotionDefinitionInterface
ParticleNumberRangeInterface
ParticlePresetTypeAlias
ParticlePresetV1Interface
ParticlePresetValidationErrorClassError thrown when a particle preset cannot be parsed.
ParticlePresetValidationResultTypeAlias
ParticleRotationDefinitionInterface
ParticleSpaceTypeAlias
ParticleSpawnDefinitionTypeAlias
ParticleStateInterface
ParticleTextureDefinitionInterface
ParticleVectorRangeInterface
ReplayFileFormatInterfaceStructure of a serialized FlxReplay JSON file.
serializeParticlePresetFunctionSerialize a validated particle preset with deterministic key ordering.
SerializeParticlePresetOptionsInterface
validateParticlePresetFunctionValidate an unknown value as a version 1 particle preset.
ValidationIssueInterface
ValidationIssueCodeTypeAlias
ValidationResultTypeAlias

Released under the MIT License.