Paper Performer

Billboard-based character rendering — paper facing handlers that orient sprite quads toward the camera.
Categories:
Tags:

The Paper Performer system provides billboard-based character rendering for 2.5D and top-down games. Facing handler components keep sprite quads oriented toward the camera or a configurable facing target each tick.

For usage guides and setup examples, see The Basics: GS_Performer.

 

Contents

PaperFacingHandlerBaseComponent

Abstract base component for billboard facing logic. Extend this to implement custom facing strategies (face camera, face movement direction, face target entity).

PaperFacingHandlerComponent

Concrete paper-facing implementation. Orients the entity’s quad toward the active camera each tick. Suitable for standard 2.5D billboard characters.

PropertyTypeDescription
Face ModeenumHow the billboard faces: toward camera, along movement direction, or toward a target.

Camera-Aware Variant

A camera-aware paper facing handler is provided by GS_Complete as a cross-gem component (PhantomCam + Performer):

ComponentGemsDescription
CamCorePaperFacingHandlerComponentPerformer + PhantomCamUses CamCore notifications to adjust paper performer facing direction relative to the active phantom camera.

See Utility: Angles Helper for details.

Extension Guide

Create custom facing strategies by extending PaperFacingHandlerBaseComponent:

  1. Create a class extending PaperFacingHandlerBaseComponent.
  2. Override the tick/update method to compute your desired facing rotation.
  3. Apply the rotation to the entity transform each frame.

See Also

For related component references:

For conceptual overviews and usage guides:

For related resources:

Get GS_Performer

GS_Performer — Explore this gem on the product page and add it to your project.