README.md

---
title: 3D Air Combat Simulator
emoji: 🌐
colorFrom: blue
colorTo: yellow
sdk: static
pinned: false
license: cc-by-nc-4.0
short_description: One-minute creation by AI Coding Autonomous Agent 'MOUSE-I'
---
# 3D Air Combat Simulator 

link: https://huggingface.co/spaces/cutechicken/3D-Airforce-Simulator
Developer: https://huggingface.co/spaces/cutechicken

## 🎮 Project Overview
A high-quality web-based 3D fighter jet simulator created with **VIBE CODING**. Built with Three.js, this is a full-scale aerial combat game that runs in your browser, featuring realistic physics engine and combat systems.

## ✨ Key Features

### 🛩️ Realistic Flight Physics
- **Real Aircraft Dynamics Simulation**: Realistic flight considering lift, gravity, and drag
- **G-Force System**: Blackout effects during extreme maneuvers
- **Stall System**: Loss of control when speed drops below threshold
- **Altitude-based Performance**: G-Force increases with altitude

### 🎯 Combat System
- **20mm Cannon**: 940 rounds, continuous fire capability
- **AIM-9 Sidewinder Missiles**: 8 missiles with 3-stage lock-on system
- **Flare System**: Heat-seeking countermeasures (3 uses)
- **Enemy AI**: Smart AI capable of evasive maneuvers, missile launches, and flare deployment

### 🎨 Immersive HUD
- **Fighter HUD**: Speed, altitude, heading, pitch/roll indicators
- **RWR (Radar Warning Receiver)**: Enemy position and lock-on warnings
- **Pitch Ladder**: Aircraft attitude display
- **Target Markers**: Automatic enemy marking within crosshair

### 🔊 Sound Design
- Engine sounds, cannon fire, missile launches
- Warning system (altitude, stall, Over-G, missile alerts)
- Voice guidance system
- Distance-based volume control

## 🎮 Controls

### Basic Controls
- **W/S**: Throttle increase/decrease
- **A/D**: Rudder (yaw) control
- **Mouse**: Pitch/roll control
- **Left Click**: Fire weapon
- **R**: Switch weapon (Cannon ↔ Missile)
- **F**: Deploy flares
- **G**: Escape stall (hold for 2 seconds)

### Combat Tips
1. **Missile Lock**: Keep enemy in crosshair for 3 seconds in AIM-9 mode
2. **Flare Usage**: Press F immediately when missile warning sounds
3. **Over-G Warning**: Level out when vision darkens during extreme maneuvers
4. **Stall Recovery**: Hold G for 2 seconds when speed drops below 300kt

## 🚀 Installation & Setup

### Requirements
- Modern web browser (Chrome, Firefox, Edge recommended)
- WebGL support
- Mouse required

## 📁 Project Structure
```
3D-Airforce-Simulator/
├── index.html          # Main HTML (HUD and UI)
├── game.js            # Game logic (physics, AI, combat systems)
├── models/            # 3D model files
│   ├── f-15.glb      # Player fighter
│   └── mig-29.glb    # Enemy fighter
├── sounds/            # Sound files
│   ├── main.ogg      # BGM
│   ├── normal.ogg    # Engine sound
│   └── ...           # Various sound effects
└── effects/          # Visual effects
    └── symbol.png    # RWR symbol
```

## 🛠️ Tech Stack
- **Three.js**: 3D graphics rendering
- **Vanilla JavaScript**: Game logic
- **Web Audio API**: Sound processing
- **Pointer Lock API**: Mouse control

## 🎯 Game Objectives
- **Mission**: Destroy all enemy aircraft (4) within 180 seconds
- **Victory Conditions**: 
  - Destroy all enemies
  - Survive time limit + destroy all enemies
- **Defeat Conditions**:
  - Health reaches 0 (hit/collision)
  - Ground collision
  - Time expires with enemies remaining

## 🏆 Scoring System
- Cannon kill: 100 points
- Missile kill: 100 points
- Collision kill: 200 points

## 💡 VIBE CODING Achievement
This project was created using the **VIBE CODING** methodology. Through rapid prototyping and immediate feedback, we achieved a high-quality 3D fighter jet simulator.

### Special Features
- Complete game engine in a single JavaScript file
- Real-time physics simulation
- Complex AI behavior patterns
- Professional HUD system
- Immersive sound design

## 🐛 Known Issues
- BGM playback delay due to autoplay policies in some browsers
- Possible frame drops on high graphics settings
- Flares may occasionally fail to perfectly evade missiles







# 3D Air Combat Simulator : 3D 전투기 시뮬레이터  

link: https://huggingface.co/spaces/cutechicken/3D-Airforce-Simulator
개발자: https://huggingface.co/spaces/cutechicken

## 🎮 프로젝트 소개

