{"id":13529594,"url":"https://github.com/xtreme8000/BetterSpades","last_synced_at":"2025-04-01T16:31:40.567Z","repository":{"id":38867369,"uuid":"67711083","full_name":"xtreme8000/BetterSpades","owner":"xtreme8000","description":"BetterSpades, an Ace of Spades client targeted at low end systems (GL/ES 1.1). Runs on your grandmother's rig!","archived":false,"fork":false,"pushed_at":"2024-01-25T23:09:08.000Z","size":3731,"stargazers_count":244,"open_issues_count":48,"forks_count":40,"subscribers_count":18,"default_branch":"standalone","last_synced_at":"2024-10-30T00:39:14.617Z","etag":null,"topics":["075","076","ace-of-spades","aos","betterspades","enet","game","linux","macos","multiplayer","open-source","openal","opengl","voxel","voxlap","windows"],"latest_commit_sha":null,"homepage":"https://aos.party/jenkins/job/BetterSpades/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xtreme8000.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-08T14:35:43.000Z","updated_at":"2024-10-29T11:30:06.000Z","dependencies_parsed_at":"2023-02-07T20:02:14.860Z","dependency_job_id":"17d70f9a-4f9e-47fa-83d8-b912dacd3899","html_url":"https://github.com/xtreme8000/BetterSpades","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtreme8000%2FBetterSpades","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtreme8000%2FBetterSpades/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtreme8000%2FBetterSpades/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtreme8000%2FBetterSpades/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xtreme8000","download_url":"https://codeload.github.com/xtreme8000/BetterSpades/tar.gz/refs/heads/standalone","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246670548,"owners_count":20815003,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["075","076","ace-of-spades","aos","betterspades","enet","game","linux","macos","multiplayer","open-source","openal","opengl","voxel","voxlap","windows"],"created_at":"2024-08-01T07:00:37.710Z","updated_at":"2025-04-01T16:31:39.448Z","avatar_url":"https://github.com/xtreme8000.png","language":"C","funding_links":[],"categories":["FPS"],"sub_categories":[],"readme":"[![Build Status](https://aos.party/jenkins/buildStatus/icon?job=BetterSpades)](https://aos.party/jenkins/job/BetterSpades/)\n[![](https://img.shields.io/github/downloads/xtreme8000/BetterSpades/total.svg)](https://github.com/xtreme8000/BetterSpades/releases)\n[![Discord](https://img.shields.io/badge/discord-join-ff00ff.svg)](https://discord.gg/9JGXKBt)\n[![GPL](https://img.shields.io/badge/license-GPL--3.0-red.svg)](https://github.com/xtreme8000/BetterSpades/blob/standalone/LICENSE)\n[![DonateBTC](https://img.shields.io/badge/bitcoin-donate-yellow.svg)](https://github.com/xtreme8000/BetterSpades#donate)\n\n![GPL v3](https://www.gnu.org/graphics/gplv3-127x51.png)\n\n## ![](docs/icon_small.png) BetterSpades\n\n* Replicate of the great game *Ace of Spades* (classic voxlap)\n* runs on very old systems back to OpenGL 1.1 (OpenGL ES support too)\n* shares similar if not even better performance to voxlap\n* can run on *\"embedded\"* systems like a [Steam Link](https://store.steampowered.com/app/353380/Steam_Link/)\n\n#### Why should I use this instead of ...?\n\n* free of any Jagex code, they can't shut it down\n* open for future expansion\n* easy to use\n* no hidden bugs\n\n### Quick usage guide\n\n**As of right now, you can download the newest stable version from the [releases page](https://github.com/xtreme8000/BetterSpades/releases).**\n\n**You can get [nightly builds here](https://aos.party/jenkins/job/BetterSpades/).**\n\nYou can either:\n* use the client temporarily by extracting the downloaded zip into a new directory.\n* extract all contents to your current Ace of Spades installation directory (normally found at `C:/Ace of Spades/`), effectively replacing the old voxlap version\n\n## System requirements\n\n| Type    | min. requirement                                     |\n| ------- | ---------------------------------------------------- |\n| OS      | Windows 98 or Linux                                  |\n| CPU     | 1 GHz single core processor                          |\n| GPU     | 64MB VRAM, Mobile Intel 945GM or equivalent          |\n| RAM     | 256MB                                                |\n| Display | 800x600px                                            |\n| Others  | Keyboard and mouse\u003cbr /\u003eDial up network connection   |\n\n\n## Build requirements\n\nThis project uses the following libraries and files:\n\n| Name         | License         | Usage                  | GitHub                                             |\n| ------------ | --------------- | ---------------------- | :------------------------------------------------: |\n| GLFW3        | *ZLib*          | OpenGL context         | [Link](https://github.com/glfw/glfw)               |\n| OpenAL soft  | *LGPL-2.1*      | 3D sound environment   | [Link](https://github.com/kcat/openal-soft)        |\n| inih         | *BSD-3.Clause*  | .INI file parser       | [Link](https://github.com/benhoyt/inih)            |\n| stb_truetype | *Public domain* | TrueType font renderer | [Link](https://github.com/nothings/stb)            |\n| dr_wav       | *Public domain* | wav support            | [Link](https://github.com/mackron/dr_libs/)        |\n| http         | *Public domain* | http client library    | [Link](https://github.com/mattiasgustavsson/libs)  |\n| LodePNG      | *MIT*           | png support            | [Link](https://github.com/lvandeve/lodepng)        |\n| libdeflate   | *MIT*           | decompression of maps  | [Link](https://github.com/ebiggers/libdeflate)     |\n| enet         | *MIT*           | networking library     | [Link](https://github.com/lsalzman/enet)           |\n| parson       | *MIT*           | JSON parser            | [Link](https://github.com/kgabis/parson)           |\n| log.c        | *MIT*           | logger                 | [Link](https://github.com/xtreme8000/log.c)        |\n| GLEW         | *MIT*           | OpenGL extensions      | [Link](https://github.com/nigels-com/glew)         |\n| hashtable    | *MIT*           | hashtable              | [Link](https://github.com/goldsborough/hashtable/) |\n| libvxl       | *MIT*           | access VXL format      | [Link](https://github.com/xtreme8000/libvxl/)      |\n| microui      | *MIT*           | user interface         | [Link](https://github.com/rxi/microui)             |\n\nYou will need to compile the following by yourself, or get hold of precompiled binaries:\n\n* GLFW3\n* GLEW\n* OpenAL soft *(only needed on Windows)*\n* libdeflate\n* enet\n\nFollow the instructions on their project page, then place produced static libraries in `deps/`.\n\nAll 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.\n\n#### Windows\n\nThis 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:\n```\ncmake -G \"MinGW Makefiles\" ..\nmingw32-make\n```\n\nIf everything went well, the client should be in the `build/BetterSpades/` subfolder.\n\nWhen starting `client.exe`, you will be greeted by a server list. Select a server on it to start playing!\nYou 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:\n\n```\nclient.exe -aos://16777343:32887 //Connects to a local server\n```\n\n#### Linux\n\nCompilation now works the same on Linux. Just change the build system to `Unix Makefiles` or leaving it as default will work too (`cmake ..`).\n\nYou can build each library yourself, or install them with your distro's package manager:\n```\nsudo apt install libgl1-mesa libgl1-mesa-dev libopenal1 libopenal-dev libglfw-dev libenet-dev libglew-dev\n```\n(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)\n\nStart the client e.g. with the following inside the `build/bin/` directory:\n```\n./client\n```\nOr connect directly to localhost:\n```\n./client -aos://16777343:32887\n```\n\n\n#### macOS\n\nThe same instructions for Linux work on macOS aside from some minor differences. First, use Homebrew or MacPorts to grab dependencies:\n```\nbrew install glfw enet\n```\nThe 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.\n\n## Gallery\n\n| \u003cimg src=\"/docs/pic01.png\" width=\"250px\"\u003e\u003cbr /\u003e*quite old* | \u003cimg src=\"/docs/pic02.png\" width=\"250px\"\u003e\u003cbr /\u003ehiesville | \u003cimg src=\"/docs/pic03.png\" width=\"250px\"\u003e |\n| :-: | :-: | :-: |\n| \u003cimg src=\"/docs/pic04.png\" width=\"250px\"\u003e\u003cbr /\u003e*grenade fun* | \u003cimg src=\"/docs/pic05.png\" width=\"250px\"\u003e\u003cbr /\u003e*falling block animation* | \u003cimg src=\"/docs/pic06.png\" width=\"250px\"\u003e\u003cbr /\u003e*sniping on normandie* |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxtreme8000%2FBetterSpades","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxtreme8000%2FBetterSpades","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxtreme8000%2FBetterSpades/lists"}