Title Screen

Classic title screen replacements are edited in the Level Editor's Classic Reskin mode. The runtime loads the reskin title from:

Editor/<Pack Name>/Level Replacements/Classic/title.json

Image files referenced by the title JSON live in:

Editor/<Pack Name>/Levels/Art/

Create A Title Screen

  1. Open the Level Editor.
  2. Drop or select your pack folder.
  3. Choose Classic Reskin.
  4. In the cutscene list, add Title Screen if it does not exist.
  5. Add one or more scenes, layers, and images.
  6. Save by changing any property or using the editor save flow.

The editor stores title screen images in the same LocalLevelBackgroundData format used by other cutscenes and level art, with one title-specific image type: titleScreenImages.

Static Images Vs Title Screen Images

Use staticImages for background pieces that simply render at a position.

Use titleScreenImages for animated title elements. These support:

Field Purpose
initialXPosition Starting X position before the image moves to position.x.
lerpSpeed How quickly the image moves from the initial position to the final position.
initialDelay Delay before the movement starts.
wiggleAmplitude Amount of idle wiggle after the image appears.
wiggleFrequency Speed of the idle wiggle.
requireCharacterName Only show this image when a matching character is selected.
isAICharacter Treat the image as an AI or companion character image.

The editor can convert a selected static image to a title screen image when you are editing the title screen.

Layering Tips

Use separate layers for:

  • full-screen background art
  • logo and foreground objects
  • moving title elements
  • selectable or character-dependent overlays

Set zOrder so foreground artwork renders above background artwork. Keep parallax at 1, 1 for normal screen-space title art unless you intentionally want background movement.

Music

Each title scene can set musicPackName and musicName. Use your pack name if the music file lives in your pack's Musics folder. Leave both blank if you want the default title music behavior.

If you add custom music, add loop metadata next to the audio file when needed:

Musics/title-theme.ogg
Musics/title-theme.json

See Replace Music and Audio Reference.

Common Problems

If the title screen does not appear, confirm:

  • the file is Level Replacements/Classic/title.json
  • referenced image names exist in Levels/Art
  • the pack depends on Classic
  • the scene has at least one layer
  • the layer has at least one staticImages, titleScreenImages, or animation reference