Skip to main content

Quick Start

1. What is Dora SSR?​

Dora SSR overview

A Short Introduction

Dora SSR is a game engine for rapid development of games on various devices. It has a built-in easy-to-use Web IDE development tool chain that supports direct game development on mobile phones, open source handhelds and other devices.

Install Dora SSR, choose your platform below, and make your first interactive scene. You can also try games in your browser.

Choose your device​

1. Install and launch​

  • Windows: install the Windows x64 MSI, then launch Dora SSR from the Start menu. Use the package with -opengl if your graphics hardware or driver cannot run the default D3D12 version.
  • macOS: extract the macOS package and open Dora, or install with brew install --cask ippclub/tap/dora-ssr.

The built-in Web IDE opens automatically in the Dora SSR window. Create your first project below.

Dora SSR opens its built-in Web IDE on Windows and macOS; shown here on macOS

Portable ZIP installation and connecting from another device are covered in Installation.

2. Create a project and add code​

  1. In the built-in Web IDE's left resource tree, right-click Workspace (or touch and hold), then select New → Folder.
  2. Enter Hello, enable Create as Project, keep the default TypeScript, and select OK.
  3. Expand Hello, open init.ts, and replace its contents with the code below. It displays a logo that moves to where you click or tap.
Create the Hello project: enter its name, enable Create as Project, choose TypeScript, and select OK

If you prefer another language, select it when creating the project and use the matching example tab.

Hello/init.ts
import {Ease, Move, Node, Sprite} from 'Dora';
const root = Node();
const sprite = Sprite("Image/logo.png");

if (sprite) {
root.addChild(sprite);
root.onTapBegan(touch => {
sprite.perform(
Move(
1, // duration in seconds
sprite.position, // start position
touch.location, // end position
Ease.OutBack // easing function
)
);
});
}

3. Run it​

Save with Ctrl + S, then click the triangular Run button (or press Ctrl + R). On macOS, use ⌘ instead of Ctrl.

On Windows/macOS, a successful run switches the same Dora SSR window from the built-in IDE to the game. Click or tap to move the logo; select the IDE tab on the left to return to editing, then use Stop to end the game.

Run Hello from the toolbar, then click or tap in the Dora SSR game window

4. Share your game​

Right-click the Hello folder and select Export → Export HTML. Extract the entire downloaded ZIP, then open its root index.html in a browser to play. Keep all accompanying files. Choose Export ZIP instead to back up or share the project for further editing.

Next, learn how to set up a scene, explore other languages, or follow the first game tutorial.

For file operations, resource imports, and export choices, see Web IDE: Everyday Operations.