多萝珍奇引擎（Dora SSR）

English | 中文

Dora SSR是一个用于多种设备上快速开发2D游戏的游戏引擎。它内置易用的开发工具链，支持在手机、开源掌机等设备上直接进行游戏开发。

Dora SSR 项目现已加入开放原子开源基金会

我们很高兴地宣布，Dora SSR 项目现已成为开放原子开源基金会的官方捐赠和孵化筹备期项目。这一新的发展阶段标志着我们致力于建设一个更开放、更协作的游戏开发环境的坚定承诺。

关于开放原子开源基金会

开放原子开源基金会（Open Atom Foundation）是一个非盈利组织，旨在支持和推广开源技术的发展。在该基金会的大家庭中，Dora SSR 会利用更广泛的资源和社区支持，以推动项目的发展和创新。更多信息请查看基金会官网。

主要特点

功能	描述
树形节点	基于树形节点结构管理游戏场景。
2D 平台游戏	基础的 2D 平台游戏功能，包括游戏逻辑和 AI 开发框架。
ECS	易用的 ECS 模块，便于游戏实体管理。
异步处理	异步处理的文件读写、资源加载等操作。
Lua	升级的 Lua 绑定，支持继承和扩展底层 C++ 对象。
YueScript	支持 YueScript 语言，强表达力且简洁的 Lua 方言。
Teal	支持 Teal 语言，编译到 Lua 的静态类型语言。
TypeScript	支持 TypeScript 语言，一门静态类型的 JavaScript 语言的超集，添加了强大的类型检查功能。
TSX	支持 TSX，允许在脚本中嵌入类似 XML/HTML 的文本，与 TypeScript 一起使用。
Rust	支持 Rust 语言，运行在内置的 WASM 绑定和 VM 上。
2D 骨骼动画	支持 2D 骨骼动画，包括：Spine2D、DragonBones 以及内置系统。
2D 物理引擎	支持 2D 物理引擎，使用：PlayRho。
Web IDE	内置开箱即用的 Web IDE，提供文件管理，代码检查、补全、高亮和定义跳转。
数据库	支持异步操作 SQLite，进行大量游戏配置数据的实时查询和写入。
Excel	支持 Excel 表格数据读取，支持同步到 SQLite 库表。
CSS 布局	提供游戏场景通过 CSS 进行自适应的 Flex 布局的功能。
特效系统	支持 Effekseer 特效系统的功能。
机器学习	内置用于创新游戏玩法的机器学习算法框架。
Yarn Spinner	支持 Yarn Spinner 语言，便于编写复杂的游戏故事系统。
矢量图形	提供矢量图形渲染 API，可直接渲染无 CSS 的 SVG 格式文件。
ImGui	内置 ImGui，便于创建调试工具和 UI 界面。
音频	支持 FLAC、OGG、MP3 和 WAV 多格式音频播放。
True Type	支持 True Type 字体的渲染和基础排版。
L·S·D	提供可用于制作自己游戏的开放美术素材和游戏 IP —— 《灵数奇缘》。

示例项目

示例项目 - Loli War

示例项目 - Zombie Escape

示例项目 - Dismentalism

示例项目 - Luv Sense Digital

安装配置

快速上手
- Android
  - 1、在游戏的运行终端下载并安装APK包。
  - 2、运行软件，通过局域网内的PC（平板或其他开发设备）的浏览器访问软件显示的服务器地址。
  - 3、开始游戏开发。
- Windows、macOS
  - 1、下载并运行软件。
    - 在macOS上也可以通过 Homebrew 进行软件安装。
      brew tap ippclub/dora-ssr brew install --cask dora-ssr
  - 2、运行软件，通过浏览器访问软件显示的服务器地址。
  - 3、开始游戏开发。
- Linux
  - 1、安装软件：
    - 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
  - 2、运行软件，通过浏览器访问软件显示的服务器地址。
  - 3、开始游戏开发。
引擎项目开发

进行Dora SSR项目开发的安装配置，详见官方文档。

快速入门

第一步：创建一个新项目
- 在浏览器中，打开Dora Dora编辑器左侧游戏资源树的右键菜单。
- 点击菜单项New，选择新建文件夹。
第二步：编写游戏代码
- 在项目文件夹下新建游戏入口代码文件，选择 Lua (Yuescript, Teal, Typescript 或 TSX) 语言命名为init。
- 编写Hello World代码：

Lua

local _ENV = Dora

