Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xtreme8000/betterspades
BetterSpades, an Ace of Spades client targeted at low end systems (GL/ES 1.1). Runs on your grandmother's rig!
https://github.com/xtreme8000/betterspades
075 076 ace-of-spades aos betterspades enet game linux macos multiplayer open-source openal opengl voxel voxlap windows
Last synced: 15 days ago
JSON representation
BetterSpades, an Ace of Spades client targeted at low end systems (GL/ES 1.1). Runs on your grandmother's rig!
- Host: GitHub
- URL: https://github.com/xtreme8000/betterspades
- Owner: xtreme8000
- License: gpl-3.0
- Created: 2016-09-08T14:35:43.000Z (about 8 years ago)
- Default Branch: standalone
- Last Pushed: 2024-01-25T23:09:08.000Z (10 months ago)
- Last Synced: 2024-05-21T13:43:09.221Z (6 months ago)
- Topics: 075, 076, ace-of-spades, aos, betterspades, enet, game, linux, macos, multiplayer, open-source, openal, opengl, voxel, voxlap, windows
- Language: C
- Homepage: https://aos.party/jenkins/job/BetterSpades/
- Size: 3.56 MB
- Stars: 228
- Watchers: 18
- Forks: 42
- Open Issues: 49
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://aos.party/jenkins/job/BetterSpades/)
[](https://github.com/xtreme8000/BetterSpades/releases)
[](https://discord.gg/9JGXKBt)
[](https://github.com/xtreme8000/BetterSpades/blob/standalone/LICENSE)
[](https://github.com/xtreme8000/BetterSpades#donate)
##  BetterSpades
* Replicate of the great game *Ace of Spades* (classic voxlap)
* runs on very old systems back to OpenGL 1.1 (OpenGL ES support too)
* shares similar if not even better performance to voxlap
* can run on *"embedded"* systems like a [Steam Link](https://store.steampowered.com/app/353380/Steam_Link/)
#### Why should I use this instead of ...?
* free of any Jagex code, they can't shut it down
* open for future expansion
* easy to use
* no hidden bugs
### Quick usage guide
**As of right now, you can download the newest stable version from the [releases page](https://github.com/xtreme8000/BetterSpades/releases).**
**You can get [nightly builds here](https://aos.party/jenkins/job/BetterSpades/).**
You can either:
* use the client temporarily by extracting the downloaded zip into a new directory.
* extract all contents to your current Ace of Spades installation directory (normally found at `C:/Ace of Spades/`), effectively replacing the old voxlap version
## System requirements
| Type | min. requirement |
| ------- | ---------------------------------------------------- |
| OS | Windows 98 or Linux |
| CPU | 1 GHz single core processor |
| GPU | 64MB VRAM, Mobile Intel 945GM or equivalent |
| RAM | 256MB |
| Display | 800x600px |
| Others | Keyboard and mouse
Dial up network connection |
## Build requirements
This project uses the following libraries and files:
| Name | License | Usage | GitHub |
| ------------ | --------------- | ---------------------- | :------------------------------------------------: |
| GLFW3 | *ZLib* | OpenGL context | [Link](https://github.com/glfw/glfw) |
| OpenAL soft | *LGPL-2.1* | 3D sound environment | [Link](https://github.com/kcat/openal-soft) |
| inih | *BSD-3.Clause* | .INI file parser | [Link](https://github.com/benhoyt/inih) |
| stb_truetype | *Public domain* | TrueType font renderer | [Link](https://github.com/nothings/stb) |
| dr_wav | *Public domain* | wav support | [Link](https://github.com/mackron/dr_libs/) |
| http | *Public domain* | http client library | [Link](https://github.com/mattiasgustavsson/libs) |
| LodePNG | *MIT* | png support | [Link](https://github.com/lvandeve/lodepng) |
| libdeflate | *MIT* | decompression of maps | [Link](https://github.com/ebiggers/libdeflate) |
| enet | *MIT* | networking library | [Link](https://github.com/lsalzman/enet) |
| parson | *MIT* | JSON parser | [Link](https://github.com/kgabis/parson) |
| log.c | *MIT* | logger | [Link](https://github.com/xtreme8000/log.c) |
| GLEW | *MIT* | OpenGL extensions | [Link](https://github.com/nigels-com/glew) |
| hashtable | *MIT* | hashtable | [Link](https://github.com/goldsborough/hashtable/) |
| libvxl | *MIT* | access VXL format | [Link](https://github.com/xtreme8000/libvxl/) |
| microui | *MIT* | user interface | [Link](https://github.com/rxi/microui) |
You will need to compile the following by yourself, or get hold of precompiled binaries:
* GLFW3
* GLEW
* OpenAL soft *(only needed on Windows)*
* libdeflate
* enet
Follow the instructions on their project page, then place produced static libraries in `deps/`.
All other requirements of the above list (like single file libs) will be downloaded by CMake automatically and **don't** need to be taken care of. Because state of copyright of 0.75 assets is unknown, CMake will also download additional assets from [*here*](http://aos.party/bsresources.zip) which are not part of this repository.
#### Windows
This project uses CMake to generate all Makefiles automatically. It's best to use MinGW-w64 for GCC on Windows. You can generate the required files by opening `cmd.exe` in the `build/` directory and typing:
```
cmake -G "MinGW Makefiles" ..
mingw32-make
```
If everything went well, the client should be in the `build/BetterSpades/` subfolder.
When starting `client.exe`, you will be greeted by a server list. Select a server on it to start playing!
You can also start the client the same way as you did with the voxlap version by opening cmd and putting an `aos://` link in as the first argument:
```
client.exe -aos://16777343:32887 //Connects to a local server
```
#### Linux
Compilation now works the same on Linux. Just change the build system to `Unix Makefiles` or leaving it as default will work too (`cmake ..`).
You can build each library yourself, or install them with your distro's package manager:
```
sudo apt install libgl1-mesa libgl1-mesa-dev libopenal1 libopenal-dev libglfw-dev libenet-dev libglew-dev
```
(this does not include [libdeflate](https://github.com/ebiggers/libdeflate) which is a requirement too, see [_Wiki/Building_](https://github.com/xtreme8000/BetterSpades/wiki/Building) for more details)
Start the client e.g. with the following inside the `build/bin/` directory:
```
./client
```
Or connect directly to localhost:
```
./client -aos://16777343:32887
```
#### macOS
The same instructions for Linux work on macOS aside from some minor differences. First, use Homebrew or MacPorts to grab dependencies:
```
brew install glfw enet
```
The development headers for OpenAL and OpenGL don't have to be installed since they come with macOS by default. [libdeflate](https://github.com/ebiggers/libdeflate) should be installed and placed manually in a way similar to Linux. See [_Wiki/Building_](https://github.com/xtreme8000/BetterSpades/wiki/Building) for more details.
## Gallery
| 
*quite old* | 
hiesville | 
|
| :-: | :-: | :-: |
| 
*grenade fun* | 
*falling block animation* | 
*sniping on normandie* |