Skip to main content

Asset Manager

The Asset Manager is where you import, organize, and manage all media files used in your visual novel. Access it by switching to the Assets mode from the mode switcher, or by clicking the Assets tab in the sidebar.

Asset Categories​

Assets are organized into four categories:

  • Backgrounds — Full-screen images used as scene backgrounds.
  • Characters — Character definitions, each containing a name, color, and a set of portrait images for different expressions.
  • Audio — Sound effects (SFX) and background music (BGM) tracks.
  • Sprites — Additional images used for UI decorations, item icons, overlays, and other visual elements.

Uploading Assets​

To add assets to your project:

  • Click the Upload button and select files from your computer.
  • Drag and drop files directly from your file manager onto the Asset Manager panel.

Multiple files can be uploaded at once. Supported formats include PNG, JPG, and WebP for images, and MP3, OGG, and WAV for audio. Files are uploaded to cloud storage via Supabase and are available across all your editing sessions.

Character Manager​

Characters have a dedicated management interface. When you click on a character in the asset list, the Character Manager opens with three tabs:

Portraits Tab​

  • View all portraits (expression images) for this character as a thumbnail grid.
  • Bulk upload — Drag multiple portrait images at once; they are added as new portraits.
  • Rename — Click a portrait's label to rename it (e.g., "happy", "sad", "angry").
  • Set default — Mark one portrait as the default expression.
  • Delete — Remove individual portraits.

Dialogs Tab​

  • Configure character-specific theme overrides: textbox color, name color, and other styling that applies when this character is speaking.

Appearances Tab​

  • View statistics on where this character is used across the project.

Character Properties​

Each character has the following properties:

  • Name — The display name shown in dialog.
  • Color — The color used for the character's name in the textbox.
  • Tags — Organizational tags for filtering and searching.
  • Description — A text description for your reference.
  • Default portrait — Which portrait to use when none is specified.
  • Emotion tags — Map each portrait to an emotion label (e.g., portrait "smile_02" tagged as "happy") for easier selection.
  • Theme overrides — Per-character visual styling (textbox background, name color, etc.) that automatically applies when this character speaks.

Audio Preview​

Audio assets display a play button. Click it to preview the sound effect or music track directly in the Asset Manager without needing to run the project.

Asset Usage Tracking​

Each asset's detail view includes a "Used in" section that lists all nodes referencing that asset. This helps you understand which parts of your project depend on a given asset before renaming or deleting it.

Search and Filtering​

Use the search bar at the top of the Asset Manager to filter assets by name. The category tabs below the search bar let you filter by asset type. As your library grows, clear naming conventions and tags keep things manageable.

Cloud Storage​

All assets are stored in Supabase cloud storage. They persist across sessions and devices. When you open a project, assets are loaded from the cloud. Storage quotas depend on your account tier.