#node #tree-node #game-engine #gamedev #lua-bindings #ssr #object


The lib for building Dora SSR game as wasm32-wasi that runs on multi-platform Dora SSR engine

15 releases

new 0.2.8 May 21, 2024
0.2.7 May 10, 2024
0.2.4 Apr 24, 2024
0.1.9 Apr 3, 2024
0.1.4 Dec 26, 2023

#45 in Game dev

Download history 2/week @ 2024-02-19 275/week @ 2024-02-26 16/week @ 2024-03-04 5/week @ 2024-03-11 436/week @ 2024-04-01 206/week @ 2024-04-08 319/week @ 2024-04-15 138/week @ 2024-04-22 7/week @ 2024-04-29 371/week @ 2024-05-06 9/week @ 2024-05-13

528 downloads per month

MIT license


Dora SSR

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

Key Features

  • Manages game scenes based on tree node structure.

  • Basic 2D platform game functions, including game logic and AI development framework.

  • Easy-to-use ECS module for game entity management.

  • Asynchronous processing of file read and write, resource loading and other operations.

  • Upgraded Lua binding with support for inheriting and extending low-level C++ objects.

  • Supports Yuescript language, strong expressive and concise Lua dialect.

  • Supports for the Teal language, a statically typed dialect for Lua.

  • Supports TypeScript, a statically typed superset of JavaScript that adds powerful type checking.

  • Supports TSX, allows embedding XML/HTML-like text within scripts, used with TypeScript.

  • Supports the Rust language, running on the built-in WASM runtime with Rust bindings.

  • 2D skeletal animation and physics engine support.

  • Built-in out-of-the-box Web IDE, providing file management, code inspection, completion, highlighting and definition jump.

  • Supports asynchronous operation of SQLite for real-time query and managing large game configuration data.

  • Supports reading Excel spreadsheet data and synchronizing it to SQLite tables.

  • Supports the Yarn Spinner language, making it easy to write complex game story systems.

  • Built-in machine learning algorithm framework for innovative gameplay.

  • Provides vector graphics rendering API, which can directly render SVG format files without CSS.

  • Built-in ImGui, easy to create debugging tools and UI interface.

  • Supports FLAC, OGG, MP3 and WAV multi-format audio playback.

  • Supports True Type font rendering and basic typesetting.

  • Provides open art resources and game IPs that can be used to create your own games - "Luv Sense Digital".


  • Quick start

    • Android

        1. Download and install the APK package on the running terminal for game dev.
        1. Run the software, and access the server address displayed by the software through the browser of a PC (tablet or other development device) on the LAN.
        1. Start game development.
    • Windows, macOS

        1. Download and run the software.
          • Get software on macOS with Homebrew using
          brew tap ippclub/dora-ssr
          brew install --cask dora-ssr
        1. Run the software and access the server address displayed by the software through a browser.
        1. Start game development.
    • Linux

        1. Installation.
        • Ubuntu Jammy

          sudo add-apt-repository ppa:ippclub/dora-ssr
          sudo apt update
          sudo apt install dora-ssr
        • Debian Bookworm

          sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 9C7705BF
          sudo add-apt-repository -S "deb https://ppa.launchpadcontent.net/ippclub/dora-ssr/ubuntu jammy main"
          sudo apt update
          sudo apt install dora-ssr
        1. Run the software and access the server address displayed by the software through a browser.
        1. Start game development.
  • Engine project development

    For the installation and configuration of Dora SSR project development, see Official Documents for details.

Quick Start

  1. Step 1: Create a new project

    • In the browser, open the right-click menu of the game resource tree on the left side of the Dora Dora editor.

    • Click on the menu item New and choose to create a new folder named Hello.

  2. Step 2: Write game code

    • Create a new project in command line.

      rustup target add wasm32-wasi
      cargo new hello-dora --name init
      cd hello-dora
      cargo add dora_ssr
    • Write code in src/main.rs.

      use dora_ssr::*;
      fn main () {
        let mut sprite = match Sprite::with_file("Image/logo.png") {
          Some(sprite) => sprite,
          None => return,
        let mut sprite_clone = sprite.clone();
        sprite.schedule(once(move |mut co| async move {
          for i in (1..=3).rev() {
            p!("{}", i);
            sleep!(co, 1.0);
          p!("Hello World");
            ActionDef::scale(0.1, 1.0, 0.5, EaseType::Linear),
            ActionDef::scale(0.5, 0.5, 1.0, EaseType::OutBack),
    • Build it into WASM file.

      cargo build --release --target wasm32-wasi
    • Upload it to engine to run. From Dora SSR Web IDE, Open the right-click menu of the game resource tree on the created folder Hello. Click on the menu item Upload and choose the compiled WASM file named init.wasm to upload.

    • Or use a helper script upload.py with commad python3 upload.py "" "Hello" inside your Rust project folder to upload WASM file. The IP address is the Dora SSR Web IDE address.

  3. Step 3: Run the game

    Click the 🎮 icon in the lower right corner of the editor, then click the menu item Run. Or press the key combination Ctrl + r.

  4. Step 4: Publish the game

    • Open the right-click menu of the project folder just created through the game resource tree on the left side of the editor and click the Download option.

    • Wait for the browser to pop up a download prompt for the packaged project file.

For more detailed tutorials, please check official documents.



Dora SSR uses the MIT License.


~19K SLoC