Need help with blade?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

142 Stars 29 Forks Other 73 Commits 0 Opened issues


a cross platform 3d engine using c++98

Services available


Need anything else?

Contributors list

# 256,107
66 commits
# 160,522
1 commit


A cross platform 3d engine using c++98

Dev Wiki:
Chat Channel:
Coding Standard:

Why re-invent another wheel and why it is open sourced?
This project started about in 2010 with the purpose to study the tech behind 3D engines.
Some of its idea is learned from Ogre, some from Nebula Device, some from in-house engines through my job. Some problems solved in real-life work have also been put into it.
Thanks to its explosive growth, Blade was open-sourced in Dec/2018 because it cannot be accomplished by any single person. Hopefully someone could help to improve it so that it may be put into practical use in the future.
Any bug reports, suggestions, criticisms are welcomed. If anything you can learn from it, that'll be great too.


  1. Crossplatform architecture, easy-to-add support for more platforms. The supported platforms are:

    • Windows (x64/x86);
    • Android (ARM/ARM64);
    • iOS is planned;

    Supported compilers: * MSVC * GCC * Clang

  2. Plugin-based framework, maximum decoupling and flexible customization.

  3. Task-based parallel system. Each subsystem has own tasks and cooperate using parallel state data.

  4. Multiple rendering API support:

    • D3D9
    • OpenGL ES 3
    • Vulkan is planned.
  5. Graphics features:

    • Large world & terrains;
    • 3DS Max importer (deprecated);
    • FBX importer;
    • Dual Quternion animation;
    • IK;
    • HBAO, HDR Post Effects;
    • CSM shadow maps;
    • Customizable rendering pipelines, using xml as config script. (deferred shading & forward shading, and any customized pipeline you want. Deferred lighting is not maintained but any implementation is welcomed);
  6. Editor (to be improved)

    • Scene editing;
    • Terrain editing, height brush & texture splatting;
    • Mesh viewer;
  7. Tool chains (CLI):

    • Texture compressor;
    • Custom package (BPK) packer (CLI), and package viewer (editor plugin);
    • Shader compiler;
    • Mesh & skinned animation importer;
    • Language processor (in a GNU gettext way) & translation editing tool (a plugin for editor);
  8. Fast build/compilation, for fast prototyping/iteration. Effective LOC 200k, takes 1.5 min on i7 CPU for Win32 debug, Android takes about 5 mins.

  9. Data binding to XML (non-intrusive); simple binary XML format.

  10. Multi-language supprt.

How to build

You need Visual Studio 2015/2017 (latest update), with desktop develepment, C++ cross platform (mobile) develeopment, MFC development installed. If any project failed to load, right-click the project and click reload to check the error messge to see which feature is missing and then re-install Visual studio with required feature (only newly required features are installed, it could be fast).

  1. Use

    git submodule update --init
    to init git submodule (art resources).
  2. Build dependencies
    Open Denpendices/build/VC14.1/ALL/AllDenpendency.sln and batch build all (MENU:Build => Batch Build..., press "Selected All" and then "Build"). At least Release|Win32 is needed for tools.
    Open All
    Dpendency_Android & batch build all if you want to build Android version.
    After that, you probably don't need to touch that solution(s) any more, exept that new dependencies were added.
    There're VC14 (VS2015 projects) too, if you want to debug & run on Android, VC14.1 (VS2017) is recommended, since older VS version may have bugs on installing packages & start apps.

  3. Build tools

    , build only Release|Win32. Blade uses win32 tools to get maximum compatibility.
    If you don't have 3DS Max SDK installed, you can unload the projects manually: BladeMaxExport, BladeMaxExportLoader. they'll probably fail to load anyway; just ignore them.
  4. Build Blade & Run

    • Open
      (or Blade_Android.sln for android);
    • Select the build type and build;
    • Set GameStudio (AppPackage_Android for android) as startup project;
      1. Editor mode
        Supported on Windows version (Blade.sln) only.
        Right Click "GameStudio" project => Configuration Properties => Debugging => Command Arguments: set "--mode=Editor"(without quotes)

How to debug Android

Note: currently OBB is needed to work. It is not convenient, and a network file device reading host obb is planed to be added.
In the BladeAndroid solution , `Terminal Projects/Data/PackagesAndroid

will build an bpk package located at:  
Bin/`. * run the app for the first time, and it will crash on not obb found, but it will create essential folders i.e. /sdcard/Android/obb/
* Use ADB "adb push repo\Bin\ /sdcard/Android/obb/" to push obb to device * Press F5 to start debugging.


## Configuration panel
Config Panel ## Editor: model viewer
Editor ## Editor: scene & terrain editing (512x4CSM)
Terrain Editing ## Terrain height brushing & config
Terrain Brush ## Dual quaternion animation: bone visualizer & bounding visualizer
Dual Quaternion Animation ## Package browser
Package Browser ## Language Editor
Language Editor

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.