# Dora-SSR
**Repository Path**: ippclub/Dora-SSR
## Basic Information
- **Project Name**: Dora-SSR
- **Description**: Dora SSR 是一款跨平台的游戏引擎，提供前沿或是具有探索性的游戏开发功能。它内置了Web IDE，提供了可以轻轻松松通过浏览器访问的快捷游戏开发环境，特别适合于在新兴市场如国产游戏掌机和其它移动电子设备上直接进行游戏开发和编程学习。
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://ippclub.gitee.io/Dora-SSR/zh-Hans/
- **GVP Project**: Yes
## Statistics
- **Stars**: 226
- **Forks**: 40
- **Created**: 2016-12-08
- **Last Updated**: 2026-04-17
## Categories & Tags
**Categories**: game-dev
**Tags**: None
## README
# 多萝珍奇引擎（Dora SSR）
Web IDE · Coding Agent
真机开发游戏引擎
|
|
#### [English](README.md) | 中文
[](https://ippclub.org) [](https://openatom.org/project/RJHufNnSKtDZ) [](https://deepwiki.com/IppClub/Dora-SSR) [](https://qm.qq.com/q/VnzYhvCDgy) [](https://discord.gg/ZfNBSKXnf9)
Dora SSR 是一个用于多种设备上快速开发游戏的游戏引擎。它内置易用的 Web IDE 开发工具链，支持在手机、开源掌机等设备上直接进行游戏开发。
## 快速入口
- [快速体验](https://dora-ssr.net/zh-Hans/docs/tutorial/quick-start)
- [功能示例代码](https://github.com/IppClub/Dora-Example/tree/master/Example)
- [完整项目示例](https://github.com/IppClub/Dora-Demo)
- [最新发布下载](https://github.com/ippclub/Dora-SSR/releases/latest)
## 技术概览
|方向|内容|
|-|-|
|开发方式|`Web IDE` + `Coding Agent` + 在目标设备运行引擎、通过浏览器接入的实时游戏开发流程|
|语言生态|`Lua` / `TypeScript` / `TSX` / `Teal` / `YueScript` / `Wa` / `Rust` / `C#`|
|运行平台|`Android` / `Windows` / `Linux` / `macOS` / `iOS` / [鸿蒙](https://github.com/IppClub/ohos_dora_ssr/blob/main/README.zh-CN.md)|
## 从这里开始
- 功能示例：参考 [Dora-Example](https://github.com/IppClub/Dora-Example/tree/master/Example) 了解各项 API 与引擎能力的最小用法。
- 完整项目：参考 [Dora-Demo](https://github.com/IppClub/Dora-Demo) 了解如何组织资源、脚本与游戏逻辑。
### 精选示例项目
- [示例项目 - Loli War](https://github.com/IppClub/Dora-Demo/tree/main/Loli%20War)
- [示例项目 - Zombie Escape](https://github.com/IppClub/Dora-Demo/tree/main/Zombie%20Escape)
- [示例项目 - Dismentalism](https://github.com/IppClub/Dora-Demo/tree/main/Dismantlism)
- [示例项目 - Luv Sense Digital](https://github.com/IppClub/LSD)
## 安装配置
### Android
- 获取：在目标设备上下载并安装 [APK](https://github.com/ippclub/Dora-SSR/releases/latest) 包。
- 运行：启动软件，并通过局域网内 PC、平板或其他开发设备上的浏览器访问软件显示的地址。
- 开始：进入 Web IDE 开始游戏开发。
### Windows
- 依赖：先安装 Visual Studio 2022 的 X86 Visual C++ 可再发行组件包，可从[微软网站](https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170)下载。
- 获取：下载并解压[软件](https://github.com/ippclub/Dora-SSR/releases/latest)。
- 运行：启动软件，并通过浏览器访问软件显示的地址。
- 开始：进入 Web IDE 开始游戏开发。
### macOS
- 获取：下载并解压[软件](https://github.com/ippclub/Dora-SSR/releases/latest)，或通过 [Homebrew](https://brew.sh) 安装：
```sh
brew install --cask ippclub/tap/dora-ssr
```
- 运行：启动软件，并通过浏览器访问软件显示的地址。
- 开始：进入 Web IDE 开始游戏开发。
### Linux
- 获取：按系统版本安装软件。
- Ubuntu Jammy
```sh
sudo add-apt-repository ppa:ippclub/dora-ssr
sudo apt update
sudo apt install dora-ssr
```
- Debian Bookworm
```sh
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
```
- 运行：启动软件，并通过浏览器访问软件显示的地址。
- 开始：进入 Web IDE 开始游戏开发。
### Linux 软件源
- Ubuntu Jammy：
```sh
sudo add-apt-repository ppa:ippclub/dora-ssr
sudo apt update
sudo apt install dora-ssr
```
- Debian Bookworm：
```sh
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
```
### 编译构建引擎
- 需要自行编译 Dora SSR 项目时，详见[官方文档](https://dora-ssr.net/zh-Hans/docs/tutorial/dev-configuration)。
## 快速上手
- 第一步：创建一个新项目
- 在浏览器中，打开 Dora Dora 编辑器左侧 `工作空间` 的右键菜单。
- 点击菜单项 `新建`，选择新建文件夹。
- 第二步：编写游戏代码
- 在项目文件夹下新建游戏入口代码文件，选择 Lua (YueScript, Teal, TypeScript 或 TSX) 语言命名为 `init`。
- 编写 Hello World 代码：
- **Lua**
```lua
local _ENV = Dora
local sprite = Sprite("Image/logo.png")
sprite: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**
```lua
local sleep = require("sleep")
local Ease = require("Ease")
local Scale = require("Scale")
local Sequence = require("Sequence")
local Sprite = require("Sprite")
local sprite = Sprite("Image/logo.png")
if not sprite is nil then
sprite: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 这门小众语言的故事在[这里](https://dora-ssr.net/zh-Hans/blog/2024/4/17/a-moon-script-tale)。
```moonscript
_ENV = Dora
with Sprite "Image/logo.png"
\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**
```typescript
import { Sprite, Ease, Scale, Sequence, sleep } from 'Dora';
const sprite = Sprite("Image/logo.png");
if (sprite) {
sprite.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 的游戏场景是一个比较容易上手的选择。新手教程可以参见[这里](https://dora-ssr.net/zh-Hans/blog/2024/4/25/tsx-dev-intro)。
```tsx
import { React, toNode } from 'DoraX';
import { Ease } from 'Dora';
toNode(
)?.slot("Count", (_, param) => print(param));
```
- **Wa**
你可以使用 Wa 作为一门脚本语言，运行在 Dora SSR 内置的 WASM 运行时上，并获得热重载的开发体验。
```go
import "dora"
func init {
sprite := dora.NewSpriteWithFile("Image/logo.png")
sprite.RunActionDef(
dora.ActionDefSequence(&[]dora.ActionDef{
dora.ActionDefEvent("Count", "3"),
dora.ActionDefDelay(1),
dora.ActionDefEvent("Count", "2"),
dora.ActionDefDelay(1),
dora.ActionDefEvent("Count", "1"),
dora.ActionDefDelay(1),
dora.ActionDefScale(0.1, 1, 0.5, dora.EaseLinear),
dora.ActionDefScale(0.5, 0.5, 1, dora.EaseOutBack),
}),
false,
)
sprite.Slot("Count", func(stack: dora.CallStack) {
stack.Pop()
param, _ := stack.PopStr()
dora.Println(param)
})
}
```
- **Rust**
Dora SSR 也支持使用 Rust 语言来编写游戏代码，编译为 WASM 文件，命名为 `init.wasm` 再上传到引擎中加载运行。详情见[这里](https://dora-ssr.net/zh-Hans/blog/2024/4/15/rusty-game-dev)。
```rust
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),
]));
}));
}
```
- 第三步：运行游戏
点击编辑器右下角 `🎮` 图标，然后点击菜单项 `运行`。或者按下组合键 `Ctrl + r`。
- 第四步：发布游戏
- 通过编辑器左侧游戏资源树，打开刚才新建的项目文件夹的右键菜单，点击 `下载` 选项。
- 等待浏览器弹出已打包项目文件的下载提示。
更详细的教程，请查看[官方文档](https://dora-ssr.net/zh-Hans/docs/tutorial/quick-start)。
## 文档
- [API参考](https://dora-ssr.net/zh-Hans/docs/api/intro)
- [教程](https://dora-ssr.net/zh-Hans/docs/tutorial/quick-start)
## 社区
- [QQ群：512620381](https://qm.qq.com/cgi-bin/qm/qr?k=7siAhjlLaSMGLHIbNctO-9AJQ0bn0G7i&jump_from=webapi&authKey=Kb6tXlvcJ2LgyTzHQzKwkMxdsQ7sjERXMJ3g10t6b+716pdKClnXqC9bAfrFUEWa)
- [Discord](https://discord.gg/ZfNBSKXnf9)
## 贡献
欢迎参与 Dora SSR 的开发和维护。请查看[贡献指南](CONTRIBUTING.zh-CN.md)了解如何提交 Issue 和 Pull Request。
## Dora SSR 项目现已加入开放原子开源基金会
我们很高兴地宣布，Dora SSR 项目现已成为开放原子开源基金会的捐赠和孵化期项目。这一新的发展阶段标志着我们致力于建设一个更开放、更协作的游戏开发环境的坚定承诺。
### 关于开放原子开源基金会
开放原子开源基金会（Open Atom Foundation）是一个非盈利组织，旨在支持和推广开源技术的发展。在该基金会的大家庭中，Dora SSR 会利用更广泛的资源和社区支持，以推动项目的发展和创新。更多信息请查看[基金会官网](https://openatom.org/)。
## 许可证
Dora SSR 使用 [MIT 许可证](LICENSE)。
> [!NOTE]
> 请注意，Dora SSR 集成了 Spine 运行时库，这是一个**商业软件**。在你的项目中使用 Spine 运行时需要获取 Esoteric Software 提供有效的商业许可证。有关获取许可证的更多详细信息，请访问 [Spine 官方网站](http://esotericsoftware.com/)。
> 请确保遵守所有许可要求，再在项目中使用 Spine 运行时。或者可以使用同样集成的开源的 **DragonBones** 系统作为动画系统的替代方案。如果你只需要创建比较简单的动画，也可以使用 Dora SSR 提供的 Model 动画模块看是否能满足需要。 