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

About the developer

turanszkij
2.6K Stars 293 Forks Other 2.7K Commits 27 Opened issues

Description

C++ game engine focusing on modern rendering techniques and performance.

Services available

!
?

Need anything else?

Contributors list

# 11,966
C++
C
directx...
vulkan
2508 commits
# 146,905
C++
C
directx...
vulkan
31 commits
# 91,038
directx...
vulkan
bullet-...
net-fra...
9 commits
# 261,075
C++
C
Windows
directx...
4 commits
# 283,752
C++
C
directx...
vulkan
2 commits
# 366,369
C++
C
Shell
directx...
2 commits
# 216,971
C++
directx...
vulkan
bullet-...
1 commit
# 47,774
C
Python
directx...
vulkan
1 commit

Wicked Engine

License: MIT Discord chat follow on Twitter
Github Build Status Appveyor Build status Store


Wicked Engine is an open-source C++ engine focusing on modern rendering techniques and performance. Use this as a framework for your graphics projects, or learning. Some programming skills are required for the best experience, but some simple tools like an Editor are also included. It is free to be used for anything good.
This project is hosted on GitHub.

You can download the source code by using Git and cloning the repository, or downloading it as zip. You can also choose to download a pre-built version of the Editor or Tests applications, which will allow you to try out features, load content and execute LUA scripts.
Tip: try loading models or scripts from the Content folder using the Editor app to see how everything works.

Platforms:

  • Windows 10 Desktop [Visual Studio 2019]
  • UWP [Visual Studio 2019]
  • Linux (experimental) [CMake 3.7]

How to build:

Windows

To build Wicked Engine for Windows 10, use Visual Studio and the provided

WickedEngine.sln
solution file. There are a couple of projects that you can run up front: Editor, Tests and Template. You just have to set either as startup project and press F5 in Visual Studio to build and run. For optimal performance, choose
Release
mode, for the best debugging experience, choose
Debug
mode.

If you want to develop an application that uses Wicked Engine, you can build the WickedEngine static library project for the appropriate platform, such as

WickedEngine_Windows
and link against it. Including the
"WickedEngine.h"
header will attempt to link the binaries for the appropriate platform, but search directories should be set up beforehand. For example, you can set additional library directories to
$(SolutionDir)BUILD\$(Platform)\$(Configuration)
by default. For examples, see the
Template
,
Tests
, and
Editor
projects.

You can also dowload prebuilt and packaged versions of the Editor and Tests here: Github Build Status

If you have questions or stuck, please use the

windows
communication channel on Discord: Discord chat

Note: Building 32-bit and ARM versions should be possible, but no longer provided by default. You will need to configure the solution for these platforms yourself if you want this. For ARM platform, also use the

-D BT_USE_DOUBLE_PRECISION=1
definition when compiling.

Cmake: It is possible to build the windows version with Cmake, but the recommended way is to use the provided WickedEngine.sln file with Visual Studio as this is the most tested method.

Linux

The Linux support is experimental. You can find a sample build script for Ubuntu 20.04 here (in the linux section). You might need to install some dependencies, such as Vulkan SDK 1.2 or greater (to get DirectXShaderCompiler), SDL2, cmake 3.7 and g++ compiler (C++ 17 compliant version). For Ubuntu 20.04, you can use the following commands to install dependencies:

bash
wget -qO - https://packages.lunarg.com/lunarg-signing-key-pub.asc | sudo apt-key add -
sudo wget -qO /etc/apt/sources.list.d/lunarg-vulkan-1.2.170-focal.list https://packages.lunarg.com/vulkan/1.2.170/lunarg-vulkan-1.2.170-focal.list
sudo apt update
sudo apt install vulkan-sdk
sudo apt install libsdl2-dev
sudo apt install build-essential
- Note: The Vulkan SDK for Ubuntu contains DXC (DirectXShaderCompiler) which is required to build the shaders. If you are using an other Linux distribution, make sure that you have DirectXShaderCompiler. To build the engine, editor and tests, use Cmake and make:
bash
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make

If you want to develop an application that uses Wicked Engine, you will have to link to libWickedEngine.a and

#include "WickedEngine.h"
into the source code. For examples, look at the Cmake files.

You can also dowload prebuilt and packaged versions of the Editor and Tests here: Github Build Status

If you have questions or stuck, please use the

linux
communication channel on Discord: Discord chat

Examples:

Initialization (C++):

// Include engine headers:
#include "WickedEngine.h"

// Declare main component once per application: MainComponent main;

// Assign window that you will render to: main.SetWindow(hWnd);

// Run the application: while(true) { main.Run(); }

Basics (C++):

RenderPath3D myGame; // Declare a game screen component, aka "RenderPath" (you could also override its Update(), Render() etc. functions). 
main.ActivatePath(&myGame); // Register your game to the application. It will call Start(), Update(), Render(), etc. from now on...

wiScene::LoadModel("myModel.wiscene"); // Simply load a model into the current global scene wiScene::GetScene(); // Get the current global scene wiRenderer::ClearWorld(); // Delete every model, etc. from the current global scene

wiScene::Scene scene2; // create a separate scene wiScene::LoadModel(scene2, "myModel2.wiscene"); // Load model into a separate scene wiScene::GetScene().Merge(scene2); // Combine separate scene with global scene

myGame.setFXAAEnabled(true); // You can enable post process effects this way...

