Overview

Relevant source files

• Assets/Doc/en/welcome.md
• Assets/Doc/zh-Hans/welcome.md
• Docs/docs/tutorial/120.dev-configuration.mdx
• Docs/i18n/zh-Hans/code.json
• Docs/i18n/zh-Hans/docusaurus-plugin-content-blog/options.json
• Docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/tutorial/120.dev-configuration.mdx
• Docs/i18n/zh-Hans/docusaurus-theme-classic/footer.json
• Docs/i18n/zh-Hans/docusaurus-theme-classic/navbar.json
• Docs/src/components/HomepageFeatures/index.tsx
• Docs/src/pages/index.module.css
• Docs/src/pages/index.tsx
• Projects/Android/Dora/app/build.gradle
• Projects/Windows/Dora/Resource.rc
• Projects/iOS/Dora/Info.plist
• Projects/macOS/Dora/Info.plist
• README.md
• README.zh-CN.md
• Source/Basic/Application.cpp

Dora SSR (多萝珍奇引擎) is a cross-platform 2D game engine designed for rapid game development on various devices. It features a built-in, easy-to-use Web IDE development toolchain that enables direct game development on mobile phones, open-source handhelds, and desktop platforms README.md22-23 This overview introduces the engine's architecture, core features, and development philosophy.

What is Dora SSR

Dora SSR is a game engine that prioritizes a "develop-on-device" workflow. By integrating a web-based IDE directly into the engine runtime, developers can run the engine on a target device (like an Android phone or a Linux handheld) and connect to it via a web browser from another machine for live development and debugging README.md57-59

Technical Foundation:

• Core Engine: C++20 implementation providing high-performance scene graph and ECS systems Projects/Android/Dora/app/build.gradle17
• Multi-Runtime Layer: Support for Lua 5.1, TypeScript (via TSTL), and a WASM runtime for high-performance extensions README.md65-69
• Graphics Backend: Powered by bgfx for multi-platform rendering abstraction Source/Basic/Application.cpp76-80
• Development Tools: A React-based Web IDE with Monaco Editor integration and an AI-powered CodingAgent README.md57-58

Supported Platforms:

Platform	Architectures	Distribution
Android	armeabi-v7a, arm64-v8a, x86_64	APK Projects/Android/Dora/app/build.gradle16
Windows	x86_64	EXE Projects/Windows/Dora/Resource.rc83
macOS	x86_64, arm64 (Universal)	APP Projects/macOS/Dora/Info.plist19-24
iOS	arm64	IPA Projects/iOS/Dora/Info.plist17-24
Linux	x86_64, arm64	Native Binaries
HarmonyOS	-	README.md39

For details, see What is Dora SSR.

Sources: README.md22-39 Source/Basic/Application.cpp32-34 Projects/Android/Dora/app/build.gradle7-11

Architecture Overview

Dora SSR uses a layered architecture to separate low-level platform concerns from high-level game logic and development tools.

System Component Diagram

Key Components:

• Application: Manages the main loop, frame timing (_targetFPS), and platform-specific windowing via SDL Source/Basic/Application.cpp86-112
• Director: The root of the scene graph, managing render targets and cameras.
• WasmRuntime: Provides the interface for running high-performance logic written in Rust or Wa via WebAssembly README.md68

Sources: Source/Basic/Application.cpp86-120 README.md57-81

Multi-Language Support

Dora SSR supports multiple programming languages, allowing developers to choose the best tool for their specific needs.

Language Mapping to Runtime

Language	Path	Target
Lua	Native	Lua VM README.md65
YueScript	Transpiled	Lua VM README.md67
TypeScript / TSX	Transpiled (TSTL)	Lua VM README.md66
Rust	Compiled	WASI README.md68
Wa	Compiled	WASI README.md68
C#	Native	DLL README.md69

Sources: README.md65-70 Assets/Doc/en/welcome.md15-21

Key Features

• Integrated Web IDE: Browser-based workflow with file management and code inspection README.md57
• AI Coding Agent: Built-in assistant for project-scoped code analysis and editing README.md58
• Advanced Animation: Support for Spine2D, DragonBones, and built-in skeletal animation README.md79
• 2D Physics: Integrated PlayRho physics engine README.md79
• Machine Learning: Built-in framework for decision trees and AI README.md82
• Retro Development: Support for embedding TIC-80 fantasy console nodes README.md86
• Visual Programming: Integrated Blockly support for Scratch-like logic creation README.md70

Next Steps

To get started with Dora SSR, explore the following child pages:

• What is Dora SSR: A deeper dive into the core concepts, architecture philosophy, and the remote development workflow.
• Installation and Setup: Instructions for installing the engine on your preferred platform (Windows, macOS, Linux, Android, or iOS).
• Quick Start Tutorial: A hands-on guide to creating your first project and running it on your device.

Sources: README.md22-31 README.zh-CN.md22-31