Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time

openblack

VCPKG CI System Deps CI GitHub Stars Discord chat License

openblack is an open source reimplementation of Black & White (2001) written in modern C++ and modern rendering engines (OpenGL, Vulkan).

You still need to have the original game assets in order to use this, don't ask where to get these.


Building

Clone the code using: git clone --recursive https://github.com/openblack/openblack.git

Configuration for using vcpkg (Recommended for new users)

The simplest way to obtain all the required dependencies is through vcpkg which is included with a manifest file.

The easiest way to get started on any platform is to allow CMake and vcpkg to handle all dependencies and configuration for you. To do so, you will be selecting the "ninja-multi-vcpkg" - Ninja Multi-Config (vcpkg) preset. Other presets are available for more advanced users.

Visual Studio Code

Visual Studio 2019 / 2022

Clion

Commandline

  • Your usual build tool-chain.
    • Ubuntu / Debian: # apt install build-essential cmake
    • Arch Linux / Manjaro: # pacman -S base-devel cmake
  • You can generate the cmake build preset using cmake --preset and you can list the presets using cmake --list-presets

Configuration for using System Dependencies (Recommended for packagers)

If you don't want to use vcpkg; CMake will use system libraries, or manually specified package directories.

CMake will find the required libraries as long as they provide a proper config file.

Arch Linux

Install openblack-git from the AUR which builds and installs directly for all Arch Linux derived distros such as Manjaro. This will require pacman to install all required dependencies.

The prefix to use is "linux-system-deps" - Linux (System Deps)

Contributing

Contributions are always welcome, whether it's modifying source code to add new features or bug fixes, documenting new file formats or simply editing some grammar.

You can also join the Discord for development discussion if you are unsure of anything.

License

openblack is released as open source software under the GPL v3 license, see the license file in the project root for the full license text.

About

openblack is an open-source game engine that supports playing Black & White (2001).

Topics

Resources

License

Releases

No releases published