RenderPath2D myMenuScreen; // This is an other render path, but now a simple 2D one. It can only render 2D graphics by default (like a menu for example) main.ActivatePath(&myMenuScreen); // activate the menu, the previous path (myGame) will be stopped

wiSprite mySprite("image.png"); // There are many utilities, such as a "sprite" helper class myMenuScreen.addSprite(&mySprite); // The 2D render path is ready to handle sprite and font rendering for you

wiAudio::Sound mySound; wiAudio::CreateSound("explosion.wav", &mySound); // Loads a sound file wiAudio::SoundInstance mySoundInstance; wiAudio::CreateSoundInstance(&mySound, &mySoundInstance); // Instances the sound file, it can be played now wiAudio::Play(&mySoundInstance); // Play the sound instance wiAudio::SetVolume(0.6, &mySoundInstance); // Set the volume of this soundinstance wiAudio::SetVolume(0.2); // Set the master volume

if (wiInput::Press(wiInput::KEYBOARD_BUTTON_SPACE)) { wiAudio::Stop(&mySoundInstance); } // You can check if a button is pressed or not (this only triggers once) if (wiInput::Down(wiInput::KEYBOARD_BUTTON_SPACE)) { wiAudio::Play(&mySoundInstance); } // You can check if a button is pushed down or not (this triggers repeatedly)

Scripting (LUA):

-- Set a rendering path for the application main component
path = RenderPath3D;
main.SetActivePath(path);    -- "main" is created automatically

-- Load a model entity into the global scene: entity = LoadModel("myModel.wiscene");

-- Load a model entity into a separate scene: scene2 = Scene() entity2 = LoadModel(scene2, "myModel2.wiscene");

-- Combine the separate scene with the global scene: scene.Merge(scene2);

-- Get the current global scene: scene = GetScene();

-- Move model to the right using the entity-component system: transform = scene.Component_GetTransform(entity); transform.Translate(Vector(2, 0, 0));

-- Clear every model from the current global scene: ClearWorld();

-- Print any WickedEngine class information to the backlog: getprops(main); -- prints the main component methods getprops(scene); -- prints the Scene class methods getprops(path); -- prints the deferred render path methods

-- Play a sound: sound = Sound() audio.CreateSound("explosion.wav", sound) soundinstance = SoundInstance() audio.CreateSoundInstance(sound, soundinstance) -- several instances can be created from one file audio.Play(soundinstance) audio.SetVolume(0.6, soundinstance) -- sets the volume of this soundinstance audio.SetVolume(0.2) -- sets the master volume

-- Check for input: if(input.Press(KEYBOARD_BUTTON_LEFT)) then audio.Play(soundinstance); -- this will play the sound if you press the left arrow on the keyboard end

(You can enter lua scripts into the backlog (HOME button), or the startup.lua script which is always executed on application startup if it is found near the app, or load a script via dofile("script.lua") command)

For more code samples and advanced use cases, please see the example projects, like the Template_Windows, Tests, or Editor project. There are also sample models and scripts included with Wicked Engine in the models and scripts folders. Check them out to learn about more features.

Scripting API:

You can use a great number of engine features through the Lua scripting api, which can even be used real time while the program is running. The included applications, like the Editor, contain a scripting input method toggled by the "Home" key. A blue screen will be presented where the user can type in LUA commands. It is very minimal in regards to input methods. For further details, please check the scripting API documentation: Wicked Engine Scripting API

Model import/export:

The native model format is the WISCENE format. Any application using Wicked Engine can open this format efficiently.

In addition, the Editor supports the importing of some common model formats (the list will potentially grow): - OBJ - GLTF 2.0

The preferred workflow is to import models into the Editor, and save them as WISCENE, then any Wicked Engine application can open them.

Graphics API:

The default renderer is

DirectX 11
on Windows and
Vulkan
on Linux. There is also an optional
DirectX 12
renderer for Windows. You can specify command line arguments (without any prefix) to switch between render devices or other settings. Currently the list of options:
Argument Description
dx12 Use DirectX 12 rendering device
vulkan Use Vulkan rendering device
debugdevice Use debug layer for graphics API validation. Performance will be degraded, but graphics warnings and errors will be written to "Output" window
gpuvalidation Use GPU Based Validation for graphics. This must be used together with
debugdevice
argument.


Other software using Wicked Engine

  • Game Guru MAX: Easy to use game creator software
  • Flytrap: Demoscene production by qop
  • Your project: add your project to this readme and open a pull request


Screenshots:

Sponza scene with voxel GI enabled: Sponza

Damaged Helmet sample model imported from GLTF: Sponza

Bokeh Depth of Field (Lain model by woopoodle at Sketchfab): DepthOfField

Motion blur (fighting game sample): MotionBlur

Stochastic Screen Space Reflections: ScreenSpaceReflections

Real time ray traced shadows and ambient occlusion (DXR, VKKHRraytracing): RaytracedShadows

Bloom: Bloom

Path tracing in the living room (model from Morgan McGuire's graphics archive): LivingRoom

City scene with a light map (model by Michael Gallie at CgTrader): City

Path tracing in the city: Balcony

Path traced caustics: Caustics

Vegetation particle system and depth of field: Vegetation

Bistro scene from Amazon Lumberyard (model from Morgan McGuire's graphics archive): Bistro_out

Bistro scene from the inside: Bistro_in

Parallax occlusion mapping: ParallxOcclusionMapping

Large scale particle simulation on the GPU: ParticleSimulation

Tiled light culling in the Bistro: TiledLightCulling

GPU-based BVH builder: GPU_BVH

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.