Compatible client of Ace of Spades 0.75


License: GPL-3.0

Language: C++

Keywords: ace-of-spades, action-game, c-plus-plus, cmake, cross-platform-game, fps, fps-game, game, linux, macos, multi-platform, multiplayer, multiplayer-game, network, online, opengl, realtime-games, sdl2, voxel, windows


Build Status

What is it?

OpenSpades is a compatible client of Ace of Spades 0.75.

  • Can connect to a vanilla/pyspades/pysnip server.
  • Uses OpenGL/AL for better visuals.
  • Open source, and cross platform.


On Linux

GCC 4.8 / Clang 3.2 or later is recommended because OpenSpades relies on C++11 features heavily.

  1. Install dependencies:

    On Debian-derived distributions: sudo apt-get install pkg-config libglew-dev libcurl3-openssl-dev libsdl2-dev libsdl2-image-dev libalut-dev (because of a bug in some distributions, you might also have to install more packages by sudo apt-get install libjpeg-dev libxinerama-dev libxft-dev)

    On other distributions: Install corresponding packages from your repository (or compile from source).

  2. Download & install SDL-2.0.2

    wget http://www.libsdl.org/release/SDL2-2.0.2.tar.gz
    tar -zxvf SDL2-2.0.2.tar.gz
    cd SDL2-2.0.2/
    ./configure && make && sudo make install
    cd ../

    Additional dependencies may be required.

  3. Download & install SDL2_image-2.0.0

    wget https://www.libsdl.org/projects/SDL_image/release/SDL2_image-2.0.0.tar.gz
    tar -zxvf SDL2_image-2.0.0.tar.gz
    cd SDL2_image-2.0.0/
    ./configure --disable-png-shared && make && sudo make install
    cd ../

    Additional dependencies may be required.

  4. Clone OpenSpades repository:

    git clone https://github.com/yvt/openspades.git && cd openspades

  5. Create directory openspades.mk in cloned/downloaded openspades repo and compile:

    mkdir openspades.mk
    cd openspades.mk
    cmake .. -DCMAKE_BUILD_TYPE=Release && make
  6. Install openspades:

    sudo make install

    note: make install broken in old releases

  7. Get shared files:

    • If you compiling certain release (0.0.10 for example):

      Download windows binary of OpenSpades from https://sites.google.com/a/yvt.jp/openspades/downloads, extract it, and copy the .pak files inside Resources directory into /usr/local/share/games/openspades/Resources or $XDG_DATA_HOME/openspades/Resources. If there were some files in these directories, you probably should remove them.

      note: use ~/.openspades/Resources in old releases.

    • If you compiling straight from source (git clone):

      All needed resources would be downloaded while make install, so no need to worry.

      If you didn't launched make install, you can install resources manually. See Resources/PakLocation.txt to find out where get latest shared files. Download, extract, and place them into /usr/local/share/games/openspades/Resources or $XDG_DATA_HOME/openspades/Resources

  8. Launch:

    openspades or cd $REPO_DIRECTORY; ./openspades.mk/bin/OpenSpades and enjoy

On Windows (with visual studio)

  1. Get CMake, Visual Studio 2013 (Express) or Visual Studio 2015 (not very supported), and the OpenSpades source. Official: https://github.com/yvt/openspades Unofficial: https://github.com/learn-more/openspades
  2. Extract or checkout the source (all examples will assume E:/Projects/openspades, update paths in the examples to reflect yours)
  3. Get (pre-compiled) copies of fltk, glew, curl, sdl2 and zlib, and place them in E:/Projects/openspades/Sources/Externals. See the file E:/Projects/openspades/Sources/Externals/readme.txt for details (and a pre-compiled set of libraries, make sure to pick the right one for your version of VS).
  4. Run CMake, using the paths: Source: E:/Projects/openspades Binaries: E:/Projects/openspades/OpenSpades.msvc For your convenience, create the directory: E:/Projects/openspades/OpenSpades.msvc/os.Resources, extract the resources (.pak files) to this dir, set OPENSPADES_RESDIR to point to this directory. (Run CMake again, now when running debug builds openspades will also read resources from this dir)
  5. Open E:/Projects/openspades/OpenSpades.msvc/OpenSpades.sln in Visual Studio.

On Mac OS X (with Xcode)

  1. Get the latest version of Xcode and OpenSpades source.
  2. Download and install SDL2 development libraries for OS X to /Library/Frameworks.
  3. Download and install SDL2_image development libraries for OS X to /Library/Frameworks.
  4. Download OS X release of OpenSpades, show the package contents, and copy libysrspades.dylib to the root of OpenSpades source tree.
  5. Open OpenSpades.xcodeproj and build.


Please see the file named LICENSE.

Note that other assets including sounds and models are not open source.

Project Statistics

Sourcerank 9
Repository Size 16.4 MB
Stars 392
Forks 126
Watchers 73
Open issues 106
Dependencies 0
Contributors 27
Tags 15
Last updated
Last pushed

Top Contributors See all

YVT Mark Jansen Ilia Marco Schlumpp Masaki Yamahata Nick Renieris Chameleonhider Dmitry Marakasov ArionWT John Ericson Dennis Barzakovsky Check your git settings! kuzyn1 pandaro UnrealIncident ShadowNinja Ada Tuukka Pensala Bridger Maskrey NotAFile

Recent Tags See all

v0.1.2 December 31, 2017
v0.1.1c March 04, 2017
v0.1.1b February 26, 2017
v0.1.1 February 25, 2017
v0.1.0 December 26, 2016
v0.0.12 June 23, 2014
v0.0.11 April 02, 2014
v0.0.10 January 01, 2014
v0.0.9 October 31, 2013
v0.0.8b September 03, 2013
v0.0.8 September 02, 2013
v0.0.7 August 27, 2013
v0.0.6 August 25, 2013
v0.0.5 August 22, 2013
v0.0.4 August 20, 2013

Interesting Forks See all

Compatible client of Ace of Spades 0.75, modified to work with the Raspberry Pi (Work In Progress)
C++ - Last pushed - 1 stars
Compatible client of Ace of Spades 0.75
C++ - Updated - 1 stars
Compatible client of Ace of Spades 0.75
C++ - GPL-3.0 - Last pushed - 1 stars
Compatible client of Ace of Spades 0.75
C++ - Updated - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2017-11-24 18:41:44 UTC

Login to resync this repository