Manual

Scene Authoring Basics

This guide shows how to build one playable scene from scratch.

Goal

By the end, you will have:

  • a scene with width and height
  • a background tile map
  • a player object
  • a saved scene file that runs in sendama play

Step 1: Open Or Create A Scene

In the editor:

  1. open Hierarchy
  2. select the scene root
  3. set scene values in Inspector

Start with:

  • Name: Level01
  • Width: 160
  • Height: 40

Step 2: Set Environment Maps

Still on the scene root, set:

  • Environment Tile Map to a .tmap file for visible background
  • Environment Collision Map (optional) when you want walls/floor blocking

If you do not have maps yet, create them in Assets -> Shift+A and come back.

Step 3: Add A Player Object

In Hierarchy:

  1. press Shift+A
  2. choose GameObject
  3. rename it to Player

In Inspector set:

  • transform position
  • renderer texture path
  • optional components

Step 4: Place Objects Visually

Use Main -> Scene.

  • Shift+Q: select mode
  • Shift+W: move mode
  • Shift+E: pan mode

Use arrow keys to move selected objects in move mode.

Step 5: Save The Scene

Press Ctrl+S.

This is important: scene and hierarchy edits are not final until you save.

Example Scene File

A small scene file can look like this:

<?php

return [
  'name' => 'Level01',
  'width' => 160,
  'height' => 40,
  'environmentTileMap' => 'Maps/level01.tmap',
  'gameObjects' => [
    [
      'name' => 'Player',
      'type' => 'GameObject',
      'transform' => [
        'position' => ['x' => 8, 'y' => 20],
      ],
      'renderer' => [
        'texture' => 'Textures/player.texture',
      ],
    ],
  ],
];

Quick Troubleshooting

If the scene does not look right:

  • object missing: verify renderer texture path
  • object in wrong place: verify transform position
  • background missing: verify tile map path
  • changes lost: make sure Ctrl+S was used

Related Guides