VaelisDocs
v1.0.0
Reference · v1.0.0

Scene JSON

Reference the Vaelis scene serialization format.

View as Markdownllms.txt

#Top-level shape

json
{
  "sceneName": "Level1",
  "hierarchyFolders": [],
  "entities": []
}

#Entity shape

json
{
  "id": "e12",
  "name": "Target",
  "tag": "Target",
  "active": true,
  "folderId": null,
  "prefabId": null,
  "prefabOverrides": {},
  "components": {
    "Transform": { "x": 0, "y": 0, "z": 0, "rotation": 0, "scaleX": 1, "scaleY": 1 }
  }
}

#Component registry

SceneSerializer recognizes the runtime component types: Transform, Camera, SpriteRenderer, ShapeRenderer, StrokePath, TextRenderer, SpeechBubble, ChatLog, TextInput, Joystick, Rigidbody2D, Collider2D, Joint2D, Light, ShadowCaster, CharacterController, LightingSettings, SpriteAnimation, AudioSource, AudioListener, Tileset, Tilemap, NavWorld2D, NavAgent2D and Script.

#Authoring rules

Scene files are plain JSON and can be authored by the editor, generated by tools or hand-written. The serializer deep-copies folder/prefab override data so saved snapshots do not alias live state.

#Default camera

A fresh/default scene uses a Main Camera entity with tag MainCamera, active state enabled, Transform at 0,0 and a main Camera flag.