andrew
/
ace-of-shades-2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
A simple 3D voxel-based shooter inspired by Ace of Spades.
80 Commits 1 Branch 6 Tags 4.2 MiB
Java 97.2%
GLSL 1.1%
D 0.8%
PowerShell 0.4%
Shell 0.3%
Other 0.2%
Go to file
Andrew Lalis 122b2060de Improved hitpoints display. 2022-07-28 11:16:59 +02:00
client Improved hitpoints display. 2022-07-28 11:16:59 +02:00
core Added chat, improved player input responses, and rebalanced weapons. 2022-07-28 11:02:09 +02:00
design Improved hitpoints display. 2022-07-28 11:16:59 +02:00
launcher Added launcher base javafx code. 2022-07-15 13:00:14 +02:00
server Added chat, improved player input responses, and rebalanced weapons. 2022-07-28 11:02:09 +02:00
worlds Added basic physics for walls, still highly broken. 2022-07-10 12:49:51 +02:00
.gitignore Added chat, improved player input responses, and rebalanced weapons. 2022-07-28 11:02:09 +02:00
LICENSE Initial commit 2022-07-03 14:34:17 +02:00
README.md Added chat, improved player input responses, and rebalanced weapons. 2022-07-28 11:02:09 +02:00
build-clients.d Upgraded build script. 2022-07-27 16:26:17 +02:00
pom.xml Added basic chat functionality, for server-side messages. 2022-07-27 16:10:22 +02:00
setversion.d Upgraded setversion.d to also run mvn clean test. 2022-07-09 11:31:20 +02:00

README.md

Ace of Shades 2

A simple 3D voxel-based shooter inspired by Ace of Spades. With some basic weapons and tools, fight against players in other teams!

screenshot

Quick-Start Guide

Read this guide to get started and join a server in just a minute or two!

  1. Make sure you've got at least Java 17 installed. You can get it here.
  2. Download the aos2-client JAR file from the releases page that's compatible with your system.
  3. Run the game by double-clicking the JAR file, or entering java -jar <jarfile> in a terminal. This should generate a client.yaml file.
  4. Set the serverHost, serverPort, and username properties accordingly for the server you want to join.
  5. Run the game again to join the server and start playing!

Controls

  • WASD to move, SPACE to jump, LEFT-CONTROL to crouch.
  • LEFT-CLICK to use your held item (shoot, destroy blocks, etc.).
  • RIGHT-CLICK to interact with things using your held item (place blocks, etc.).
  • R to reload.
  • T to chat. Press ENTER to send the chat.
  • ESCAPE to exit the game.
  • Numbers are used for selecting different items.
  • F3 toggles showing debug info.

Setting up a Server

Setting up a server is quite easy. Just go to the releases page and download the latest aos2-server JAR file, and run it. It'll create a server.yaml configuration file if you don't provide one.

Configuration

Both the client and server use a similar style of YAML-based configuration, where upon booting up, the program will look for a configuration file in the current working directory with one of the following names: configuration, config, cfg, ending in either .yaml or .yml. Alternatively, you can provide the path to a configuration file at a different location via a single command-line argument. For example:

java -jar server.jar /path/to/my/custom/config.yaml

If no configuration file is found, and none is explicitly provided, then a set of default configuration options is loaded.