local sprite = Sprite("Image/logo.png")
sprite:schedule(once(function()
  for i = 3, 1, -1 do
    print(i)
    sleep(1)
  end
  print("Hello World")
  sprite:perform(Sequence(
    Scale(0.1, 1, 0.5),
    Scale(0.5, 0.5, 1, Ease.OutBack)
  ))
end))

Teal

local sleep <const> = require("sleep")
local Ease <const> = require("Ease")
local Scale <const> = require("Scale")
local Sequence <const> = require("Sequence")
local once <const> = require("once")
local Sprite <const> = require("Sprite")

local sprite = Sprite("Image/logo.png")
if not sprite is nil then
  sprite:schedule(once(function()
    for i = 3, 1, -1 do
      print(i)
      sleep(1)
    end
    print("Hello World")
    sprite:perform(Sequence(
      Scale(0.1, 1, 0.5),
      Scale(0.5, 0.5, 1, Ease.OutBack)
    ))
  end))
end

Yuescript

有关 Dora SSR 所支持的 Yuescript 这门小众语言的故事在这里。

_ENV = Dora

with Sprite "Image/logo.png"
   \schedule once ->
     for i = 3, 1, -1
       print i
       sleep 1
     print "Hello World!"
     \perform Sequence(
       Scale 0.1, 1, 0.5
       Scale 0.5, 0.5, 1, Ease. OutBack
     )

Typescript

import {Sprite, Ease, Scale, Sequence, once, sleep} from 'Dora';

const sprite = Sprite("Image/logo.png");
if (sprite) {
  sprite.schedule(once(() => {
    for (let i of $range(3, 1, -1)) {
      print(i);
      sleep(1);
    }
    print("Hello World");
    sprite.perform(Sequence(
      Scale(0.1, 1, 0.5),
      Scale(0.5, 0.5, 1, Ease.OutBack)
    ))
  }));
}

TSX

使用 TSX 语言来创建 Dora SSR 的游戏场景是一个比较容易上手的选择。新手教程可以参见这里。

import {React, toNode, useRef} from 'DoraX';
import {ActionDef, Ease, Sprite, once, sleep} from 'Dora';

const actionRef = useRef<ActionDef.Type>();
const spriteRef = useRef<Sprite.Type>();

const onUpdate = once(() => {
  for (let i of $range(3, 1, -1)) {
    print(i);
    sleep(1);
  }
  print("Hello World");
  if (actionRef.current && spriteRef.current) {
    spriteRef.current.perform(actionRef.current);
  }
});

toNode(
  <sprite
    ref={spriteRef}
    file='Image/logo.png'
    onUpdate={onUpdate}
  >
    <action ref={actionRef}>
      <sequence>
        <scale time={0.1} start={1} stop={0.5}/>
        <scale time={0.5} start={0.5} stop={1} easing={Ease.OutBack}/>
      </sequence>
    </action>
  </sprite>
);

Rust

也支持使用 Rust 语言来编写游戏代码，编译为 WASM 文件，命名为 init.wasm 再上传到引擎中加载运行。详情见这里。

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");
    sprite_clone.perform_def(ActionDef::sequence(&vec![
      ActionDef::scale(0.1, 1.0, 0.5, EaseType::Linear),
      ActionDef::scale(0.5, 0.5, 1.0, EaseType::OutBack),
    ]));
  }));
}

第三步：运行游戏

点击编辑器右下角🎮图标，然后点击菜单项Run。或者按下组合键Ctrl + r。
第四步：发布游戏
- 通过编辑器左侧游戏资源树，打开刚才新建的项目文件夹的右键菜单，点击Download选项。
- 等待浏览器弹出已打包项目文件的下载提示。

更详细的教程，请查看官方文档。

文档

社区

贡献

欢迎参与Dora SSR的开发和维护。请查看贡献指南了解如何提交Issue和Pull Request。

许可证

Dora SSR使用MIT许可证。原为Dorothy SSR项目，项目名称现处于更名程序中。

Li Jin / Dora-SSR

多萝珍奇引擎（Dora SSR）

English | 中文

Dora SSR 项目现已加入开放原子开源基金会

关于开放原子开源基金会

主要特点

示例项目

安装配置

快速入门

文档

社区

贡献

许可证

简介

发行版 (8)

贡献者

近期动态

Li Jin / Dora-SSR .gitee-modal { width: 500px !important; }

多萝珍奇引擎（Dora SSR）

English | 中文

Dora SSR 项目现已加入开放原子开源基金会

关于开放原子开源基金会

主要特点

示例项目

安装配置

快速入门

文档

社区

贡献

许可证

简介

发行版 (8)

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

Li Jin / Dora-SSR