Update README.md

README.md

@@ -1,5 +1,5 @@
 ---
-title: Jet Fight 3D
+title: 3D Air Combat Simulator
 emoji: 🌐
 colorFrom: blue
 colorTo: yellow
@@ -10,5 +10,233 @@ models:
 license: cc-by-nc-4.0
 short_description: One-minute creation by AI Coding Autonomous Agent MOUSE-I
 ---
+# JET FIGHT SIMULATOR - 3D Fighter Jet 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
+```
+jet-fight-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
+
+
+
+
+
+
+
+# JET FIGHT SIMULATOR - 3D 전투기 시뮬레이터  
+개발자: 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 지원
+- 마우스 필수
+
+## 📁 프로젝트 구조
+
+```
+jet-fight-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 재생 지연
+- 고사양 그래픽 설정에서 프레임 드롭 가능
+- 플레어 효과가 간혹 미사일을 완벽히 회피하지 못할 수 있음
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference