CTFTNKS: Capture-The-Flag Tank Game

CTFTNKS is a fast-paced, tank battle browser game featuring multiple game modes, including Capture the Flag, Deathmatch, and King of the Hill. It is built with modern vanilla web technologies.

:video_game: Play the game now at: ctftnks.github.io

Features

• Multiple Game Modes: CTF, Deathmatch, Team Deathmatch, and King of the Hill.
• Smart AI Bots: Adaptive bot speed and strategic behavior.
• Dynamic Power-ups: Laser, Machine Gun, Guided Missiles, Wrecking Ball, and more.

How to Play

1. Open ctftnks.github.io
2. Menu: Use the menu to select a game mode and configure players/bots.
3. Controls: Default controls for Player 1 are Arrow Keys to move and Space to fire. These can be remapped in the Menu.
4. Goal: Capture the enemy flag and return it to your base while defending your own!

Documentation

• :books: Architecture & Guides (VitePress): High-level design, arc42 documentation, ADRs, and development guides.
• :memo: API Documentation (TypeDoc): Detailed technical documentation of classes, methods, and types.

The raw documentation-as-code is placed in the directory /docs/.

First Steps for Development

Prerequisites

• Node.js (Latest LTS recommended)

Installation of dependencies

First, you need to install the npm-dependencies using the command

npm install
Copy

Development

Launch the development server:

npm run dev
Copy

The game should now be available in your browser at http://localhost:5173

Build

Build the project for production:

npm run build
Copy

The output will be generated in the dist/ directory.

Testing

Run the unit test suite:

npm test
Copy

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.