Giter Club home page Giter Club logo

sourcehold's Introduction

Sourcehold

Notice

This project is frozen until we know what the new Definitive Edition of Stronghold from Firefly will be able to do!

Looking for a Stronghold (Crusader) community? Join the UCP Discord Discord

Project description

Build Status

Open source engine implementation of Stronghold by Firefly Studios. This project is currently in an early stage of development. Once completed, it should be able to replace all editions of classic Stronghold, including the HD remaster.


Imgur

About

Stronghold is a castle sim created by Firefly Studios in 2001. It was released for Windows and supports MacOS since its HD remaster. The purpose of this project is to make Stronghold playable on platforms it didn't support originally. It is not intended to be a 100% accurate source port, so there will be differences.

Building

Sourcehold uses the following libraries:

  • SDL2
  • OpenAL
  • FFmpeg (avcodec, avutil, avformat, swscale)
  • zlib's blast for PKWARE decompression
  • EnTT as submodule
  • filesystem as submodule
  • cxxopts as submodule

After cloning the repository, make sure to run git submodule init and git submodule update to fetch EnTT, filesystem and cxxopts.

Run cmake in your build directory.

Windows

You will have to build the dependencies from source and the most convenient way is to use vcpkg.
This may take a long time, depending on your machine.
Alternatively you may install everything manually (not recommended).

Quickstart

Installing vcpkg:

git clone https://github.com/microsoft/vcpkg
cd vcpkg
./bootstrap-vcpkg.bat
vcpkg integrate install

Installing the dependencies:

vcpkg --triplet x64-windows install sdl2 ffmpeg openal-soft

Then continue building Sourcehold with CMake:

cmake -H. -B build -DCMAKE_TOOLCHAIN_FILE=%VCPKG_FOLDER%\scripts\buildsystems\vcpkg.cmake
cmake --build build

Mac OS

Simply run build.sh macos from apple directory in the repository root. This script will install Homebrew and all necessary dependencies and build project. To build debug configuration pass -t Debug option to build.sh.

Note: You should install Xcode before trying to build project using build.sh script. Also do not forget to pass -c option to build.sh if you build Mac OS version of the Sourcehold after iOS version.

iOS

Currently you can not build for iOS devices. Only iOS simulator is supported. To build Sourcehold for the iOS simulator run build.sh ios-simulator from apple directory in the repository root. Script will install Homebrew and all necessary tools. Also it will compile and install SDL2 and FFmpeg libraries to thirdparty/ios directory in the repository root. To build debug configuration pass -t Debug option to build.sh.

After building project with build.sh script you may also peform subsequent builds using Xcode. To do that simply open Stronghold.xcodeproj from cmake build directory.

Note: You should install Xcode before trying to build project using build.sh script. Also do not forget to pass -c option to build.sh if you build iOS version of the Sourcehold after Mac OS version.

Running

Make sure you point Sourcehold to where your game data is located, which you can do using --path=/your/path or copy the files to a directory called data in the main folder of Sourcehold. The directory should look like this:

data
├── binks/
├── fx/
├── gfx/
├── gfx8/
├── gm/
├── help/
├── maps/
├── stronghold.mlb
├── sh.tex
├── delete.ani
├── hand.ani
├── jester.ani
└── sword.ani

iOS

You may run iOS version on the simulator using run-on-ios-simulator.sh script. You should pass simulator UUID to this script. Run it without parameters to get list of available simulators and their UUIDs. By default run-on-ios-simulator.sh tries to run release configuration. Pass -t Debug option to alter this behaviour.

You also may just drag'n'drop application bundle (Stronghold.app) to the simulator and run it manually.

Note: Currently data folder is embedded into application bundle resources, thus you should put it in the main folder of Sourcehold before you build the project.

Configuration

This is either done by reading an existing Stronghold config file, found in your documents folder under Stronghold/stronghold.cfg, via command line or both. Options from the command line will overwrite the ones from the config. Available options are listed with the --help argument. You can also add your command line options to a file called settings.ini, in the form option=value.

iOS

On iOS configuration is not currently supported.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.