Fosilo

An Ace of Spades 0.75 dedicated server written in Go.

Features

• Supports the entire protocol (including community extensions)
• Supports the following game modes: CTF, TDM, Babel, Arena, TC
• Add server to the BuildAndShoot and aos.coffee masterservers
• Plugin system for commands and gamemodes in Lua

Installation

1. Ensure you have ENet installed on your system from your favorite package manager
2. Grab pre-compiled binary or build from source
3. Edit config file of game mode you wish to run, change passowrds, setup map pool, enable registration in the masterserver etc.
4. Launch the server, for example we will be using CTF ./fosilo start --config config/config-ctf.toml

Building from Source

1. Clone the repository:

git clone https://github.com/siohaza/fosilo.git
cd fosilo

2. Install ENet from your favorite package manager and then Golang dependencies:

go mod download

3. Build the server:

make build
# OR
go build -o fosilo ./cmd/fosilo

The compiled binary will be created as fosilo in the project root.

For detailed Lua API documentation see this file.

License

GPLv3

Credits

• libspades and piqueserver - 0.75 protocol documentation with extensions

• SpadesX - reference for physics code, vxl map parser

• libvxl - reference for vxl map parser

• NotABurner - major help with server debugging, design suggestions

• sByte - design suggestions