Skip to content

hack-to-distinguished/tank_squared

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TANK SQUARED

Tank Squared Logo

Bron's army vs the Russians! Who will win? A turn-based tank battle game built with modern web technologies.


🎮 Overview

Tank Squared is a turn-based tank strategy game in development in parallel with HTTP_C, a web server and messaging system built in C.

In Tank Squared, players command tanks, adjust movement, and fire projectiles using realistic physics simulations. Each turn challenges you to outmaneuver and outshoot your opponent, whether it's the AI enemy or other players in future versions.

This project combines PixiJS for graphics rendering and Planck.js for physics simulation, providing a foundation for destructible environments, tank customization, and immersive gameplay.


🚀 Current Features (v1.0)

  • ✔️ Projectile motion mechanics
  • ✔️ Collision detection (ground and player)
  • ✔️ Turn-based gameplay loop
  • ✔️ Basic enemy tank behavior
  • ✔️ Movement detection via Planck.js
  • ✔️ Functional start screen

🔧 Upcoming Features (v1.0.1 Roadmap)

  • ✔️ Terrain destruction
  • ✔️ Procedural terrain generation
  • ✔️ Enhanced physics (motor speed, friction, etc.)
  • ⬜ Expanded tank properties
  • ✔️ Health bars and death states
  • ✔️ Damage detection
  • ⬜ Multiple screens (pause, settings, etc.)
  • ⬜ Refined player edges in Planck.js
  • ⬜ Revamped shooting controls
  • ⬜ Object cleanup and redundant deletion
  • ⬜ Optimized game loop

📖 Documentation References


🛠️ Getting Started

1. Install Node.js

Download and install the latest version of Node.js.

Verify installation:

node -v
# v22.14.0

npm -v
# 10.9.0

2. Clone the Repository

git clone https://github.com/Chris33871/tank_squared.git

3. Install Dependencies

npm install

Check dependencies:

npm list pixi.js planck
# [email protected] /path/to/project
# ├── [email protected]  
# └── [email protected]

4. Run the Game

npx vite

Expected output:

VITE v6.2.3  ready in 214 ms

➜  Local:   http://localhost:5173/
➜  Network: use --host to expose
➜  press h + enter to show help

Open the local link to start playing.

Home Page Screenshot


🧩 Tech Stack

  • PixiJS → 2D rendering engine for smooth visuals
  • Planck.js → Physics simulation for realistic gameplay
  • Vite → Fast build tool and dev server
  • JavaScript/TypeScript → Core game logic


📜 License

This project is licensed under the MIT License. See LICENSE for details.


🗺️ Road Ahead

Tank Squared is still in early stages. The near-term goal is refining core mechanics and introducing destructible terrain. Long-term plans include multiplayer support, multiple tank classes, and advanced AI. Stay tuned for updates.

About

Pixijs turn by turn multiplayer game in development

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5