Dora Project, Special Super Rare Edition.
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.
We are delighted to announce that the Dora SSR project has officially become a donation and incubation preparatory project under the Open Atom Foundation. This new stage of development signifies our steadfast commitment to building a more open and collaborative gaming development environment.
The Open Atom Foundation is a non-profit organization dedicated to supporting and promoting the development of open-source technologies. Within this foundation's community, Dora SSR will utilize broader resources and community support to propel the project's development and innovation. For more information, please visit the foundation's official website.
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
Windows, macOS
brew tap ippclub/dora-ssr
brew install --cask dora-ssr
Linux
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
Engine project development
For the installation and configuration of Dora SSR project development, see Official Documents for details.
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.
Step 2: Write game code
Create a new game entry code file of Lua (Yuescript, Teal, Typescript or TSX) under the project folder, named init
.
Write Hello World code:
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))
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
_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
)
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)
))
}));
}
import { React, toNode, useRef } from 'dora-x';
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>
);
init.wasm
, upload it to engine to run.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),
]));
}));
}
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
.
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.
Welcome to participate in the development and maintenance of Dora SSR. Please see Contributing Guidelines to learn how to submit Issues and Pull Requests.
Dora SSR uses the MIT License. The project was originally named Dorothy SSR and is currently undergoing a renaming process.