Arena Game

A real-time 3D multiplayer strategy game where two players compete by purchasing and deploying tanks, helicopters, infantry units, and turrets while controlling a player character that can shoot enemies directly.

Play Now at arena.ibuildstuff.eu

Features

• Real-time Multiplayer: Play against another player or AI with live updates via WebSocket
• 3D Graphics: Built with Three.js for immersive 3D visualization
• Player Character: Control a soldier that can move and shoot enemies
• Strategic Gameplay:
  • Purchase tanks, helicopters, infantry (snipers, rocket launchers), and super units
  • Claim neutral turrets, forward bases, and barracks
  • Infantry can capture barracks for forward spawning and healing
  • Earn passive income and kill rewards
  • Units automatically move toward enemy base
  • Units engage in combat when in range
  • Collect health packs to heal your player
• Point-based Scoring: Earn points for kills (tanks: 10, helicopters: 20, turrets: 20, players: 50)
• AI Opponents: Practice against Easy, Medium, or Hard AI
• Spectator Mode: Watch live games in progress
• Leaderboard: Track top players by points and wins
• Authentication: Login with GitHub, BlueSky, or play as guest
• Sound Effects: Immersive audio for shooting, explosions, and more
• Mobile Support: Touch controls with dual joysticks

Controls

Key	Action
WASD / Arrow Keys	Move player
Left Click / X	Shoot
C	Buy unit / Claim turret or base
V	Bulk buy (10 units at 10% discount)
Right-drag	Rotate camera
Scroll	Zoom in/out
H	Toggle help overlay

Tech Stack

Client

• Vanilla JavaScript with ES6+ modules
• Three.js 0.160 for 3D rendering
• Vite 5.4 for build tooling and dev server
• Bun 1.x as the JavaScript runtime

Server

• Go 1.25 for high-performance game logic
• gorilla/websocket 1.5 for WebSocket connections
• chi 5.2 router for HTTP handling
• Authoritative server architecture (20 TPS)

Project Structure

web-arena-game/
├── client/                  # Frontend (Vanilla JS + Three.js)
│   ├── src/
│   │   ├── game/           # 3D game rendering (units, arena, effects)
│   │   ├── input/          # Player input handling
│   │   ├── network/        # WebSocket client
│   │   ├── ui/             # DOM-based UI (HUD, menus)
│   │   ├── state/          # Client state management
│   │   ├── audio/          # Sound effects manager
│   │   └── utils/          # Utilities and constants
│   ├── public/sounds/      # Audio files
│   ├── index.html
│   └── package.json
│
└── server/                  # Backend (Go)
    ├── main.go              # Server entry point
    ├── internal/
    │   ├── game/           # Game logic (room, AI, spawning, turrets)
    │   ├── websocket/      # WebSocket hub and client handling
    │   ├── types/          # Shared types, events, constants
    │   └── auth/           # OAuth (GitHub, BlueSky)
    ├── leaderboard.json    # Persistent leaderboard data
    └── go.mod

Getting Started

Prerequisites

• Go 1.25+: Download Go
• Bun 1.x: Install Bun
• Make: Usually pre-installed on macOS/Linux

Quick Start

# Install all dependencies
make tools

# Build server (client auto-embedded)
make build

# Run the server
make run

Then open browser at http://localhost:3000

For development with hot reload:

make run-dev

Then open browser at http://localhost:5173

Makefile Targets

Root-level (make <target> from project root):

• make tools - Install all tools and dependencies
• make build - Build server (client auto-embedded)
• make run - Build and run server
• make run-dev - Run dev servers with hot reload
• make clean - Clean all build artifacts
• make test - Run server tests

How to Play

1. Open your browser at http://localhost:3000 (or 5173 for dev)
2. Optionally login with GitHub or BlueSky for leaderboard tracking
3. Click "Join Queue" to find an opponent, or "Play vs AI"
4. Control your player with WASD, shoot with click or X
5. Walk to buy zones and press C to purchase units
6. Claim neutral turrets and forward bases for tactical advantage
7. Use V for bulk purchases (10 units at 10% discount)
8. Collect health packs (green crosses) to heal
9. Earn points by destroying enemy units
10. Win: Have more points when the 5-minute timer ends!

Game Mechanics

Economy

Item	Cost	Notes
Starting money	$200
Passive income	$10/second
Tank	$50	From base or forward bases
Sniper	$60	Infantry, long range, low HP
Rocket Launcher	$75	Infantry, high damage, slow
Helicopter	$80	From base or forward bases
Super Tank	$150	From forward bases only
Super Helicopter	$150	From forward bases only
Bulk buy (10 units)	10% discount	$450 for tanks, $720 for helicopters
Forward Base claim	$500	Top/bottom claimable zones
Turret claim	Free	Walk to neutral turret and press C
Barracks claim	Free	Infantry only, walk inside and press C

Kill Rewards

Target	Reward
Tank	$15
Sniper	$20
Rocket Launcher	$25
Helicopter	$25
Super Tank	$75
Super Helicopter	$100
Player	$50
Turret	$30
Barracks	$40

Unit Stats

Unit	HP	Speed	Damage	Attack Rate	Range
Player	80	12	15	3/sec	25
Tank	30	5	10	1/sec	10
Sniper	15	4	25	0.5/sec	35
Rocket Launcher	20	3.5	40	0.3/sec	30
Helicopter	30	15	10	1/sec	20
Super Tank	90	4	20	1/sec	12
Super Helicopter	90	12	20	1/sec	22
Turret	100	-	15	2/sec	30
Base Turret	150	-	20	2/sec	35
Barracks	40	-	-	-	-

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