A fast, scalable, distributed game server framework for C++, include actor library, network library,can be used as a real time multiplayer game engine ( MMO RPG ), which support Lua script and Unity3d client. Plan to support UE4, Cocos2dx client.
HTML C++ C Java Python Shell Other
Latest commit 02a883c Nov 19, 2016 NickYang fix doc hyperlinks


Server Architecture

Copyright © https://github.com/ArkGame

❗️ New game frame with some new ideas, this project is based on NFrame

QQ Group:341159815

What is it?

ArkGameFrame is a lightweight, fast, scalable, distributed plugin framework to create game server easily. Greatly inspired by OGRE and Bigworld.


  • General abstract data system
  • Interface-oriented programming (IOP)
  • Event-driven and data-driven
  • Extensible apps, plugins, and modules
  • High concurrency and performance by using actor model (Theron)
  • Based on the event-driven and attribute-driven can make business more clear and easy to maintenance
  • Based on C++ standard, easy to handle and learn
  • Cross platform (Include Windows and Linux)
  • Distributed server architecture
  • Use Excel as configuration files, easier for users
  • With existed Unity3D client for rapid development


Please create a new issue to ask a question.

Unity3D client

Unity3D Client


App Architecture:

App Architecture

Server Architecture

Server Architecture

Get the Sources:

git clone https://github.com/ArkGame/ArkGameFrame.git


svn checkout https://github.com/ArkGame/ArkGameFrame


  • libevent 2.0.22
  • easylogging++ 9.80
  • mysql++ 3.2.2
  • google protobuf 2.5.0
  • pybind11 1.2
  • redis-cpp-client
  • Theron 6.00.01
  • curl 7.37.1

Supported Compilers

  • GCC >= 4.8 (Tested in Ubuntu 15.04)
  • MSVC >= VS2015 (Tested in Win7/10)

Build and Install

MSVC >= 2015

  1. Git pull all source
  2. Run Dep/build_dep.bat
  3. Open the solution: Frame/Ark.sln
  4. Build the solutionArk.sln
  5. Run GenerateConfigXML.bat to generate configuration files
  6. Run the binary file by Bin/Server/Debug/Run.bat

CodeBlocks >= 13.1(Only in linux)

  1. Git pull all source
  2. Run Dep/build_dep.sh
  3. Open the solution with CodeBlocks: Frame/Ark.workspace
  4. Check C++11 option in CodeBlocks compiler setting
  5. Build Ark.workspace
  6. Run bash ./GenerateConfigXML.sh to generate configuration files
  7. Run the binary file by Bin/Server/Debug/rund.sh

❗️ Fixing some problem


  1. Git pull all source
  2. Install cmake[>= 2.8] please choose options for installing: Add CMake to the system PATH for all users and restart your computer
  3. Install VS2015 or gcc[>= 4.8]
  4. Run install.bat or install.sh to build NF
  5. Run the binary file by _Out/Server/Debug/run.bat or _Out/Server/Debug/rund_cmake.sh
  6. (Optional)For Release Version, after above, run BuildNF.VS2015.Release.X64.bat or BuildNF.CMake.Release.sh, then run the binary file by _Out/Server/Release/run.bat or _Out/Server/Release/run_cmake.sh


User Manual




Please see Frame/Samples.


The ArkGameFrame project is currently available under the Apache License.

C# Project

Still working on it, maybe use Akka.net or Orleans

Our team has always specialized in the agile development and try to help different teams to develop game project quickly and easily. After years of development, we create this frame which is a fast, scalable, distributed game server framework written by C++, include the actor library, network library, can be used as a real-time multiplayer game engine. We are still improving it.