**VIBE CODING**으로 제작된 완성도 높은 웹 기반 3D 전투기 시뮬레이터입니다. Three.js를 활용하여 브라우저에서 실행되는 본격적인 공중전 게임으로, 실제 전투기의 물리 엔진과 전투 시스템을 구현했습니다.


## ✨ 주요 특징

### 🛩️ 리얼리스틱한 비행 물리
- **실제 항공기 역학 시뮬레이션**: 양력, 중력, 항력을 고려한 현실적인 비행
- **G-Force 시스템**: 급기동 시 블랙아웃 효과 구현
- **스톨(실속) 시스템**: 속도 부족 시 조종 불능 상태 재현
- **고도별 성능 변화**: 고도에 따른 G-Force 증가

### 🎯 전투 시스템
- **20mm 기관포**: 940발 탄약, 연사 가능
- **AIM-9 사이드와인더 미사일**: 8발 장착, 3단계 락온 시스템
- **플레어 시스템**: 미사일 회피용 열추적 교란 장치 (3회 사용)
- **적기 AI**: 회피 기동, 미사일 발사, 플레어 사용 가능한 스마트 AI

### 🎨 몰입감 있는 HUD
- **전투기 HUD**: 속도, 고도, 헤딩, 피치/롤 표시
- **RWR (레이더 경보 수신기)**: 적기 위치 및 락온 경고
- **피치 래더**: 항공기 자세 표시
- **타겟 마커**: 크로스헤어 내 적기 자동 표시

### 🔊 사운드 디자인
- 엔진음, 기관포, 미사일 발사음
- 경고음 시스템 (고도, 스톨, Over-G, 미사일 경고)
- 음성 안내 시스템
- 거리별 음량 조절

## 🎮 조작법

### 기본 조작
- **W/S**: 스로틀 증가/감소
- **A/D**: 러더 (요) 조작
- **마우스**: 피치/롤 조작
- **좌클릭**: 무기 발사
- **R**: 무기 전환 (기관포 ↔ 미사일)
- **F**: 플레어 발사
- **G**: 스톨 탈출 (2초간 유지)

### 전투 팁
1. **미사일 락온**: AIM-9 모드에서 적기를 크로스헤어에 3초간 유지
2. **플레어 사용**: 미사일 경고음이 들리면 즉시 F키로 플레어 발사
3. **Over-G 주의**: 급기동 시 시야가 어두워지면 수평 비행으로 회복
4. **스톨 회복**: 속도 300kt 이하에서 G키를 2초간 눌러 회복

## 🚀 설치 및 실행

### 요구사항
- 최신 웹 브라우저 (Chrome, Firefox, Edge 권장)
- WebGL 지원
- 마우스 필수

## 📁 프로젝트 구조

```
3D-Airforce-Simulator/
├── index.html          # 메인 HTML (HUD 및 UI)
├── game.js            # 게임 로직 (물리, AI, 전투 시스템)
├── models/            # 3D 모델 파일
│   ├── f-15.glb      # 플레이어 전투기
│   └── mig-29.glb    # 적 전투기
├── sounds/            # 사운드 파일
│   ├── main.ogg      # BGM
│   ├── normal.ogg    # 엔진음
│   └── ...           # 각종 효과음
└── effects/          # 시각 효과
    └── symbol.png    # RWR 심볼
```

## 🛠️ 기술 스택

- **Three.js**: 3D 그래픽 렌더링
- **Vanilla JavaScript**: 게임 로직
- **Web Audio API**: 사운드 처리
- **Pointer Lock API**: 마우스 컨트롤

## 🎯 게임 목표

- **미션**: 180초 내에 모든 적기(4대) 격추
- **승리 조건**: 
  - 모든 적기 파괴
  - 시간 내 생존 + 모든 적기 파괴
- **패배 조건**:
  - 체력 0 (피격/충돌)
  - 지면 충돌
  - 시간 초과 시 적기 잔존

## 🏆 점수 시스템

- 기관포 격추: 100점
- 미사일 격추: 100점
- 충돌 격추: 200점

## 💡 VIBE CODING의 결과물

이 프로젝트는 **VIBE CODING** 방법론으로 제작되었습니다. 빠른 프로토타이핑과 즉각적인 피드백을 통해 높은 완성도의 3D 전투기 시뮬레이터를 구현했습니다.

### 특별한 점
- 단일 JavaScript 파일로 구현된 완전한 게임 엔진
- 실시간 물리 시뮬레이션
- 복잡한 AI 행동 패턴
- 전문적인 HUD 시스템
- 몰입감 있는 사운드 디자인

## 🐛 알려진 이슈

- 일부 브라우저에서 자동 재생 정책으로 인한 BGM 재생 지연
- 고사양 그래픽 설정에서 프레임 드롭 가능
- 플레어 효과가 간혹 미사일을 완벽히 회피하지 못할 수 있음