Skip to content

World file format ​

A Yumina world is one JSON file. This is the reference for every part of it, written for people and for AI tools.

Most creators never read it. Studio writes the file for you, and your own AI can edit a card directly through Connect your AI. This reference is for three cases:

  • You run the open-source engine yourself, or put a card inside a game as a character.
  • Your AI tool has no connector. Give it the single-file spec and it can write a valid world for you to import.
  • You want to look up exactly how a section, a variable type, a directive or a rule works.

Spec Sections ​

SectionWhat It Covers
World SchemaTop-level WorldDefinition structure, all fields
Entries & SectionsEntry types, sections, keywords, matching, official presets
Variables & DirectivesTypes, operations, directive syntax, dot-path updates, behavior rules
Rules & ReactionsTriggers, conditions, actions, system effects, event patterns
MacrosAll macro placeholders and their replacements
Custom UIrootComponent, useYumina() API, sandboxing, built-in components
AudioTrack types, AI directives, playlists, conditional BGM
Full DownloadSingle-file spec for AI agents