Engine Dev Configuration

1. Get the Source

git clone https://github.com/ippclub/Dora-SSR.git

2. Game Engine Runtime Development

2.1 Windows

1. Install Visual Studio Community 2022.
2. Open the project file in the IDE: Projects/Windows/Dora.sln.
3. Compile, debug, and run the project.

2.2 macOS

1. Install latest Xcode.
2. Open the project file in the IDE: Projects/macOS/Dora.xcodeproj.
3. Compile, debug, and run the project.

2.3 iOS

1. Install latest Xcode.
2. Open the project file in the IDE: Projects/iOS/Dora.xcodeproj.
3. Compile, debug, and run the project.

2.4 Android

1. Manually generate Lua bindings.

   # ubuntu
   sudo apt-get install lua5.1
   sudo apt-get install -y luarocks
   sudo luarocks install luafilesystem
   cd Tools/tolua++
   lua tolua++.lua
   
   # macOS
   cd Tools/tolua++
   ./build.sh
   
   # Windows
   cd Tools\tolua++
   build.bat

2. Install latest Android Studio.

3. Open the project directory in the IDE: Projects/Android/Dora.

4. Compile, debug, and run the project.

2.5 Linux

Ubuntu, Debian

1. Manually generate Lua bindings.

   sudo apt-get install lua5.1
   sudo apt-get install -y luarocks
   sudo luarocks install luafilesystem
   cd Tools/tolua++
   lua tolua++.lua

2. Install dependent packages.

   sudo apt-get install -y libsdl2-dev libgl1-mesa-dev libssl-dev

3. Run the compile scripts.

   • For the first time build

   # For arm architecture
   cd Projects/Linux
   make arm
   
   # For x86_64 architecture
   cd Projects/Linux
   make x86_64
   • For incremental build

   cd Projects/Linux
   make

4. Run the generated software.

   cd Assets
   ../Projects/Linux/build/dora-ssr
   
   # Or specify the resource directory with command line arguments
   ./Projects/Linux/build/dora-ssr --asset Assets

ArchLinux

1. Install dependent packages.

   sudo pacman -S lua51 luarocks sdl2 openssl gcc make cmake --needed
   # Because the lua version must be 5.1,you need to use lua 5.1 instead of the newest version of lua
   # The easiest way is using 'ln' to create a soft link
   sudo ln -s /usr/bin/lua5.1 /usr/local/bin/lua

2. Manually generate Lua bindings.

   sudo luarocks --lua-version 5.1 install luafilesystem
   cd Tools/tolua++
   lua5.1 tolua++.lua

3. Run the compile scripts.

   • For the first time build

   # For arm architecture
   cd Projects/Linux
   make arm
   
   # For x86_64 architecture
   cd Projects/Linux
   make x86_64
   • For incremental build

   cd Projects/Linux
   make

4. Run the generated software.

   cd Assets
   ../Projects/Linux/build/dora-ssr
   
   # Or specify the resource directory with command line arguments
   ./Projects/Linux/build/dora-ssr --asset Assets

3. Web IDE Development

1. Compile and run the Dora SSR engine.
2. Install the latest version of Node.js.
3. Initialize the project and enter the Dora Dora editor development mode.

   # macOS
   cd Tools/dora-dora/3rdParty/YarnEditor && yarn && yarn build
   rm -rf ../../public/yarn-editor
   mv dist ../../public/yarn-editor
   cd ../.. && yarn
   yarn start

   # Linux
   cd Tools/dora-dora/3rdParty/YarnEditor && yarn && yarn build-linux
   rm -rf ../../public/yarn-editor
   mv dist ../../public/yarn-editor
   cd ../.. && yarn
   yarn start

   # Windows
   cd Tools\dora-dora\3rdParty\YarnEditor && yarn && yarn build-win
   rmdir /Q /S ..\..\public\yarn-editor
   move dist ..\..\public\yarn-editor
   cd ..\.. && yarn install --network-timeout 1000000
   yarn start
   Alternatively, you can generate the Web IDE release files, copy them to the project's Assets/www directory, and then start the Dora SSR engine to test the full project functionality.

   # macOS, Linux
   # Ensure the previous steps of compiling and copying YarnEditor are completed
   cd Tools/dora-dora
   yarn build
   rm -rf ../../Assets/www
   mv build ../../Assets/www

   # Windows
   # Ensure the previous steps of compiling and copying YarnEditor are completed
   cd Tools\dora-dora
   yarn build
   rmdir /Q /S ..\..\Assets\www
   move build ..\..\Assets\www