Skip to content

INSTALL.md

Latest commit

 

History

History
108 lines (80 loc) · 5.18 KB

INSTALL.md

File metadata and controls

108 lines (80 loc) · 5.18 KB

Dependencies

You will need the following libraries to build Barony:

OPTIONAL dependencies:

  • One of FMOD Ex or OpenAL for audio support.

FMOD Ex can be downloadable at http://www.fmod.org/download-previous-products/ (you do need an account to download it). You can disable FMOD by running cmake with -DFMOD_ENABLED=OFF (it's also disabled if not found). Use of FMOD Ex in Barony is considered deprecated.

OpenAL can be used with -DOPENAL_ENABLED

You will also need the following tools:

  • A working C++ compiler (Visual Studio, MinGW (not officially supported, CMakeLists.txt may require modification), GCC, Clang, or xtools)
  • CMake
  • Linux users will also need Make, or whatever alternate you may generate build files for.

Windows Instructions

Acquire Dependencies

PhysFS:

  • Download from https://icculus.org/physfs/downloads/physfs-3.0.1.tar.bz2
  • Open with .7zip or similar, open up docs/INSTALL.txt inside the archive for instructions to read along with this short guide.
  • Download/install cmake-gui for Windows (or use a command line version if you have it -- you may select "Add CMake to the system PATH for all users/current user" during installation for ease of use)
  • Open up the physfs-3.0.1 directory in cmake-gui and select configure, then generate
  • You will now get Visual Studio files to open up and build
  • Open up files in Visual Studio, in Solution Explorer right click the 'physfs' solution and 'build'
  • You will now see a physfs.lib file in physfs-3.0.1/Release/ to use when building Barony. Put this in one of the VCC++ Library Directories folder for the Barony project.
  • Similarly you can find physfs-3.0.1/src/physfs.h to put in one of the VC++ Include Directories from the Barony project.

dirent.h is a POSIX header, you will need to obtain a Windows port. For example, from https://github.com/tronkko/dirent

//TODO: Where get OpenGL? Did you need to install the "Windows SDK" when setting up Visual Studio?

Download everything else. You may need to build things. More explicit instructions here would be nice.

TODO: vcpkg something or other

Building Barony

Visual Studio Instructions:

  • Rather than individually setting up environment variables for every dependency, you can simply create an environment variable named BARONY_WIN32_LIBRARIES and point it to a combined dependencies folder. Said folder should have a subdirectory named include with all libraries' header files in there, and a lib subdirectory for the library archives themselves.
  • After that, create a directory named build (or somesuch) in the root Barony directory, and either run cmake .. inside it from a command prompt, or use cmake-gui.
    • There are some additional options you can specify, such as -DFMOD_ENABLED, -DSTEAMWORKS_ENABLED, -DEOS_ENABLED, -DOPENAL_ENABLED.
    • If you do not specify one of FMOD or OpenAL enabled, the game will build without sound support.
  • Open barony.sln and the standard Visual Studio experience is now all yours.
    • Build the whole solution to generate the .exe files. (Make sure that the appropriate Platform Toolset is installed)
  • MinGW probably not supported right now in the CMakeList.txt...PRs welcome :) TODO: MinGW support, one master SLN with Steam, EOS, FMOD, OpenAL, etc variants all in one place.

If you're using MinGW or GCC, you'll need to run CMake first, then make: cmake . && make (NOTE: Not supported, CMakeLists.txt is probably broken for MinGW support)

If you are missing GL header files like glext.h they are available from https://www.khronos.org/registry/OpenGL/api/GL/.

Linux Instructions

Acquire Dependencies

For Debian/Ubuntu, you should be able to install most of these dependencies with: //TODO: Add OpenAL to the list. sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-net-dev libsdl2-ttf-dev libpng-dev libz-dev libphysfs-dev rapidjson-dev

You will also need PhysFS v3.0.1 for Barony v3.1.5+ if not available in your distro's package repository. Linux Install (Navigate to somewhere to drop install files first):

Building Barony

You can do something along the following lines:

mkdir build
cd build
cmake ..
make -j

Build Flags

TODO: Document all of them...

For Audio support, you may pass in one of the following to your cmake invocation, depending on which you installed: -DFMOD_ENABLED or -DOPENAL_ENABLED

Steamworks or EOS support: -DSTEAMWORKS_ENABLED and -DEOS_ENABLED

Example cmake invocation, for a build using Steamworks, EOS, and FMOD:

cmake -DCMAKE_BUILD_TYPE=Release -DFMOD_ENABLED=ON -DSTEAMWORKS_ENABLED=1 -DEOS_ENABLED=1 # TODO: Standardize ON and 1...