Skip to content
NovyJump Docs

Media & Resolution Specs

This page defines the author-facing technical constraints for assets and layout.

Screen resolution and coordinate space

  • JumpDrive renders on a 1080×1920 portrait canvas.
  • Coordinates are in a screen space where:
    • (0, 0) is top-left
    • x increases to the right
    • y increases downward

Renpy show ... at <tag> mapping

The converter maps a limited set of Renpy transform tags into JumpDrive pixel coordinates:

  • left => (0, 1920)
  • right => (1080, 1920)
  • center / default => (540, 1920)
  • truecenter => (540, 960)
  • topleft / reset => (0, 0)
  • topright => (1080, 0)
  • offscreenleft => (-4000, 1920)
  • offscreenright => (4000, 1920)

If you need more positioning detail, see Transforms.

Supported media types

Images

Recognized as image assets by the converter:

  • .avif
  • .png
  • .jpg
  • .jpeg
  • .webp
  • .svg
  • .gif
  • .bmp

Audio

Recognized as audio assets by the converter:

  • .opus
  • .mp3
  • .mp2
  • .flac
  • .wav
  • .pcm

Important note about .ogg:

  • The converter’s current implementation treats .ogg as a video extension first.
  • Until that is corrected, avoid .ogg for audio in NovyJump uploads.

Video

Recognized as video assets by the converter:

  • .mp4
  • .webm
  • .mkv
  • .ogv
  • .avi
  • (plus several codec-specific extensions)

Notes:

  • Video files may be accepted as assets during conversion, but full JumpDrive playback support may be limited depending on the runtime.

How assets are resolved

Case-insensitive matching

Asset resolution is case-insensitive.

To avoid surprises, use explicit string paths where the grammar allows them.

Notes:

  • For backgrounds, scene does not accept string paths; use an image alias with a string path, then scene the alias.
  • For audio, play supports string paths.

Examples:

  • Images:
    • image bg_room = "images/bg_room.png"
  • Audio:
    • "music/theme.mp3"
    • "game/music/theme.mp3"

Default lookup locations

When you reference an asset by name only (for example scene bg_room), the converter tries common defaults:

  • Images:
    • ./images/
  • Audio:
    • ./audio/
    • ./sound/
    • ./sounds/
    • ./music/
    • ./voice/
    • ./sfx/

Referencing assets from Ink

In Ink, assets are referenced by filename inside NovyJump’s multimedia directives (see Supported Ink Syntax). The same resolution rules, supported formats, and coordinate space above apply — including the .ogg caveat for audio.

bg_room.png
# sprite: alice, alice_happy.png, happy, x=540, y=960
# music: theme.mp3, channel=bgm, loop=true
  • Sprite/scene positions use the same 1080×1920 screen space (x=540, y=960 is centre).
  • Give the filename with its extension so the converter classifies the asset type correctly.
  • Audio format guidance is identical to Ren’Py: prefer .mp3 / .opus / .wav; avoid .ogg.