bediazu / openspades

Compatible client of Ace of Spades 0.75

OpenSpades

Official website — Download — Community — Trello board

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 experience.
• Open source, and cross platform.

How to Build/Install?

Before you start: In case you're having issues to build OpenSpades, it may be because this README file is outdated, if so:

1. See the Building Guide, which may be up to date
2. Or open an issue if the problem persists

On Linux

GCC 4.9 / 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 xdg-utils libfreetype6-dev libopus-dev libopusfile-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. Clone OpenSpades repository:

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

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

   mkdir openspades.mk
   cd openspades.mk
   cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo && make

4. Install OpenSpades (optional but recommended):

   sudo make install

   note: If you have a previous installation of OpenSpades, you have to uninstall it manually by sudo rm -rf /usr/local/share/games/openspades before installing a new one.

5. Launch:

   openspades (if installed) or cd $REPO_DIRECTORY/openspades.mk; bin/OpenSpades and enjoy

On Windows (with Visual Studio)

1. Get the required software if you haven't already:

• CMake 2.8+
• PowerShell 5.0
  • Integrated with Windows 10.
  • Older versions are not tested, but might work
• Visual Studio 2015
  • VS2013 is no longer supported, but might work
  • VS2017 is not yet supported, but might work

2. Grab the source code:

• From a release: https://github.com/yvt/openspades/releases
• Latest development version (0.1.0): https://github.com/yvt/openspades/archive/master.zip

3. Extract or checkout the source

• All examples will assume E:/Projects/openspades, update paths in the examples to reflect yours

4. Get (pre-compiled) copies of 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 links to pre-compiled sets of libraries for your version of Visual Studio

5. Run CMake:

• Source: E:/Projects/openspades
• Binaries: E:/Projects/openspades/OpenSpades.msvc
• Generator: Visual Studio 14 (2015) (not Win64!)

6. Open E:/Projects/openspades/OpenSpades.msvc/OpenSpades.sln in Visual Studio.
7. Build the solution.

• The recommended build configuration is MinSizeRel or Release if you're not an developer
• The default build output directory is E:/projects/OpenSpades/OpenSpades.msvc/bin/BUILD_TYPE/

8. Copy all .dll files from Source/Externals/lib to the build output directory.
9. To get audio working, download a Windows release of OpenSpades, extract it, and copy the following dlls to the build output directory:

• For OpenAL audio: openal32.dll
• For YSR audio: YSRSpades.dll, libgcc_s_dw2-1.dll, libstdc++-6.dll, pthreadGC2.dll

10. Download the Non-free pak and copy it to the Resources folder inside your build output directory, which is probably E:/Projects/openspades/openspades.msvc/bin/BUILD_TYPE/Resources. You can also copy the paks contained in Official Mods/ folder of OpenSpades 0.0.12b to add more fonts and improve localization support of your build.

On Mac OS X (with Xcode)

1. Get the latest version of Xcode and OpenSpades source.
2. Get (pre-compiled) copies of libraries, and place them in Sources/Externals

• See the file Sources/Externals/readme.txt for details

4. Download OS X release of OpenSpades, show the package contents, and copy libysrspades.dylib to Sources/Externals/lib.
5. Download and extract the Non-free pak. After that, copy pak000-Nonfree.pak and font-unifont.pak to Resources/.
6. Open OpenSpades.xcodeproj and build.

Troubleshooting

For troubleshooting and common problems see TROUBLESHOOTING.

Licensing

Please see the file named LICENSE.