Paper Performer

The Paper Performer system provides billboard-style character rendering for 2.5D games. The Paper Facing Handler rotates sprite-based characters to always face the active camera while maintaining proper orientation relative to movement direction. This prevents the visual artifacts that occur when a flat sprite is viewed from the side.

For component properties and the facing algorithm, see the Framework API reference.

Contents

• How It Works
• Camera-Aware Variant
• Entity Configuration
• Glossary
• See Also

How It Works

The PaperFacingHandlerComponent is placed on any entity that uses sprite-based or flat-mesh character rendering. Each frame, it calculates the optimal facing direction based on:

1. The active camera’s position (via CamCore notifications).
2. The entity’s movement direction.
3. Configurable facing rules.

The result is a character that always presents its front face to the camera without snapping or popping during movement direction changes.

Camera-Aware Variant

The CamCorePaperFacingHandlerComponent (in GS_Complete) extends the base paper facing with direct camera core integration. It listens to CamCoreNotificationBus for camera position updates, ensuring the facing calculation uses the exact camera state rather than a cached position.

Entity Configuration

Note this has been put inside a GS_Unit prefab.

Glossary

For full definitions, see the Glossary.

See Also

For the full API, component properties, and C++ extension guide:

• Framework API: Paper Performer

For related systems:

• The Basics: PhantomCam
• Utility: Angles Helper

Get GS_Performer

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