Skip to content

AIBG-Vault/Alien-Warz

Repository files navigation

AIBG - Alien Wars

Description

Alien warz is a 1v1, turn-based strategy game where two alien factions battle for dominance on a glowing grid in deep space. Each player commands an aliens ship, competing to harvest resources, claim territory, and sabotage their rival.

The arena is a vibrant, shifting neon battlefield suspended in the void. Every turn, players must carefully decide how to position their units. and how to secure key resources. The stakes rise as the board evolves, forcing tighter conflicts and bolder strategies.

The game is built in Unity with C#, supporting both human players and AI-controlled contestants, allowing aliens to be trained and tested for competitive showdowns.(video).

Visuals

image Alien Warz - Main menu Alien Warz - Start Alien Warz - Possible path Alien Warz - Base RF Shields Alien Warz - Freeze Alien Warz - Daze Alien Warz - Actions menu Alien Warz - Refinement Alien Warz - Conversion Alien Warz - Game over

Docs

Attribution

Created by:

License CC BY-NC-SA 4.0

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Usage

This topic was used in the following events:

  • Novi Sad 05/2024 (AIBG v4.0)

How to run

Bot Setup Instructions

⚠️ NOTE: Pay close attention to the specified versions of programming languages, compilers, and dependencies.
If contestants wish to use a language not listed here, please contact the Topic Team to ensure that all participants use the same version.
It is mandatory that contestants use the exact versions specified if they choose that language.

To use the built-in bot provided in the game (against which you can test your own bot), you must have Python installed and correctly set in your system path.
If everything is set up properly, you will see the following screen.

Supported Language Versions

  • Python: 3.10.12
  • C#: .NET 8.0
  • C++: 11.4.0
  • Java: 17
  • Node.js: 12.22.9

WSL Configuration

⚠️ ONLY if you are using Windows.

If development is done on Windows, you must install WSL2 with the default Ubuntu distribution.
You can configure WSL from the command line (CMD). If everything is configured properly, you should see output similar to the one below (make sure VERSION == 2):

wsl -l -v       # check WSL versions
wsl --install   # install default Ubuntu OS
wsl --set-default Ubuntu   # set Ubuntu as the default WSL distro

Inside WSL, you will need to install the dependencies for your chosen programming language.

Bot Setup Instructions

⚠️ IMPORTANT: Use the exact versions of programming languages, compilers, and dependencies listed below.
If you want to use a language not listed here, contact the Topic Team to ensure everyone uses the same version.


Supported Language Versions

  • Python: 3.10.12
  • C#: .NET 8.0
  • C++: 11.4.0
  • Java: 17
  • Node.js: 12.22.9

Windows WSL Setup

If using Windows, install WSL2 with the default Ubuntu distribution:

wsl -l -v                  # check WSL versions
wsl --install              # install Ubuntu (default)
wsl --set-default Ubuntu   # set Ubuntu as the default distro
Enter WSL with:

Language Environment Setup (inside WSL) Java

sudo apt update
sudo apt install openjdk-17-jdk -y

C#

sudo apt-get update
sudo apt-get install -y dotnet-sdk-8.0

C++

sudo apt update
sudo apt install build-essential

Node.js

sudo apt install nodejs

Notes Always run the game as administrator:

# MacOS
sudo open AIBG.app

# Linux
sudo ./AIBG

Use echo $PATH to debug environment issues.

Use absolute paths in scripts if needed (e.g. /usr/bin/dotnet).

On Windows, make sure scripts use LF line endings, not CRLF.

#Shell Script Requirements Provide a run script for your bot: run_<TEAM_NAME>.sh

The first argument is the path to the script directory.

Save your PID in pid.log for process tracking.

Use a build script (build_<TEAM_NAME>.sh) if compilation is required.

Example snippet:

SCRIPT_DIR=$(cd "$(dirname "$0")"; pwd)
echo "$$" > "$SCRIPT_DIR/pid.log"
python3 "$SCRIPT_DIR/your_bot.py"

About

Player versus player, 3D, turn based game about aliens fighting over resources on a neon board in space. Made using Unity and C#, supporting both player inputs and inputs via script so that the different contestants can train their aliens to compete against each other.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors